@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/agents/child-session/parent-tool-bridge.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionToolContext, ToolDefinition } from '@earendil-works/pi-coding-agent';
+import { type ExecuteTool } from '../../../kernel/tool-execution/execute-tool.js';
+type ParentTool = ExtensionToolContext['tools'][number];
+export type ArgumentsFor = (toolName: string, params: unknown) => unknown;
+export interface ParentToolBridge {
+    readonly callable: readonly ParentTool[];
+    readonly names: readonly string[];
+    readonly executeTool: ExecuteTool;
+    readonly argumentsFor?: ArgumentsFor;
+}
+export declare function bridgeParentTools({ callable, names, executeTool, argumentsFor }: ParentToolBridge): ToolDefinition[];
+export {};

package/dist/extensions/agents/child-session/parent-tool-bridge.js

@@ -0,0 +1,28 @@
+import { outcomeText } from '../../../kernel/tool-execution/execute-tool.js';
+import { NestedToolCallFailedError } from '../errors.js';
+const unchanged = (_toolName, params) => params;
+export function bridgeParentTools({ callable, names, executeTool, argumentsFor = unchanged }) {
+    const selected = new Set(names);
+    return callable.filter(({ name }) => selected.has(name)).map((tool) => bridgeTo(tool, executeTool, argumentsFor));
+}
+function bridgeTo(tool, executeTool, argumentsFor) {
+    return {
+        name: tool.name,
+        label: tool.label,
+        description: tool.description,
+        parameters: tool.parameters,
+        ...(tool.executionMode === undefined ? {} : { executionMode: tool.executionMode }),
+        execute: async (_toolCallId, params, signal, onUpdate) => resultOf(await executeTool(tool.name, argumentsFor(tool.name, params), nestedCallOptions(signal, onUpdate))),
+    };
+}
+const nestedCallOptions = (signal, onUpdate) => ({
+    ...(signal === undefined ? {} : { signal }),
+    ...(onUpdate === undefined ? {} : { onUpdate }),
+});
+function resultOf(outcome) {
+    if (outcome.isError) {
+        throw new NestedToolCallFailedError(outcomeText(outcome));
+    }
+    return outcome.result;
+}
+//# sourceMappingURL=parent-tool-bridge.js.map

package/dist/extensions/agents/child-session/parent-tool-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-tool-bridge.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/parent-tool-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAsC,MAAM,gDAAgD,CAAC;AACjH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAMzD,MAAM,SAAS,GAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC;AAS9D,MAAM,UAAU,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,GAAG,SAAS,EAAoB;IAC5G,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAgB,EAAE,WAAwB,EAAE,YAA0B;IACtF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAClF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CACvD,QAAQ,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;KAC/G,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAG,CAAC,MAA+B,EAAE,QAA6C,EAAsB,EAAE,CAAC,CAAC;IACjI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;CAChD,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,OAAoB;IACpC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,yBAAyB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}

package/dist/extensions/agents/child-session/sdk-child-session-factory.d.ts

@@ -0,0 +1,7 @@
+import type { ChildSession, ChildSessionFactory, ChildSessionSpec } from './child-session-factory.js';
+import type { SubAgentModels } from './sub-agent-models.js';
+export declare class SdkChildSessionFactory implements ChildSessionFactory {
+    #private;
+    constructor(agentDir: string, models: SubAgentModels);
+    create(spec: ChildSessionSpec): Promise<ChildSession>;
+}

package/dist/extensions/agents/child-session/sdk-child-session-factory.js

@@ -0,0 +1,70 @@
+import { createAgentSession, SessionManager, SettingsManager } from '@earendil-works/pi-coding-agent';
+import { childResourceLoader } from './child-resource-loader.js';
+const CHILD_SETTINGS = { compaction: { enabled: true } };
+const SILENT = { kind: 'silent' };
+const UNEXPLAINED_MODEL_ERROR = 'the model answered with an error';
+export class SdkChildSessionFactory {
+    #agentDir;
+    #models;
+    constructor(agentDir, models) {
+        this.#agentDir = agentDir;
+        this.#models = models;
+    }
+    async create(spec) {
+        const settingsManager = SettingsManager.inMemory(CHILD_SETTINGS);
+        const resourceLoader = childResourceLoader(spec, this.#agentDir, settingsManager);
+        await resourceLoader.reload();
+        const model = await this.#models.resolve(spec.model);
+        const { session } = await createAgentSession({
+            ...modelOptions(spec, model),
+            cwd: spec.cwd,
+            agentDir: this.#agentDir,
+            modelRuntime: await this.#models.runtime(),
+            resourceLoader,
+            settingsManager,
+            sessionManager: SessionManager.inMemory(spec.cwd),
+            noTools: 'all',
+            tools: [...spec.toolNames],
+            customTools: [...spec.tools],
+        });
+        return new SdkChildSession(session);
+    }
+}
+const modelOptions = ({ thinkingLevel }, model) => ({
+    ...(model === undefined ? {} : { model }),
+    ...(thinkingLevel === undefined ? {} : { thinkingLevel }),
+});
+class SdkChildSession {
+    #session;
+    constructor(session) {
+        this.#session = session;
+    }
+    prompt(task) {
+        return this.#session.prompt(task, { expandPromptTemplates: false });
+    }
+    onTurnEnd(listener) {
+        this.#session.subscribe((event) => {
+            if (event.type === 'turn_end') {
+                listener({ continues: event.toolResults.length > 0 });
+            }
+        });
+    }
+    abort() {
+        return this.#session.abort();
+    }
+    answer() {
+        const last = [...this.#session.messages].reverse().find(isAssistantMessage);
+        return last === undefined ? SILENT : answerOf(last);
+    }
+    dispose() {
+        this.#session.dispose();
+    }
+}
+const isAssistantMessage = (message) => message.role === 'assistant';
+function answerOf({ stopReason, errorMessage, content }) {
+    if (stopReason === 'error') {
+        return { kind: 'error', reason: errorMessage ?? UNEXPLAINED_MODEL_ERROR };
+    }
+    return { kind: 'text', text: content.flatMap((part) => (part.type === 'text' ? [part.text] : [])).join('\n') };
+}
+//# sourceMappingURL=sdk-child-session-factory.js.map

package/dist/extensions/agents/child-session/sdk-child-session-factory.js.map

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

package/dist/extensions/agents/child-session/sub-agent-models.d.ts

@@ -0,0 +1,9 @@
+import { ModelRuntime } from '@earendil-works/pi-coding-agent';
+import type { ModelReference } from './child-session-factory.js';
+export type ChildModel = NonNullable<ReturnType<ModelRuntime['getModel']>>;
+export declare class SubAgentModels {
+    #private;
+    constructor(agentDir: string);
+    runtime(): Promise<ModelRuntime>;
+    resolve(reference: ModelReference | undefined): Promise<ChildModel | undefined>;
+}

package/dist/extensions/agents/child-session/sub-agent-models.js

@@ -0,0 +1,27 @@
+import { join } from 'node:path';
+import { ModelRuntime } from '@earendil-works/pi-coding-agent';
+import { SubAgentModelUnavailableError } from '../errors.js';
+const AUTH_FILE = 'auth.json';
+const MODELS_FILE = 'models.json';
+export class SubAgentModels {
+    #agentDir;
+    #runtime;
+    constructor(agentDir) {
+        this.#agentDir = agentDir;
+    }
+    runtime() {
+        this.#runtime ??= ModelRuntime.create({ authPath: join(this.#agentDir, AUTH_FILE), modelsPath: join(this.#agentDir, MODELS_FILE) });
+        return this.#runtime;
+    }
+    async resolve(reference) {
+        if (reference === undefined) {
+            return undefined;
+        }
+        const model = (await this.runtime()).getModel(reference.provider, reference.id);
+        if (model === undefined) {
+            throw new SubAgentModelUnavailableError(reference.provider);
+        }
+        return model;
+    }
+}
+//# sourceMappingURL=sub-agent-models.js.map

package/dist/extensions/agents/child-session/sub-agent-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-models.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/sub-agent-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,WAAW,GAAG,aAAa,CAAC;AAIlC,MAAM,OAAO,cAAc;IAChB,SAAS,CAAS;IAC3B,QAAQ,CAAoC;IAE5C,YAAY,QAAgB;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;QACpI,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAqC;QACjD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QAChF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,6BAA6B,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/extensions/agents/child-session/tool-selection.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from '../roster/agent-definition.js';
+export declare function selectChildTools(agent: AgentDefinition, callable: readonly string[]): readonly string[];

package/dist/extensions/agents/child-session/tool-selection.js

@@ -0,0 +1,14 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/subagent/agents.ts.
+import { toPiToolName } from '../../../kernel/vocabulary/claude-tool-names.js';
+const ARGUMENT_SCOPE = '(';
+const NEVER_GIVEN_TO_A_CHILD = new Set(['Agent', 'Task']);
+export function selectChildTools(agent, callable) {
+    const offered = agent.tools === undefined ? callable : grantedTools(agent.tools);
+    const denied = new Set(deniedTools(agent.disallowedTools));
+    return [...new Set(offered)].filter((name) => !NEVER_GIVEN_TO_A_CHILD.has(name) && !denied.has(name));
+}
+const isScopedToArguments = (entry) => entry.includes(ARGUMENT_SCOPE);
+const grantedTools = (entries) => entries.filter((entry) => !isScopedToArguments(entry)).map(toPiToolName);
+const deniedTools = (entries) => entries.map((entry) => toPiToolName(withoutArgumentScope(entry)));
+const withoutArgumentScope = (entry) => entry.split(ARGUMENT_SCOPE)[0] ?? entry;
+//# sourceMappingURL=tool-selection.js.map

package/dist/extensions/agents/child-session/tool-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/tool-selection.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAG/E,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/E,MAAM,UAAU,gBAAgB,CAAC,KAAsB,EAAE,QAA2B;IAClF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAEvF,MAAM,YAAY,GAAG,CAAC,OAA0B,EAAY,EAAE,CAC5D,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAE3E,MAAM,WAAW,GAAG,CAAC,OAA0B,EAAY,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhI,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC"}

package/dist/extensions/agents/child-session/turn-cap.d.ts

@@ -0,0 +1,8 @@
+import type { ChildTurn } from './child-session-factory.js';
+export declare class TurnCap {
+    #private;
+    readonly limit: number | undefined;
+    constructor(limit: number | undefined, stop: () => void);
+    count({ continues }: ChildTurn): void;
+    isReached(): boolean;
+}

package/dist/extensions/agents/child-session/turn-cap.js

@@ -0,0 +1,21 @@
+export class TurnCap {
+    limit;
+    #stop;
+    #turns = 0;
+    #reached = false;
+    constructor(limit, stop) {
+        this.limit = limit;
+        this.#stop = stop;
+    }
+    count({ continues }) {
+        this.#turns += 1;
+        if (continues && this.limit !== undefined && this.#turns >= this.limit) {
+            this.#reached = true;
+            this.#stop();
+        }
+    }
+    isReached() {
+        return this.#reached;
+    }
+}
+//# sourceMappingURL=turn-cap.js.map

package/dist/extensions/agents/child-session/turn-cap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-cap.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/turn-cap.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,OAAO;IACT,KAAK,CAAqB;IAC1B,KAAK,CAAa;IAC3B,MAAM,GAAG,CAAC,CAAC;IACX,QAAQ,GAAG,KAAK,CAAC;IAEjB,YAAY,KAAyB,EAAE,IAAgB;QACrD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,EAAE,SAAS,EAAa;QAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/extensions/agents/errors.d.ts

@@ -0,0 +1,14 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export declare class UnknownAgentTypeError extends AntharaError {
+    constructor(requested: string, available: readonly string[]);
+}
+export declare class AgentRunFailedError extends AntharaError {
+}
+export declare class SubAgentModelUnavailableError extends AntharaError {
+    constructor(provider: string);
+}
+export declare class NestedToolCallFailedError extends AntharaError {
+}
+export declare class WorktreeUnavailableError extends AntharaError {
+    constructor(repo: string, reason: string);
+}

package/dist/extensions/agents/errors.js

@@ -0,0 +1,22 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export class UnknownAgentTypeError extends AntharaError {
+    constructor(requested, available) {
+        super(`Agent type "${requested}" not found. Available agents: ${available.join(', ')}.`);
+    }
+}
+export class AgentRunFailedError extends AntharaError {
+}
+export class SubAgentModelUnavailableError extends AntharaError {
+    constructor(provider) {
+        super(`The model provider "${provider}" is not available to sub-agents: they run on a model runtime built from auth.json ` +
+            'and models.json in the pi agent folder, which a provider registered by an extension does not reach.');
+    }
+}
+export class NestedToolCallFailedError extends AntharaError {
+}
+export class WorktreeUnavailableError extends AntharaError {
+    constructor(repo, reason) {
+        super(`Cannot start the agent in a worktree of ${repo}: ${reason}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/extensions/agents/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/extensions/agents/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YAAY,SAAiB,EAAE,SAA4B;QACzD,KAAK,CAAC,eAAe,SAAS,kCAAkC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3F,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;CAAG;AAExD,MAAM,OAAO,6BAA8B,SAAQ,YAAY;IAC7D,YAAY,QAAgB;QAC1B,KAAK,CACH,uBAAuB,QAAQ,qFAAqF;YAClH,qGAAqG,CACxG,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,YAAY;CAAG;AAE9D,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IACxD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,2CAA2C,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/extensions/agents/index.d.ts

@@ -0,0 +1,4 @@
+import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { type ChildSessionsFor } from './session-agents.js';
+export default function agentsExtension(pi: ExtensionAPI): void;
+export declare function registerAgentTools(pi: ExtensionAPI, childSessions: ChildSessionsFor): void;

package/dist/extensions/agents/index.js

@@ -0,0 +1,80 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { withdrawAgentRoster } from '../../kernel/agent-roster/agent-roster-slot.js';
+import { publishAgentRunner, withdrawAgentRunner } from '../../kernel/agent-runner/agent-runner-slot.js';
+import { backgroundMailbox } from '../../kernel/background-mailbox/background-mailbox.js';
+import { textResult } from '../../kernel/tool-results/tool-result.js';
+import { backgroundFinishedText, backgroundStartedText, completedRunText, failedRunText } from './agent-result-text.js';
+import { ClaudeAgentParams } from './agent-schema.js';
+import { SdkChildSessionFactory } from './child-session/sdk-child-session-factory.js';
+import { SubAgentModels } from './child-session/sub-agent-models.js';
+import { AgentRunFailedError } from './errors.js';
+import { SessionAgents } from './session-agents.js';
+const AGENT_TOOL_NAMES = ['Agent', 'Task'];
+const AGENT_RESULT_MESSAGE = 'anthara-agent-result';
+const AGENT_DESCRIPTION = [
+    'Launch an agent to handle a complex, multi-step task on its own. Each agent type has its own instructions and tools.',
+    'Pick the agent with subagent_type; its final message comes back as this tool\'s result.',
+    'The agent does not see this conversation, so give it a complete, self-contained prompt.',
+    'Start several agents in one message to run them at the same time.',
+    'run_in_background: true returns a run id at once, and a notice arrives in the conversation when the agent finishes.',
+].join(' ');
+export default function agentsExtension(pi) {
+    registerAgentTools(pi, (agentDir) => new SdkChildSessionFactory(agentDir, new SubAgentModels(agentDir)));
+}
+export function registerAgentTools(pi, childSessions) {
+    const agents = new SessionAgents((run) => {
+        backgroundMailbox().post({ customType: AGENT_RESULT_MESSAGE, content: backgroundFinishedText(run) });
+    }, childSessions, pi.events);
+    followSessionLifecycle(pi, agents);
+    for (const name of AGENT_TOOL_NAMES) {
+        pi.registerTool(agentTool(name, agents));
+    }
+}
+function followSessionLifecycle(pi, agents) {
+    let leaveMailbox;
+    pi.on('session_start', async (_event, ctx) => {
+        await agents.begin(ctx);
+        publishAgentRunner(ctx.sessionManager.getSessionId(), agents);
+        leaveMailbox = deliverBackgroundResults(pi);
+    });
+    pi.on('session_shutdown', (_event, ctx) => {
+        withdrawAgentRunner(ctx.sessionManager.getSessionId());
+        withdrawAgentRoster(ctx.sessionManager.getSessionId());
+        leaveMailbox?.();
+    });
+}
+const deliverBackgroundResults = (pi) => backgroundMailbox().subscribe(({ customType, content }) => {
+    pi.sendMessage({ customType, content, display: true }, { triggerTurn: true });
+});
+function agentTool(name, agents) {
+    return defineTool({
+        name,
+        label: name,
+        description: AGENT_DESCRIPTION,
+        parameters: ClaudeAgentParams,
+        prepareLoadout: () => ({
+            descriptions: { [name]: agents.describe(AGENT_DESCRIPTION) },
+        }),
+        execute: (_toolCallId, input, signal, _onUpdate, parent) => runAgentCall(agents, input, { signal, parent }),
+    });
+}
+async function runAgentCall(agents, input, { signal, parent }) {
+    const dispatcher = agents.dispatcher();
+    const request = agentRequest(input);
+    if (dispatcher.runsInBackground(request)) {
+        return textResult(backgroundStartedText(dispatcher.start(request, parent)));
+    }
+    const outcome = await dispatcher.run(request, parent, signal);
+    if (outcome.kind === 'failed') {
+        throw new AgentRunFailedError(failedRunText(outcome));
+    }
+    return textResult(completedRunText(outcome));
+}
+const agentRequest = ({ subagent_type: subagentType, description, prompt, model, run_in_background: runInBackground }) => ({
+    subagentType,
+    description,
+    prompt,
+    ...(model === undefined ? {} : { model }),
+    ...(runInBackground === undefined ? {} : { runInBackground }),
+});
+//# sourceMappingURL=index.js.map

package/dist/extensions/agents/index.js.map

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

package/dist/extensions/agents/memory/agent-memory.d.ts

@@ -0,0 +1,11 @@
+import type { AgentDefinition } from '../roster/agent-definition.js';
+import type { MemoryBackend } from './memory-backend.js';
+export interface MemoryProvision {
+    readonly toolNames: readonly string[];
+    readonly instruction: string;
+}
+export declare class AgentMemory {
+    #private;
+    constructor(backend: MemoryBackend, report: (message: string) => void);
+    provide({ id, memory }: AgentDefinition, callable: readonly string[]): MemoryProvision;
+}

package/dist/extensions/agents/memory/agent-memory.js

@@ -0,0 +1,28 @@
+const NO_MEMORY = { toolNames: [], instruction: '' };
+export class AgentMemory {
+    #backend;
+    #report;
+    #reportedAgents = new Set();
+    constructor(backend, report) {
+        this.#backend = backend;
+        this.#report = report;
+    }
+    provide({ id, memory }, callable) {
+        if (memory === undefined) {
+            return NO_MEMORY;
+        }
+        const tools = this.#backend.toolsFor(memory, callable);
+        if (tools.kind === 'available') {
+            return { toolNames: tools.toolNames, instruction: tools.instruction };
+        }
+        this.#reportOnce(id, `${id}: memory: ${memory} is not supported here, because ${tools.reason}. The agent runs without memory.`);
+        return NO_MEMORY;
+    }
+    #reportOnce(agentId, message) {
+        if (!this.#reportedAgents.has(agentId)) {
+            this.#reportedAgents.add(agentId);
+            this.#report(message);
+        }
+    }
+}
+//# sourceMappingURL=agent-memory.js.map

package/dist/extensions/agents/memory/agent-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memory.js","sourceRoot":"","sources":["../../../../src/extensions/agents/memory/agent-memory.ts"],"names":[],"mappings":"AAQA,MAAM,SAAS,GAAoB,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAEtE,MAAM,OAAO,WAAW;IACb,QAAQ,CAAgB;IACxB,OAAO,CAA4B;IACnC,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YAAY,OAAsB,EAAE,MAAiC;QACnE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAmB,EAAE,QAA2B;QAClE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,aAAa,MAAM,mCAAmC,KAAK,CAAC,MAAM,kCAAkC,CAAC,CAAC;QAChI,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,WAAW,CAAC,OAAe,EAAE,OAAe;QAC1C,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/extensions/agents/memory/fabric-memory-backend.d.ts

@@ -0,0 +1,8 @@
+import type { McpNameRoster } from '../../../kernel/mcp-names/mcp-names.js';
+import type { MemoryBackend, MemoryScope, MemoryTools } from './memory-backend.js';
+export declare const FABRIC_SERVER_NAME = "anthara-fabric";
+export declare class FabricMemoryBackend implements MemoryBackend {
+    #private;
+    constructor(roster: McpNameRoster, sessionId: string);
+    toolsFor(scope: MemoryScope, callable: readonly string[]): MemoryTools;
+}

package/dist/extensions/agents/memory/fabric-memory-backend.js

@@ -0,0 +1,40 @@
+import { memoryInstruction } from './memory-instruction.js';
+export const FABRIC_SERVER_NAME = 'anthara-fabric';
+const FABRIC_TOOL_NAME = new RegExp(`^mcp__(?:plugin_.+_)?${FABRIC_SERVER_NAME}__(?<tool>.+)$`);
+const SEARCH = 'search_memories';
+const RECORD_PRIVATELY = 'add_private_memory';
+const RECORD_SHARED = 'add_shared_memory';
+const TOOLS_BY_SCOPE = {
+    user: [SEARCH, RECORD_PRIVATELY],
+    local: [SEARCH, RECORD_PRIVATELY],
+    project: [SEARCH, RECORD_PRIVATELY, RECORD_SHARED],
+};
+export class FabricMemoryBackend {
+    #roster;
+    #sessionId;
+    constructor(roster, sessionId) {
+        this.#roster = roster;
+        this.#sessionId = sessionId;
+    }
+    toolsFor(scope, callable) {
+        const offered = this.#fabricToolsIn(callable);
+        if (offered.size === 0) {
+            return unavailable('is not connected');
+        }
+        const missing = TOOLS_BY_SCOPE[scope].filter((tool) => !offered.has(tool));
+        return missing.length > 0 ? unavailable(`does not offer ${missing.join(', ')}`) : available(scope, offered);
+    }
+    #fabricToolsIn(callable) {
+        const named = callable.map((piName) => [FABRIC_TOOL_NAME.exec(this.#roster.claudeNameOf(this.#sessionId, piName))?.groups?.tool, piName]);
+        return new Map(named.flatMap(([tool, piName]) => (tool === undefined ? [] : [[tool, piName]])));
+    }
+}
+const unavailable = (problem) => ({ kind: 'unavailable', reason: `the ${FABRIC_SERVER_NAME} MCP server ${problem}` });
+function available(scope, offered) {
+    const named = (tool) => offered.get(tool) ?? tool;
+    const toolNames = TOOLS_BY_SCOPE[scope].map(named);
+    const recordShared = scope === 'project' ? named(RECORD_SHARED) : undefined;
+    const instruction = memoryInstruction(scope, { search: named(SEARCH), recordPrivately: named(RECORD_PRIVATELY), recordShared });
+    return { kind: 'available', toolNames, instruction };
+}
+//# sourceMappingURL=fabric-memory-backend.js.map

package/dist/extensions/agents/memory/fabric-memory-backend.js.map

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

package/dist/extensions/agents/memory/memory-backend.d.ts

@@ -0,0 +1,12 @@
+export type MemoryScope = 'user' | 'project' | 'local';
+export type MemoryTools = {
+    readonly kind: 'available';
+    readonly toolNames: readonly string[];
+    readonly instruction: string;
+} | {
+    readonly kind: 'unavailable';
+    readonly reason: string;
+};
+export interface MemoryBackend {
+    toolsFor(scope: MemoryScope, callable: readonly string[]): MemoryTools;
+}

package/dist/extensions/agents/memory/memory-backend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-backend.js.map

package/dist/extensions/agents/memory/memory-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-backend.js","sourceRoot":"","sources":["../../../../src/extensions/agents/memory/memory-backend.ts"],"names":[],"mappings":""}

package/dist/extensions/agents/memory/memory-instruction.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryScope } from './memory-backend.js';
+export interface MemoryToolNames {
+    readonly search: string;
+    readonly recordPrivately: string;
+    readonly recordShared: string | undefined;
+}
+export declare function memoryInstruction(scope: MemoryScope, tools: MemoryToolNames): string;

package/dist/extensions/agents/memory/memory-instruction.js

@@ -0,0 +1,12 @@
+export function memoryInstruction(scope, tools) {
+    const lines = [
+        '## Memory',
+        `You have persistent memory in Anthara Fabric (scope: ${scope}). Before you start, recall what is relevant to the task with ${tools.search}.`,
+        `When you finish, record each durable fact you learned, such as a decision, a convention or a correction, with ${tools.recordPrivately}: one fact per call, saying who or what it is about.`,
+        ...sharedLine(tools.recordShared),
+        'Never record secrets, credentials or personal data.',
+    ];
+    return lines.join('\n\n');
+}
+const sharedLine = (recordShared) => recordShared === undefined ? [] : [`Record a fact every teammate on this project should know with ${recordShared} instead.`];
+//# sourceMappingURL=memory-instruction.js.map

package/dist/extensions/agents/memory/memory-instruction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-instruction.js","sourceRoot":"","sources":["../../../../src/extensions/agents/memory/memory-instruction.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,KAAkB,EAAE,KAAsB;IAC1E,MAAM,KAAK,GAAG;QACZ,WAAW;QACX,wDAAwD,KAAK,iEAAiE,KAAK,CAAC,MAAM,GAAG;QAC7I,iHAAiH,KAAK,CAAC,eAAe,sDAAsD;QAC5L,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;QACjC,qDAAqD;KACtD,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,YAAgC,EAAY,EAAE,CAChE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,iEAAiE,YAAY,WAAW,CAAC,CAAC"}

package/dist/extensions/agents/model-selection.d.ts

@@ -0,0 +1,12 @@
+import type { ModelReference } from './child-session/child-session-factory.js';
+import type { SessionModelChoices } from '../../kernel/model-choice/model-choice.js';
+import type { AgentDefinition } from './roster/agent-definition.js';
+export interface SelectedModel {
+    readonly headerLabel: string;
+    readonly reference?: ModelReference;
+}
+export declare class PerCallModels {
+    #private;
+    constructor(choices: SessionModelChoices);
+    select(perCallModel: string | undefined, agent: AgentDefinition, sessionModel: ModelReference | undefined): SelectedModel;
+}

package/dist/extensions/agents/model-selection.js

@@ -0,0 +1,14 @@
+const SESSION_MODEL_LABEL = 'session model';
+export class PerCallModels {
+    #choices;
+    constructor(choices) {
+        this.#choices = choices;
+    }
+    select(perCallModel, agent, sessionModel) {
+        const choice = this.#choices.resolve(perCallModel ?? agent.declaredModel);
+        return choice.kind === 'concrete' ? selected({ provider: choice.provider, id: choice.id }) : sessionSelection(sessionModel);
+    }
+}
+const selected = (reference) => ({ headerLabel: reference.id, reference });
+const sessionSelection = (sessionModel) => sessionModel === undefined ? { headerLabel: SESSION_MODEL_LABEL } : selected(sessionModel);
+//# sourceMappingURL=model-selection.js.map

package/dist/extensions/agents/model-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../../../src/extensions/agents/model-selection.ts"],"names":[],"mappings":"AASA,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAE5C,MAAM,OAAO,aAAa;IACf,QAAQ,CAAsB;IAEvC,YAAY,OAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,YAAgC,EAAE,KAAsB,EAAE,YAAwC;QACvG,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9H,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,CAAC,SAAyB,EAAiB,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AAE1G,MAAM,gBAAgB,GAAG,CAAC,YAAwC,EAAiB,EAAE,CACnF,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC"}

package/dist/extensions/agents/preloaded-skills.d.ts

@@ -0,0 +1,7 @@
+import type { PromptCatalog } from '../../kernel/prompt-catalog/invocable.js';
+import type { AgentDefinition } from './roster/agent-definition.js';
+export declare class PreloadedSkills {
+    #private;
+    constructor(catalog: () => PromptCatalog, projectTrusted: boolean);
+    sectionFor({ skills, plugin }: AgentDefinition): string;
+}

package/dist/extensions/agents/preloaded-skills.js

@@ -0,0 +1,32 @@
+const SECTION_HEADING = '## Preloaded skills';
+const BLOCK_SEPARATOR = '\n\n';
+export class PreloadedSkills {
+    #catalog;
+    #projectTrusted;
+    constructor(catalog, projectTrusted) {
+        this.#catalog = catalog;
+        this.#projectTrusted = projectTrusted;
+    }
+    sectionFor({ skills, plugin }) {
+        if (skills.length === 0) {
+            return '';
+        }
+        const blocks = skills.map((name) => this.#blockFor(name, plugin));
+        return [SECTION_HEADING, ...blocks].join(BLOCK_SEPARATOR);
+    }
+    #blockFor(name, plugin) {
+        const skill = this.#candidates(name, plugin).find((lookup) => this.#isUsable(lookup));
+        return skill === undefined ? `<skill name="${name}">(skill not found)</skill>` : `<skill name="${name}">\n${skill.invocable.body.trim()}\n</skill>`;
+    }
+    #candidates(name, plugin) {
+        const references = plugin === undefined ? [name] : [`${plugin}:${name}`, name];
+        return references.map((reference) => this.#catalog().find(reference));
+    }
+    #isUsable(lookup) {
+        return lookup.kind === 'found' && lookup.invocable.kind === 'skill' && this.#mayRead(lookup.invocable);
+    }
+    #mayRead({ scope }) {
+        return scope !== 'project' || this.#projectTrusted;
+    }
+}
+//# sourceMappingURL=preloaded-skills.js.map

package/dist/extensions/agents/preloaded-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloaded-skills.js","sourceRoot":"","sources":["../../../src/extensions/agents/preloaded-skills.ts"],"names":[],"mappings":"AAIA,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,eAAe,GAAG,MAAM,CAAC;AAI/B,MAAM,OAAO,eAAe;IACjB,QAAQ,CAAsB;IAC9B,eAAe,CAAU;IAElC,YAAY,OAA4B,EAAE,cAAuB;QAC/D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAmB;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,eAAe,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,MAA0B;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAwB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5G,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,IAAI,6BAA6B,CAAC,CAAC,CAAC,gBAAgB,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;IACtJ,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,MAA0B;QAClD,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC/E,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,SAAS,CAAC,MAAuB;QAC/B,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzG,CAAC;IAED,QAAQ,CAAC,EAAE,KAAK,EAAkB;QAChC,OAAO,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;IACrD,CAAC;CACF"}