praxis-agent 0.1.0

package/dist/core/usage.js

@@ -0,0 +1,133 @@
+const BUILTIN_PRICING = {
+    'claude-3-5-sonnet-20241022': {
+        inputPerMillionUsd: 3,
+        outputPerMillionUsd: 15,
+        cacheReadInputPerMillionUsd: 0.3,
+        cacheCreationInputPerMillionUsd: 3.75,
+    },
+    'claude-3-7-sonnet-20250219': {
+        inputPerMillionUsd: 3,
+        outputPerMillionUsd: 15,
+        cacheReadInputPerMillionUsd: 0.3,
+        cacheCreationInputPerMillionUsd: 3.75,
+    },
+    'claude-sonnet-4-20250514': {
+        inputPerMillionUsd: 3,
+        outputPerMillionUsd: 15,
+        cacheReadInputPerMillionUsd: 0.3,
+        cacheCreationInputPerMillionUsd: 3.75,
+    },
+    'claude-opus-4-20250514': {
+        inputPerMillionUsd: 15,
+        outputPerMillionUsd: 75,
+        cacheReadInputPerMillionUsd: 1.5,
+        cacheCreationInputPerMillionUsd: 18.75,
+    },
+    'gpt-4o': {
+        inputPerMillionUsd: 5,
+        outputPerMillionUsd: 15,
+    },
+    'gpt-4o-mini': {
+        inputPerMillionUsd: 0.15,
+        outputPerMillionUsd: 0.6,
+    },
+};
+function validRate(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+function parsePricing(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    const input = record.inputPerMillionUsd;
+    const output = record.outputPerMillionUsd;
+    if (!validRate(input) || !validRate(output)) {
+        throw new Error(`${label} requires non-negative inputPerMillionUsd and outputPerMillionUsd`);
+    }
+    const cacheRead = record.cacheReadInputPerMillionUsd;
+    const cacheCreation = record.cacheCreationInputPerMillionUsd;
+    if (cacheRead !== undefined && !validRate(cacheRead)) {
+        throw new Error(`${label}.cacheReadInputPerMillionUsd must be non-negative`);
+    }
+    if (cacheCreation !== undefined && !validRate(cacheCreation)) {
+        throw new Error(`${label}.cacheCreationInputPerMillionUsd must be non-negative`);
+    }
+    return {
+        inputPerMillionUsd: input,
+        outputPerMillionUsd: output,
+        ...(cacheRead === undefined
+            ? {}
+            : { cacheReadInputPerMillionUsd: cacheRead }),
+        ...(cacheCreation === undefined
+            ? {}
+            : { cacheCreationInputPerMillionUsd: cacheCreation }),
+    };
+}
+export class ModelPricingRegistry {
+    table;
+    environmentModels;
+    constructor(overrides = {}) {
+        this.table = { ...BUILTIN_PRICING, ...overrides };
+        this.environmentModels = new Set(Object.keys(overrides));
+    }
+    resolve(model) {
+        return this.table[model];
+    }
+    diagnose(model) {
+        const pricing = this.resolve(model);
+        if (!pricing) {
+            return {
+                model,
+                source: 'unknown',
+                policy: 'fail-closed',
+                budgetBehavior: 'reject-before-provider',
+            };
+        }
+        return {
+            model,
+            source: this.environmentModels.has(model) ? 'environment' : 'builtin',
+            pricing,
+            policy: 'fail-closed',
+            budgetBehavior: 'enforce',
+        };
+    }
+    static fromEnvironment(value) {
+        if (value === undefined || value.trim().length === 0) {
+            return new ModelPricingRegistry();
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(value);
+        }
+        catch (error) {
+            throw new Error('PRAXIS_PRICING_JSON must be valid JSON', {
+                cause: error,
+            });
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('PRAXIS_PRICING_JSON must be an object keyed by model');
+        }
+        const overrides = {};
+        for (const [model, pricing] of Object.entries(parsed)) {
+            overrides[model] = parsePricing(pricing, `PRAXIS_PRICING_JSON.${model}`);
+        }
+        return new ModelPricingRegistry(overrides);
+    }
+}
+function regularInputTokens(usage) {
+    return Math.max(0, usage.inputTokens -
+        (usage.cacheReadInputTokens ?? 0) -
+        (usage.cacheCreationInputTokens ?? 0));
+}
+export function usageCostUsd(usage, pricing) {
+    const regularInput = regularInputTokens(usage);
+    const input = regularInput * pricing.inputPerMillionUsd;
+    const output = usage.outputTokens * pricing.outputPerMillionUsd;
+    const cacheRead = (usage.cacheReadInputTokens ?? 0) *
+        (pricing.cacheReadInputPerMillionUsd ?? pricing.inputPerMillionUsd);
+    const cacheCreation = (usage.cacheCreationInputTokens ?? 0) *
+        (pricing.cacheCreationInputPerMillionUsd ?? pricing.inputPerMillionUsd);
+    return (input + output + cacheRead + cacheCreation) / 1_000_000;
+}
+//# sourceMappingURL=usage.js.map

package/dist/core/usage.js.map

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

package/dist/extensions/claude-extension-tools.d.ts

@@ -0,0 +1,16 @@
+import type { ModelToolCall, ModelToolDefinition, PermissionDecision, PermissionResolver, PermissionResolutionContext, ToolExecutionContext, ToolExecutionResult, ToolRegistry } from '../core/runtime.js';
+import type { ClaudeExtensionCatalog } from './claude-extensions.js';
+export declare class ClaudeExtensionToolRegistry implements ToolRegistry {
+    private readonly base;
+    private readonly catalog;
+    constructor(base: ToolRegistry, catalog: ClaudeExtensionCatalog);
+    definitions(): readonly ModelToolDefinition[];
+    prepare(call: ModelToolCall, context: ToolExecutionContext): Promise<ModelToolCall>;
+    execute(call: ModelToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+export declare class ClaudeExtensionPermissionResolver implements PermissionResolver {
+    private readonly base;
+    constructor(base: PermissionResolver);
+    resolve(call: ModelToolCall, context?: PermissionResolutionContext): PermissionDecision | Promise<PermissionDecision>;
+}
+//# sourceMappingURL=claude-extension-tools.d.ts.map

package/dist/extensions/claude-extension-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-extension-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/claude-extension-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAYpE,qBAAa,2BAA4B,YAAW,YAAY;IAE5D,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,sBAAsB;IAGlD,WAAW,IAAI,SAAS,mBAAmB,EAAE;IAwBvC,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAUnB,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAWhC;AAED,qBAAa,iCAAkC,YAAW,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAErD,OAAO,CACL,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAKpD"}

package/dist/extensions/claude-extension-tools.js

@@ -0,0 +1,78 @@
+function skillInput(call) {
+    const skill = call.input.skill;
+    const args = call.input.args ?? '';
+    if (typeof skill !== 'string' || skill.length === 0) {
+        throw new Error('skill must be a non-empty string');
+    }
+    if (typeof args !== 'string')
+        throw new Error('args must be a string');
+    return { skill, args };
+}
+export class ClaudeExtensionToolRegistry {
+    base;
+    catalog;
+    constructor(base, catalog) {
+        this.base = base;
+        this.catalog = catalog;
+    }
+    definitions() {
+        const skills = this.catalog.modelInvocableSkills();
+        if (skills.length === 0)
+            return this.base.definitions();
+        return [
+            ...this.base.definitions(),
+            {
+                name: 'Skill',
+                description: 'Load an available Claude skill or command by name.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        skill: {
+                            type: 'string',
+                            enum: skills.map((skill) => skill.name),
+                        },
+                        args: { type: 'string' },
+                    },
+                    required: ['skill'],
+                    additionalProperties: false,
+                },
+            },
+        ];
+    }
+    async prepare(call, context) {
+        if (call.name !== 'Skill')
+            return this.base.prepare(call, context);
+        const input = skillInput(call);
+        const definition = this.catalog
+            .modelInvocableSkills()
+            .find((skill) => skill.name === input.skill);
+        if (!definition)
+            throw new Error(`Unknown or disabled skill ${input.skill}`);
+        return { ...call, input };
+    }
+    async execute(call, context) {
+        if (call.name !== 'Skill')
+            return this.base.execute(call, context);
+        const { skill, args } = skillInput(call);
+        const content = this.catalog.renderSkill(skill, args);
+        if (content === null)
+            throw new Error(`Unknown skill ${skill}`);
+        return {
+            content: `Launching skill: ${skill}`,
+            isError: false,
+            followUpUserMessages: [content],
+        };
+    }
+}
+export class ClaudeExtensionPermissionResolver {
+    base;
+    constructor(base) {
+        this.base = base;
+    }
+    resolve(call, context) {
+        return call.name === 'Skill'
+            ? { behavior: 'allow' }
+            : this.base.resolve(call, context);
+    }
+}
+//# sourceMappingURL=claude-extension-tools.js.map

package/dist/extensions/claude-extension-tools.js.map

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

package/dist/extensions/claude-extensions.d.ts

@@ -0,0 +1,41 @@
+import type { ModelContentBlock, ModelImage } from '../core/runtime.js';
+import type { ClaudeMcpPromptDefinition } from '../mcp/claude-mcp-tools.js';
+import type { ClaudeSharedResources, ClaudeTextResource } from '../compatibility/claude/shared-resources.js';
+export type ClaudeExtensionKind = 'agent' | 'command' | 'skill';
+export interface ClaudeExtensionDefinition extends ClaudeTextResource {
+    kind: ClaudeExtensionKind;
+    name: string;
+    description: string;
+    body: string;
+    modelInvocable: boolean;
+}
+export interface ClaudePromptExpansion {
+    userMessages: readonly string[];
+    messages?: readonly ClaudePromptExpansionMessage[];
+}
+export interface ClaudePromptExpansionMessage {
+    text: string;
+    contentBlocks?: readonly ModelContentBlock[];
+    images?: readonly ModelImage[];
+}
+export declare function validateClaudeExtensions(resources: readonly ClaudeTextResource[]): void;
+export declare class ClaudeExtensionCatalog {
+    private readonly commands;
+    private readonly skills;
+    private readonly agents;
+    private readonly disableSlashCommands;
+    private mcpPrompts;
+    constructor(resources: Pick<ClaudeSharedResources, 'agents' | 'commands' | 'skills'>, options?: {
+        disableSlashCommands?: boolean;
+    });
+    setMcpPrompts(prompts: readonly ClaudeMcpPromptDefinition[]): void;
+    expandPrompt(prompt: string): ClaudePromptExpansion;
+    expandPromptAsync(prompt: string, signal?: AbortSignal, toolResultDirectory?: string): Promise<ClaudePromptExpansion>;
+    mcpPromptNames(): readonly string[];
+    skill(name: string): ClaudeExtensionDefinition | null;
+    modelInvocableSkills(): readonly ClaudeExtensionDefinition[];
+    agent(name: string): ClaudeExtensionDefinition | null;
+    agentNames(): readonly string[];
+    renderSkill(name: string, argumentsText: string): string | null;
+}
+//# sourceMappingURL=claude-extensions.d.ts.map

package/dist/extensions/claude-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-extensions.d.ts","sourceRoot":"","sources":["../../src/extensions/claude-extensions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAC3E,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,6CAA6C,CAAA;AAEpD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;AAE/D,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,IAAI,EAAE,mBAAmB,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE,SAAS,4BAA4B,EAAE,CAAA;CACnD;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAC/B;AAiED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,IAAI,CAiDN;AAiFD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,UAAU,CAA+C;gBAG/D,SAAS,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC,EACxE,OAAO,GAAE;QAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAO;IAiBlD,aAAa,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAAG,IAAI;IAWlE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAyB7C,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IAwCjC,cAAc,IAAI,SAAS,MAAM,EAAE;IAInC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAIrD,oBAAoB,IAAI,SAAS,yBAAyB,EAAE;IAQ5D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAIrD,UAAU,IAAI,SAAS,MAAM,EAAE;IAI/B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAIhE"}

package/dist/extensions/claude-extensions.js

@@ -0,0 +1,270 @@
+import { basename, dirname, extname } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+const BUILTIN_LOOP = {
+    path: '/__praxis_builtin__/commands/loop.md',
+    scope: 'user',
+    content: '',
+    kind: 'command',
+    name: 'loop',
+    description: 'Run a prompt or slash command on a recurring interval; defaults to 10 minutes.',
+    modelInvocable: true,
+    body: `# /loop — schedule a recurring prompt
+
+Parse the input into an optional interval followed by a prompt, then schedule it with CronCreate.
+
+Parsing order:
+1. A leading token matching ^\\d+[smhd]$ is the interval; the remainder is the prompt.
+2. Otherwise, a trailing "every <N><unit>" or "every <N> <unit-word>" clause is the interval when it is a valid time expression.
+3. Otherwise, use 10m and keep the complete input as the prompt.
+
+If the resulting prompt is empty, show usage /loop [interval] <prompt> and do not call CronCreate.
+
+Convert intervals to five-field cron:
+- Ns: ceil(N/60) minutes, minimum one minute.
+- Nm up to 59: */N * * * *.
+- Nm of 60 or more: 0 */H * * *, rounded to a clean hour divisor.
+- Nh up to 23: 0 */N * * * *.
+- Nd: 0 0 */N * *.
+
+If an interval cannot be represented evenly, choose the nearest clean interval and tell the user what was rounded.
+
+Call CronCreate with the derived cron, the parsed prompt verbatim, and recurring true. Confirm the prompt, cron, human cadence, seven-day auto-expiration, CronDelete cancellation, and job ID. Then immediately execute the parsed prompt once; invoke slash commands through Skill and otherwise act on the prompt directly.
+
+Input:
+$ARGUMENTS`,
+};
+function parseFrontmatter(resource) {
+    const lines = resource.content.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---') {
+        return { metadata: {}, body: resource.content };
+    }
+    const closingIndex = lines.findIndex((line, index) => index > 0 && line.trim() === '---');
+    if (closingIndex < 0)
+        return { metadata: {}, body: resource.content };
+    let metadata;
+    try {
+        metadata = parseYaml(lines.slice(1, closingIndex).join('\n'));
+    }
+    catch {
+        return { metadata: {}, body: lines.slice(closingIndex + 1).join('\n') };
+    }
+    if (metadata !== null && typeof metadata !== 'object') {
+        return { metadata: {}, body: lines.slice(closingIndex + 1).join('\n') };
+    }
+    return {
+        metadata: (metadata ?? {}),
+        body: lines.slice(closingIndex + 1).join('\n'),
+    };
+}
+export function validateClaudeExtensions(resources) {
+    for (const resource of resources) {
+        const lines = resource.content.split(/\r?\n/);
+        if (lines[0]?.trim() !== '---')
+            continue;
+        const closingIndex = lines.findIndex((line, index) => index > 0 && line.trim() === '---');
+        if (closingIndex < 0) {
+            throw new Error(`Unterminated extension frontmatter: ${resource.path}`);
+        }
+        let metadata;
+        try {
+            metadata = parseYaml(lines.slice(1, closingIndex).join('\n'));
+        }
+        catch (error) {
+            throw new Error(`Invalid extension frontmatter: ${resource.path}`, {
+                cause: error,
+            });
+        }
+        if (metadata !== null && typeof metadata !== 'object') {
+            throw new Error(`Extension frontmatter must be an object: ${resource.path}`);
+        }
+        const record = (metadata ?? {});
+        if (record.name !== undefined &&
+            (typeof record.name !== 'string' || record.name.length === 0)) {
+            throw new Error(`Extension name must be a non-empty string: ${resource.path}`);
+        }
+        if (record.description !== undefined &&
+            typeof record.description !== 'string') {
+            throw new Error(`Extension description must be a string: ${resource.path}`);
+        }
+        if (record['disable-model-invocation'] !== undefined &&
+            typeof record['disable-model-invocation'] !== 'boolean') {
+            throw new Error(`Extension disable-model-invocation must be a boolean: ${resource.path}`);
+        }
+    }
+}
+function defaultName(kind, path) {
+    if (kind === 'command') {
+        const normalized = path.replaceAll('\\', '/');
+        const marker = '/commands/';
+        const markerIndex = normalized.lastIndexOf(marker);
+        const relativePath = markerIndex < 0
+            ? basename(path, extname(path))
+            : normalized.slice(markerIndex + marker.length).replace(/\.md$/, '');
+        return relativePath.replaceAll('/', ':');
+    }
+    return kind === 'skill'
+        ? basename(dirname(path))
+        : basename(path, extname(path));
+}
+function parseDefinition(kind, resource) {
+    const parsed = parseFrontmatter(resource);
+    const metadata = (parsed.metadata.name === undefined ||
+        (typeof parsed.metadata.name === 'string' &&
+            parsed.metadata.name.length > 0)) &&
+        (parsed.metadata.description === undefined ||
+            typeof parsed.metadata.description === 'string') &&
+        (parsed.metadata['disable-model-invocation'] === undefined ||
+            typeof parsed.metadata['disable-model-invocation'] === 'boolean')
+        ? parsed.metadata
+        : {};
+    const { body } = parsed;
+    const name = kind === 'command'
+        ? defaultName(kind, resource.path)
+        : typeof metadata.name === 'string'
+            ? metadata.name
+            : defaultName(kind, resource.path);
+    const description = typeof metadata.description === 'string' ? metadata.description : '';
+    return {
+        ...resource,
+        kind,
+        name,
+        description,
+        body,
+        modelInvocable: metadata['disable-model-invocation'] !== true,
+    };
+}
+function indexed(kind, resources) {
+    const definitions = new Map();
+    for (const resource of resources) {
+        const definition = parseDefinition(kind, resource);
+        definitions.set(definition.name, definition);
+    }
+    return definitions;
+}
+function substituteArguments(body, argumentsText) {
+    const values = argumentsText.length === 0 ? [] : argumentsText.split(/\s+/);
+    return body.replace(/\$(ARGUMENTS|\d+)/g, (_, key) => key === 'ARGUMENTS' ? argumentsText : (values[Number(key)] ?? ''));
+}
+function renderInvocation(definition, argumentsText) {
+    const content = substituteArguments(definition.body, argumentsText);
+    return definition.kind === 'skill'
+        ? `Base directory for this skill: ${dirname(definition.path)}\n\n${content}`
+        : content;
+}
+export class ClaudeExtensionCatalog {
+    commands;
+    skills;
+    agents;
+    disableSlashCommands;
+    mcpPrompts = new Map();
+    constructor(resources, options = {}) {
+        this.disableSlashCommands = options.disableSlashCommands === true;
+        this.commands = options.disableSlashCommands
+            ? new Map()
+            : new Map([['loop', BUILTIN_LOOP]]);
+        if (!options.disableSlashCommands) {
+            for (const [name, command] of indexed('command', resources.commands)) {
+                this.commands.set(name, command);
+            }
+        }
+        this.skills = options.disableSlashCommands
+            ? new Map()
+            : indexed('skill', resources.skills);
+        this.agents = indexed('agent', resources.agents);
+    }
+    setMcpPrompts(prompts) {
+        this.mcpPrompts.clear();
+        if (this.disableSlashCommands)
+            return;
+        const occupied = new Set([...this.commands.keys(), ...this.skills.keys()]);
+        for (const prompt of prompts) {
+            if (occupied.has(prompt.name) || this.mcpPrompts.has(prompt.name))
+                continue;
+            this.mcpPrompts.set(prompt.name, prompt);
+        }
+    }
+    expandPrompt(prompt) {
+        const match = /^\/([^\s]+)(?:\s+(.*))?$/.exec(prompt);
+        if (!match?.[1]) {
+            return { userMessages: [prompt] };
+        }
+        const name = match[1];
+        const argumentsText = match[2]?.trim() ?? '';
+        const definition = this.skills.get(name) ?? this.commands.get(name);
+        if (!definition) {
+            return { userMessages: [prompt] };
+        }
+        return {
+            userMessages: [
+                [
+                    `<command-message>${name}</command-message>`,
+                    `<command-name>/${name}</command-name>`,
+                    ...(argumentsText
+                        ? [`<command-args>${argumentsText}</command-args>`]
+                        : []),
+                ].join('\n'),
+                renderInvocation(definition, argumentsText),
+            ],
+        };
+    }
+    async expandPromptAsync(prompt, signal, toolResultDirectory) {
+        const staticExpansion = this.expandPrompt(prompt);
+        if (staticExpansion.userMessages.length !== 1 ||
+            staticExpansion.userMessages[0] !== prompt) {
+            return staticExpansion;
+        }
+        const match = /^\/([^\s]+) \(MCP\)(?: (.*))?$/.exec(prompt.trim());
+        if (!match?.[1])
+            return staticExpansion;
+        const userFacingName = `${match[1]} (MCP)`;
+        const definition = [...this.mcpPrompts.values()].find((candidate) => candidate.userFacingName === userFacingName);
+        if (!definition)
+            return staticExpansion;
+        const argumentsText = match[2] ?? '';
+        const result = await definition.invoke(argumentsText, {
+            ...(signal ? { signal } : {}),
+            ...(toolResultDirectory ? { toolResultDirectory } : {}),
+        });
+        const metadata = [
+            `<command-message>${definition.name}</command-message>`,
+            `<command-name>/${definition.name}</command-name>`,
+            ...(argumentsText
+                ? [`<command-args>${argumentsText}</command-args>`]
+                : []),
+        ].join('\n');
+        return {
+            userMessages: [metadata, result.text],
+            messages: [
+                { text: metadata },
+                {
+                    text: result.text,
+                    contentBlocks: result.contentBlocks,
+                    images: result.images,
+                },
+            ],
+        };
+    }
+    mcpPromptNames() {
+        return [...this.mcpPrompts.values()].map((prompt) => prompt.userFacingName);
+    }
+    skill(name) {
+        return this.skills.get(name) ?? this.commands.get(name) ?? null;
+    }
+    modelInvocableSkills() {
+        const definitions = new Map(this.commands);
+        for (const [name, skill] of this.skills)
+            definitions.set(name, skill);
+        return [...definitions.values()].filter((definition) => definition.modelInvocable);
+    }
+    agent(name) {
+        return this.agents.get(name) ?? null;
+    }
+    agentNames() {
+        return [...this.agents.keys()];
+    }
+    renderSkill(name, argumentsText) {
+        const definition = this.skill(name);
+        return definition ? renderInvocation(definition, argumentsText) : null;
+    }
+}
+//# sourceMappingURL=claude-extensions.js.map

package/dist/extensions/claude-extensions.js.map

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

package/dist/hooks/claude-hook-tools.d.ts

@@ -0,0 +1,26 @@
+import type { ModelToolCall, PermissionDecision, PermissionResolver, PermissionResolutionContext, ToolExecutionContext, ToolExecutionResult, ToolRegistry } from '../core/runtime.js';
+import type { ClaudeHookOutcome, ClaudeHookRunner } from './claude-hooks.js';
+export interface ClaudeHookSessionInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+}
+export interface ClaudeHookToolCoordinatorOptions {
+    tools: ToolRegistry;
+    permissions: PermissionResolver;
+    hooks: ClaudeHookRunner;
+    session: ClaudeHookSessionInput;
+    recordOutcome(outcome: ClaudeHookOutcome, deferUntilApproval?: boolean): Promise<void>;
+    deferPreToolUseOutcome?(call: ModelToolCall): boolean;
+}
+export declare class ClaudeHookToolCoordinator implements ToolRegistry, PermissionResolver {
+    private readonly options;
+    private readonly prepared;
+    constructor(options: ClaudeHookToolCoordinatorOptions);
+    definitions(): readonly import("../core/runtime.js").ModelToolDefinition[];
+    prepare(call: ModelToolCall, context: ToolExecutionContext): Promise<ModelToolCall>;
+    resolve(call: ModelToolCall, context?: PermissionResolutionContext): Promise<PermissionDecision>;
+    execute(call: ModelToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=claude-hook-tools.d.ts.map

package/dist/hooks/claude-hook-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hook-tools.d.ts","sourceRoot":"","sources":["../../src/hooks/claude-hook-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAE5E,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,KAAK,EAAE,gBAAgB,CAAA;IACvB,OAAO,EAAE,sBAAsB,CAAA;IAC/B,aAAa,CACX,OAAO,EAAE,iBAAiB,EAC1B,kBAAkB,CAAC,EAAE,OAAO,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,sBAAsB,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAA;CACtD;AAQD,qBAAa,yBACX,YAAW,YAAY,EAAE,kBAAkB;IAI/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;gBAElC,OAAO,EAAE,gCAAgC;IAEtE,WAAW;IAIL,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAkDnB,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,kBAAkB,CAAC;IAgCxB,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAkDhC"}