agnostic-prompt-aps 1.1.2__py3-none-any.whl → 1.1.4__py3-none-any.whl

aps_cli/payload/agnostic-prompt-standard/platforms/claude-code/tools-registry.json

@@ -0,0 +1,300 @@
+{
+  "platformId": "claude-code",
+  "adapterVersion": "1.0.0",
+  "lastUpdated": "2026-01-20",
+  "toolNaming": {
+    "style": "Tools are referenced by their exact names (e.g., Bash, Read, Edit).",
+    "mcpTools": "MCP tools use pattern: mcp__<server>__<tool>",
+    "rule": "Use the exact tool name. No qualification or prefixes needed."
+  },
+  "toolSets": [
+    {
+      "id": "filesystem",
+      "mention": "filesystem",
+      "description": "Tool set: file system operations (read, write, edit, search).",
+      "tools": [
+        "Read",
+        "Write",
+        "Edit",
+        "Glob",
+        "Grep",
+        "NotebookEdit"
+      ]
+    },
+    {
+      "id": "execution",
+      "mention": "execution",
+      "description": "Tool set: command execution and task management.",
+      "tools": [
+        "Bash",
+        "Task",
+        "TodoWrite"
+      ]
+    },
+    {
+      "id": "web",
+      "mention": "web",
+      "description": "Tool set: web fetching and search operations.",
+      "tools": [
+        "WebFetch",
+        "WebSearch"
+      ]
+    },
+    {
+      "id": "interaction",
+      "mention": "interaction",
+      "description": "Tool set: user interaction and questions.",
+      "tools": [
+        "AskUserQuestion"
+      ]
+    }
+  ],
+  "tools": [
+    {
+      "id": "Read",
+      "mention": "Read",
+      "preferredName": "Read",
+      "legacyName": null,
+      "description": "Read file contents from the local filesystem. Supports text files, images, PDFs, and Jupyter notebooks.",
+      "risk": "low",
+      "sideEffects": "reads",
+      "capabilities": [
+        "fs.read"
+      ],
+      "notes": "Can read any file type. Images and PDFs are processed visually."
+    },
+    {
+      "id": "Write",
+      "mention": "Write",
+      "preferredName": "Write",
+      "legacyName": null,
+      "description": "Create or overwrite files on the local filesystem.",
+      "risk": "medium",
+      "sideEffects": "writes",
+      "capabilities": [
+        "fs.write"
+      ],
+      "notes": "Requires reading the file first if it exists. Prefer Edit for existing files."
+    },
+    {
+      "id": "Edit",
+      "mention": "Edit",
+      "preferredName": "Edit",
+      "legacyName": null,
+      "description": "Perform exact string replacements in existing files.",
+      "risk": "medium",
+      "sideEffects": "writes",
+      "capabilities": [
+        "fs.patch"
+      ],
+      "notes": "Requires reading the file first. Fails if old_string is not unique."
+    },
+    {
+      "id": "Bash",
+      "mention": "Bash",
+      "preferredName": "Bash",
+      "legacyName": null,
+      "description": "Execute bash commands in a persistent shell session.",
+      "risk": "high",
+      "sideEffects": "executes",
+      "capabilities": [
+        "shell.exec"
+      ],
+      "notes": "Use for git, npm, docker, etc. Avoid for file operations (use Read/Write/Edit)."
+    },
+    {
+      "id": "Glob",
+      "mention": "Glob",
+      "preferredName": "Glob",
+      "legacyName": null,
+      "description": "Find files by glob pattern matching.",
+      "risk": "low",
+      "sideEffects": "reads",
+      "capabilities": [
+        "search.files"
+      ],
+      "notes": "Faster than find command. Returns paths sorted by modification time."
+    },
+    {
+      "id": "Grep",
+      "mention": "Grep",
+      "preferredName": "Grep",
+      "legacyName": null,
+      "description": "Search file contents using regular expressions (built on ripgrep).",
+      "risk": "low",
+      "sideEffects": "reads",
+      "capabilities": [
+        "search.text"
+      ],
+      "notes": "Supports full regex syntax. Use output_mode for different result formats."
+    },
+    {
+      "id": "WebFetch",
+      "mention": "WebFetch",
+      "preferredName": "WebFetch",
+      "legacyName": null,
+      "description": "Fetch content from a URL and process it with a prompt.",
+      "risk": "medium",
+      "sideEffects": "network",
+      "capabilities": [
+        "web.fetch"
+      ],
+      "notes": "Converts HTML to markdown. Has 15-minute cache."
+    },
+    {
+      "id": "WebSearch",
+      "mention": "WebSearch",
+      "preferredName": "WebSearch",
+      "legacyName": null,
+      "description": "Search the web and return results.",
+      "risk": "medium",
+      "sideEffects": "network",
+      "capabilities": [
+        "web.search"
+      ],
+      "notes": "Must include Sources section with URLs after answering."
+    },
+    {
+      "id": "Task",
+      "mention": "Task",
+      "preferredName": "Task",
+      "legacyName": null,
+      "description": "Launch specialized subagents for complex multi-step tasks.",
+      "risk": "medium",
+      "sideEffects": "mixed",
+      "capabilities": [
+        "agent.spawn"
+      ],
+      "notes": "Subagent types: Bash, general-purpose, Explore, Plan, etc."
+    },
+    {
+      "id": "TodoWrite",
+      "mention": "TodoWrite",
+      "preferredName": "TodoWrite",
+      "legacyName": null,
+      "description": "Create and manage a structured task list for tracking progress.",
+      "risk": "low",
+      "sideEffects": "none",
+      "capabilities": [
+        "planning.todos"
+      ],
+      "notes": "Use for complex multi-step tasks. States: pending, in_progress, completed."
+    },
+    {
+      "id": "NotebookEdit",
+      "mention": "NotebookEdit",
+      "preferredName": "NotebookEdit",
+      "legacyName": null,
+      "description": "Replace, insert, or delete cells in Jupyter notebooks.",
+      "risk": "medium",
+      "sideEffects": "writes",
+      "capabilities": [
+        "notebook.patch"
+      ],
+      "notes": "Cell numbers are 0-indexed. Supports code and markdown cells."
+    },
+    {
+      "id": "AskUserQuestion",
+      "mention": "AskUserQuestion",
+      "preferredName": "AskUserQuestion",
+      "legacyName": null,
+      "description": "Ask the user questions to gather preferences, clarify instructions, or get decisions.",
+      "risk": "low",
+      "sideEffects": "none",
+      "capabilities": [
+        "user.prompt"
+      ],
+      "notes": "Supports multiple choice with 2-4 options. Users can always select 'Other'."
+    },
+    {
+      "id": "TaskOutput",
+      "mention": "TaskOutput",
+      "preferredName": "TaskOutput",
+      "legacyName": null,
+      "description": "Retrieve output from a running or completed background task.",
+      "risk": "low",
+      "sideEffects": "reads",
+      "capabilities": [
+        "agent.output"
+      ],
+      "notes": "Use block=true to wait for completion, block=false for status check."
+    },
+    {
+      "id": "KillShell",
+      "mention": "KillShell",
+      "preferredName": "KillShell",
+      "legacyName": null,
+      "description": "Kill a running background bash shell by its ID.",
+      "risk": "low",
+      "sideEffects": "executes",
+      "capabilities": [
+        "shell.kill"
+      ],
+      "notes": "Use when you need to terminate a long-running shell."
+    },
+    {
+      "id": "Skill",
+      "mention": "Skill",
+      "preferredName": "Skill",
+      "legacyName": null,
+      "description": "Execute a skill (slash command) within the conversation.",
+      "risk": "medium",
+      "sideEffects": "mixed",
+      "capabilities": [
+        "skill.exec"
+      ],
+      "notes": "Used for slash commands like /commit, /review-pr."
+    },
+    {
+      "id": "EnterPlanMode",
+      "mention": "EnterPlanMode",
+      "preferredName": "EnterPlanMode",
+      "legacyName": null,
+      "description": "Transition to plan mode for designing implementation approaches.",
+      "risk": "low",
+      "sideEffects": "none",
+      "capabilities": [
+        "planning.enter"
+      ],
+      "notes": "Use for non-trivial implementation tasks requiring user approval."
+    },
+    {
+      "id": "ExitPlanMode",
+      "mention": "ExitPlanMode",
+      "preferredName": "ExitPlanMode",
+      "legacyName": null,
+      "description": "Signal plan completion and request user approval.",
+      "risk": "low",
+      "sideEffects": "none",
+      "capabilities": [
+        "planning.exit"
+      ],
+      "notes": "Can request bash command permissions via allowedPrompts."
+    }
+  ],
+  "recommended": {
+    "aps": {
+      "planner": [
+        "Read",
+        "Glob",
+        "Grep",
+        "WebFetch",
+        "WebSearch",
+        "TodoWrite",
+        "AskUserQuestion",
+        "Task"
+      ],
+      "implementer": [
+        "Read",
+        "Write",
+        "Edit",
+        "Bash",
+        "Glob",
+        "Grep",
+        "TodoWrite",
+        "Task",
+        "NotebookEdit"
+      ]
+    }
+  }
+}

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/README.md

@@ -1,24 +1,17 @@
 # VS Code + GitHub Copilot adapter
 
-This adapter documents **how APS fits into VS Code Copilot's file conventions**, and provides ready-to-copy templates.
+This adapter documents **how APS fits into VS Code Copilot's file conventions**.
 
 ## What this adapter provides
 
 - `manifest.json` — where VS Code discovers skills, agents, prompts, and instructions
 - `tools-registry.json` — a curated registry of tools/tool-sets and their **canonical frontmatter names**
 - `frontmatter/` — copy/paste YAML frontmatter templates for VS Code files
-- `templates/` — drop-in `.github/*` templates (agents)
 
 ## Quickstart
 
-1. Install this APS skill into your repo at:
-   - `.github/skills/agnostic-prompt-standard/`
-2. Copy the templates into your workspace (root):
-   - From: `platforms/vscode-copilot/templates/.github/`
-   - To: `.github/`
-
-After copying, you'll have:
-- `.github/agents/aps-prompt-protocol.agent.md`
+Install this APS skill into your repo at:
+- `.github/skills/agnostic-prompt-standard/`
 
 ## VS Code file locations (summary)
 
@@ -30,7 +23,6 @@ VS Code Copilot discovers these files:
 - **Custom instructions**:
   - `.github/copilot-instructions.md`
   - `.github/instructions/*.instructions.md`
-  - `AGENTS.md` (optional)
 
 See `manifest.json` for the full matrix (including personal and Claude locations).
 

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/agent-frontmatter.md

@@ -5,7 +5,7 @@ description: "What this agent does and when to use it."
 # Optional: a short hint shown in the UI
 argument-hint: "Describe the task…"
 # Optional: list of tools/tool-sets available to this agent
-tools: ["search", "read", "edit", "execute", "todo", "web/fetch"]
+tools: ['execute/runInTerminal', 'read/readFile', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'web/fetch', 'todo']
 # Optional: default model for this agent (if your org enables model selection)
 model: "GPT-4.1"
 # Optional: allow VS Code to run subagents (isolated contexts)

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/instructions-frontmatter.md

@@ -9,4 +9,3 @@ description: "Frontend coding conventions"
 Notes:
 - VS Code supports a single `.github/copilot-instructions.md` (workspace-wide).
 - VS Code also supports targeted `*.instructions.md` files (default folder: `.github/instructions`).
-- VS Code can read `AGENTS.md` files (workspace root; optional nested via setting).

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/manifest.json

@@ -27,7 +27,6 @@
     "instructions": [
       ".github/copilot-instructions.md",
       ".github/instructions/*.instructions.md",
-      "AGENTS.md (root, optional nested via setting)",
       "CLAUDE.md / GEMINI.md (GitHub ecosystem alternates)"
     ]
   },

aps_cli/payload/agnostic-prompt-standard/references/03-agentic-control.md

@@ -6,10 +6,10 @@ This document defines the **agentic control DSL** used inside `<process>` bodies
 
 ```yaml
 keywords:
-  control: [GIVEN, WHEN, IF, ELSE IF, ELSE, THEN]
+  control: [GIVEN, WHEN, THEN, IF, ELSE IF, ELSE, IN]
   actions: [RUN, USE, CAPTURE, SET, UNSET, RETURN, ASSERT]
   story: [TELL, SNAP, MILESTONE]
-  blocks: [WITH, PAR, JOIN]
+  blocks: [WITH, PAR, JOIN, TRY, FOREACH, RECOVER]
   modifiers: [atomic, timeout_ms, retry]
 ```
 
@@ -37,9 +37,13 @@ identifiers:
   reserved:
     - GIVEN
     - WHEN
+    - THEN
     - IF
     - ELSE
-    - THEN
+    - FOREACH
+    - IN
+    - TRY
+    - RECOVER
     - RUN
     - USE
     - SET
@@ -61,6 +65,17 @@ identifiers:
 
 Reserved words cannot be used as ids/keys/symbols (`AG-002`).
 
+## GIVEN / WHEN / THEN (BDD pattern)
+
+These keywords support Behavior-Driven Design (BDD) style specifications:
+
+- `GIVEN`: establishes preconditions or context that must hold before execution.
+- `WHEN`: describes a trigger, event, or condition that initiates action.
+- `THEN`: specifies expected outcomes or postconditions after execution.
+
+Each keyword opens a block with `:` (Python-style). The block body contains statements that execute
+when the condition is satisfied. Engines SHOULD evaluate conditions in lexical order.
+
 ## Strings, booleans, and numbers
 
 ```yaml
@@ -108,35 +123,61 @@ except as explicitly defined by the engine:
 
 Engines SHOULD log deterministic span indices and MUST NOT perform speculative execution.
 
+## FOREACH iteration
+
+`FOREACH` provides deterministic iteration over symbol arrays:
+
+- `FOREACH item IN ITEMS:` iterates over each element in the `ITEMS` array in **index order**.
+- The loop variable (`item`) is bound to the current element for each iteration.
+- Loop body statements execute sequentially; the engine MUST NOT parallelize unless explicitly
+  wrapped in `PAR`.
+- If `ITEMS` is empty, the loop body is skipped entirely.
+- The loop variable is scoped to the block; it is undefined after the closing boundary.
+
+Engines SHOULD expose the current index via a deterministic mechanism (e.g., `_INDEX` symbol).
+
+## TRY / RECOVER error handling
+
+`TRY` and `RECOVER` define structured error handling:
+
+- `TRY:` begins a guarded block; statements execute until completion or first hard error.
+- `RECOVER (err):` binds the error to the named variable (`err`) and executes recovery statements.
+- If no error occurs, the `RECOVER` block is skipped.
+- Recovery statements MAY access the error variable to inspect type, message, or context.
+- Nested `TRY` blocks are permitted; inner handlers take precedence.
+
+Error binding follows engine-defined schema; at minimum, engines MUST expose `err.type` and
+`err.message`.
+
 ## Invocation syntax (normative)
 
 The following describes statement syntax at a human-readable level. The authoritative grammar is
 in **05 Grammar**.
 
 ```text
-RUN `process_id` [where: k1=V1, ...].
+RUN `process_id` [where: k1=V1, ...]
 
-USE `tool_name` [where: k1=V1, ...] [(atomic[, timeout_ms=NUM][, retry=NUM])].
+USE `tool_name` [where: k1=V1, ...] [(atomic[, timeout_ms=NUM][, retry=NUM])]
 
-CAPTURE S1[, S2 ...] from `tool_name` [map: "path1"→S1, "path2?"→S2 ...].
+CAPTURE S1[, S2 ...] from `tool_name` [map: "path1"→S1, "path2?"→S2 ...]
   - Optional field via suffix '?'; no error if missing; symbol unchanged.
 
 SET SYMBOL := VALUE [(from SOURCE)]
   - SOURCE ∈ { `tool`, INP, UpperSym, "Agent Inference" }
 
-UNSET SYMBOL.
+UNSET SYMBOL
 
-RETURN: SYMBOL[, SYMBOL...].
-RETURN: key=VALUE[, key=VALUE ...].
+RETURN: SYMBOL[, SYMBOL...]
+RETURN: key=VALUE[, key=VALUE ...]
   - VALUE may be an artifact reference: {"$artifact":"SYMBOL","hash":"sha256:..."}.
 
-ASSERT <condition>.
-ASSERT ALL: [ <condition>, <condition>, ... ].
+ASSERT <condition>
+ASSERT ALL: [ <condition>, <condition>, ... ]
 
-TELL "message" [why:SYMBOL] [level={brief|full}] [outcome:"text"].
-MILESTONE "title".
+TELL "message" [why:SYMBOL] [level={brief|full}] [outcome:"text"]
+MILESTONE "title"
 
-SNAP [SYM1, SYM2 ...] [delta=true|false] [redact=[SYM_A, SYM_B ...]].
+SNAP [SYM1, SYM2 ...] [delta=true|false] [redact=[SYM_A, SYM_B ...]]
 ```
 
 ## Arguments and values

aps_cli/payload/agnostic-prompt-standard/references/04-schemas-and-types.md

@@ -132,6 +132,3 @@ Style guidelines:
 - JSON block constant example: [../assets/constants/constants-json-block-v1.0.0.example.md](../assets/constants/constants-json-block-v1.0.0.example.md)
 - TEXT block constant example: [../assets/constants/constants-text-block-v1.0.0.example.md](../assets/constants/constants-text-block-v1.0.0.example.md)
 
-## Example agents
-
-- VS Code orchestration agent: [../assets/agents/vscode-agent-v1.0.0.agent.md](../assets/agents/vscode-agent-v1.0.0.agent.md)

aps_cli/payload/agnostic-prompt-standard/references/05-grammar.md

@@ -9,6 +9,7 @@ This document defines the normative EBNF for the agentic control DSL.
 
 ```ebnf
 Letter        = "A"…"Z" | "a"…"z" ;
+LowerLetter   = "a"…"z" ;
 Digit         = "0"…"9" ;
 Space         = " " ;
 Newline       = "\n" ;
@@ -26,13 +27,13 @@ BlockOpen     = UpperSym, ":", Space, BlockType, "<<", EOL ;
 BlockClose    = ">>" ;
 BlockValue    = BlockType, "<<", EOL, { <any line except BlockClose>, EOL }, BlockClose ;
 
-JsonKey       = Letter, { Letter | Digit | "_" | "-" } ;
+JsonKey       = LowerLetter, { LowerLetter | Digit | "_" | "-" } ;
 JsonValue     = String | Number | Bool | "null" | JsonObj | JsonArr | UpperSym ;
 JsonPair      = "\"", JsonKey, "\"", ":", Space?, JsonValue ;
 JsonObj       = "{", Space?, [ JsonPair, { ",", Space?, JsonPair } ], Space?, "}" ;
 JsonArr       = "[", Space?, [ JsonValue, { ",", Space?, JsonValue } ], Space?, "]" ;
 
-IdLower       = Letter, { Letter | Digit | "_" | "-" } ;
+IdLower       = LowerLetter, { LowerLetter | Digit | "_" | "-" } ;
 Key           = IdLower ;
 Value         = String | Number | Bool | JsonObj | JsonArr | UpperSym | Placeholder | EnumLit ;
 
@@ -65,6 +66,7 @@ IfStmt        = "IF", Space, <expr>, ":" ;
 ElseIfStmt    = "ELSE IF", Space, <expr>, ":" ;
 ElseStmt      = "ELSE", ":" ;
 WhenStmt      = "WHEN", Space, <condition-text-no-colon>, ":" ;
+ThenStmt      = "THEN", Space, <condition-text-no-colon>, ":" ;
 GivenStmt     = "GIVEN", Space, <condition-text-no-colon>, ":" ;
 
 EOL           = Newline ;
@@ -88,7 +90,7 @@ RegexConst    = "matches", Space, String ;
 
 Statement     = RunStmt | UseStmt | CaptureStmt | SetStmt | UnsetStmt | ReturnStmt | AssertStmt
               | TellStmt | MileStmt | WithBlock | ParBlock | JoinBlock | ForEachStmt | TryBlock
-              | IfStmt | ElseIfStmt | ElseStmt | SnapStmt ;
+              | IfStmt | ElseIfStmt | ElseStmt | GivenStmt | WhenStmt | ThenStmt | SnapStmt ;
 
 Program       = { Statement, EOL } ;
 ```