@inbrowser/agent 0.0.0-placeholder → 0.2.0

package/dist/session.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `createAgentSession()` — the host-facing session container.
+ *
+ * Generic over the strategy. Translates a `StrategyEvent` stream
+ * into the typed `SessionEvent` stream the host consumes. Tracks
+ * workspace + runtime patches as tool results flow in.
+ */
+import type { AgentSession, AgentSessionConfig } from './types/session.js';
+export declare function createAgentSession(config: AgentSessionConfig): AgentSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAOzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA+H3E"}

package/dist/session.js

@@ -0,0 +1,179 @@
+/**
+ * `createAgentSession()` — the host-facing session container.
+ *
+ * Generic over the strategy. Translates a `StrategyEvent` stream
+ * into the typed `SessionEvent` stream the host consumes. Tracks
+ * workspace + runtime patches as tool results flow in.
+ */
+let sessionCounter = 0;
+export function createAgentSession(config) {
+    const id = config.id ?? `session-${++sessionCounter}-${Date.now().toString(36)}`;
+    let workspace = freezeWorkspace(config.history.length > 0 ? extractInitialWorkspace(config) : initialWorkspace());
+    let runtime = initialRuntime();
+    let history = [...config.history];
+    let currentAbort = null;
+    const session = {
+        id,
+        get workspace() {
+            return workspace;
+        },
+        get runtime() {
+            return runtime;
+        },
+        submit(prompt, externalSignal) {
+            // Compose an internal controller that listens to both the
+            // external signal and our `cancel()` override.
+            const inner = new AbortController();
+            currentAbort = inner;
+            const linked = linkSignals(externalSignal, inner.signal);
+            return run(prompt, linked);
+        },
+        cancel() {
+            currentAbort?.abort();
+        },
+    };
+    function bumpWorkspace(patch) {
+        if (!patch)
+            return false;
+        workspace = freezeWorkspace({ ...workspace, ...patch });
+        return true;
+    }
+    function bumpRuntime(patch) {
+        if (!patch)
+            return false;
+        runtime = freezeRuntime({ ...runtime, ...patch });
+        return true;
+    }
+    async function* run(prompt, signal) {
+        const turnId = `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+        yield { kind: 'turn_started', turnId };
+        // Capture the user message in history so the next turn sees it.
+        const userMsg = {
+            id: `u-${turnId}`,
+            role: 'user',
+            text: prompt,
+            timestamp: Date.now(),
+        };
+        history = [...history, userMsg];
+        const systemPrompt = config.systemPromptBuilder(workspace, runtime);
+        const strategyEvents = config.strategy.run({
+            prompt,
+            history,
+            workspace,
+            runtime,
+            llm: config.llm,
+            tools: config.tools,
+            toolList: config.toolList,
+            toolContext: config.toolContext,
+            systemPrompt,
+            ...(config.tracer ? { tracer: config.tracer } : {}),
+            turnId,
+        }, signal);
+        let assistantText = '';
+        const assistantId = `a-${turnId}`;
+        for await (const ev of strategyEvents) {
+            if (ev.kind === 'text') {
+                assistantText += ev.chunk;
+                yield { kind: 'text', turnId, chunk: ev.chunk };
+            }
+            else if (ev.kind === 'thinking') {
+                yield { kind: 'thinking', turnId, chunk: ev.chunk };
+            }
+            else if (ev.kind === 'tool_call') {
+                yield {
+                    kind: 'tool_started',
+                    turnId,
+                    callId: ev.id,
+                    name: ev.name,
+                    args: ev.args,
+                    ...(ev.signature ? { signature: ev.signature } : {}),
+                };
+            }
+            else if (ev.kind === 'tool_result') {
+                const wsBumped = bumpWorkspace(ev.result.workspacePatch);
+                const rtBumped = bumpRuntime(ev.result.runtimePatch);
+                yield { kind: 'tool_finished', turnId, callId: ev.id, result: ev.result };
+                if (wsBumped)
+                    yield { kind: 'workspace_changed', workspace };
+                if (rtBumped)
+                    yield { kind: 'runtime_changed', runtime };
+            }
+            else if (ev.kind === 'turn_complete') {
+                const metrics = config.metrics.recordTurn({
+                    llmId: config.llm.id,
+                    model: ev.details.requestedModel,
+                    durationMs: 0,
+                    rawUsage: ev.usage,
+                });
+                // Append assistant message to history.
+                const assistantMsg = {
+                    id: assistantId,
+                    role: 'assistant',
+                    text: assistantText,
+                    metrics,
+                    details: ev.details,
+                    timestamp: Date.now(),
+                };
+                history = [...history, assistantMsg];
+                yield { kind: 'turn_completed', turnId, metrics, details: ev.details };
+            }
+            else if (ev.kind === 'error') {
+                yield { kind: 'error', turnId, message: ev.message };
+                return;
+            }
+            else if (ev.kind === 'custom') {
+                yield { kind: 'strategy_event', name: ev.name, data: ev.data };
+            }
+        }
+        yield { kind: 'completed' };
+    }
+    return session;
+}
+function initialWorkspace() {
+    return freezeWorkspace({
+        presetId: '',
+        rules: '',
+        code: '',
+        appSource: '',
+        stitch: { projectId: null, latestScreenUrl: null, brief: null },
+    });
+}
+function extractInitialWorkspace(config) {
+    // History-only resume — workspace can be threaded in by the caller
+    // via a follow-up patch, but the session's initial workspace shape
+    // matches the empty defaults until then.
+    void config;
+    return initialWorkspace();
+}
+function initialRuntime() {
+    return freezeRuntime({
+        terminal: [],
+        runSummary: null,
+        deploy: null,
+        parseError: null,
+        uiErrors: [],
+        sandboxVersion: 0,
+    });
+}
+function freezeWorkspace(w) {
+    return Object.freeze({ ...w, stitch: Object.freeze({ ...w.stitch }) });
+}
+function freezeRuntime(r) {
+    return Object.freeze({
+        ...r,
+        terminal: Object.freeze([...r.terminal]),
+        uiErrors: Object.freeze([...r.uiErrors]),
+    });
+}
+/** Combine two abort signals into one that fires when either fires. */
+function linkSignals(a, b) {
+    const controller = new AbortController();
+    if (a.aborted || b.aborted) {
+        controller.abort();
+        return controller.signal;
+    }
+    a.addEventListener('abort', () => controller.abort(), { once: true });
+    b.addEventListener('abort', () => controller.abort(), { once: true });
+    return controller.signal;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/skill-catalog.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Static catalog of skill workflows.
+ *
+ * Phase five of the implementation plan splits the planner-executor work
+ * into three branches: this catalog, the router that classifies a user
+ * prompt against the catalog, and the executor that walks a chosen
+ * skill's prescribed step sequence. This module is the data + types
+ * gate — no runtime logic. The router reads `triggerHints` to score
+ * candidate matches; the executor reads `steps` to materialize a plan.
+ *
+ * Each entry's `name` matches a value in the `SkillName` enum from
+ * `eval/fixture.ts` (re-exported here for convenience). Step
+ * descriptions are imperative, short, and model-agnostic. Per-step
+ * `verifier?` references existing starter / custom specs where one
+ * fits naturally; not every step has one. Leaf "compile / deploy /
+ * verify" steps tend to have a spec; intermediate read / draft steps
+ * usually don't.
+ *
+ * The catalog is hand-authored and intentionally `const`. The
+ * companion test in `test/skill-catalog.test.ts` asserts shape
+ * invariants: every `name` is in `SKILL_NAMES`, every entry has at
+ * least three trigger hints, every entry has between four and nine
+ * steps, every step id is unique and kebab-case within its plan, and
+ * every `verifier?.name` matches a spec registered by
+ * `registerAllSpecs(createSpecRegistry())`.
+ */
+import type { SkillName, SuccessSpecReference } from './eval/fixture.js';
+/**
+ * One ordered step in a skill's prescribed workflow.
+ *
+ * `id` is a stable kebab-case identifier, unique within the parent
+ * plan. The executor uses it as the scratch key for the step's
+ * bounded sub-loop. `description` is an imperative one-liner — what
+ * the step does, in the project's voice. `verifier?` is an optional
+ * `SuccessSpecReference` the executor can run after the step finishes
+ * to gate whether the plan advances; the same shape that fixtures
+ * use, so the executor can re-use `evaluateSpec` without translation.
+ */
+export interface PlanStep {
+    /** Stable kebab-case id, unique within the plan. */
+    id: string;
+    /** Short imperative description of what the step does. */
+    description: string;
+    /** Optional reference to a success spec that verifies this step. */
+    verifier?: SuccessSpecReference;
+}
+/**
+ * One row in the skill catalog. Describes a single skill workflow as
+ * a triple of (router signals, plan, identity).
+ */
+export interface SkillCatalogEntry {
+    /** Matches a value in `SKILL_NAMES` from `eval/fixture.ts`. */
+    name: SkillName;
+    /** One-line description used by the router and surfaced in the plan. */
+    description: string;
+    /**
+     * Lowercase keyword tokens the router scans the user prompt for.
+     * Order does not matter; at least one hit signals a candidate match.
+     */
+    triggerHints: readonly string[];
+    /** Prescribed workflow as an ordered sequence of steps. */
+    steps: readonly PlanStep[];
+}
+/** Read-only view over the catalog. */
+export type SkillCatalog = readonly SkillCatalogEntry[];
+export declare const SKILL_CATALOG: SkillCatalog;
+/**
+ * Look up a catalog entry by skill name. Returns `undefined` when the
+ * name is not in the catalog. The router will use this to materialize
+ * an entry after picking a winner; the executor will use it to
+ * unwrap a router decision into a plan.
+ */
+export declare function getSkillEntry(name: SkillName): SkillCatalogEntry | undefined;
+/**
+ * List every skill name present in the catalog, in catalog order. The
+ * router uses this to iterate candidates when scoring a prompt; the
+ * test suite uses it to assert the catalog covers every value in
+ * `SKILL_NAMES`.
+ */
+export declare function listSkillNames(): readonly SkillName[];
+//# sourceMappingURL=skill-catalog.d.ts.map

package/dist/skill-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.d.ts","sourceRoot":"","sources":["../src/skill-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAWzE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,IAAI,EAAE,SAAS,CAAC;IAChB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,2DAA2D;IAC3D,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC5B;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,SAAS,iBAAiB,EAAE,CAAC;AAQxD,eAAO,MAAM,aAAa,EAAE,YA8V3B,CAAC;AAcF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,SAAS,SAAS,EAAE,CAErD"}

package/dist/skill-catalog.js

@@ -0,0 +1,388 @@
+/**
+ * Static catalog of skill workflows.
+ *
+ * Phase five of the implementation plan splits the planner-executor work
+ * into three branches: this catalog, the router that classifies a user
+ * prompt against the catalog, and the executor that walks a chosen
+ * skill's prescribed step sequence. This module is the data + types
+ * gate — no runtime logic. The router reads `triggerHints` to score
+ * candidate matches; the executor reads `steps` to materialize a plan.
+ *
+ * Each entry's `name` matches a value in the `SkillName` enum from
+ * `eval/fixture.ts` (re-exported here for convenience). Step
+ * descriptions are imperative, short, and model-agnostic. Per-step
+ * `verifier?` references existing starter / custom specs where one
+ * fits naturally; not every step has one. Leaf "compile / deploy /
+ * verify" steps tend to have a spec; intermediate read / draft steps
+ * usually don't.
+ *
+ * The catalog is hand-authored and intentionally `const`. The
+ * companion test in `test/skill-catalog.test.ts` asserts shape
+ * invariants: every `name` is in `SKILL_NAMES`, every entry has at
+ * least three trigger hints, every entry has between four and nine
+ * steps, every step id is unique and kebab-case within its plan, and
+ * every `verifier?.name` matches a spec registered by
+ * `registerAllSpecs(createSpecRegistry())`.
+ */
+import { SPEC_FINAL_RULES_INCLUDES_LITERAL, SPEC_FINAL_RUNTIME_RUN_SUMMARY_OK, SPEC_GAME_RULES_SIMULATOR_ACCEPTS_POSITIVE_AND_REJECTS_CHEAT, SPEC_PYRIC_AGENTS_LINT_CLEAN_AND_RULE_REJECTS_CHEAT, SPEC_REPORT_MENTIONS_ALL_OF, SPEC_REPORT_MENTIONS_AT_LEAST_ONE_OF, SPEC_TRACE_CONTAINS_TOOL_CALL_BY_NAME, } from './eval/spec-helpers.js';
+// ---------------------------------------------------------------------------
+// The catalog. One entry per in-scope skill, in `SKILL_NAMES` order.
+// Step content is derived from each skill's `SKILL.md` playbook in the
+// downstream firebase-agent-sdk repo.
+// ---------------------------------------------------------------------------
+export const SKILL_CATALOG = [
+    {
+        name: 'firestore-rules-audit',
+        description: 'Audit Firestore security rules for vulnerabilities, semantic errors, and structural anti-patterns.',
+        triggerHints: ['firestore', 'audit', 'rules', 'security', 'vulnerability', 'review'],
+        steps: [
+            {
+                id: 'inspect-rules',
+                description: 'Fetch deployed Firestore rules, parse to AST, and run validator checks.',
+            },
+            {
+                id: 'triage-findings',
+                description: 'Group validator findings by severity: critical, high, medium, low.',
+            },
+            {
+                id: 'cross-reference',
+                description: 'Combine findings on the same path to surface compound vulnerabilities.',
+            },
+            {
+                id: 'apply-context',
+                description: 'Escalate or de-escalate findings based on path purpose and data sensitivity.',
+            },
+            {
+                id: 'compile-report',
+                description: 'Compile prioritized health report with score, findings, and remediation.',
+                verifier: {
+                    name: SPEC_REPORT_MENTIONS_AT_LEAST_ONE_OF,
+                    args: { tokens: ['critical', 'high', 'finding'] },
+                },
+            },
+        ],
+    },
+    {
+        name: 'firebase-project-audit',
+        description: 'Audit an unknown Firebase project for auth gaps, rule weaknesses, and structural issues across services.',
+        triggerHints: ['firebase', 'project', 'audit', 'inspect', 'health', 'unknown'],
+        steps: [
+            {
+                id: 'inspect-project',
+                description: 'Inspect auth, rules, and database structure in a single crawl.',
+            },
+            {
+                id: 'assess-auth',
+                description: 'Evaluate enabled providers and surface auth configuration gaps.',
+            },
+            {
+                id: 'assess-rules',
+                description: 'Walk the rule tree and flag open paths, broken expressions, and warnings.',
+            },
+            {
+                id: 'assess-structure',
+                description: 'Walk the data structure for deep nesting, god nodes, and array patterns.',
+            },
+            {
+                id: 'cross-reference-rules-data',
+                description: 'Compare rule paths against data paths to find unprotected data and orphan rules.',
+            },
+            {
+                id: 'compile-report',
+                description: 'Compile prioritized report with health score, findings, and recommended skills to load.',
+                verifier: {
+                    name: SPEC_REPORT_MENTIONS_AT_LEAST_ONE_OF,
+                    args: { tokens: ['health', 'finding', 'recommendation'] },
+                },
+            },
+        ],
+    },
+    {
+        name: 'rtdb-data-modeling',
+        description: 'Analyze and recommend Realtime Database structures with flat collections, fan-out writes, and index tables.',
+        triggerHints: [
+            'rtdb',
+            'realtime',
+            'data',
+            'model',
+            'modeling',
+            'denormalize',
+            'structure',
+            'schema',
+        ],
+        steps: [
+            {
+                id: 'crawl-structure',
+                description: 'Crawl database structure to inventory top-level keys, depth, and child counts.',
+            },
+            {
+                id: 'sample-data',
+                description: 'Read representative paths to compare stored shape against per-screen needs.',
+            },
+            {
+                id: 'check-god-nodes',
+                description: 'Identify unbounded lists and god nodes that grow without per-user scoping.',
+            },
+            {
+                id: 'evaluate-queries',
+                description: 'Map each app list to a single orderBy path and flag multi-field filter needs.',
+            },
+            {
+                id: 'propose-restructure',
+                description: 'Propose flat collections, index tables, and summary collections via fan-out writes.',
+            },
+            {
+                id: 'verify-restructure',
+                description: 'Validate the proposed shape with a multi-path write and a re-crawl of the structure.',
+                verifier: {
+                    name: SPEC_TRACE_CONTAINS_TOOL_CALL_BY_NAME,
+                    args: { tool: 'crawl_database_structure', minCount: 1 },
+                },
+            },
+        ],
+    },
+    {
+        name: 'firebase-security-rules',
+        description: 'Author, simulate, and deploy Realtime Database security rules with auth, validation, and immutability patterns.',
+        triggerHints: ['rtdb', 'realtime', 'rules', 'security', 'authz', 'access', 'validate'],
+        steps: [
+            {
+                id: 'inspect-current-rules',
+                description: 'Inspect deployed rules and read linter warnings on existing expressions.',
+            },
+            {
+                id: 'design-change',
+                description: 'Identify the rule changes required by the request or by prior audit findings.',
+            },
+            {
+                id: 'validate-expressions',
+                description: 'Build and validate each rule expression before assembling the ruleset IR.',
+            },
+            {
+                id: 'simulate-access',
+                description: 'Simulate positive, negative, cross-user, and validation scenarios against the draft rules.',
+            },
+            {
+                id: 'deploy-rules',
+                description: 'Deploy the full ruleset after every simulation passes.',
+                verifier: {
+                    name: SPEC_FINAL_RULES_INCLUDES_LITERAL,
+                    args: { literal: 'auth' },
+                },
+            },
+            {
+                id: 'verify-deployment',
+                description: 'Re-inspect the deployed rules to confirm they match the intended IR.',
+            },
+        ],
+    },
+    {
+        name: 'firebase-client-sdk',
+        description: 'Generate correct Firebase web client code for init, auth gating, listeners, fan-out writes, and queries.',
+        triggerHints: ['client', 'sdk', 'web', 'javascript', 'app', 'listener', 'init'],
+        steps: [
+            {
+                id: 'get-config',
+                description: 'Fetch the project client config for initializeApp.',
+            },
+            {
+                id: 'inspect-rules-for-auth',
+                description: 'Inspect deployed rules to determine the auth state the client must satisfy.',
+            },
+            {
+                id: 'check-indexes',
+                description: 'Verify indexOn declarations cover every planned orderByChild query.',
+            },
+            {
+                id: 'generate-init-and-auth',
+                description: 'Emit initialization, the auth gate, and the sign-in flow.',
+            },
+            {
+                id: 'generate-reads',
+                description: 'Emit entity listeners, fan-in patterns, or one-time reads as needed.',
+            },
+            {
+                id: 'generate-writes',
+                description: 'Emit set, update at path, and multi-location update writes per intent.',
+            },
+            {
+                id: 'add-cleanup-and-errors',
+                description: 'Add listener unsubscription and permission-denied error handling.',
+            },
+            {
+                id: 'verify-run',
+                description: 'Run the generated code once and confirm the run summary reports success.',
+                verifier: { name: SPEC_FINAL_RUNTIME_RUN_SUMMARY_OK },
+            },
+        ],
+    },
+    {
+        name: 'pyric-agents',
+        description: 'Author Firestore rules and seed data through the pyric MCP tools with lint gating and reversible commits.',
+        triggerHints: ['pyric', 'firestore', 'rules', 'seed', 'lint', 'mcp'],
+        steps: [
+            {
+                id: 'draft-rules',
+                description: 'Draft the Firestore rules source in conversation.',
+            },
+            {
+                id: 'lint-rules',
+                description: 'Lint the draft and iterate until errors are empty.',
+            },
+            {
+                id: 'write-rules',
+                description: 'Write the lint-clean rules through the gated write tool.',
+            },
+            {
+                id: 'draft-seed',
+                description: 'Compose seed data as collection-to-documents arrays.',
+            },
+            {
+                id: 'write-seed',
+                description: 'Write the shape-validated seed through the gated write tool.',
+                verifier: {
+                    name: SPEC_PYRIC_AGENTS_LINT_CLEAN_AND_RULE_REJECTS_CHEAT,
+                },
+            },
+            {
+                id: 'surface-audit-log',
+                description: 'Point the user at the emitted plan and commit event ids.',
+            },
+        ],
+    },
+    {
+        name: 'playground-prompts',
+        description: 'Generate well-shaped 30-50 word playground prompts with a bounded domain and a rule-enforced security boundary.',
+        triggerHints: ['playground', 'prompt', 'prompts', 'demo', 'test', 'scenario'],
+        steps: [
+            {
+                id: 'pick-dimension',
+                description: 'Pick the capability dimension to exercise (rules, transactions, queries, listeners).',
+            },
+            {
+                id: 'pick-domain',
+                description: 'Pick a bounded familiar domain with two collections and a relationship.',
+            },
+            {
+                id: 'specify-security-boundary',
+                description: 'Specify a security boundary tedious to enforce in client code alone.',
+            },
+            {
+                id: 'draft-prompt',
+                description: 'Draft a 30-50 word prompt that fills in actors, data model, and constraint.',
+            },
+            {
+                id: 'tag-capabilities',
+                description: 'Tag what the prompt exercises so the consumer can pick by capability.',
+                verifier: {
+                    name: SPEC_REPORT_MENTIONS_AT_LEAST_ONE_OF,
+                    args: { tokens: ['exercises', 'capability', 'rules', 'state', 'membership'] },
+                },
+            },
+        ],
+    },
+    {
+        name: 'rtdb-game-rules',
+        description: 'Design and deploy Realtime Database security rules for turn-based games with turn guards and win checks.',
+        triggerHints: ['rtdb', 'realtime', 'game', 'turn', 'multiplayer', 'rules'],
+        steps: [
+            {
+                id: 'identify-players',
+                description: 'Identify players, their marks, and how they map to authenticated UIDs.',
+            },
+            {
+                id: 'design-turn-flow',
+                description: 'Design the turn marker, alternation order, and turn-guard write rule.',
+            },
+            {
+                id: 'design-board-and-moves',
+                description: 'Design the board layout, move protocol, and per-cell validation.',
+            },
+            {
+                id: 'design-win-and-end',
+                description: 'Design win helpers, terminal states, and the winner validation rule.',
+            },
+            {
+                id: 'compose-ruleset',
+                description: 'Compose the full ruleset from turnGuard, flip, winCheckHelper, and helpers.',
+            },
+            {
+                id: 'simulate-and-deploy',
+                description: 'Simulate positive and cheating moves, then deploy the ruleset.',
+                verifier: {
+                    name: SPEC_GAME_RULES_SIMULATOR_ACCEPTS_POSITIVE_AND_REJECTS_CHEAT,
+                    args: { database: 'rtdb' },
+                },
+            },
+        ],
+    },
+    {
+        name: 'firestore-game-rules',
+        description: 'Design and deploy Firestore security rules for turn-based games with split-allow rules and dynamic field keys.',
+        triggerHints: ['firestore', 'game', 'turn', 'multiplayer', 'rules', 'split-allow'],
+        steps: [
+            {
+                id: 'design-board',
+                description: 'Design a flat board map with statically named cell fields.',
+            },
+            {
+                id: 'design-turns',
+                description: 'Design turn enforcement with resource.data and a turn-flip validation.',
+            },
+            {
+                id: 'design-move-validity',
+                description: 'Design placement or movement validity with dynamic field keys or a config document.',
+            },
+            {
+                id: 'design-win-detection',
+                description: 'Enumerate winning lines or piece-counter wins as static expressions.',
+            },
+            {
+                id: 'split-allow-rules',
+                description: 'Split the update rule into normal-move, winning-move, and draw branches to stay under the complexity ceiling.',
+            },
+            {
+                id: 'generate-and-deploy',
+                description: 'Generate the rules via code, deploy them, and verify under the test API.',
+                verifier: {
+                    name: SPEC_GAME_RULES_SIMULATOR_ACCEPTS_POSITIVE_AND_REJECTS_CHEAT,
+                    args: { database: 'firestore' },
+                },
+            },
+            {
+                id: 'iterate-on-complexity',
+                description: 'If valid moves are denied, re-split the rules and move expensive checks into separate allow branches.',
+                verifier: {
+                    name: SPEC_REPORT_MENTIONS_ALL_OF,
+                    args: { tokens: ['allow', 'update'] },
+                },
+            },
+        ],
+    },
+];
+// ---------------------------------------------------------------------------
+// Helpers. The router and executor will read the catalog through these to
+// keep their implementations narrow; the catalog itself is exported as a
+// value so callers can iterate without going through them.
+// ---------------------------------------------------------------------------
+const ENTRY_BY_NAME = new Map(SKILL_CATALOG.map((entry) => [entry.name, entry]));
+const NAMES = SKILL_CATALOG.map((entry) => entry.name);
+/**
+ * Look up a catalog entry by skill name. Returns `undefined` when the
+ * name is not in the catalog. The router will use this to materialize
+ * an entry after picking a winner; the executor will use it to
+ * unwrap a router decision into a plan.
+ */
+export function getSkillEntry(name) {
+    return ENTRY_BY_NAME.get(name);
+}
+/**
+ * List every skill name present in the catalog, in catalog order. The
+ * router uses this to iterate candidates when scoring a prompt; the
+ * test suite uses it to assert the catalog covers every value in
+ * `SKILL_NAMES`.
+ */
+export function listSkillNames() {
+    return NAMES;
+}
+//# sourceMappingURL=skill-catalog.js.map