@poping/yome 0.0.2

package/dist/loops/orchestrator.d.ts

@@ -0,0 +1,13 @@
+import type { AgentLoop, AgentLoopContext, AgentLoopCallbacks, UserInput } from './types.js';
+/**
+ * Orchestrator-Workers: a central LLM dynamically breaks down the task,
+ * delegates subtasks to worker LLM calls (with tools), then synthesizes results.
+ *
+ * Flow: In → Orchestrator → [Worker1, Worker2, ...] (parallel) → Synthesizer → Out
+ */
+export declare class OrchestratorAgentLoop implements AgentLoop {
+    readonly name = "orchestrator";
+    readonly description = "Orchestrator-workers: decompose, delegate in parallel, synthesize";
+    run(userMessage: UserInput, ctx: AgentLoopContext, cb: AgentLoopCallbacks): Promise<void>;
+    private runWorker;
+}

package/dist/loops/orchestrator.js

@@ -0,0 +1,107 @@
+import { callLLM, extractText, callLLMStream } from '../llm.js';
+import { userInputAsText } from './types.js';
+const MAX_WORKER_ITERATIONS = 15;
+/**
+ * Orchestrator-Workers: a central LLM dynamically breaks down the task,
+ * delegates subtasks to worker LLM calls (with tools), then synthesizes results.
+ *
+ * Flow: In → Orchestrator → [Worker1, Worker2, ...] (parallel) → Synthesizer → Out
+ */
+export class OrchestratorAgentLoop {
+    name = 'orchestrator';
+    description = 'Orchestrator-workers: decompose, delegate in parallel, synthesize';
+    async run(userMessage, ctx, cb) {
+        ctx.messages.push({ role: 'user', content: userMessage });
+        let totalInput = 0;
+        let totalOutput = 0;
+        try {
+            // Step 1: Orchestrator decomposes the task
+            const decomposeResponse = await callLLM(ctx.config, ctx.systemPrompt, [
+                ...ctx.messages,
+                {
+                    role: 'user',
+                    content: 'Break this task into independent subtasks that can be executed in parallel. ' +
+                        'Output ONLY a JSON array of objects: [{"id": 1, "task": "description"}, ...]. ' +
+                        'Keep it to 2-5 subtasks. No other text.',
+                },
+            ]);
+            totalInput += decomposeResponse.usage.input_tokens;
+            totalOutput += decomposeResponse.usage.output_tokens;
+            const decomposeText = extractText(decomposeResponse);
+            let subtasks;
+            try {
+                const match = decomposeText.match(/\[[\s\S]*\]/);
+                subtasks = match ? JSON.parse(match[0]) : [{ id: 1, task: userInputAsText(userMessage) }];
+            }
+            catch {
+                subtasks = [{ id: 1, task: userInputAsText(userMessage) }];
+            }
+            cb.onTextDelta(`**Orchestrator** dispatching ${subtasks.length} workers:\n`);
+            subtasks.forEach((s) => cb.onTextDelta(`- Worker ${s.id}: ${s.task}\n`));
+            cb.onTextDelta('\n');
+            // Step 2: Execute workers in parallel
+            const workerResults = await Promise.all(subtasks.map((subtask) => this.runWorker(subtask, ctx, cb).then((r) => {
+                totalInput += r.inputTokens;
+                totalOutput += r.outputTokens;
+                return r;
+            })));
+            // Step 3: Synthesizer combines results
+            cb.onTextDelta('\n---\n**Synthesizing results...**\n\n');
+            const synthesisContext = `Original task: ${userMessage}\n\n` +
+                workerResults
+                    .map((r) => `## Worker ${r.id} (${r.task})\n${r.result}`)
+                    .join('\n\n');
+            const synthesizeMessages = [
+                ...ctx.messages,
+                {
+                    role: 'user',
+                    content: `Here are the results from parallel workers. Synthesize them into a coherent final answer.\n\n${synthesisContext}`,
+                },
+            ];
+            const synthResponse = await callLLMStream(ctx.config, ctx.systemPrompt, synthesizeMessages, [], (event) => {
+                if (event.type === 'text_delta' && event.text) {
+                    cb.onTextDelta(event.text);
+                }
+            });
+            totalInput += synthResponse.usage.input_tokens;
+            totalOutput += synthResponse.usage.output_tokens;
+            ctx.messages.push({ role: 'assistant', content: synthResponse.content });
+        }
+        catch (err) {
+            cb.onError(err);
+            return;
+        }
+        cb.onDone({ inputTokens: totalInput, outputTokens: totalOutput });
+    }
+    async runWorker(subtask, ctx, cb) {
+        const workerMessages = [
+            { role: 'user', content: `Execute this subtask: ${subtask.task}\nBe concise and focused.` },
+        ];
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let resultText = '';
+        for (let i = 0; i < MAX_WORKER_ITERATIONS; i++) {
+            const response = await callLLMStream(ctx.config, ctx.systemPrompt, workerMessages, ctx.tools, (event) => {
+                if (event.type === 'text_delta' && event.text) {
+                    resultText += event.text;
+                }
+            });
+            inputTokens += response.usage.input_tokens;
+            outputTokens += response.usage.output_tokens;
+            workerMessages.push({ role: 'assistant', content: response.content });
+            const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+            if (toolUseBlocks.length === 0 || response.stop_reason === 'end_turn')
+                break;
+            const toolResults = [];
+            for (const block of toolUseBlocks) {
+                cb.onToolUse(block.name, block.input);
+                const result = await ctx.executeTool(block.name, block.input);
+                cb.onToolResult(block.name, result);
+                toolResults.push({ type: 'tool_result', tool_use_id: block.id, content: result });
+            }
+            workerMessages.push({ role: 'user', content: toolResults });
+        }
+        return { id: subtask.id, task: subtask.task, result: resultText || '(no output)', inputTokens, outputTokens };
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/loops/orchestrator.js.map

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

package/dist/loops/parallel.d.ts

@@ -0,0 +1,6 @@
+import type { AgentLoop, AgentLoopContext, AgentLoopCallbacks, UserInput } from './types.js';
+export declare class ParallelAgentLoop implements AgentLoop {
+    readonly name = "parallel";
+    readonly description = "Parallel tool execution loop";
+    run(userMessage: UserInput, ctx: AgentLoopContext, cb: AgentLoopCallbacks): Promise<void>;
+}

package/dist/loops/parallel.js

@@ -0,0 +1,48 @@
+import { callLLMStream } from '../llm.js';
+const MAX_ITERATIONS = 30;
+export class ParallelAgentLoop {
+    name = 'parallel';
+    description = 'Parallel tool execution loop';
+    async run(userMessage, ctx, cb) {
+        ctx.messages.push({ role: 'user', content: userMessage });
+        let totalInput = 0;
+        let totalOutput = 0;
+        for (let i = 0; i < MAX_ITERATIONS; i++) {
+            try {
+                const response = await callLLMStream(ctx.config, ctx.systemPrompt, ctx.messages, ctx.tools, (event) => {
+                    if (event.type === 'text_delta' && event.text) {
+                        cb.onTextDelta(event.text);
+                    }
+                });
+                totalInput += response.usage.input_tokens;
+                totalOutput += response.usage.output_tokens;
+                ctx.messages.push({ role: 'assistant', content: response.content });
+                const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+                if (toolUseBlocks.length === 0 || response.stop_reason === 'end_turn') {
+                    cb.onDone({ inputTokens: totalInput, outputTokens: totalOutput });
+                    return;
+                }
+                // Execute all tools in parallel
+                for (const block of toolUseBlocks) {
+                    cb.onToolUse(block.name, block.input);
+                }
+                const results = await Promise.all(toolUseBlocks.map((block) => ctx.executeTool(block.name, block.input)));
+                const toolResults = toolUseBlocks.map((block, idx) => {
+                    cb.onToolResult(block.name, results[idx]);
+                    return {
+                        type: 'tool_result',
+                        tool_use_id: block.id,
+                        content: results[idx],
+                    };
+                });
+                ctx.messages.push({ role: 'user', content: toolResults });
+            }
+            catch (err) {
+                cb.onError(err);
+                return;
+            }
+        }
+        cb.onDone({ inputTokens: totalInput, outputTokens: totalOutput });
+    }
+}
+//# sourceMappingURL=parallel.js.map

package/dist/loops/parallel.js.map

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

package/dist/loops/route.d.ts

@@ -0,0 +1,13 @@
+import type { AgentLoop, AgentLoopContext, AgentLoopCallbacks, UserInput } from './types.js';
+/**
+ * Routing: classify input then dispatch to a specialized handler.
+ *
+ * Flow: In → LLM Router → [route1 | route2 | route3 | ...] → Out
+ *
+ * Each route has a specialized system prompt so the LLM focuses on that domain.
+ */
+export declare class RouteAgentLoop implements AgentLoop {
+    readonly name = "route";
+    readonly description = "Routing: classify input then dispatch to specialized handler";
+    run(userMessage: UserInput, ctx: AgentLoopContext, cb: AgentLoopCallbacks): Promise<void>;
+}

package/dist/loops/route.js

@@ -0,0 +1,88 @@
+import { callLLM, extractText, callLLMStream } from '../llm.js';
+const MAX_ITERATIONS = 30;
+const ROUTES = [
+    {
+        name: 'code',
+        description: 'Writing, editing, debugging, or refactoring code',
+        systemPrompt: 'You are a coding specialist. Focus on writing clean, correct code. ' +
+            'Read files before editing. Use tools to verify your changes compile/run.',
+    },
+    {
+        name: 'analyze',
+        description: 'Reading, understanding, explaining, or reviewing code/files',
+        systemPrompt: 'You are an analysis specialist. Focus on reading and understanding code. ' +
+            'Provide clear explanations. Use Read/Grep/Glob to gather information before answering.',
+    },
+    {
+        name: 'shell',
+        description: 'Running commands, managing files, git operations, build/test tasks',
+        systemPrompt: 'You are a shell operations specialist. Focus on running commands efficiently. ' +
+            'Prefer Bash tool for system operations. Be careful with destructive commands.',
+    },
+    {
+        name: 'general',
+        description: 'General questions, planning, brainstorming, or anything else',
+        systemPrompt: 'You are a helpful assistant. Answer the user concisely and accurately. ' +
+            'Use tools only when needed to verify facts or gather information.',
+    },
+];
+/**
+ * Routing: classify input then dispatch to a specialized handler.
+ *
+ * Flow: In → LLM Router → [route1 | route2 | route3 | ...] → Out
+ *
+ * Each route has a specialized system prompt so the LLM focuses on that domain.
+ */
+export class RouteAgentLoop {
+    name = 'route';
+    description = 'Routing: classify input then dispatch to specialized handler';
+    async run(userMessage, ctx, cb) {
+        ctx.messages.push({ role: 'user', content: userMessage });
+        let totalInput = 0;
+        let totalOutput = 0;
+        try {
+            // Step 1: Classify
+            const routeList = ROUTES.map((r) => `- ${r.name}: ${r.description}`).join('\n');
+            const classifyResponse = await callLLM(ctx.config, 'You are a router.', [
+                {
+                    role: 'user',
+                    content: `Classify this request into exactly one category. Reply with ONLY the category name.\n\nCategories:\n${routeList}\n\nRequest: ${userMessage}`,
+                },
+            ]);
+            totalInput += classifyResponse.usage.input_tokens;
+            totalOutput += classifyResponse.usage.output_tokens;
+            const classification = extractText(classifyResponse).trim().toLowerCase();
+            const route = ROUTES.find((r) => classification.includes(r.name)) ?? ROUTES[ROUTES.length - 1];
+            cb.onTextDelta(`*[routed to: ${route.name}]*\n\n`);
+            // Step 2: Execute with specialized system prompt
+            const specializedPrompt = `${route.systemPrompt}\n\n${ctx.systemPrompt}`;
+            for (let i = 0; i < MAX_ITERATIONS; i++) {
+                const response = await callLLMStream(ctx.config, specializedPrompt, ctx.messages, ctx.tools, (event) => {
+                    if (event.type === 'text_delta' && event.text) {
+                        cb.onTextDelta(event.text);
+                    }
+                });
+                totalInput += response.usage.input_tokens;
+                totalOutput += response.usage.output_tokens;
+                ctx.messages.push({ role: 'assistant', content: response.content });
+                const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+                if (toolUseBlocks.length === 0 || response.stop_reason === 'end_turn')
+                    break;
+                const toolResults = [];
+                for (const block of toolUseBlocks) {
+                    cb.onToolUse(block.name, block.input);
+                    const result = await ctx.executeTool(block.name, block.input);
+                    cb.onToolResult(block.name, result);
+                    toolResults.push({ type: 'tool_result', tool_use_id: block.id, content: result });
+                }
+                ctx.messages.push({ role: 'user', content: toolResults });
+            }
+        }
+        catch (err) {
+            cb.onError(err);
+            return;
+        }
+        cb.onDone({ inputTokens: totalInput, outputTokens: totalOutput });
+    }
+}
+//# sourceMappingURL=route.js.map

package/dist/loops/route.js.map

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

package/dist/loops/simple.d.ts

@@ -0,0 +1,6 @@
+import type { AgentLoop, AgentLoopContext, AgentLoopCallbacks, UserInput } from './types.js';
+export declare class SimpleAgentLoop implements AgentLoop {
+    readonly name = "simple";
+    readonly description = "Sequential tool-call loop (default)";
+    run(userMessage: UserInput, ctx: AgentLoopContext, cb: AgentLoopCallbacks): Promise<void>;
+}

package/dist/loops/simple.js

@@ -0,0 +1,46 @@
+import { callLLMStream } from '../llm.js';
+const MAX_ITERATIONS = 30;
+export class SimpleAgentLoop {
+    name = 'simple';
+    description = 'Sequential tool-call loop (default)';
+    async run(userMessage, ctx, cb) {
+        ctx.messages.push({ role: 'user', content: userMessage });
+        let totalInput = 0;
+        let totalOutput = 0;
+        for (let i = 0; i < MAX_ITERATIONS; i++) {
+            try {
+                const response = await callLLMStream(ctx.config, ctx.systemPrompt, ctx.messages, ctx.tools, (event) => {
+                    if (event.type === 'text_delta' && event.text) {
+                        cb.onTextDelta(event.text);
+                    }
+                });
+                totalInput += response.usage.input_tokens;
+                totalOutput += response.usage.output_tokens;
+                ctx.messages.push({ role: 'assistant', content: response.content });
+                const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+                if (toolUseBlocks.length === 0 || response.stop_reason === 'end_turn') {
+                    cb.onDone({ inputTokens: totalInput, outputTokens: totalOutput });
+                    return;
+                }
+                const toolResults = [];
+                for (const block of toolUseBlocks) {
+                    cb.onToolUse(block.name, block.input);
+                    const result = await ctx.executeTool(block.name, block.input);
+                    cb.onToolResult(block.name, result);
+                    toolResults.push({
+                        type: 'tool_result',
+                        tool_use_id: block.id,
+                        content: result,
+                    });
+                }
+                ctx.messages.push({ role: 'user', content: toolResults });
+            }
+            catch (err) {
+                cb.onError(err);
+                return;
+            }
+        }
+        cb.onDone({ inputTokens: totalInput, outputTokens: totalOutput });
+    }
+}
+//# sourceMappingURL=simple.js.map

package/dist/loops/simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../../src/loops/simple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,qCAAqC,CAAC;IAE7D,KAAK,CAAC,GAAG,CACP,WAAsB,EACtB,GAAqB,EACrB,EAAsB;QAEtB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAE1D,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,KAAK,EACT,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBAC9C,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC,CACF,CAAC;gBAEF,UAAU,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;gBAC1C,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC;gBAC5C,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gBAEpE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAC3C,CAAC,CAAC,EAA4C,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CACvE,CAAC;gBAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;oBACtE,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;oBAClE,OAAO;gBACT,CAAC;gBAED,MAAM,WAAW,GAAmB,EAAE,CAAC;gBACvC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;oBAClC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBACtC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC9D,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBACpC,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,aAAa;wBACnB,WAAW,EAAE,KAAK,CAAC,EAAE;wBACrB,OAAO,EAAE,MAAM;qBAChB,CAAC,CAAC;gBACL,CAAC;gBAED,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5D,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;QACH,CAAC;QAED,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/loops/types.d.ts

@@ -0,0 +1,32 @@
+import type { YomeConfig } from '../config.js';
+import type { ContentBlock, AgentMessage, AnthropicTool } from '../types.js';
+export interface AgentLoopCallbacks {
+    onTextDelta: (text: string) => void;
+    onToolUse: (name: string, input: Record<string, unknown>) => void;
+    onToolResult: (name: string, result: string) => void;
+    onDone: (usage: {
+        inputTokens: number;
+        outputTokens: number;
+    }) => void;
+    onError: (error: Error) => void;
+}
+export interface AgentLoopContext {
+    config: YomeConfig;
+    systemPrompt: string;
+    messages: AgentMessage[];
+    tools: AnthropicTool[];
+    executeTool: (name: string, input: Record<string, unknown>) => Promise<string>;
+}
+export type UserInput = string | ContentBlock[];
+export declare function userInputAsText(input: UserInput): string;
+export interface AgentLoop {
+    readonly name: string;
+    readonly description: string;
+    run(userMessage: UserInput, context: AgentLoopContext, callbacks: AgentLoopCallbacks): Promise<void>;
+}
+export interface AgentLoopRegistry {
+    get(name: string): AgentLoop | undefined;
+    list(): AgentLoop[];
+    register(loop: AgentLoop): void;
+    default(): AgentLoop;
+}

package/dist/loops/types.js

@@ -0,0 +1,9 @@
+export function userInputAsText(input) {
+    if (typeof input === 'string')
+        return input;
+    return input
+        .filter((b) => b.type === 'text')
+        .map((b) => b.text)
+        .join('\n');
+}
+//# sourceMappingURL=types.js.map

package/dist/loops/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/loops/types.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAwC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/permissions/checker.d.ts

@@ -0,0 +1,18 @@
+import type { ToolPermissionContext, PermissionDecision, PermissionResult } from './types.js';
+/**
+ * Check if a specific command/path is allowed by a content-specific rule.
+ */
+export declare function isContentAllowed(ctx: ToolPermissionContext, toolName: string, content: string): boolean;
+/**
+ * Check if a specific command/path is denied by a content-specific rule.
+ */
+export declare function isContentDenied(ctx: ToolPermissionContext, toolName: string, content: string): boolean;
+/**
+ * Main permission check for a tool invocation.
+ *
+ * @param toolName - The tool being invoked
+ * @param isReadOnly - Whether the tool is read-only
+ * @param ctx - Current permission context
+ * @param toolResult - Optional result from the tool's own checkPermissions()
+ */
+export declare function checkPermission(toolName: string, isReadOnly: boolean, ctx: ToolPermissionContext, toolResult?: PermissionResult): PermissionDecision;

package/dist/permissions/checker.js

@@ -0,0 +1,89 @@
+import { parseRuleValue, toolMatchesRule, contentMatchesRule } from './ruleParser.js';
+const RULE_SOURCES = ['cliArg', 'session', 'userSettings', 'projectSettings'];
+function getAllowRules(ctx) {
+    return RULE_SOURCES.flatMap((source) => (ctx.allowRules[source] ?? []).map((s) => ({
+        source,
+        ruleBehavior: 'allow',
+        ruleValue: parseRuleValue(s),
+    })));
+}
+function getDenyRules(ctx) {
+    return RULE_SOURCES.flatMap((source) => (ctx.denyRules[source] ?? []).map((s) => ({
+        source,
+        ruleBehavior: 'deny',
+        ruleValue: parseRuleValue(s),
+    })));
+}
+/**
+ * Check if the entire tool is denied by a rule.
+ */
+function isToolDenied(ctx, toolName) {
+    return getDenyRules(ctx).some((r) => toolMatchesRule(toolName, r.ruleValue));
+}
+/**
+ * Check if the entire tool is allowed by a rule.
+ */
+function isToolAllowed(ctx, toolName) {
+    return getAllowRules(ctx).some((r) => toolMatchesRule(toolName, r.ruleValue));
+}
+/**
+ * Check if a specific command/path is allowed by a content-specific rule.
+ */
+export function isContentAllowed(ctx, toolName, content) {
+    return getAllowRules(ctx).some((r) => contentMatchesRule(toolName, content, r.ruleValue));
+}
+/**
+ * Check if a specific command/path is denied by a content-specific rule.
+ */
+export function isContentDenied(ctx, toolName, content) {
+    return getDenyRules(ctx).some((r) => contentMatchesRule(toolName, content, r.ruleValue));
+}
+/**
+ * Main permission check for a tool invocation.
+ *
+ * @param toolName - The tool being invoked
+ * @param isReadOnly - Whether the tool is read-only
+ * @param ctx - Current permission context
+ * @param toolResult - Optional result from the tool's own checkPermissions()
+ */
+export function checkPermission(toolName, isReadOnly, ctx, toolResult) {
+    // 1. Check deny rules (always respected)
+    if (isToolDenied(ctx, toolName)) {
+        return { behavior: 'deny', message: `Permission to use ${toolName} has been denied.` };
+    }
+    // 2. Tool-specific deny
+    if (toolResult?.behavior === 'deny') {
+        return toolResult;
+    }
+    // 3. Bypass mode allows everything
+    if (ctx.mode === 'bypassPermissions') {
+        return { behavior: 'allow' };
+    }
+    // 4. Accept-edits mode: allow read-only tools + file edit tools
+    if (ctx.mode === 'acceptEdits') {
+        if (isReadOnly)
+            return { behavior: 'allow' };
+        const editTools = ['Edit', 'Write'];
+        if (editTools.includes(toolName))
+            return { behavior: 'allow' };
+        // Bash still needs ask unless explicitly allowed
+    }
+    // 5. Explicit allow rules
+    if (isToolAllowed(ctx, toolName)) {
+        return { behavior: 'allow' };
+    }
+    // 6. Tool-specific ask/allow
+    if (toolResult?.behavior === 'allow') {
+        return toolResult;
+    }
+    if (toolResult?.behavior === 'ask') {
+        return toolResult;
+    }
+    // 7. Read-only tools are always allowed
+    if (isReadOnly) {
+        return { behavior: 'allow' };
+    }
+    // 8. Default: ask for write operations
+    return { behavior: 'ask', message: `Allow ${toolName} to proceed?` };
+}
+//# sourceMappingURL=checker.js.map

package/dist/permissions/checker.js.map

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

package/dist/permissions/index.d.ts

@@ -0,0 +1,4 @@
+export type { PermissionMode, PermissionBehavior, PermissionRule, PermissionRuleValue, PermissionRuleSource, PermissionDecision, PermissionResult, ToolPermissionContext, PermissionRulesBySource, } from './types.js';
+export { parseRuleValue, serializeRuleValue, toolMatchesRule, contentMatchesRule } from './ruleParser.js';
+export { loadAllPermissionRules, loadDefaultMode, initializePermissionContext, addPermissionRuleToUserSettings } from './loader.js';
+export { checkPermission, isContentAllowed, isContentDenied } from './checker.js';

package/dist/permissions/index.js

@@ -0,0 +1,4 @@
+export { parseRuleValue, serializeRuleValue, toolMatchesRule, contentMatchesRule } from './ruleParser.js';
+export { loadAllPermissionRules, loadDefaultMode, initializePermissionContext, addPermissionRuleToUserSettings } from './loader.js';
+export { checkPermission, isContentAllowed, isContentDenied } from './checker.js';
+//# sourceMappingURL=index.js.map

package/dist/permissions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/permissions/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,2BAA2B,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACpI,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/permissions/loader.d.ts

@@ -0,0 +1,22 @@
+import type { PermissionBehavior, PermissionRule, PermissionMode, ToolPermissionContext } from './types.js';
+/**
+ * Load all permission rules from user settings (~/.yome/settings.json)
+ * and project settings (.yome/settings.json).
+ */
+export declare function loadAllPermissionRules(): PermissionRule[];
+/**
+ * Load the default permission mode from settings.
+ */
+export declare function loadDefaultMode(): PermissionMode;
+/**
+ * Build an initial ToolPermissionContext from disk settings and CLI args.
+ */
+export declare function initializePermissionContext(opts?: {
+    allowedTools?: string[];
+    disallowedTools?: string[];
+    mode?: PermissionMode;
+}): ToolPermissionContext;
+/**
+ * Persist a new allow/deny rule to user settings.
+ */
+export declare function addPermissionRuleToUserSettings(ruleString: string, behavior: PermissionBehavior): void;