Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 8, 2026

Documents the runtime file/URL inclusion feature supporting both {{#runtime-import}} macro syntax and @path inline shorthand.

Changes

Added comprehensive Runtime Imports section to /docs/src/content/docs/reference/templating.md:

  • Two syntax forms: Macro {{#runtime-import filepath}} and inline @./path / @../path
  • Line range extraction: Both syntaxes support :start-end notation (e.g., @./auth.go:45-52)
  • URL fetching: HTTP/HTTPS URLs with 1-hour cache (@https://example.com/file.md)
  • Security: Path validation prevents directory traversal, content sanitization rejects GitHub Actions macros
  • Syntax comparison table: Feature parity and differences between macro vs inline forms

Example

---
on: pull_request
engine: copilot
---

# Security Review

Follow these guidelines:

@./.github/security-checklist.md

Review the code changes:

@./src/payment/processor.go:234-267

Compare with tests:

@./tests/payment/processor_test.go:145-178

Screenshot

Runtime imports documentation

Note: Inline syntax requires paths start with ./ or ../ to distinguish from email addresses.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
    • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro dev (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Add docs for runtime-import and the @path syntax for imports.

Custom agent used: technical-doc-writer
AI technical documentation writer for GitHub Actions library using Astro Starlight and GitHub Docs voice


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add documentation for runtime-import and @path imports Add docs for runtime-import and @path syntax Jan 8, 2026
Copilot AI requested a review from pelikhan January 8, 2026 03:46
@pelikhan pelikhan marked this pull request as ready for review January 8, 2026 03:48
@pelikhan pelikhan merged commit e0a8e84 into main Jan 8, 2026
@pelikhan pelikhan deleted the copilot/add-runtime-import-docs branch January 8, 2026 03:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants