@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/errors/anthara-error.d.ts

@@ -0,0 +1,3 @@
+export declare abstract class AntharaError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}

package/dist/errors/anthara-error.js

@@ -0,0 +1,7 @@
+export class AntharaError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+//# sourceMappingURL=anthara-error.js.map

package/dist/errors/anthara-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthara-error.js","sourceRoot":"","sources":["../../src/errors/anthara-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,YAAa,SAAQ,KAAK;IAC9C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+import type { AgentOutcome } from '../../kernel/agent-runner/agent-outcome.js';
+import type { ParentContext, ReadOnlyAgentTask, SubAgentRequest, SubAgentRunner } from '../../kernel/agent-runner/sub-agent-runner.js';
+import { type SubagentHooks } from '../../kernel/subagent-hooks/subagent-hooks-slot.js';
+import { type BackgroundRuns } from './background-runs.js';
+import type { InProcessAgentRunner } from './child-session/in-process-agent-runner.js';
+import type { RunPlanner } from './run-planner.js';
+import type { WorktreeIsolation } from './worktrees/worktree-isolation.js';
+export interface AgentRequest extends SubAgentRequest {
+    readonly runInBackground?: boolean;
+}
+export interface DispatcherCollaborators {
+    readonly planner: RunPlanner;
+    readonly runner: InProcessAgentRunner;
+    readonly background: BackgroundRuns;
+    readonly worktrees: WorktreeIsolation;
+    readonly hooks?: () => SubagentHooks;
+}
+export interface StartedRun {
+    readonly id: string;
+    readonly agent: string;
+}
+export declare class AgentDispatcher implements SubAgentRunner {
+    #private;
+    constructor({ planner, runner, background, worktrees, hooks }: DispatcherCollaborators);
+    runsInBackground({ subagentType, runInBackground }: AgentRequest): boolean;
+    run(request: AgentRequest, parent: ParentContext, signal: AbortSignal | undefined): Promise<AgentOutcome>;
+    runReadOnly(task: ReadOnlyAgentTask, parent: ParentContext, signal: AbortSignal | undefined): Promise<AgentOutcome>;
+    start(request: AgentRequest, parent: ParentContext): StartedRun;
+}

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

@@ -0,0 +1,73 @@
+import { NO_SUBAGENT_HOOKS } from '../../kernel/subagent-hooks/subagent-hooks-slot.js';
+import { newRunId } from './background-runs.js';
+import { WorktreeUnavailableError } from './errors.js';
+const PROMPT_SECTION_SEPARATOR = '\n\n';
+export class AgentDispatcher {
+    #planner;
+    #runner;
+    #background;
+    #worktrees;
+    #hooks;
+    constructor({ planner, runner, background, worktrees, hooks = () => NO_SUBAGENT_HOOKS }) {
+        this.#planner = planner;
+        this.#runner = runner;
+        this.#background = background;
+        this.#worktrees = worktrees;
+        this.#hooks = hooks;
+    }
+    runsInBackground({ subagentType, runInBackground }) {
+        const declared = this.#planner.agentFor(subagentType).background === true;
+        return runInBackground === true || declared;
+    }
+    run(request, parent, signal) {
+        return this.#runPlanned(this.#planner.plan(request, parent), newRunId(), signal);
+    }
+    runReadOnly(task, parent, signal) {
+        return this.#runner.run(this.#planner.planReadOnly(task, parent), signal);
+    }
+    // no abort signal: a background run outlives the turn that started it
+    start(request, parent) {
+        const planned = this.#planner.plan(request, parent);
+        const id = newRunId();
+        this.#background.track(id, request.description, this.#runPlanned(planned, id, undefined));
+        return { id, agent: planned.agent.id };
+    }
+    async #runPlanned(planned, runId, signal) {
+        const hooks = this.#hooks();
+        const subagent = { agentId: runId, agentType: planned.agent.id };
+        const outcome = await this.#runIsolated(briefed(planned, await hooks.start(subagent)), runId, signal);
+        await hooks.stop({ ...subagent, ...(outcome.kind === 'completed' ? { lastAssistantMessage: outcome.text } : {}) });
+        return outcome;
+    }
+    async #runIsolated(planned, runId, signal) {
+        if (planned.agent.isolation !== 'worktree') {
+            return this.#runner.run(planned, signal);
+        }
+        const opened = await this.#open(planned.parent.cwd, runId);
+        return opened.kind === 'unavailable' ? unavailableOutcome(planned, opened.reason) : this.#runInWorktree(planned, opened.worktree, signal);
+    }
+    async #open(repo, runId) {
+        try {
+            return { kind: 'opened', worktree: await this.#worktrees.open(repo, runId) };
+        }
+        catch (error) {
+            if (error instanceof WorktreeUnavailableError) {
+                return { kind: 'unavailable', reason: error.message };
+            }
+            throw error;
+        }
+    }
+    async #runInWorktree(planned, worktree, signal) {
+        const outcome = await this.#runner.run({ ...planned, workingFolder: worktree.path }, signal);
+        const closure = await this.#worktrees.close(worktree);
+        return closure.kind === 'kept' ? { ...outcome, keptWorktree: closure.path } : outcome;
+    }
+}
+const briefed = (planned, contexts) => ({ ...planned, prompt: [planned.prompt, ...contexts].join(PROMPT_SECTION_SEPARATOR) });
+const unavailableOutcome = ({ agent, model }, reason) => ({
+    kind: 'failed',
+    agent: agent.id,
+    model: model.headerLabel,
+    reason,
+});
+//# sourceMappingURL=agent-dispatcher.js.map

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

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

package/dist/extensions/agents/agent-result-text.d.ts

@@ -0,0 +1,7 @@
+import type { CompletedRun, FailedRun } from '../../kernel/agent-runner/agent-outcome.js';
+import type { StartedRun } from './agent-dispatcher.js';
+import type { FinishedRun } from './background-runs.js';
+export declare const completedRunText: (run: CompletedRun) => string;
+export declare const failedRunText: (run: FailedRun) => string;
+export declare const backgroundStartedText: ({ id, agent }: StartedRun) => string;
+export declare function backgroundFinishedText({ id, description, outcome }: FinishedRun): string;

package/dist/extensions/agents/agent-result-text.js

@@ -0,0 +1,13 @@
+const runHeader = ({ agent, model }) => `[${agent} · ${model}]`;
+const keptWorktreeNote = ({ keptWorktree }) => keptWorktree === undefined ? '' : `\n\nThe agent changed files, so its git worktree was kept at ${keptWorktree}.`;
+export const completedRunText = (run) => `${runHeader(run)}\n\n${run.text}${keptWorktreeNote(run)}`;
+export const failedRunText = (run) => `The ${run.agent} agent failed: ${run.reason}${keptWorktreeNote(run)}`;
+export const backgroundStartedText = ({ id, agent }) => `Started ${agent} in the background as run ${id}. ` +
+    'A notice arrives in this conversation when it finishes; carry on with other work meanwhile.';
+export function backgroundFinishedText({ id, description, outcome }) {
+    const run = `Background run ${id} (${description})`;
+    return outcome.kind === 'completed'
+        ? `${run} finished.\n\n${completedRunText(outcome)}`
+        : `${run} did not finish. ${failedRunText(outcome)}`;
+}
+//# sourceMappingURL=agent-result-text.js.map

package/dist/extensions/agents/agent-result-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-result-text.js","sourceRoot":"","sources":["../../../src/extensions/agents/agent-result-text.ts"],"names":[],"mappings":"AAIA,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAA4B,EAAU,EAAE,CAAC,IAAI,KAAK,MAAM,KAAK,GAAG,CAAC;AAElG,MAAM,gBAAgB,GAAG,CAAC,EAAE,YAAY,EAA4B,EAAU,EAAE,CAC9E,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gEAAgE,YAAY,GAAG,CAAC;AAEpH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAiB,EAAU,EAAE,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAE1H,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAc,EAAU,EAAE,CAAC,OAAO,GAAG,CAAC,KAAK,kBAAkB,GAAG,CAAC,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAEhI,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAc,EAAU,EAAE,CACzE,WAAW,KAAK,6BAA6B,EAAE,IAAI;IACnD,6FAA6F,CAAC;AAEhG,MAAM,UAAU,sBAAsB,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAe;IAC9E,MAAM,GAAG,GAAG,kBAAkB,EAAE,KAAK,WAAW,GAAG,CAAC;IACpD,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW;QACjC,CAAC,CAAC,GAAG,GAAG,iBAAiB,gBAAgB,CAAC,OAAO,CAAC,EAAE;QACpD,CAAC,CAAC,GAAG,GAAG,oBAAoB,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,9 @@
+import { Type, type Static } from 'typebox';
+export declare const ClaudeAgentParams: Type.TObject<{
+    description: Type.TString;
+    prompt: Type.TString;
+    subagent_type: Type.TString;
+    model: Type.TOptional<Type.TString>;
+    run_in_background: Type.TOptional<Type.TBoolean>;
+}>;
+export type AgentInput = Static<typeof ClaudeAgentParams>;

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

@@ -0,0 +1,12 @@
+import { Type } from 'typebox';
+export const ClaudeAgentParams = Type.Object({
+    description: Type.String({ description: 'A short (3-5 word) description of the task' }),
+    prompt: Type.String({ description: 'The task for the agent to perform' }),
+    subagent_type: Type.String({ description: 'The type of specialized agent to use for this task' }),
+    model: Type.Optional(Type.String({
+        description: 'Optional model for this agent: sonnet, opus, haiku or fable for the newest model of that tier, inherit for ' +
+            "this session's model, or a concrete model id. Takes precedence over the agent definition's model.",
+    })),
+    run_in_background: Type.Optional(Type.Boolean({ description: 'Set to true to run this agent in the background. You are notified when it completes.' })),
+});
+//# sourceMappingURL=agent-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-schema.js","sourceRoot":"","sources":["../../../src/extensions/agents/agent-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;IACvF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;IACzE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC;IACjG,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,6GAA6G;YAC7G,mGAAmG;KACtG,CAAC,CACH;IACD,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAC9B,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,sFAAsF,EAAE,CAAC,CACtH;CACF,CAAC,CAAC"}

package/dist/extensions/agents/background-runs.d.ts

@@ -0,0 +1,12 @@
+import type { AgentOutcome } from '../../kernel/agent-runner/agent-outcome.js';
+export interface FinishedRun {
+    readonly id: string;
+    readonly description: string;
+    readonly outcome: AgentOutcome;
+}
+export declare const newRunId: () => string;
+export declare class BackgroundRuns {
+    private readonly notify;
+    constructor(notify: (run: FinishedRun) => void);
+    track(id: string, description: string, work: Promise<AgentOutcome>): void;
+}

package/dist/extensions/agents/background-runs.js

@@ -0,0 +1,20 @@
+import { randomUUID } from 'node:crypto';
+const RUN_ID_PREFIX = 'agent-';
+const RUN_ID_LENGTH = 8;
+export const newRunId = () => `${RUN_ID_PREFIX}${randomUUID().replaceAll('-', '').slice(0, RUN_ID_LENGTH)}`;
+export class BackgroundRuns {
+    notify;
+    constructor(notify) {
+        this.notify = notify;
+    }
+    // the work never rejects (a failure is an outcome); a notice that cannot be delivered is dropped, because the
+    // session that asked was replaced and a rejection here would be unhandled and end the whole pi process
+    track(id, description, work) {
+        work
+            .then((outcome) => {
+            this.notify({ id, description, outcome });
+        })
+            .catch(() => undefined);
+    }
+}
+//# sourceMappingURL=background-runs.js.map

package/dist/extensions/agents/background-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-runs.js","sourceRoot":"","sources":["../../../src/extensions/agents/background-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAC/B,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC;AAEpH,MAAM,OAAO,cAAc;IACR,MAAM,CAA6B;IAEpD,YAAY,MAAkC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,8GAA8G;IAC9G,uGAAuG;IACvG,KAAK,CAAC,EAAU,EAAE,WAAmB,EAAE,IAA2B;QAChE,IAAI;aACD,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YAChB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/extensions/agents/built-in/built-in-agents.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from '../roster/agent-definition.js';
+export declare const BUILT_IN_AGENTS: readonly AgentDefinition[];

package/dist/extensions/agents/built-in/built-in-agents.js

@@ -0,0 +1,56 @@
+const READ_ONLY_TOOLS = ['read', 'grep', 'find', 'ls'];
+const EXPLORE_PROMPT = [
+    'You are an exploration agent. Quickly investigate the codebase and return structured findings that another agent can use without re-reading everything.',
+    '',
+    'You must NOT make any changes: only read, search, and summarize.',
+    '',
+    'Your output goes to an agent who has NOT seen the files you explored. Report:',
+    '',
+    '1. Relevant files with paths and one-line roles',
+    '2. Key functions/types with `file:line` references',
+    '3. How the pieces connect (data flow, call flow)',
+    '4. Anything surprising or risky',
+    '',
+    'Be selective: compressed, load-bearing findings beat exhaustive dumps.',
+].join('\n');
+const PLAN_PROMPT = [
+    'You are a planning specialist. You receive context and requirements, then produce a clear implementation plan.',
+    '',
+    'You must NOT make any changes: only read, analyze, and plan.',
+    '',
+    'Deliver:',
+    '',
+    '1. Step-by-step plan, each step small and independently verifiable',
+    '2. Files to touch per step, with `file:line` anchors where known',
+    '3. Risks and open questions, each with a suggested resolution',
+    '4. What to test and how the tests would fail without the change',
+].join('\n');
+const GENERAL_PURPOSE_PROMPT = [
+    'You are a general-purpose agent with full capabilities, operating in an isolated context window to handle delegated tasks without polluting the main conversation.',
+    '',
+    'Work autonomously to complete the assigned task, using the available tools as needed.',
+    '',
+    'When finished, report: what was done, what was verified (commands run, tests passed), and anything the delegator must know (caveats, follow-ups, files changed).',
+].join('\n');
+const readOnlyBuiltIn = (id, description, systemPrompt) => ({
+    id,
+    description,
+    systemPrompt,
+    tools: READ_ONLY_TOOLS,
+    disallowedTools: [],
+    skills: [],
+    skipsContextFiles: true,
+});
+export const BUILT_IN_AGENTS = [
+    readOnlyBuiltIn('Explore', 'Fast read-only codebase exploration that returns compressed findings', EXPLORE_PROMPT),
+    readOnlyBuiltIn('Plan', 'Designs implementation plans from context and requirements, read-only', PLAN_PROMPT),
+    {
+        id: 'general-purpose',
+        description: 'General-purpose agent with full capabilities in an isolated context',
+        systemPrompt: GENERAL_PURPOSE_PROMPT,
+        disallowedTools: [],
+        skills: [],
+        skipsContextFiles: false,
+    },
+];
+//# sourceMappingURL=built-in-agents.js.map

package/dist/extensions/agents/built-in/built-in-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-agents.js","sourceRoot":"","sources":["../../../../src/extensions/agents/built-in/built-in-agents.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAEvD,MAAM,cAAc,GAAG;IACrB,yJAAyJ;IACzJ,EAAE;IACF,kEAAkE;IAClE,EAAE;IACF,+EAA+E;IAC/E,EAAE;IACF,iDAAiD;IACjD,oDAAoD;IACpD,kDAAkD;IAClD,iCAAiC;IACjC,EAAE;IACF,wEAAwE;CACzE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,WAAW,GAAG;IAClB,gHAAgH;IAChH,EAAE;IACF,8DAA8D;IAC9D,EAAE;IACF,UAAU;IACV,EAAE;IACF,oEAAoE;IACpE,kEAAkE;IAClE,+DAA+D;IAC/D,iEAAiE;CAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,sBAAsB,GAAG;IAC7B,oKAAoK;IACpK,EAAE;IACF,uFAAuF;IACvF,EAAE;IACF,kKAAkK;CACnK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,WAAmB,EAAE,YAAoB,EAAmB,EAAE,CAAC,CAAC;IACnG,EAAE;IACF,WAAW;IACX,YAAY;IACZ,KAAK,EAAE,eAAe;IACtB,eAAe,EAAE,EAAE;IACnB,MAAM,EAAE,EAAE;IACV,iBAAiB,EAAE,IAAI;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAA+B;IACzD,eAAe,CAAC,SAAS,EAAE,sEAAsE,EAAE,cAAc,CAAC;IAClH,eAAe,CAAC,MAAM,EAAE,uEAAuE,EAAE,WAAW,CAAC;IAC7G;QACE,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,qEAAqE;QAClF,YAAY,EAAE,sBAAsB;QACpC,eAAe,EAAE,EAAE;QACnB,MAAM,EAAE,EAAE;QACV,iBAAiB,EAAE,KAAK;KACzB;CACF,CAAC"}

package/dist/extensions/agents/built-in/read-only-agent.d.ts

@@ -0,0 +1,3 @@
+import type { ReadOnlyAgentTask } from '../../../kernel/agent-runner/sub-agent-runner.js';
+import type { AgentDefinition } from '../roster/agent-definition.js';
+export declare const readOnlyAgent: ({ name, systemPrompt }: ReadOnlyAgentTask) => AgentDefinition;

package/dist/extensions/agents/built-in/read-only-agent.js

@@ -0,0 +1,11 @@
+const READ_ONLY_TOOLS = ['Read', 'Grep', 'Glob'];
+export const readOnlyAgent = ({ name, systemPrompt }) => ({
+    id: name,
+    description: name,
+    systemPrompt,
+    tools: READ_ONLY_TOOLS,
+    disallowedTools: [],
+    skills: [],
+    skipsContextFiles: false,
+});
+//# sourceMappingURL=read-only-agent.js.map

package/dist/extensions/agents/built-in/read-only-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-agent.js","sourceRoot":"","sources":["../../../../src/extensions/agents/built-in/read-only-agent.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,EAAqB,EAAmB,EAAE,CAAC,CAAC;IAC5F,EAAE,EAAE,IAAI;IACR,WAAW,EAAE,IAAI;IACjB,YAAY;IACZ,KAAK,EAAE,eAAe;IACtB,eAAe,EAAE,EAAE;IACnB,MAAM,EAAE,EAAE;IACV,iBAAiB,EAAE,KAAK;CACzB,CAAC,CAAC"}

package/dist/extensions/agents/child-session/child-resource-loader.d.ts

@@ -0,0 +1,3 @@
+import { DefaultResourceLoader, type SettingsManager } from '@earendil-works/pi-coding-agent';
+import type { ChildSessionSpec } from './child-session-factory.js';
+export declare function childResourceLoader(spec: ChildSessionSpec, agentDir: string, settingsManager: SettingsManager): DefaultResourceLoader;

package/dist/extensions/agents/child-session/child-resource-loader.js

@@ -0,0 +1,22 @@
+import { DefaultResourceLoader } from '@earendil-works/pi-coding-agent';
+export function childResourceLoader(spec, agentDir, settingsManager) {
+    return new DefaultResourceLoader({
+        cwd: spec.cwd,
+        agentDir,
+        settingsManager,
+        noExtensions: true,
+        noSkills: true,
+        noPromptTemplates: true,
+        noThemes: true,
+        noContextFiles: spec.skipsContextFiles,
+        ...promptOverrides(spec),
+    });
+}
+// the plain systemPrompt and appendSystemPrompt options read their value as a file whenever a file of that name exists
+function promptOverrides({ systemPrompt, appendedPrompt }) {
+    return {
+        ...(systemPrompt === '' ? {} : { systemPromptOverride: () => systemPrompt }),
+        ...(appendedPrompt === '' ? {} : { appendSystemPromptOverride: (discovered) => [...discovered, appendedPrompt] }),
+    };
+}
+//# sourceMappingURL=child-resource-loader.js.map

package/dist/extensions/agents/child-session/child-resource-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-resource-loader.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/child-resource-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,iCAAiC,CAAC;AAK9F,MAAM,UAAU,mBAAmB,CAAC,IAAsB,EAAE,QAAgB,EAAE,eAAgC;IAC5G,OAAO,IAAI,qBAAqB,CAAC;QAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ;QACR,eAAe;QACf,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;QACvB,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,IAAI,CAAC,iBAAiB;QACtC,GAAG,eAAe,CAAC,IAAI,CAAC;KACzB,CAAC,CAAC;AACL,CAAC;AAED,uHAAuH;AACvH,SAAS,eAAe,CAAC,EAAE,YAAY,EAAE,cAAc,EAAoB;IACzE,OAAO;QACL,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC;QAC5E,GAAG,CAAC,cAAc,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,0BAA0B,EAAE,CAAC,UAAoB,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;KAC5H,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,39 @@
+import type { ExtensionContext, ToolDefinition } from '@earendil-works/pi-coding-agent';
+export interface ModelReference {
+    readonly provider: string;
+    readonly id: string;
+}
+type ThinkingLevel = NonNullable<ExtensionContext['thinkingLevel']>;
+export interface ChildSessionSpec {
+    readonly cwd: string;
+    readonly systemPrompt: string;
+    readonly appendedPrompt: string;
+    readonly skipsContextFiles: boolean;
+    readonly toolNames: readonly string[];
+    readonly tools: readonly ToolDefinition[];
+    readonly model?: ModelReference;
+    readonly thinkingLevel?: ThinkingLevel;
+}
+export interface ChildTurn {
+    readonly continues: boolean;
+}
+export type ChildAnswer = {
+    readonly kind: 'text';
+    readonly text: string;
+} | {
+    readonly kind: 'error';
+    readonly reason: string;
+} | {
+    readonly kind: 'silent';
+};
+export interface ChildSession {
+    prompt(task: string): Promise<void>;
+    onTurnEnd(listener: (turn: ChildTurn) => void): void;
+    abort(): Promise<void>;
+    answer(): ChildAnswer;
+    dispose(): void;
+}
+export interface ChildSessionFactory {
+    create(spec: ChildSessionSpec): Promise<ChildSession>;
+}
+export {};

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=child-session-factory.js.map

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

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

package/dist/extensions/agents/child-session/child-todo-list.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
+export declare const CHILD_TODO_WRITE = "TodoWrite";
+export declare function childTodoWriteTool(): ToolDefinition;

package/dist/extensions/agents/child-session/child-todo-list.js

@@ -0,0 +1,21 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { assertReplaceable } from '../../../kernel/todo-list/todo-list-rules.js';
+import { TODO_WRITTEN_TEXT } from '../../../kernel/todo-list/todo-result-text.js';
+import { TodoWriteParams } from '../../../kernel/todo-list/todo-schema.js';
+import { TODO_WRITE_DESCRIPTION } from '../../../kernel/todo-list/todo-write-description.js';
+import { textResult } from '../../../kernel/tool-results/tool-result.js';
+export const CHILD_TODO_WRITE = 'TodoWrite';
+export function childTodoWriteTool() {
+    return defineTool({
+        name: CHILD_TODO_WRITE,
+        label: CHILD_TODO_WRITE,
+        description: TODO_WRITE_DESCRIPTION,
+        parameters: TodoWriteParams,
+        execute: async (_toolCallId, { todos }) => Promise.resolve(acknowledged(todos)),
+    });
+}
+function acknowledged(todos) {
+    assertReplaceable(todos);
+    return textResult(TODO_WRITTEN_TEXT);
+}
+//# sourceMappingURL=child-todo-list.js.map

package/dist/extensions/agents/child-session/child-todo-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-todo-list.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/child-todo-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,eAAe,EAAiB,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAEzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,sBAAsB;QACnC,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;KAChF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAA0B;IAC9C,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC"}

package/dist/extensions/agents/child-session/child-tools.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from '@earendil-works/pi-coding-agent';
+import type { ParentContext } from '../../../kernel/agent-runner/sub-agent-runner.js';
+import type { AgentDefinition } from '../roster/agent-definition.js';
+export interface ChildTools {
+    readonly toolNames: readonly string[];
+    readonly tools: readonly ToolDefinition[];
+}
+export interface ChildToolsRequest {
+    readonly agent: AgentDefinition;
+    readonly parent: ParentContext;
+    readonly extraToolNames: readonly string[];
+    readonly workingFolder?: string;
+}
+export declare function childToolsFor({ agent, parent, extraToolNames, workingFolder }: ChildToolsRequest): ChildTools;

package/dist/extensions/agents/child-session/child-tools.js

@@ -0,0 +1,16 @@
+import { CHILD_TODO_WRITE, childTodoWriteTool } from './child-todo-list.js';
+import { argumentsInFolder } from './folder-arguments.js';
+import { bridgeParentTools } from './parent-tool-bridge.js';
+import { selectChildTools } from './tool-selection.js';
+export function childToolsFor({ agent, parent, extraToolNames, workingFolder }) {
+    const callable = parent.tools ?? [];
+    const toolNames = [...new Set([...selectChildTools(agent, callable.map(({ name }) => name)), ...extraToolNames])];
+    const bridged = { callable, names: toolNames.filter((name) => name !== CHILD_TODO_WRITE), ...argumentsIn(workingFolder) };
+    return { toolNames, tools: [...bridgedTools(bridged, parent.executeTool), ...childOwnTools(toolNames)] };
+}
+function bridgedTools(bridged, executeTool) {
+    return executeTool === undefined ? [] : bridgeParentTools({ ...bridged, executeTool });
+}
+const argumentsIn = (folder) => folder === undefined ? {} : { argumentsFor: (toolName, params) => argumentsInFolder(toolName, params, folder) };
+const childOwnTools = (names) => (names.includes(CHILD_TODO_WRITE) ? [childTodoWriteTool()] : []);
+//# sourceMappingURL=child-tools.js.map

package/dist/extensions/agents/child-session/child-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-tools.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/child-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAyB,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAcvD,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAqB;IAC/F,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAClH,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,gBAAgB,CAAC,EAAE,GAAG,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC;IAC1H,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;AAC3G,CAAC;AAED,SAAS,YAAY,CAAC,OAA8C,EAAE,WAAoC;IACxG,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,MAA0B,EAA0C,EAAE,CACzF,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;AAElH,MAAM,aAAa,GAAG,CAAC,KAAwB,EAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/dist/extensions/agents/child-session/folder-arguments.d.ts

@@ -0,0 +1 @@
+export declare function argumentsInFolder(toolName: string, params: unknown, folder: string): unknown;

package/dist/extensions/agents/child-session/folder-arguments.js

@@ -0,0 +1,16 @@
+import { resolve } from 'node:path';
+const PATH_TOOLS = new Set(['read', 'write', 'edit', 'grep', 'find', 'ls']);
+const SHELL_TOOL = 'bash';
+export function argumentsInFolder(toolName, params, folder) {
+    return isArguments(params) ? rebased(toolName, params, folder) : params;
+}
+function rebased(toolName, params, folder) {
+    if (PATH_TOOLS.has(toolName)) {
+        return { ...params, path: resolve(folder, typeof params.path === 'string' ? params.path : '.') };
+    }
+    return toolName === SHELL_TOOL ? startedIn(folder, params) : params;
+}
+const startedIn = (folder, params) => typeof params.command === 'string' ? { ...params, command: `${changeDirectory(folder)}\n${params.command}` } : params;
+const isArguments = (params) => typeof params === 'object' && params !== null && !Array.isArray(params);
+const changeDirectory = (folder) => `cd '${folder.replaceAll("'", "'\\''")}' || exit 1`;
+//# sourceMappingURL=folder-arguments.js.map

package/dist/extensions/agents/child-session/folder-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-arguments.js","sourceRoot":"","sources":["../../../../src/extensions/agents/child-session/folder-arguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACjG,MAAM,UAAU,GAAG,MAAM,CAAC;AAI1B,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,MAAe,EAAE,MAAc;IACjF,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1E,CAAC;AAED,SAAS,OAAO,CAAC,QAAgB,EAAE,MAAiB,EAAE,MAAc;IAClE,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACnG,CAAC;IACD,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACtE,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,MAAiB,EAAa,EAAE,CACjE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAExH,MAAM,WAAW,GAAG,CAAC,MAAe,EAAuB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtI,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,CAAC"}

package/dist/extensions/agents/child-session/in-process-agent-runner.d.ts

@@ -0,0 +1,20 @@
+import type { AgentOutcome } from '../../../kernel/agent-runner/agent-outcome.js';
+import type { ParentContext } from '../../../kernel/agent-runner/sub-agent-runner.js';
+import type { MemoryProvision } from '../memory/agent-memory.js';
+import type { SelectedModel } from '../model-selection.js';
+import type { AgentDefinition } from '../roster/agent-definition.js';
+import type { ChildSessionFactory } from './child-session-factory.js';
+export interface AgentRunRequest {
+    readonly agent: AgentDefinition;
+    readonly model: SelectedModel;
+    readonly prompt: string;
+    readonly preloadedSkills: string;
+    readonly memory: MemoryProvision;
+    readonly parent: ParentContext;
+    readonly workingFolder?: string;
+}
+export declare class InProcessAgentRunner {
+    #private;
+    constructor(children: ChildSessionFactory);
+    run(request: AgentRunRequest, signal: AbortSignal | undefined): Promise<AgentOutcome>;
+}

package/dist/extensions/agents/child-session/in-process-agent-runner.js

@@ -0,0 +1,94 @@
+import { childToolsFor } from './child-tools.js';
+import { TurnCap } from './turn-cap.js';
+const PROMPT_SECTION_SEPARATOR = '\n\n';
+const CANCELLED = 'it was cancelled';
+const NO_FINAL_MESSAGE = 'it ended without a final message';
+const CANCELLED_ENDING = { kind: 'stopped', reason: CANCELLED };
+const isCancelled = (signal) => signal?.aborted === true;
+export class InProcessAgentRunner {
+    #children;
+    constructor(children) {
+        this.#children = children;
+    }
+    async run(request, signal) {
+        const outcomes = new RunOutcomes(request);
+        if (isCancelled(signal)) {
+            return outcomes.failed(CANCELLED);
+        }
+        try {
+            const child = await this.#children.create(childSpecFor(request));
+            return outcomes.from(await runToTheEnd(child, request, signal));
+        }
+        catch (error) {
+            return outcomes.failed(isCancelled(signal) ? CANCELLED : reasonOf(error));
+        }
+    }
+}
+function childSpecFor({ agent, model, preloadedSkills, memory, parent, workingFolder }) {
+    return {
+        cwd: workingFolder ?? parent.cwd,
+        systemPrompt: agent.systemPrompt,
+        appendedPrompt: [preloadedSkills, memory.instruction].filter((section) => section !== '').join(PROMPT_SECTION_SEPARATOR),
+        skipsContextFiles: agent.skipsContextFiles,
+        ...childToolsFor({ agent, parent, extraToolNames: memory.toolNames, ...(workingFolder === undefined ? {} : { workingFolder }) }),
+        ...(model.reference === undefined ? {} : { model: model.reference }),
+        ...(parent.thinkingLevel === undefined ? {} : { thinkingLevel: parent.thinkingLevel }),
+    };
+}
+async function runToTheEnd(child, request, signal) {
+    try {
+        return await watchedRun(child, request, signal);
+    }
+    finally {
+        child.dispose();
+    }
+}
+async function watchedRun(child, { agent, prompt }, signal) {
+    const stop = () => {
+        void child.abort();
+    };
+    const cap = new TurnCap(agent.maxTurns, stop);
+    child.onTurnEnd((turn) => {
+        cap.count(turn);
+    });
+    signal?.addEventListener('abort', stop, { once: true });
+    try {
+        await child.prompt(prompt);
+    }
+    finally {
+        signal?.removeEventListener('abort', stop);
+    }
+    return endingOf(child, cap, signal);
+}
+function endingOf(child, cap, signal) {
+    if (isCancelled(signal)) {
+        return CANCELLED_ENDING;
+    }
+    return cap.isReached() ? { kind: 'stopped', reason: `stopped after ${String(cap.limit)} turns` } : { kind: 'answered', answer: child.answer() };
+}
+const reasonOf = (error) => (error instanceof Error ? error.message : String(error));
+class RunOutcomes {
+    #agent;
+    #model;
+    constructor({ agent, model }) {
+        this.#agent = agent.id;
+        this.#model = model.headerLabel;
+    }
+    from(ending) {
+        return ending.kind === 'stopped' ? this.failed(ending.reason) : this.#fromAnswer(ending.answer);
+    }
+    failed(reason) {
+        return { kind: 'failed', agent: this.#agent, model: this.#model, reason };
+    }
+    #fromAnswer(answer) {
+        if (answer.kind === 'error') {
+            return this.failed(answer.reason);
+        }
+        const text = answer.kind === 'text' ? answer.text.trim() : '';
+        return text === '' ? this.failed(NO_FINAL_MESSAGE) : this.#completed(text);
+    }
+    #completed(text) {
+        return { kind: 'completed', agent: this.#agent, model: this.#model, text };
+    }
+}
+//# sourceMappingURL=in-process-agent-runner.js.map

package/dist/extensions/agents/child-session/in-process-agent-runner.js.map

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