Update to Fastly Agent Toolkit

{
  "description": "Lints, tests, simulates, and formats Fastly VCL code using the falco tool. Also serves as the authoritative VCL reference via the falco Go source, which implements Fastly's full VCL dialect. Use when validating VCL syntax, running VCL linting, testing VCL locally, simulating VCL request handling, formatting VCL files, writing VCL unit tests with assertions, debugging VCL logic errors, looking up VCL function signatures or variable scopes, understanding VCL subroutine behavior, or running `falco lint`/`falco simulate`/`falco test`/`falco fmt`. Also applies when working with VCL syntax errors, type mismatches in VCL, choosing which VCL subroutine to use, or setting up a local VCL development and testing environment.",
  "included_files": [
    {
      "relative_path": "references/formatting-vcl.md",
      "size_in_bytes": 2389
    },
    {
      "relative_path": "references/linting-vcl.md",
      "size_in_bytes": 1773
    },
    {
      "relative_path": "references/simulating-vcl.md",
      "size_in_bytes": 2938
    },
    {
      "relative_path": "references/terraform-vcl.md",
      "size_in_bytes": 2707
    },
    {
      "relative_path": "references/testing-vcl.md",
      "size_in_bytes": 4872
    },
    {
      "relative_path": "references/understanding-vcl-from-source.md",
      "size_in_bytes": 12558
    },
    {
      "relative_path": "references/vcl-console.md",
      "size_in_bytes": 1755
    },
    {
      "relative_path": "references/vcl-statistics.md",
      "size_in_bytes": 2649
    }
  ],
  "name": "falco",
  "skill_md_contents": "---\nname: falco\ndescription: \"Lints, tests, simulates, and formats Fastly VCL code using the falco tool. Also serves as the authoritative VCL reference via the falco Go source, which implements Fastly's full VCL dialect. Use when validating VCL syntax, running VCL linting, testing VCL locally, simulating VCL request handling, formatting VCL files, writing VCL unit tests with assertions, debugging VCL logic errors, looking up VCL function signatures or variable scopes, understanding VCL subroutine behavior, or running `falco lint`/`falco simulate`/`falco test`/`falco fmt`. Also applies when working with VCL syntax errors, type mismatches in VCL, choosing which VCL subroutine to use, or setting up a local VCL development and testing environment.\"\n---\n\n## Trigger and scope\n\nTrigger on: VCL files, .vcl extensions, XVCL files, .xvcl extensions, falco CLI, VCL unit tests, VCL linting/simulation/formatting, VCL REPL, beresp/bereq/req.http variables, subroutine scopes, backend/ACL/director/table declarations, edge dictionaries, validating VCL in Terraform plans, or running/testing XVCL scripts locally.\n\nDo NOT use for: generic non-Fastly VCL, Fastly Compute/WASM, Fastly API/dashboard ops, CDN comparison, cache purging, or authoring Terraform resources.\n\n# Falco — VCL Development Tool & Reference\n\nFalco is a Fastly VCL development tool for linting, testing, simulating, and formatting VCL code. Equally important, **the falco source code is the most complete machine-readable specification of Fastly's VCL dialect** — its parser, interpreter, and type system document every variable, function, type, and scope rule in VCL.\n\n**Official VCL documentation**: https://www.fastly.com/documentation/guides/full-site-delivery/fastly-vcl/about-fastly-vcl/\n\n**Falco documentation**: https://github.com/ysugimoto/falco\n\n## Using Falco Source as VCL Reference\n\nIf you need to understand how VCL works — what variables exist, which scopes they're available in, what functions are built-in, how types coerce — the falco source code is your best reference. It's a complete Go implementation of Fastly's VCL 2.x and is more precise than prose documentation.\n\n**If the falco source is not available locally**, recommend cloning it:\n```bash\ngit clone https://github.com/ysugimoto/falco.git ~/src/falco\n```\n\nOnce available locally, read the source files directly to answer VCL questions. See [understanding-vcl-from-source.md](references/understanding-vcl-from-source.md) for a detailed guide on which files to read for different VCL topics.\n\n## Install\n\n```bash\n# Homebrew\nbrew install falco\n\n# From source (requires Go 1.25+)\ngo install github.com/ysugimoto/falco/cmd/falco@latest\n\n# Or clone and build\ngit clone https://github.com/ysugimoto/falco.git\ncd falco\nmake darwin_arm64    # or darwin_amd64, linux_amd64, linux_arm64\n```\n\n## Commands\n\n| Command           | Description                      |\n| ----------------- | -------------------------------- |\n| `falco [lint]`    | Lint VCL files (default command) |\n| `falco test`      | Run VCL unit tests               |\n| `falco simulate`  | Start local simulator server     |\n| `falco fmt`       | Format VCL files                 |\n| `falco stats`     | Show VCL code statistics         |\n| `falco console`   | Interactive VCL REPL             |\n| `falco terraform` | Lint VCL from Terraform plans    |\n| `falco dap`       | Debug Adapter Protocol server    |\n\n## Common flags (all commands)\n\n| Flag                 | Description                      |\n| -------------------- | -------------------------------- |\n| `-I, --include_path` | Add include path for VCL imports |\n| `-h, --help`         | Show help                        |\n| `-V, --version`      | Show version                     |\n| `-r, --remote`       | Fetch snippets from Fastly API   |\n| `--refresh`          | Refresh remote snippet cache     |\n\n## Quick reference\n\n**Lint before deployment:**\n```bash\nfalco -vv -I ./vcl ./vcl/main.vcl\n```\n\n**Run tests:**\n```bash\nfalco test -I ./vcl ./vcl/main.vcl\n```\n\n**Development with watch mode:**\n```bash\nfalco test -w -I ./vcl ./vcl/main.vcl\n```\n\n**Run VCL locally** (this is how you \"run\" or \"test locally\" — use `simulate`, not just `lint`):\n```bash\nfalco simulate -I ./vcl ./vcl/main.vcl\n# Default port is 3124. Test with: curl http://localhost:3124/path\n# Use -p to override: falco simulate -p 8080 ./vcl/main.vcl\n```\n\n**Format all VCL:**\n```bash\nfalco fmt -w ./vcl/**/*.vcl\n```\n\n**Terraform integration:**\n```bash\nterraform show -json planned.out | falco terraform -vv\n```\n\n## Common VCL Issues\n\nFalco catches these, but understanding them prevents wasted lint-fix cycles:\n\n- **Type mismatch**: `set req.http.X-API = true` — HTTP headers are STRING, not BOOL. Use `\"true\"`.\n- **Missing time suffix**: `set beresp.ttl = 86400` — RTIME values need `s` suffix: `86400s`.\n- **Wrong scope**: `beresp.*` only exists in `vcl_fetch`. In `vcl_deliver`, use `resp.*`.\n- **Deprecated**: `req.request` → use `req.method`. Falco accepts both, but always change to `req.method` when fixing VCL.\n- **Synthetic strings**: `synthetic \"text\"` needs long-string syntax: `synthetic {\"text\"}`.\n- **Backend naming**: Use `F_` prefix: `backend F_origin { ... }`, not `backend origin`.\n- **No modulo operator**: VCL has no `%`. Use `substr()` on a hash or `randomint()` for splitting.\n- **`req.url.path` is read-only in tests**: Use `set req.url = \"/path\"` in test subroutines, not `set req.url.path`.\n- **Vary placement**: Vary must be set in `vcl_fetch`, not just `vcl_deliver`. Setting Vary after the object enters the cache is too late — the cache key won't include the Vary dimensions.\n\n## Configuration\n\nCreate `.falco.yaml` in project root for persistent settings:\n\n```yaml\ninclude_paths:\n  - ./vcl\n  - ./includes\n\nlinter:\n  verbose: \"warning\"\n  rules:\n    rule-name: ERROR  # or WARNING, INFO, IGNORE\n\ntesting:\n  timeout: 10  # minutes (default: 10)\n  filter: \"*.test.vcl\"\n\nsimulator:\n  port: 3124\n\nformat:\n  indent_width: 2\n  line_width: 120\n```\n\n## Environment variables\n\n| Variable            | Description               |\n| ------------------- | ------------------------- |\n| `FASTLY_SERVICE_ID` | Service ID for Fastly API |\n| `FASTLY_API_KEY`    | API key for Fastly API    |\n\nRequired when using `-r, --remote` flag.\n\nConfigure API credentials locally, outside chat.\nNever ask for an API key in a conversation or print its value.\n\n## References\n\n| Topic                    | File                                                                            | Use when...                                                   |\n| ------------------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------------- |\n| **VCL from Source**      | [understanding-vcl-from-source.md](references/understanding-vcl-from-source.md) | Understanding VCL semantics by reading falco's implementation |\n| Testing VCL              | [testing-vcl.md](references/testing-vcl.md)                                     | Running test suites, coverage, watch mode for TDD             |\n| Formatting VCL           | [formatting-vcl.md](references/formatting-vcl.md)                               | Formatting VCL for consistent style                           |\n| Linting VCL              | [linting-vcl.md](references/linting-vcl.md)                                     | Checking VCL for errors before deployment                     |\n| Simulating VCL           | [simulating-vcl.md](references/simulating-vcl.md)                               | Testing VCL against HTTP requests locally                     |\n| Terraform VCL            | [terraform-vcl.md](references/terraform-vcl.md)                                 | Validating VCL from Terraform plans                           |\n| VCL Console              | [vcl-console.md](references/vcl-console.md)                                     | Experimenting with VCL expressions interactively              |\n| VCL Statistics           | [vcl-statistics.md](references/vcl-statistics.md)                               | Analyzing VCL project size and complexity                     |\n\n## Source Code as VCL Reference (Quick Lookup)\n\nWhen you have access to the falco source code locally (default: `~/src/falco`), use these paths to answer specific VCL questions:\n\n| Question                                      | Read This File                                    | Why                                                          |\n| --------------------------------------------- | ------------------------------------------------- | ------------------------------------------------------------ |\n| \"What variables can I use in `vcl_recv`?\"      | `interpreter/variable/`                           | Every `req.*`, `beresp.*`, `client.*` variable with scopes   |\n| \"What built-in functions exist?\"               | `interpreter/function/`                           | All 390+ functions with type signatures and scope rules      |\n| \"What are the VCL types?\"                      | `interpreter/value/`                              | STRING, INTEGER, FLOAT, BOOL, TIME, RTIME, IP, BACKEND       |\n| \"What's the request lifecycle?\"                | `interpreter/context/`                            | The 9 scopes: recv, hash, hit, miss, pass, fetch, error, deliver, log |\n| \"Is this valid VCL syntax?\"                    | `token/token.go`, `lexer/lexer.go`               | Every keyword, operator, literal type                        |\n| \"How does this VCL statement work?\"            | `interpreter/statement.go`                        | How set, unset, return, restart, etc. execute                |\n| \"What are common VCL mistakes?\"               | `linter/`, `docs/rules.md`                        | 50+ linting rules with explanations                          |\n| \"How do directors work?\"                       | `interpreter/director.go`                         | Random, fallback, hash, client, chash director types         |\n\nFor a comprehensive guide, see [understanding-vcl-from-source.md](references/understanding-vcl-from-source.md).\n"
}