@debian777/kairos-mcp 3.3.3 → 3.4.0

package/dist/embed-docs/mem/00000000-0000-0000-0000-000000002003.md

@@ -0,0 +1,195 @@
+---
+version: "3.4.0"
+slug: create-new-protocol-review
+title: Review and Publish New KAIROS Protocol
+---
+
+# Review and Publish New KAIROS Protocol
+
+Validate a drafted KAIROS protocol through format review, stranger review, user approval, and mint. Invoked by Chain 1 (`create-new-protocol`) or directly to re-review an existing draft.
+
+## Natural Language Triggers
+
+**Typically invoked by:** Chain 1's chain link step via `kairos_begin(key: "create-new-protocol-review")`.
+
+**Can be invoked directly when user says:**
+
+- "review my protocol draft" / "validate this protocol"
+- "re-run format review on my draft"
+- "mint my protocol" (when a draft already exists)
+
+**Trigger pattern:** **review** / **validate** / **mint** + (protocol / draft).
+
+**Must Never:**
+- Run without `$KAIROS_WORK_DIR` set and containing `draft-protocol.md`.
+- Skip format or stranger review steps.
+
+**Must Always:**
+- Verify `$KAIROS_WORK_DIR` and draft file exist before proceeding.
+- Require both reviews to pass before presenting to user.
+- Freeze the draft checksum after reviews pass and verify it before minting.
+- Clean up `$KAIROS_WORK_DIR` after minting (or on cancellation).
+
+**Good trigger examples:**
+- Chained from `create-new-protocol` → run this protocol
+- "Review and mint my protocol draft" → run this protocol
+
+**Bad trigger examples:**
+- "Create a new protocol" → use `create-new-protocol`, not this
+- "Search for a protocol" → use `kairos_search`, not this
+
+---
+
+## Prerequisites
+
+This protocol requires `$KAIROS_WORK_DIR` from Chain 1 (engine-provided, persists across chained protocols):
+
+- `$KAIROS_WORK_DIR/draft-protocol.md` — the drafted protocol file
+- `$KAIROS_WORK_DIR/requirements.md` — requirements summary (optional, for context)
+
+**If invoked directly** (no Chain 1), the engine creates `$KAIROS_WORK_DIR` at `kairos_begin`. Copy the draft file there before proceeding.
+
+**Security:** Do NOT write credentials, tokens, or secrets into any file in `$KAIROS_WORK_DIR`.
+
+---
+
+## Format Review [SUBAGENT]
+
+Delegate format verification to a subagent. The subagent writes its verdict to `$KAIROS_WORK_DIR/format-review.md`.
+
+**Input:** `$KAIROS_WORK_DIR/draft-protocol.md`.
+
+**Subagent task:**
+
+1. Read `$KAIROS_WORK_DIR/draft-protocol.md`.
+2. Verify protocol structure compliance:
+   - H1 present (exactly one)
+   - First H2 is Natural Language Triggers (with all 6 subsections: trigger phrases, trigger pattern, Must Never, Must Always, good examples, bad examples)
+   - Last H2 is Completion Rule
+   - Every middle H2 has a challenge block
+   - No duplicate H2 headings
+3. Verify subagent eligibility per step:
+   - Every H2 step has `[SUBAGENT]` tag
+   - Every step has explicit `**Input:**`, `**Actions:**`, `**Output:**`
+   - Actions are numbered and imperative
+4. Verify challenge type selection (per `kairos_begin(key: "challenge-type-guide")`):
+   - No `comment` challenges on steps that produce files, call tools, or check system state
+   - `shell` challenges use compound `&&` chains (not `;`)
+   - `shell` challenges include `timeout_seconds`
+5. Verify interpreter selection:
+   - Flag bash challenges containing `while read`, `grep | awk`, or escaped quotes deeper than one level — suggest Perl rewrite
+   - Multi-line regex validation MUST use `perl -0777` (not bash `grep`)
+   - JSON block validation MUST use `perl -MJSON` or `python3 -c 'import json'` (not bash pattern matching)
+   - Simple file tests (`test -f`, `which`, `git status`) stay bash
+6. Verify DRY compliance:
+   - No duplicated content across files (if Router pattern)
+   - No boilerplate sections — shared content extracted or inlined
+7. Verify 350-line limit:
+   - Count lines. If over 350, list which sections to split or extract.
+8. Verify slug convention:
+   - Slug present in frontmatter
+   - Follows naming rules (lowercase, hyphenated, 2–4 segments)
+   - If Router: children expand parent slug by one segment
+9. Write verdict to `$KAIROS_WORK_DIR/format-review.md`. First line MUST be `PASS` or `FAIL`. Remaining lines: list of specific fixes if FAIL.
+
+**Output:** `$KAIROS_WORK_DIR/format-review.md` with verdict on first line.
+
+**If fail:** Main agent applies fixes to the draft and re-runs this step until pass.
+
+```json
+{"challenge":{"type":"shell","shell":{"cmd":"test -f \"$KAIROS_WORK_DIR/format-review.md\" && head -1 \"$KAIROS_WORK_DIR/format-review.md\" | grep -qi 'pass'","timeout_seconds":5},"required":true}}
+```
+
+## Stranger Review [SUBAGENT]
+
+Delegate executability review to a subagent with junior AI agent persona. The subagent writes its verdict to `$KAIROS_WORK_DIR/stranger-review.md`.
+
+**Input:** `$KAIROS_WORK_DIR/draft-protocol.md` (post format-review fixes).
+
+**Subagent task:**
+
+1. Assume persona: Junior AI agent, first time encountering KAIROS protocols.
+2. **Mocked dry-run (most important):** Walk through every step in order and produce a mocked but **structurally correct** challenge response. If a mock is wrong, the protocol is ambiguous.
+   - **`mcp` challenges:** Return valid MCP tool-call JSON with correct `tool_name`, plausible `arguments`, and realistic `result` envelope. No placeholder strings.
+   - **`shell` challenges:** Write the exact command. If non-destructive, show expected stdout/stderr and exit code. Destructive: show command only.
+   - **`user_input` challenges:** Write a realistic user response matching all constraints. If choice implied, pick one and justify.
+   - **`comment` challenges:** Write a realistic agent comment meeting `min_length`, covering the step's stated output, no filler.
+3. **Clarity checks** (alongside dry-run):
+   - **Executability test:** Can I follow step-by-step without guessing? (yes/no + explanation)
+   - **Ambiguity check:** Vague terms like "appropriate", "reasonable", "as needed"? (list every instance)
+   - **Missing context:** Steps referencing undefined variables or concepts? (list them)
+   - **Missing examples:** Complex rules without examples? (list them)
+4. Write verdict to `$KAIROS_WORK_DIR/stranger-review.md`. First line MUST be `PASS` or `FAIL`. Remaining lines: mocked dry-run responses and clarity check results. If FAIL, include specific gaps with the failing mock inline.
+
+**Output:** `$KAIROS_WORK_DIR/stranger-review.md` with verdict on first line and full dry-run.
+
+**If fail:** Main agent revises draft — replace vague terms, add examples, define missing variables, fix steps whose mock drifted from intent. Re-run until pass.
+
+```json
+{"challenge":{"type":"shell","shell":{"cmd":"test -f \"$KAIROS_WORK_DIR/stranger-review.md\" && head -1 \"$KAIROS_WORK_DIR/stranger-review.md\" | grep -qi 'pass'","timeout_seconds":5},"required":true}}
+```
+
+## Checksum Freeze [SUBAGENT]
+
+Freeze the draft after both reviews pass. Prevents accidental edits between "reviews passed" and "user approved".
+
+**Input:** `$KAIROS_WORK_DIR/draft-protocol.md` (post both reviews).
+
+**Actions:**
+1. Compute md5 checksum of the draft file.
+2. Write checksum to `$KAIROS_WORK_DIR/draft-protocol.md.md5`.
+
+**Output:** `$KAIROS_WORK_DIR/draft-protocol.md.md5` containing the frozen checksum.
+
+```json
+{"challenge":{"type":"shell","shell":{"cmd":"md5 -q \"$KAIROS_WORK_DIR/draft-protocol.md\" > \"$KAIROS_WORK_DIR/draft-protocol.md.md5\" && test -s \"$KAIROS_WORK_DIR/draft-protocol.md.md5\"","timeout_seconds":5},"required":true}}
+```
+
+## User Review [SUBAGENT]
+
+Present the drafted and reviewed protocol to the user for final approval.
+
+**Input:** `$KAIROS_WORK_DIR/draft-protocol.md`, `$KAIROS_WORK_DIR/format-review.md`, `$KAIROS_WORK_DIR/stranger-review.md`.
+
+**Actions:**
+1. Present full protocol markdown (or all files if Router pattern).
+2. Summarize: pattern used, step count, challenge types, slug(s), both review verdicts.
+3. Ask: "Type 'approved' to mint, describe what needs adjustment, or 'cancel'."
+
+**Output:** User approval, change requests, or cancellation.
+
+```json
+{"challenge":{"type":"user_input","user_input":{"prompt":"Review the protocol draft above. Type 'approved' to mint, describe adjustments, or 'cancel'."},"required":true}}
+```
+
+## Mint Protocol [SUBAGENT]
+
+Verify the draft is unchanged since checksum freeze, then call `kairos_mint`.
+
+**Input:** Approved `$KAIROS_WORK_DIR/draft-protocol.md`, slug from frontmatter.
+
+**Actions:**
+1. Verify draft unchanged: `md5 -q "$KAIROS_WORK_DIR/draft-protocol.md" | diff - "$KAIROS_WORK_DIR/draft-protocol.md.md5"`. If diff fails, warn user and abort.
+2. Call `kairos_mint` with `force_update: false` (unless user explicitly asked to overwrite).
+3. If Router pattern: mint the router first, then each extension in order.
+4. Verify each mint succeeded by checking the returned URI.
+5. Report the chain head URI(s) back to the user with clickable links.
+
+**Output:** Confirmation with minted URI(s) and slug(s).
+
+```json
+{"challenge":{"type":"mcp","mcp":{"tool_name":"kairos_mint"},"required":true}}
+```
+
+## Completion Rule
+
+Only reachable after all prior steps are solved.
+
+**Cleanup:** `$KAIROS_WORK_DIR` is cleaned up by the engine at `kairos_attest`.
+
+The user now has a minted KAIROS protocol that:
+1. Passed Format Review — structure, DRY, 350-line limit, slug convention, challenge type selection.
+2. Passed Stranger Review — mocked dry-run with structurally correct challenge responses, unambiguous, executable by a junior AI agent.
+3. Checksum verified — draft unchanged between review pass and mint.
+4. User approved the final draft.
+5. Successfully minted to KAIROS and discoverable via `kairos_search`.

package/dist/embed-docs/mem/00000000-0000-0000-0000-000000002004.md

@@ -0,0 +1,240 @@
+---
+version: "3.4.0"
+slug: challenge-type-guide
+title: Challenge Type Selection Guide
+---
+
+# Challenge Type Selection Guide
+
+Decision rules, JSON formats, interpreter selection, and anti-patterns for choosing KAIROS challenge types. Loaded by protocol-authoring agents during drafting and review.
+
+## Natural Language Triggers
+
+**Typically invoked by:** `create-new-protocol` (Chain 1) Draft Markdown step and `create-new-protocol-review` (Chain 2) Format Review step via `kairos_begin(key: "challenge-type-guide")`.
+
+**Can be invoked directly when agent needs:**
+
+- "challenge type reference" / "which challenge type to use"
+- "how to write shell challenges" / "challenge format"
+- "interpreter selection for challenges"
+
+**Trigger pattern:** **challenge** + (type | format | selection | guide).
+
+**Must Never:**
+- Be used as an execution protocol — this is a reference policy, not a workflow.
+
+**Must Always:**
+- Be consulted before assigning challenge types to protocol steps.
+
+**Good trigger examples:**
+- Drafting a new protocol and need challenge types → load this
+- Reviewing challenge type selection in a draft → load this
+
+**Bad trigger examples:**
+- "Create a new protocol" → use `create-new-protocol`
+- "Review my protocol draft" → use `create-new-protocol-review`
+
+---
+
+## Core Rules
+
+`comment` is the challenge type of **last resort**. If a step produces any observable artifact — a file, a git state change, an API response, a process exit code — use `shell` or `mcp` instead.
+
+### Decision Tree
+
+```
+Does the step call an MCP tool?
+ ├─ YES → "mcp" with tool_name
+ └─ NO → Does the step produce or modify a file?
+          ├─ YES → "shell" to verify the file
+          └─ NO → Does the step require human approval or choice?
+                   ├─ YES → "user_input" with a specific prompt
+                   └─ NO → Does the step run a command or check system state?
+                            ├─ YES → "shell"
+                            └─ NO → "comment" (pure reasoning, no artifact)
+```
+
+### Challenge JSON Formats
+
+**shell** — engine runs command, checks exit code 0:
+
+Example: ```json
+{"challenge":{"type":"shell","shell":{"cmd":"<command>","timeout_seconds":30},"required":true}}
+```
+
+**mcp** — engine confirms named MCP tool was invoked:
+
+Example: ```json
+{"challenge":{"type":"mcp","mcp":{"tool_name":"<tool>"},"required":true}}
+```
+
+With pinned arguments:
+
+Example: ```json
+{"challenge":{"type":"mcp","mcp":{"tool_name":"kairos_begin","arguments":{"key":"some-slug"}},"required":true}}
+```
+
+**user_input** — engine confirms user provided non-empty response:
+
+Example: ```json
+{"challenge":{"type":"user_input","user_input":{"prompt":"<specific question>"},"required":true}}
+```
+
+**comment** — engine checks min_length only (last resort):
+
+Example: ```json
+{"challenge":{"type":"comment","comment":{"min_length":50},"required":true}}
+```
+
+### Shell Challenge Rules
+
+- Chain checks with `&&` (not `;`) — first failure short-circuits.
+- Always set `timeout_seconds`: 5s for local checks, 30–120s for network/build.
+- All file paths MUST use `$KAIROS_WORK_DIR/` prefix (never hardcoded `/tmp/`).
+- Use `test -f` for existence, `grep -q` for content, `wc -l | awk` for line counts.
+
+```json
+{"challenge":{"type":"comment","comment":{"min_length":30},"required":true}}
+```
+
+---
+
+## Interpreter Selection
+
+For text validation, regex, and structural checks, **Perl is often shorter, clearer, and more correct** than bash.
+
+| Task | Use bash | Use perl | Use python3 |
+|---|---|---|---|
+| File exists, tool installed, git state | `test -f`, `which`, `git status` | -- | -- |
+| Simple content grep | `grep -q 'pattern' file` | -- | -- |
+| Multi-line regex | -- | `perl -0777 -ne '/pat/ms or die'` | -- |
+| Count + assert (headings, sections) | `grep -c \| awk` (fragile) | `perl -0777 -ne '@m=/pat/g; die if @m<N'` | -- |
+| Paragraph processing (commits, blocks) | `while read` loop (messy) | `perl -00 -ne '...'` | -- |
+| JSON validation | `python3 -m json.tool` | `perl -MJSON -e 'decode_json(do{local$/;<>})'` | `python3 -c 'import json; ...'` |
+| YAML validation | -- | -- | `python3 -c 'import yaml; ...'` |
+| Complex data structure checks | -- | -- | `python3 -c 'import json; d=json.load(...); assert ...'` |
+
+**Rule of thumb:** If you're writing `grep | awk`, `while read`, nested escaping, or multi-line patterns in bash — rewrite in Perl. If you need `import` for a data format (YAML, TOML) — use Python.
+
+### Perl Flags Cheat Sheet
+
+| Flag | Effect | Use case |
+|---|---|---|
+| `-e '...'` | Execute code | Every Perl challenge |
+| `-n` | Implicit `while(<>)` loop, no auto-print | Process lines, filter |
+| `-p` | Like `-n` but auto-prints `$_` | Transform-and-verify |
+| `-l` | Auto-chomp + auto-newline | Clean line processing |
+| `-a` | Auto-split into `@F` (like awk) | Field extraction |
+| `-0777` | Slurp entire file as one string | Multi-line regex |
+| `-00` | Paragraph mode (split on blank lines) | Commit messages, markdown blocks |
+| `-MJSON` | Load core JSON module | JSON validation without Python |
+
+### Bash vs Perl Examples
+
+**Count H2 headings and verify required sections:**
+
+bash (fragile):
+
+Example: ```bash
+grep -c '^## ' "$D" | awk '$1 >= 3' && grep -q '^## Natural Language Triggers' "$D" && grep -q '^## Completion Rule' "$D"
+```
+
+perl (one pass, clear logic):
+
+Example: ```bash
+perl -0777 -ne '@h=/^## (.+)/mg; die "Need >=3 H2s" if @h<3; grep(/^Natural Language Triggers$/,@h) or die "Missing NLT"; grep(/^Completion Rule$/,@h) or die "Missing CR"' "$D"
+```
+
+**Validate JSON challenge blocks:**
+
+perl (core JSON module):
+
+Example: ```bash
+perl -MJSON -0777 -ne '@b=/```json\s*\n(\{.*?\})\s*\n```/gs; die "No blocks" unless @b; eval{decode_json($_)} or die "Bad JSON: $@" for @b; print scalar(@b)." valid\n"' "$D"
+```
+
+```json
+{"challenge":{"type":"comment","comment":{"min_length":30},"required":true}}
+```
+
+---
+
+## Anti-Patterns
+
+| Anti-Pattern | Why It Fails | Fix |
+|---|---|---|
+| `comment` with `min_length: 20` | Trivially satisfiable with filler | Raise to 50+, or switch to `shell` if artifact exists |
+| `comment` for steps that run commands | Says "run X" but only checks agent wrote words | Use `shell` with the actual command |
+| `comment` for steps that call MCP tools | Says "call tool Y" but only checks text output | Use `mcp` with `tool_name` |
+| `shell` without `timeout_seconds` | May hang indefinitely | Always set timeout |
+| `user_input` with generic prompt "Confirm" | User doesn't know what they're confirming | Write a specific question |
+| `shell` with `echo 'placeholder'` | Always passes, proves nothing | Replace with real verification command |
+| Checks chained with `;` instead of `&&` | Later checks run even if earlier ones fail | Use `&&` for short-circuit |
+| Hardcoded `/tmp/` paths | Concurrent runs collide; world-readable on Linux | Use `$KAIROS_WORK_DIR` |
+| bash `while read \| grep \| awk` chains | Fragile, escaping nightmare, non-portable | Rewrite in Perl |
+
+```json
+{"challenge":{"type":"comment","comment":{"min_length":30},"required":true}}
+```
+
+---
+
+## Security and Concurrency
+
+### Session-Scoped Working Directory
+
+Never use hardcoded `/tmp/` paths. Use a session-scoped, user-private working directory:
+
+Example: ```bash
+export KAIROS_WORK_DIR=$(mktemp -d "${XDG_RUNTIME_DIR:-${TMPDIR:-/tmp}}/kairos-XXXXXX")
+chmod 700 "$KAIROS_WORK_DIR"
+```
+
+**Priority chain:** `XDG_RUNTIME_DIR` (preferred, per-user, `0700` by spec) → `TMPDIR` (macOS fallback) → `/tmp` (last resort, `chmod 700`).
+
+**Why:** Concurrent chat sessions running the same protocol would collide on hardcoded paths. `mktemp -d` guarantees isolation. Completion Rule MUST `rm -rf "$KAIROS_WORK_DIR"`.
+
+**Rules:** All file paths in shell challenges use `$KAIROS_WORK_DIR/` prefix. Prerequisites section creates it. Completion Rule cleans it up. Never write credentials or secrets to files.
+
+```json
+{"challenge":{"type":"comment","comment":{"min_length":30},"required":true}}
+```
+
+---
+
+## Composition Patterns
+
+**Multi-check compound command** — chain with `&&`, first failure short-circuits:
+
+Example: ```bash
+test -f <file> && grep -q '<required>' <file> && wc -l < <file> | awk '$1 <= 350'
+```
+
+**Freeze-then-verify** — two consecutive steps:
+- Step N (after review): `md5 -q <file> > "$KAIROS_WORK_DIR/<file>.md5"`
+- Step N+1 (before publish): `md5 -q <file> | diff - "$KAIROS_WORK_DIR/<file>.md5"`
+
+**Write-then-grep** — subagent delegation:
+- Subagent instruction: "Write verdict to `$KAIROS_WORK_DIR/<name>.md`. First line: `PASS` or `FAIL`."
+- Main agent challenge: `head -1 "$KAIROS_WORK_DIR/<name>.md" | grep -qi 'pass'`
+
+**Dry-run before execution** — three steps:
+- Step N: `<tool> --dry-run` (shell challenge)
+- Step N+1: `user_input` (human reviews output)
+- Step N+2: `<tool> --yes` (shell challenge)
+
+```json
+{"challenge":{"type":"comment","comment":{"min_length":30},"required":true}}
+```
+
+## Completion Rule
+
+Only reachable after all prior steps are solved.
+
+The agent has loaded the challenge type selection guide and can now:
+1. Pick the correct challenge type for each protocol step using the decision tree.
+2. Write valid challenge JSON in the correct format.
+3. Choose the right interpreter (bash / perl / python3) for shell challenges.
+4. Avoid all listed anti-patterns.
+5. Apply security and concurrency rules (`$KAIROS_WORK_DIR`).
+6. Use composition patterns for multi-check, freeze-verify, and subagent delegation.

package/dist/embed-docs/mem/README.md

@@ -0,0 +1,24 @@
+# Bundled meta-protocols
+
+This directory contains the bundled KAIROS-internal protocol chains and policy
+documents that are injected into the Kairos app space at boot.
+
+## Protocols
+
+| UUID | Slug | Purpose |
+|------|------|---------|
+| [2001](00000000-0000-0000-0000-000000002001.md) | `create-new-protocol` | Chain 1: Author — gather requirements, draft protocol markdown |
+| [2003](00000000-0000-0000-0000-000000002003.md) | `create-new-protocol-review` | Chain 2: Review & Publish — format review, stranger review, approval, mint |
+| [2002](00000000-0000-0000-0000-000000002002.md) | `refine-search` | Refine search — improve a failed kairos_search query |
+
+### Chained authoring flow
+
+```
+2001 (Author) → kairos_begin(key: "create-new-protocol-review") → 2003 (Review & Publish)
+```
+
+## Reference Documents
+
+| UUID | Slug | Purpose |
+|------|------|---------|
+| [2004](00000000-0000-0000-0000-000000002004.md) | `challenge-type-guide` | Decision tree, JSON formats, interpreter selection, anti-patterns for challenge types. Loaded as policy target by 2001 and 2003. |

package/dist/resources/docs-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-resources.d.ts","sourceRoot":"","sources":["../../src/resources/docs-resources.ts"],"names":[],"mappings":"AASA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,QAqDhD"}
+{"version":3,"file":"docs-resources.d.ts","sourceRoot":"","sources":["../../src/resources/docs-resources.ts"],"names":[],"mappings":"AASA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,QAkEhD"}

package/dist/resources/docs-resources.js

@@ -1,4 +1,4 @@
-import { getResource, getResources } from './embedded-mcp-resources.js';
+import { getMeta, getResource, getResources } from './embedded-mcp-resources.js';
 import { logger } from '../utils/structured-logger.js';
 function mdOrFallback(uri, text, notFound = 'Document not found') {
     return {
@@ -42,6 +42,14 @@ export function registerDocsResources(server) {
             }
         }
     }
+    const meta = getMeta();
+    for (const [slug, content] of Object.entries(meta)) {
+        if (typeof content !== 'string')
+            continue;
+        const uri = `kairos://meta/${slug}`;
+        const name = `Meta: ${slug.replace(/-/g, ' ')}`;
+        server.registerResource(`meta-${slug.replace(/[^a-zA-Z0-9_-]/g, '_')}`, uri, { name, description: `Bundled protocol or policy (${slug})`, mimeType: 'text/markdown' }, (uriObj) => mdOrFallback(uriObj, content));
+    }
     // Tools docs are not registered as resources to keep resources/list lean.
 }
 //# sourceMappingURL=docs-resources.js.map

package/dist/resources/docs-resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-resources.js","sourceRoot":"","sources":["../../src/resources/docs-resources.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs-resources.js","sourceRoot":"","sources":["../../src/resources/docs-resources.ts"],"names":[],"mappings":"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"}

package/dist/resources/embedded-mcp-resources.d.ts

@@ -29,6 +29,12 @@ export declare const mcpResources: {
         kairos_update: string;
     };
     mem: {};
+    meta: {
+        "create-new-protocol": string;
+        "refine-search": string;
+        "create-new-protocol-review": string;
+        "challenge-type-guide": string;
+    };
 };
 /**
  * Get prompts object
@@ -50,6 +56,10 @@ export declare function getTools(): Record<string, any>;
  * Get mem object
  */
 export declare function getMem(): Record<string, any>;
+/**
+ * Get meta object
+ */
+export declare function getMeta(): Record<string, any>;
 /**
  * Get a prompt by key (e.g. 'contextual-prompt')
  */
@@ -58,6 +68,10 @@ export declare function getPrompt(key: string): string | undefined;
  * Get a resource by key (e.g. 'TEST', 'doc.TEST', 'mem.<uuid>')
  */
 export declare function getResource(key: string): string | any | undefined;
+/**
+ * Meta protocol / policy markdown by slug (from frontmatter).
+ */
+export declare function getMetaDoc(slug: string): string | undefined;
 /**
  * Get a template by key (e.g. 'kairos-memory')
  */

package/dist/resources/embedded-mcp-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedded-mcp-resources.d.ts","sourceRoot":"","sources":["../../src/resources/embedded-mcp-resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE9C;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAkB3D"}
+{"version":3,"file":"embedded-mcp-resources.d.ts","sourceRoot":"","sources":["../../src/resources/embedded-mcp-resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE9C;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE5C;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,SAAS,CAgBjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAmB3D"}