praxis-agent 0.1.0

package/dist/tools/claude-workflow-tools.d.ts

@@ -0,0 +1,27 @@
+import type { ModelToolCall, ModelToolDefinition, ToolExecutionContext, ToolExecutionResult, ToolRegistry } from '../core/runtime.js';
+import { type WorkflowManager } from '../application/workflow-manager.js';
+import type { ClaudeSubagentExecutor } from '../application/subagent-service.js';
+export interface ClaudeWorkflowToolRegistryOptions {
+    base: ToolRegistry;
+    manager: WorkflowManager;
+    executor: ClaudeSubagentExecutor;
+    cwd: string;
+    cwdProvider?: () => string;
+    configRoot: string;
+    sessionId: string;
+    promptIdForCall(callId: string): string | null;
+    defaultModel: string;
+    tokenBudget?: number | null;
+    enabled: boolean;
+}
+export declare class ClaudeWorkflowToolRegistry implements ToolRegistry {
+    private readonly options;
+    private readonly prepared;
+    constructor(options: ClaudeWorkflowToolRegistryOptions);
+    definitions(): readonly ModelToolDefinition[];
+    prepare(call: ModelToolCall, context: ToolExecutionContext): Promise<ModelToolCall>;
+    execute(call: ModelToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    private resolveSource;
+    private source;
+}
+//# sourceMappingURL=claude-workflow-tools.d.ts.map

package/dist/tools/claude-workflow-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-workflow-tools.d.ts","sourceRoot":"","sources":["../../src/tools/claude-workflow-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAA;AAwEhF,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,eAAe,CAAA;IACxB,QAAQ,EAAE,sBAAsB,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9C,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB;AAcD,qBAAa,0BAA2B,YAAW,YAAY;IAGjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAEhC,OAAO,EAAE,iCAAiC;IAEvE,WAAW,IAAI,SAAS,mBAAmB,EAAE;IAQvC,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAkEnB,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;YA2DjB,aAAa;IA8C3B,OAAO,CAAC,MAAM;CASf"}

package/dist/tools/claude-workflow-tools.js

@@ -0,0 +1,257 @@
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, resolve } from 'node:path';
+import { parseWorkflowScript, } from '../application/workflow-manager.js';
+const MAX_SCRIPT_BYTES = 524_288;
+const WORKFLOW_DEFINITION = {
+    name: 'Workflow',
+    description: `Run an explicitly requested, sandboxed JavaScript workflow in the background. Use only when the user asks for a workflow or named saved workflow; for ordinary delegation use Agent.
+
+Every script starts with a pure-literal \`export const meta = { name, description, phases? }\`. Its async body may use \`args\`, \`agent(prompt, options?)\`, \`parallel(thunks)\`, \`pipeline(items, ...stages)\`, \`workflow(nameOrScriptPath, args)\`, \`phase(title)\`, \`log(message)\`, and \`budget.{total,spent(),remaining()}\`. Agent options are \`label\`, \`phase\`, \`model\`, \`effort\`, \`agentType\`, \`schema\`, and \`isolation: 'worktree'\`. Pipeline stages receive \`(previousResult, originalItem, index)\`; failed parallel or pipeline items become null. Nested workflows are limited to one level.
+
+Provide one source: \`scriptPath\` takes precedence over \`script\`, which takes precedence over \`name\`. Saved names resolve from project then user \`.claude/workflows\`, followed by built-ins. The call returns a task ID immediately; use TaskOutput/TaskStop for lifecycle. Resume a terminal or interrupted run with its script path and \`resumeFromRunId\`; completed matching agents replay from journal. Workflows allow at most 1000 agents, 4096 collection items, and bounded concurrency. Scripts have no Node.js, filesystem, network, ambient time, or randomness.`,
+    inputSchema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            script: { type: 'string', maxLength: MAX_SCRIPT_BYTES },
+            name: { type: 'string' },
+            description: { type: 'string' },
+            title: { type: 'string' },
+            args: {},
+            scriptPath: { type: 'string' },
+            resumeFromRunId: {
+                type: 'string',
+                pattern: '^wf_[a-z0-9-]{6,}$',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+const DEEP_RESEARCH = `export const meta = {
+  name: 'deep-research',
+  description: 'Research a topic from independent angles and synthesize the evidence',
+  phases: [
+    { title: 'Research', detail: 'Gather independent evidence' },
+    { title: 'Synthesis', detail: 'Reconcile findings and produce the answer' },
+  ],
+}
+phase('Research')
+const topic = typeof args === 'string' ? args : args.topic
+if (typeof topic !== 'string' || topic.length === 0) throw new Error('deep-research requires args.topic')
+const findings = await parallel([
+  () => agent('Research primary sources for: ' + topic, { label: 'Primary sources', phase: 'Research' }),
+  () => agent('Find counterarguments and unresolved questions for: ' + topic, { label: 'Counterevidence', phase: 'Research' }),
+  () => agent('Build a concise factual timeline for: ' + topic, { label: 'Timeline', phase: 'Research' }),
+])
+phase('Synthesis')
+return agent('Synthesize these findings into a sourced answer about ' + topic + ':\n' + JSON.stringify(findings), { label: 'Synthesis', phase: 'Synthesis' })`;
+const CODE_REVIEW = `export const meta = {
+  name: 'code-review',
+  description: 'Review a code change for correctness, security, tests, and maintainability',
+  phases: [
+    { title: 'Review', detail: 'Run independent focused reviews' },
+    { title: 'Triage', detail: 'Deduplicate and rank actionable findings' },
+  ],
+}
+phase('Review')
+const target = typeof args === 'string' ? args : (args.target || 'current working tree changes')
+const reviews = await parallel([
+  () => agent('Review ' + target + ' for logic errors and edge cases. Return only actionable findings.', { label: 'Correctness', phase: 'Review' }),
+  () => agent('Review ' + target + ' for security, resource, and concurrency bugs. Return only actionable findings.', { label: 'Security', phase: 'Review' }),
+  () => agent('Review tests for ' + target + ' and identify behavior not actually covered.', { label: 'Test coverage', phase: 'Review' }),
+])
+phase('Triage')
+return agent('Deduplicate and severity-rank these review findings. Keep concrete file references and fixes:\n' + JSON.stringify(reviews), { label: 'Triage', phase: 'Triage' })`;
+const BUILT_INS = new Map([
+    ['deep-research', DEEP_RESEARCH],
+    ['code-review', CODE_REVIEW],
+]);
+function optionalString(input, name) {
+    const value = input[name];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`${name} must be a non-empty string`);
+    }
+    return value;
+}
+export class ClaudeWorkflowToolRegistry {
+    options;
+    prepared = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    definitions() {
+        const base = this.options.base.definitions();
+        if (!this.options.enabled || base.some(({ name }) => name === 'Workflow')) {
+            return base;
+        }
+        return [...base, WORKFLOW_DEFINITION];
+    }
+    async prepare(call, context) {
+        if (call.name === 'TaskOutput' || call.name === 'TaskStop') {
+            const taskId = call.input.task_id ?? call.input.shell_id;
+            if (typeof taskId === 'string' && this.options.manager.has(taskId)) {
+                if (call.name === 'TaskOutput') {
+                    const block = call.input.block ?? true;
+                    const timeout = call.input.timeout ?? 30_000;
+                    if (typeof block !== 'boolean')
+                        throw new Error('block must be a boolean');
+                    if (typeof timeout !== 'number' || timeout < 0 || timeout > 600_000) {
+                        throw new Error('timeout must be between 0 and 600000');
+                    }
+                    return { ...call, input: { task_id: taskId, block, timeout } };
+                }
+                return { ...call, input: { task_id: taskId } };
+            }
+            return this.options.base.prepare(call, context);
+        }
+        if (call.name !== 'Workflow')
+            return this.options.base.prepare(call, context);
+        if (!this.options.enabled)
+            throw new Error('Tool Workflow is unavailable');
+        const allowed = new Set([
+            'script',
+            'name',
+            'description',
+            'title',
+            'args',
+            'scriptPath',
+            'resumeFromRunId',
+        ]);
+        for (const key of Object.keys(call.input)) {
+            if (!allowed.has(key))
+                throw new Error(`Unknown Workflow input field ${key}`);
+        }
+        const script = optionalString(call.input, 'script');
+        const name = optionalString(call.input, 'name');
+        const scriptPath = optionalString(call.input, 'scriptPath');
+        const description = optionalString(call.input, 'description');
+        const title = optionalString(call.input, 'title');
+        const resumeFromRunId = optionalString(call.input, 'resumeFromRunId');
+        if (!scriptPath && !script && !name) {
+            throw new Error('InputValidationError: [\n  {\n    "code": "custom",\n    "path": [],\n    "message": "Must provide script, name, or scriptPath"\n  }\n]');
+        }
+        if (resumeFromRunId && !/^wf_[a-z0-9-]{6,}$/u.test(resumeFromRunId)) {
+            throw new Error('resumeFromRunId must match ^wf_[a-z0-9-]{6,}$');
+        }
+        const source = await this.resolveSource({
+            ...(scriptPath ? { scriptPath } : {}),
+            ...(script ? { script } : {}),
+            ...(name ? { name } : {}),
+        });
+        this.prepared.set(call.id, source);
+        return {
+            ...call,
+            input: {
+                ...(scriptPath ? { scriptPath } : script ? { script } : { name }),
+                ...(description ? { description } : {}),
+                ...(title ? { title } : {}),
+                ...(Object.hasOwn(call.input, 'args') ? { args: call.input.args } : {}),
+                ...(resumeFromRunId ? { resumeFromRunId } : {}),
+            },
+        };
+    }
+    async execute(call, context) {
+        if (call.name === 'TaskOutput' || call.name === 'TaskStop') {
+            const taskId = String(call.input.task_id);
+            if (this.options.manager.has(taskId)) {
+                return {
+                    content: call.name === 'TaskOutput'
+                        ? await this.options.manager.output(taskId, {
+                            block: Boolean(call.input.block),
+                            timeout: Number(call.input.timeout),
+                        })
+                        : this.options.manager.stop(taskId),
+                    isError: false,
+                };
+            }
+            return this.options.base.execute(call, context);
+        }
+        if (call.name !== 'Workflow')
+            return this.options.base.execute(call, context);
+        const source = this.prepared.get(call.id);
+        this.prepared.delete(call.id);
+        if (!source)
+            throw new Error('Workflow was not prepared');
+        const launch = await this.options.manager.launch({
+            sessionId: this.options.sessionId,
+            promptId: this.options.promptIdForCall(call.id) ?? call.id,
+            script: source.script,
+            parsed: source.parsed,
+            args: Object.hasOwn(call.input, 'args') ? call.input.args : undefined,
+            ...(typeof call.input.resumeFromRunId === 'string'
+                ? { resumeFromRunId: call.input.resumeFromRunId }
+                : {}),
+            defaultModel: this.options.defaultModel,
+            ...(this.options.tokenBudget === undefined
+                ? {}
+                : { tokenBudget: this.options.tokenBudget }),
+            runAgent: (agentOptions) => this.options.executor.runWorkflowAgent(agentOptions),
+            resolveNested: (reference) => this.resolveSource(reference.endsWith('.js') || reference.includes('/')
+                ? { scriptPath: reference }
+                : { name: reference }),
+            ...(context.signal ? { signal: context.signal } : {}),
+        });
+        return {
+            content: launch.content,
+            isError: false,
+            nativeToolUseResult: {
+                isAsync: true,
+                status: 'async_launched',
+                taskId: launch.taskId,
+                taskType: 'local_workflow',
+                runId: launch.runId,
+                outputFile: launch.transcriptDirectory,
+            },
+        };
+    }
+    async resolveSource(input) {
+        if (input.scriptPath) {
+            const path = isAbsolute(input.scriptPath)
+                ? input.scriptPath
+                : resolve(this.options.cwdProvider?.() ?? this.options.cwd, input.scriptPath);
+            let script;
+            try {
+                script = await readFile(path, 'utf8');
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    throw new Error(`Workflow script file not found: ${path}`);
+                }
+                throw error;
+            }
+            return this.source(script);
+        }
+        if (input.script)
+            return this.source(input.script);
+        const name = String(input.name);
+        for (const path of [
+            resolve(this.options.cwdProvider?.() ?? this.options.cwd, '.claude', 'workflows', `${name}.js`),
+            resolve(this.options.configRoot, 'workflows', `${name}.js`),
+        ]) {
+            try {
+                return this.source(await readFile(path, 'utf8'));
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+        const builtIn = BUILT_INS.get(name);
+        if (builtIn)
+            return this.source(builtIn);
+        const available = [...BUILT_INS.keys()].join(', ');
+        throw new Error(`Workflow "${name}" not found. Available: ${available}`);
+    }
+    source(script) {
+        if (Buffer.byteLength(script) > MAX_SCRIPT_BYTES) {
+            throw new Error(`Workflow script exceeded ${MAX_SCRIPT_BYTES} bytes`);
+        }
+        return {
+            script,
+            parsed: parseWorkflowScript(script),
+        };
+    }
+}
+//# sourceMappingURL=claude-workflow-tools.js.map

package/dist/tools/claude-workflow-tools.js.map

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

package/dist/tools/claude-worktree-tools.d.ts

@@ -0,0 +1,17 @@
+import type { ModelToolCall, ModelToolDefinition, ToolExecutionContext, ToolExecutionResult, ToolRegistry } from '../core/runtime.js';
+import type { SessionWorktreeManager, WorkspaceContext } from '../application/session-worktree.js';
+export declare class ClaudeWorktreeToolRegistry implements ToolRegistry {
+    private readonly options;
+    private readonly enabled;
+    constructor(options: {
+        base: ToolRegistry;
+        manager: SessionWorktreeManager;
+        workspace: WorkspaceContext;
+        enabledTools?: readonly ('EnterWorktree' | 'ExitWorktree')[];
+    });
+    definitions(): readonly ModelToolDefinition[];
+    prepare(call: ModelToolCall, context: ToolExecutionContext): Promise<ModelToolCall>;
+    execute(call: ModelToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+export declare const claudeWorktreeToolDefinitions: readonly [ModelToolDefinition, ModelToolDefinition];
+//# sourceMappingURL=claude-worktree-tools.d.ts.map

package/dist/tools/claude-worktree-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-worktree-tools.d.ts","sourceRoot":"","sources":["../../src/tools/claude-worktree-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,oCAAoC,CAAA;AAyE3C,qBAAa,0BAA2B,YAAW,YAAY;IAI3D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAG1B,OAAO,EAAE;QACxB,IAAI,EAAE,YAAY,CAAA;QAClB,OAAO,EAAE,sBAAsB,CAAA;QAC/B,SAAS,EAAE,gBAAgB,CAAA;QAC3B,YAAY,CAAC,EAAE,SAAS,CAAC,eAAe,GAAG,cAAc,CAAC,EAAE,CAAA;KAC7D;IAOH,WAAW,IAAI,SAAS,mBAAmB,EAAE;IAYvC,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IA0CnB,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAmBhC;AAED,eAAO,MAAM,6BAA6B,qDAGhC,CAAA"}

package/dist/tools/claude-worktree-tools.js

@@ -0,0 +1,135 @@
+const ENTER_DEFINITION = {
+    name: 'EnterWorktree',
+    description: 'Create or enter an isolated Git worktree and switch the current session into it.',
+    inputSchema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            name: {
+                description: 'Optional name for a new worktree. Each "/"-separated segment may contain only letters, digits, dots, underscores, and dashes; max 64 chars total. A random name is generated if not provided. Mutually exclusive with path.',
+                type: 'string',
+            },
+            path: {
+                description: 'Path to an existing worktree to switch into instead of creating a new one. Must be registered with the current repository and live under .claude/worktrees. Mutually exclusive with name.',
+                type: 'string',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+const EXIT_DEFINITION = {
+    name: 'ExitWorktree',
+    description: 'Exit an active worktree session and return to the original working directory.',
+    inputSchema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            action: {
+                description: '"keep" leaves the worktree and branch on disk; "remove" deletes both.',
+                type: 'string',
+                enum: ['keep', 'remove'],
+            },
+            discard_changes: {
+                description: 'Required true when action is "remove" and the worktree has uncommitted files or unmerged commits.',
+                type: 'boolean',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function objectInput(call) {
+    if (!call.input ||
+        typeof call.input !== 'object' ||
+        Array.isArray(call.input)) {
+        throw new Error(`${call.name} input must be an object`);
+    }
+    return call.input;
+}
+function optionalString(input, key) {
+    const value = input[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`${key} must be a non-empty string`);
+    }
+    return value;
+}
+export class ClaudeWorktreeToolRegistry {
+    options;
+    enabled;
+    constructor(options) {
+        this.options = options;
+        this.enabled = new Set(options.enabledTools ?? ['EnterWorktree', 'ExitWorktree']);
+    }
+    definitions() {
+        const base = this.options.base.definitions();
+        const existing = new Set(base.map(({ name }) => name));
+        return [
+            ...base,
+            ...[ENTER_DEFINITION, EXIT_DEFINITION].filter((definition) => this.enabled.has(definition.name) && !existing.has(definition.name)),
+        ];
+    }
+    async prepare(call, context) {
+        if (call.name === 'EnterWorktree' && this.enabled.has(call.name)) {
+            const input = objectInput(call);
+            const name = optionalString(input, 'name');
+            const path = optionalString(input, 'path');
+            if (name !== undefined && path !== undefined) {
+                throw new Error('EnterWorktree name and path are mutually exclusive');
+            }
+            return {
+                ...call,
+                input: {
+                    ...(name === undefined ? {} : { name }),
+                    ...(path === undefined ? {} : { path }),
+                },
+            };
+        }
+        if (call.name === 'ExitWorktree' && this.enabled.has(call.name)) {
+            const input = objectInput(call);
+            const action = input.action;
+            if (action !== 'keep' && action !== 'remove') {
+                throw new Error('action must be keep or remove');
+            }
+            const discardChanges = input.discard_changes;
+            if (discardChanges !== undefined && typeof discardChanges !== 'boolean') {
+                throw new Error('discard_changes must be a boolean');
+            }
+            return {
+                ...call,
+                input: {
+                    action,
+                    ...(discardChanges === undefined
+                        ? {}
+                        : { discard_changes: discardChanges }),
+                },
+            };
+        }
+        return this.options.base.prepare(call, {
+            ...context,
+            cwd: this.options.workspace.cwd(),
+        });
+    }
+    async execute(call, context) {
+        if (call.name === 'EnterWorktree' && this.enabled.has(call.name)) {
+            const input = call.input;
+            const result = await this.options.manager.enter(input, call.id);
+            return { ...result, isError: false };
+        }
+        if (call.name === 'ExitWorktree' && this.enabled.has(call.name)) {
+            const input = call.input;
+            const result = await this.options.manager.exit(input, call.id);
+            return { ...result, isError: false };
+        }
+        return this.options.base.execute(call, {
+            ...context,
+            cwd: this.options.workspace.cwd(),
+        });
+    }
+}
+export const claudeWorktreeToolDefinitions = [
+    ENTER_DEFINITION,
+    EXIT_DEFINITION,
+];
+//# sourceMappingURL=claude-worktree-tools.js.map

package/dist/tools/claude-worktree-tools.js.map

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

package/dist/tools/filtered-tool-registry.d.ts

@@ -0,0 +1,16 @@
+import type { ModelToolCall, ModelToolDefinition, ToolExecutionContext, ToolExecutionResult, ToolRegistry } from '../core/runtime.js';
+export interface FilteredToolRegistryOptions {
+    tools?: readonly string[];
+    disallowedTools?: readonly string[];
+}
+export declare class FilteredToolRegistry implements ToolRegistry {
+    private readonly base;
+    private readonly definitionsByName;
+    private readonly enabledNames;
+    constructor(base: ToolRegistry, options?: FilteredToolRegistryOptions);
+    definitions(): readonly ModelToolDefinition[];
+    prepare(call: ModelToolCall, context: ToolExecutionContext): Promise<ModelToolCall>;
+    execute(call: ModelToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    private assertEnabled;
+}
+//# sourceMappingURL=filtered-tool-registry.d.ts.map

package/dist/tools/filtered-tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtered-tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/filtered-tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACb,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAWD,qBAAa,oBAAqB,YAAW,YAAY;IAKrD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0C;IAC5E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;gBAG/B,IAAI,EAAE,YAAY,EACnC,OAAO,GAAE,2BAAgC;IAsB3C,WAAW,IAAI,SAAS,mBAAmB,EAAE;IAQvC,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAKnB,OAAO,CACX,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAK/B,OAAO,CAAC,aAAa;CAKtB"}

package/dist/tools/filtered-tool-registry.js

@@ -0,0 +1,51 @@
+function exactToolNames(rules) {
+    return new Set(rules.flatMap((rule) => {
+        const match = /^([A-Za-z][\w-]*)$/.exec(rule);
+        return match?.[1] ? [match[1]] : [];
+    }));
+}
+export class FilteredToolRegistry {
+    base;
+    definitionsByName;
+    enabledNames;
+    constructor(base, options = {}) {
+        this.base = base;
+        const definitions = base.definitions();
+        this.definitionsByName = new Map(definitions.map((definition) => [definition.name, definition]));
+        const selected = options.tools;
+        const enabled = selected === undefined || selected.includes('default')
+            ? new Set(this.definitionsByName.keys())
+            : new Set(selected);
+        for (const name of enabled) {
+            if (!this.definitionsByName.has(name)) {
+                throw new Error(`Unknown tool in --tools: ${name}`);
+            }
+        }
+        for (const name of exactToolNames(options.disallowedTools ?? [])) {
+            enabled.delete(name);
+        }
+        this.enabledNames = enabled;
+    }
+    definitions() {
+        return [...this.enabledNames].map((name) => {
+            const definition = this.definitionsByName.get(name);
+            if (!definition)
+                throw new Error(`Unknown enabled tool: ${name}`);
+            return definition;
+        });
+    }
+    async prepare(call, context) {
+        this.assertEnabled(call.name);
+        return this.base.prepare(call, context);
+    }
+    async execute(call, context) {
+        this.assertEnabled(call.name);
+        return this.base.execute(call, context);
+    }
+    assertEnabled(name) {
+        if (!this.enabledNames.has(name)) {
+            throw new Error(`Tool ${name} is disabled by CLI controls`);
+        }
+    }
+}
+//# sourceMappingURL=filtered-tool-registry.js.map

package/dist/tools/filtered-tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtered-tool-registry.js","sourceRoot":"","sources":["../../src/tools/filtered-tool-registry.ts"],"names":[],"mappings":"AAaA,SAAS,cAAc,CAAC,KAAwB;IAC9C,OAAO,IAAI,GAAG,CACZ,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACrC,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED,MAAM,OAAO,oBAAoB;IAKZ;IAJF,iBAAiB,CAA0C;IAC3D,YAAY,CAAqB;IAElD,YACmB,IAAkB,EACnC,UAAuC,EAAE;QADxB,SAAI,GAAJ,IAAI,CAAc;QAGnC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QACtC,IAAI,CAAC,iBAAiB,GAAG,IAAI,GAAG,CAC9B,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAC/D,CAAA;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAA;QAC9B,MAAM,OAAO,GACX,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YACpD,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;YACxC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAA;QACvB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAA;YACrD,CAAC;QACH,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAA;IAC7B,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACnD,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAA;YACjE,OAAO,UAAU,CAAA;QACnB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAmB,EACnB,OAA6B;QAE7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAmB,EACnB,OAA6B;QAE7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,8BAA8B,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;CACF"}

package/dist/tools/glob.d.ts

@@ -0,0 +1,9 @@
+export interface GlobFilesOptions {
+    root: string;
+    displayRoot: string;
+    absoluteRoot: string;
+    pattern: string;
+    signal?: AbortSignal;
+}
+export declare function globFiles(options: GlobFilesOptions): Promise<string>;
+//# sourceMappingURL=glob.d.ts.map

package/dist/tools/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/tools/glob.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAiCD,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+D1E"}