@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/hooks/runners/http-runner.js

@@ -0,0 +1,42 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/hooks/runners.ts.
+import { isJsonObject, parseJson } from '../../../kernel/private-files/private-files.js';
+const OUTPUT_LIMIT = 1_000_000;
+const HEADER_VARIABLE = /\$(?:\{([A-Za-z_]\w*)\}|([A-Za-z_]\w*))/g;
+const TIMEOUT_ERRORS = new Set(['TimeoutError', 'AbortError']);
+const JSON_CONTENT = { 'content-type': 'application/json' };
+export const httpRunner = {
+    run: async (handler, payload, context) => {
+        try {
+            const response = await fetch(handler.url, { method: 'POST', headers: { ...JSON_CONTENT, ...resolvedHeaders(handler) }, body: JSON.stringify(payload), ...deadline(context.timeoutMs) });
+            return await runOf(response);
+        }
+        catch (error) {
+            return failureOf(error, context.timeoutMs);
+        }
+    },
+};
+function resolvedHeaders({ headers, allowedEnvVars }) {
+    const allowed = new Set(allowedEnvVars);
+    const resolve = (value) => value.replace(HEADER_VARIABLE, (_reference, braced, bare) => {
+        const name = braced ?? bare ?? '';
+        return allowed.has(name) ? (process.env[name] ?? '') : '';
+    });
+    return Object.fromEntries(Object.entries(headers).map(([name, value]) => [name, resolve(value)]));
+}
+const deadline = (timeoutMs) => (timeoutMs === undefined ? {} : { signal: AbortSignal.timeout(timeoutMs) });
+async function runOf(response) {
+    const body = (await response.text()).slice(0, OUTPUT_LIMIT);
+    if (!response.ok) {
+        return { kind: 'failed', reason: `HTTP ${String(response.status)}` };
+    }
+    if (body.trim() === '') {
+        return { kind: 'exited', exitCode: 0, stdout: '', stderr: '' };
+    }
+    const parsed = parseJson(body);
+    return parsed.kind === 'parsed' && isJsonObject(parsed.value) ? { kind: 'exited', exitCode: 0, stdout: body, stderr: '' } : { kind: 'failed', reason: 'the reply is not a JSON object' };
+}
+function failureOf(error, timeoutMs) {
+    const timedOut = error instanceof Error && TIMEOUT_ERRORS.has(error.name);
+    return timedOut && timeoutMs !== undefined ? { kind: 'timed-out', afterMs: timeoutMs } : { kind: 'failed', reason: 'the request did not complete' };
+}
+//# sourceMappingURL=http-runner.js.map

package/dist/extensions/hooks/runners/http-runner.js.map

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

package/dist/extensions/hooks/runners/pi-hook-agents.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { HookAgents } from './hook-runner.js';
+type AgentSource = Pick<ExtensionContext, 'cwd' | 'model' | 'modelRegistry' | 'thinkingLevel' | 'sessionManager'>;
+export declare function piHookAgents(ctx: AgentSource): HookAgents;
+export {};

package/dist/extensions/hooks/runners/pi-hook-agents.js

@@ -0,0 +1,18 @@
+import { agentRunnerFor } from '../../../kernel/agent-runner/agent-runner-slot.js';
+import { AgentHookRunFailedError, NoSubAgentAvailableError } from './errors.js';
+export function piHookAgents(ctx) {
+    return {
+        ask: async (question, signal) => {
+            const lookup = agentRunnerFor(ctx.sessionManager.getSessionId());
+            if (lookup.kind === 'unavailable') {
+                throw new NoSubAgentAvailableError();
+            }
+            const outcome = await lookup.runner.runReadOnly(question, ctx, signal);
+            if (outcome.kind === 'failed') {
+                throw new AgentHookRunFailedError(outcome.reason);
+            }
+            return outcome.text;
+        },
+    };
+}
+//# sourceMappingURL=pi-hook-agents.js.map

package/dist/extensions/hooks/runners/pi-hook-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-hook-agents.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/pi-hook-agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAKhF,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBAClC,MAAM,IAAI,wBAAwB,EAAE,CAAC;YACvC,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACvE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extensions/hooks/runners/pi-hook-models.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { HookModels } from './hook-runner.js';
+type ModelSource = Pick<ExtensionContext, 'model' | 'modelRegistry'>;
+export declare function piHookModels(ctx: ModelSource): HookModels;
+export {};

package/dist/extensions/hooks/runners/pi-hook-models.js

@@ -0,0 +1,16 @@
+const FAILED_STOP_REASONS = new Set(['error', 'aborted']);
+export function piHookModels(ctx) {
+    return {
+        sessionModel: () => ctx.model,
+        find: (modelId) => ctx.modelRegistry.getAvailable().find(({ id }) => id === modelId),
+        ask: (model, question, signal) => ask(ctx, model, question, signal),
+    };
+}
+async function ask(ctx, model, { systemPrompt, prompt }, signal) {
+    const reply = await ctx.modelRegistry.complete(model, { systemPrompt, messages: [{ role: 'user', content: prompt, timestamp: Date.now() }] }, { signal });
+    if (FAILED_STOP_REASONS.has(reply.stopReason)) {
+        throw new Error(`the model stopped with ${reply.stopReason}`);
+    }
+    return reply.content.flatMap((part) => (part.type === 'text' ? [part.text] : [])).join('');
+}
+//# sourceMappingURL=pi-hook-models.js.map

package/dist/extensions/hooks/runners/pi-hook-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-hook-models.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/pi-hook-models.ts"],"names":[],"mappings":"AAMA,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAE/E,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,OAAO;QACL,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK;QAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC;QACpF,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,GAAgB,EAAE,KAAc,EAAE,EAAE,YAAY,EAAE,MAAM,EAAiB,EAAE,MAAmB;IAC/G,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1J,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC"}

package/dist/extensions/hooks/runners/prompt-runner.d.ts

@@ -0,0 +1,3 @@
+import type { PromptHandler } from '../registry/hook-handler.js';
+import type { HookHandlerRunner } from './hook-runner.js';
+export declare const promptRunner: HookHandlerRunner<PromptHandler>;

package/dist/extensions/hooks/runners/prompt-runner.js

@@ -0,0 +1,27 @@
+import { promptWith } from './prompt-template.js';
+const PROMPT_HOOK_SYSTEM_PROMPT = [
+    'You are a Claude Code hook deciding whether an action should proceed.',
+    'Answer with ONLY a JSON object and nothing else:',
+    '{"ok": true} to let it proceed, or {"ok": false, "reason": "<short reason>"} to stop it.',
+].join('\n');
+export const promptRunner = {
+    run: async (handler, payload, context) => {
+        const model = modelFor(handler, context.models);
+        if (model === undefined) {
+            return { kind: 'failed', reason: 'no model is available for a prompt hook' };
+        }
+        const signal = context.timeoutMs === undefined ? new AbortController().signal : AbortSignal.timeout(context.timeoutMs);
+        try {
+            const answer = await context.models.ask(model, { systemPrompt: PROMPT_HOOK_SYSTEM_PROMPT, prompt: promptWith(handler.prompt, payload) }, signal);
+            return { kind: 'exited', exitCode: 0, stdout: answer, stderr: '' };
+        }
+        catch {
+            return failureOf(signal, context.timeoutMs);
+        }
+    },
+};
+const modelFor = ({ model }, models) => (model === undefined ? models.sessionModel() : (models.find(model) ?? models.sessionModel()));
+function failureOf(signal, timeoutMs) {
+    return signal.aborted && timeoutMs !== undefined ? { kind: 'timed-out', afterMs: timeoutMs } : { kind: 'failed', reason: 'the model call failed' };
+}
+//# sourceMappingURL=prompt-runner.js.map

package/dist/extensions/hooks/runners/prompt-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-runner.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/prompt-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,yBAAyB,GAAG;IAChC,uEAAuE;IACvE,kDAAkD;IAClD,0FAA0F;CAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,yCAAyC,EAAE,CAAC;QAC/E,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACjJ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAiB,EAAE,MAAkB,EAAyB,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAExL,SAAS,SAAS,CAAC,MAAmB,EAAE,SAA6B;IACnE,OAAO,MAAM,CAAC,OAAO,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;AACrJ,CAAC"}

package/dist/extensions/hooks/runners/prompt-template.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+export declare function promptWith(prompt: string, payload: JsonObject): string;

package/dist/extensions/hooks/runners/prompt-template.js

@@ -0,0 +1,7 @@
+const ARGUMENTS_PLACEHOLDER = '$ARGUMENTS';
+export function promptWith(prompt, payload) {
+    const json = JSON.stringify(payload);
+    const template = prompt.includes(ARGUMENTS_PLACEHOLDER) ? prompt : `${prompt}\n\n${ARGUMENTS_PLACEHOLDER}`;
+    return template.replaceAll(ARGUMENTS_PLACEHOLDER, () => json);
+}
+//# sourceMappingURL=prompt-template.js.map

package/dist/extensions/hooks/runners/prompt-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-template.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/prompt-template.ts"],"names":[],"mappings":"AAEA,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAE3C,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,OAAmB;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,qBAAqB,EAAE,CAAC;IAC3G,OAAO,QAAQ,CAAC,UAAU,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}

package/dist/extensions/hooks/runners/runners-by-type.d.ts

@@ -0,0 +1,9 @@
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+import type { HookHandler, HookHandlerType } from '../registry/hook-handler.js';
+import type { HookHandlerRunner, HookRun, RunContext } from './hook-runner.js';
+export declare const RUNNERS_BY_TYPE: {
+    readonly [T in HookHandlerType]: HookHandlerRunner<Extract<HookHandler, {
+        type: T;
+    }>>;
+};
+export declare function runHandler(handler: HookHandler, payload: JsonObject, context: RunContext): Promise<HookRun>;

package/dist/extensions/hooks/runners/runners-by-type.js

@@ -0,0 +1,20 @@
+import { agentRunner } from './agent-runner.js';
+import { commandRunner } from './command-runner.js';
+import { httpRunner } from './http-runner.js';
+import { promptRunner } from './prompt-runner.js';
+export const RUNNERS_BY_TYPE = {
+    command: commandRunner,
+    http: httpRunner,
+    prompt: promptRunner,
+    agent: agentRunner,
+};
+export async function runHandler(handler, payload, context) {
+    const runner = RUNNERS_BY_TYPE[handler.type];
+    try {
+        return await runner.run(handler, payload, context);
+    }
+    catch (error) {
+        return { kind: 'not-started', reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=runners-by-type.js.map

package/dist/extensions/hooks/runners/runners-by-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners-by-type.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/runners-by-type.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAA8F;IACxH,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,WAAW;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAoB,EAAE,OAAmB,EAAE,OAAmB;IAC7F,MAAM,MAAM,GAAmC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACjG,CAAC;AACH,CAAC"}

package/dist/extensions/hooks/unsupported-events.d.ts

@@ -0,0 +1,5 @@
+import type { SupportedHookEvent } from './bridges/event-bridge.js';
+export type UnsupportedHookEvent = 'Setup' | 'PermissionRequest' | 'PermissionDenied' | 'MessageDisplay' | 'TaskCreated' | 'TaskCompleted' | 'TeammateIdle' | 'ConfigChange' | 'CwdChanged' | 'DirectoryAdded' | 'FileChanged' | 'PreModelSwitch' | 'Elicitation' | 'ElicitationResult';
+export type ClaudeHookEvent = SupportedHookEvent | UnsupportedHookEvent;
+export declare const UNSUPPORTED_HOOK_EVENTS: Readonly<Record<UnsupportedHookEvent, string>>;
+export declare const isUnsupportedHookEvent: (event: string) => event is UnsupportedHookEvent;

package/dist/extensions/hooks/unsupported-events.js

@@ -0,0 +1,18 @@
+export const UNSUPPORTED_HOOK_EVENTS = {
+    Setup: 'Claude runs it only for its own --init and --maintenance launches, which pi has no counterpart for',
+    PermissionRequest: 'pi has no permission dialog, so there is no request to answer',
+    PermissionDenied: 'pi has no permission classifier, so no call is ever denied that way',
+    MessageDisplay: 'pi has no event at the moment a message is shown that a hook could answer',
+    TaskCreated: 'the package offers no task tools; TodoWrite lists are not tasks',
+    TaskCompleted: 'the package offers no task tools; TodoWrite lists are not tasks',
+    TeammateIdle: 'the package has no agent teams',
+    ConfigChange: 'pi does not watch settings files while a session runs',
+    CwdChanged: 'a pi session keeps the working folder it started in',
+    DirectoryAdded: 'the package has no command that adds a working directory',
+    FileChanged: 'pi has no file watcher an extension can register paths with',
+    PreModelSwitch: 'pi announces a model only after it has been switched, so nothing can run before',
+    Elicitation: "pi's MCP client does not hand an extension the questions a server asks",
+    ElicitationResult: "pi's MCP client does not hand an extension the questions a server asks",
+};
+export const isUnsupportedHookEvent = (event) => Object.hasOwn(UNSUPPORTED_HOOK_EVENTS, event);
+//# sourceMappingURL=unsupported-events.js.map

package/dist/extensions/hooks/unsupported-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-events.js","sourceRoot":"","sources":["../../../src/extensions/hooks/unsupported-events.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,uBAAuB,GAAmD;IACrF,KAAK,EAAE,oGAAoG;IAC3G,iBAAiB,EAAE,+DAA+D;IAClF,gBAAgB,EAAE,qEAAqE;IACvF,cAAc,EAAE,2EAA2E;IAC3F,WAAW,EAAE,iEAAiE;IAC9E,aAAa,EAAE,iEAAiE;IAChF,YAAY,EAAE,gCAAgC;IAC9C,YAAY,EAAE,uDAAuD;IACrE,UAAU,EAAE,qDAAqD;IACjE,cAAc,EAAE,0DAA0D;IAC1E,WAAW,EAAE,6DAA6D;IAC1E,cAAc,EAAE,iFAAiF;IACjG,WAAW,EAAE,wEAAwE;IACrF,iBAAiB,EAAE,wEAAwE;CAC5F,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAiC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC"}

package/dist/extensions/instructions/attachments.d.ts

@@ -0,0 +1,21 @@
+import type { InstructionLoad } from '../../kernel/instruction-events/instruction-events.js';
+import { type InstructionRequest } from './instruction-set.js';
+import type { ScopedRule } from './rules.js';
+export interface Attachment {
+    readonly text: string;
+    readonly load: InstructionLoad;
+}
+export interface AttachmentCandidate {
+    readonly path: string;
+    readonly attachments: () => readonly Attachment[];
+}
+export type AttachmentSource = (touchedFile: string) => readonly AttachmentCandidate[];
+export declare class AttachmentLedger {
+    #private;
+    constructor(source: AttachmentSource);
+    attachFor(touchedFile: string): readonly Attachment[];
+    reset(): void;
+}
+export declare const combineSources: (...sources: readonly AttachmentSource[]) => AttachmentSource;
+export declare function scopedRuleSource(rules: readonly ScopedRule[]): AttachmentSource;
+export declare const nestedInstructionSource: (cwd: string, request: InstructionRequest) => AttachmentSource;

package/dist/extensions/instructions/attachments.js

@@ -0,0 +1,55 @@
+import { relative, sep } from 'node:path';
+import { isWithin, realPathOf } from './files.js';
+import { nestedInstructionFiles } from './instruction-files.js';
+import { describeInstruction, renderBlock } from './instruction-text.js';
+import { loadInstructions } from './instruction-set.js';
+import { compileRuleGlob } from './path-glob.js';
+export class AttachmentLedger {
+    #source;
+    #attached = new Set();
+    constructor(source) {
+        this.#source = source;
+    }
+    attachFor(touchedFile) {
+        const attachments = [];
+        for (const candidate of this.#source(touchedFile)) {
+            if (!this.#attached.has(candidate.path)) {
+                this.#attached.add(candidate.path);
+                attachments.push(...candidate.attachments());
+            }
+        }
+        return attachments;
+    }
+    reset() {
+        this.#attached.clear();
+    }
+}
+export const combineSources = (...sources) => (touchedFile) => sources.flatMap((source) => source(touchedFile));
+export function scopedRuleSource(rules) {
+    const compiled = rules.map((rule) => ({ rule, root: realPathOf(rule.root), matchers: rule.globs.map(compileRuleGlob) }));
+    return (touchedFile) => {
+        const real = realPathOf(touchedFile);
+        return compiled
+            .filter(({ root, matchers }) => isWithin(root, real) && matchers.some((matches) => matches(relative(root, real).split(sep).join('/'))))
+            .map(({ rule }) => ({ path: rule.path, attachments: () => [scopedRuleAttachment(rule, touchedFile)] }));
+    };
+}
+function scopedRuleAttachment(rule, touchedFile) {
+    const description = `${describeInstruction({ origin: rule.origin, kind: 'rule', path: rule.path })} for ${rule.globs.join(', ')}`;
+    return {
+        text: renderBlock({ path: rule.path, description, content: rule.body }),
+        load: {
+            filePath: rule.path,
+            memoryType: rule.origin === 'user' ? 'User' : 'Project',
+            loadReason: 'path_glob_match',
+            globs: rule.globs,
+            triggerFilePath: touchedFile,
+        },
+    };
+}
+export const nestedInstructionSource = (cwd, request) => (touchedFile) => nestedInstructionFiles(cwd, touchedFile).map((file) => ({
+    path: file.path,
+    attachments: () => attachmentsOf(loadInstructions([file], { ...request, loadReason: 'nested_traversal' }), touchedFile),
+}));
+const attachmentsOf = ({ entries }, touchedFile) => entries.map(({ block, load }) => ({ text: renderBlock(block), load: { ...load, triggerFilePath: touchedFile } }));
+//# sourceMappingURL=attachments.js.map

package/dist/extensions/instructions/attachments.js.map

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

package/dist/extensions/instructions/excludes.d.ts

@@ -0,0 +1,2 @@
+export declare function isExcluded(path: string, patterns: readonly string[]): boolean;
+export declare const readClaudeMdExcludes: (settingsFiles: readonly string[]) => readonly string[];

package/dist/extensions/instructions/excludes.js

@@ -0,0 +1,13 @@
+import { readJsonObjectLeniently } from '../../kernel/private-files/private-files.js';
+import { realPathOf } from './files.js';
+import { compileGlob } from './path-glob.js';
+export function isExcluded(path, patterns) {
+    if (patterns.length === 0) {
+        return false;
+    }
+    const spellings = [path, realPathOf(path)];
+    return patterns.some((pattern) => spellings.some(compileGlob(pattern)));
+}
+export const readClaudeMdExcludes = (settingsFiles) => settingsFiles.flatMap((file) => stringsIn(readJsonObjectLeniently(file).claudeMdExcludes));
+const stringsIn = (value) => Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+//# sourceMappingURL=excludes.js.map

package/dist/extensions/instructions/excludes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excludes.js","sourceRoot":"","sources":["../../../src/extensions/instructions/excludes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAA2B;IAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,aAAgC,EAAqB,EAAE,CAC1F,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAE7F,MAAM,SAAS,GAAG,CAAC,KAAc,EAAY,EAAE,CAC7C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC"}

package/dist/extensions/instructions/files.d.ts

@@ -0,0 +1,4 @@
+export declare function realPathOf(path: string): string;
+export declare const isWithin: (root: string, path: string) => boolean;
+export declare function isFile(path: string): boolean;
+export declare function readTextOrEmpty(path: string): string;

package/dist/extensions/instructions/files.js

@@ -0,0 +1,29 @@
+import { readFileSync, realpathSync, statSync } from 'node:fs';
+import { basename, dirname, join, sep } from 'node:path';
+export function realPathOf(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        const parent = dirname(path);
+        return parent === path ? path : join(realPathOf(parent), basename(path));
+    }
+}
+export const isWithin = (root, path) => path === root || path.startsWith(root + sep);
+export function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function readTextOrEmpty(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/extensions/instructions/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/extensions/instructions/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,IAAY,EAAW,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;AAE9G,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/extensions/instructions/imports.d.ts

@@ -0,0 +1,28 @@
+export interface ImportBudget {
+    files: number;
+    bytes: number;
+}
+export type ImportBoundary = readonly string[] | 'anywhere';
+export interface ImportPolicy {
+    readonly home: string;
+    readonly boundary: ImportBoundary;
+    readonly isExcluded: (path: string) => boolean;
+    readonly budget: ImportBudget;
+    readonly seen: Set<string>;
+}
+export interface ImportedInstruction {
+    readonly path: string;
+    readonly content: string;
+    readonly parent: string;
+}
+export interface ExpandedInstruction {
+    readonly imported: readonly ImportedInstruction[];
+    readonly notLoaded: readonly string[];
+    readonly outsideProject: readonly string[];
+}
+export declare const MAX_IMPORT_FILES = 50;
+export declare const createImportBudget: () => ImportBudget;
+export declare function expandImports(file: {
+    readonly path: string;
+    readonly content: string;
+}, policy: ImportPolicy): ExpandedInstruction;

package/dist/extensions/instructions/imports.js

@@ -0,0 +1,92 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/context-imports.ts.
+import { dirname, join, resolve } from 'node:path';
+import { isFile, isWithin, readTextOrEmpty, realPathOf } from './files.js';
+import { scanFences, stripBlockComments } from './strip-comments.js';
+export const MAX_IMPORT_FILES = 50;
+const MAX_IMPORT_BYTES = 256 * 1024;
+const MAX_IMPORT_DEPTH = 4;
+const TRUNCATION_MARKER = '[truncated: import byte budget exhausted]';
+const IMPORT_REFERENCE = /(^|\s)@(\S+)/g;
+const INLINE_CODE_SPAN = /(`+)[^`]*?\1/g;
+const HOME_PREFIX = '~';
+export const createImportBudget = () => ({ files: MAX_IMPORT_FILES, bytes: MAX_IMPORT_BYTES });
+export function expandImports(file, policy) {
+    policy.seen.add(realPathOf(file.path));
+    const expansion = new ImportExpansion(policy);
+    expansion.expandFrom(file.path, file.content, 1);
+    return expansion.result();
+}
+class ImportExpansion {
+    #policy;
+    #imported = [];
+    #notLoaded = new Set();
+    #outsideProject = new Set();
+    constructor(policy) {
+        this.#policy = policy;
+    }
+    result() {
+        return { imported: this.#imported, notLoaded: [...this.#notLoaded], outsideProject: [...this.#outsideProject] };
+    }
+    expandFrom(importer, content, depth) {
+        for (const target of importTargets(content)) {
+            this.#follow(target, importer, depth);
+        }
+    }
+    #follow(target, importer, depth) {
+        const resolved = resolve(dirname(importer), expandHome(target, this.#policy.home));
+        const real = realPathOf(resolved);
+        if (depth > MAX_IMPORT_DEPTH) {
+            this.#notLoaded.add(target);
+        }
+        else if (!this.#isInsideBoundary(real)) {
+            this.#notLoaded.add(target);
+            this.#outsideProject.add(target);
+        }
+        else if (this.#isWorthLoading(resolved, real)) {
+            this.#load(target, real, importer, depth);
+        }
+    }
+    #isInsideBoundary(real) {
+        const { boundary } = this.#policy;
+        return boundary === 'anywhere' || boundary.some((root) => isWithin(root, real));
+    }
+    #isWorthLoading(resolved, real) {
+        const { isExcluded, seen } = this.#policy;
+        return !isExcluded(resolved) && !isExcluded(real) && !seen.has(real) && isFile(real);
+    }
+    #load(target, real, importer, depth) {
+        const { budget, seen } = this.#policy;
+        if (budget.files === 0 || budget.bytes === 0) {
+            this.#notLoaded.add(target);
+            return;
+        }
+        const content = stripBlockComments(readTextOrEmpty(real)).trim();
+        seen.add(real);
+        budget.files -= 1;
+        this.#imported.push({ path: real, content: this.#withinBudget(content), parent: importer });
+        this.expandFrom(real, content, depth + 1);
+    }
+    #withinBudget(content) {
+        const { budget } = this.#policy;
+        const bytes = Buffer.from(content);
+        if (bytes.length <= budget.bytes) {
+            budget.bytes -= bytes.length;
+            return content;
+        }
+        const kept = bytes.subarray(0, budget.bytes).toString('utf8').replace(/�$/, '');
+        budget.bytes = 0;
+        return `${kept.trim()}\n${TRUNCATION_MARKER}`;
+    }
+}
+function importTargets(content) {
+    return scanFences(content)
+        .filter(({ fenced }) => !fenced)
+        .flatMap(({ text }) => [...text.replace(INLINE_CODE_SPAN, '').matchAll(IMPORT_REFERENCE)].map((match) => match[2] ?? ''));
+}
+function expandHome(target, home) {
+    if (target === HOME_PREFIX) {
+        return home;
+    }
+    return target.startsWith(`${HOME_PREFIX}/`) ? join(home, target.slice(HOME_PREFIX.length + 1)) : target;
+}
+//# sourceMappingURL=imports.js.map

package/dist/extensions/instructions/imports.js.map

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

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

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function instructionsExtension(pi: ExtensionAPI): void;

package/dist/extensions/instructions/index.js

@@ -0,0 +1,43 @@
+import { announceInstructionLoad } from '../../kernel/instruction-events/instruction-events.js';
+import { openSessionInstructions, tidyContextFiles } from './session-instructions.js';
+import { touchedFiles } from './touched-file.js';
+const SECTION_NAME = 'claude_instructions';
+export default function instructionsExtension(pi) {
+    const sessions = new Map();
+    pi.on('before_agent_start', async (event, ctx) => {
+        const options = event.systemPromptOptions;
+        addToPrompt(options, await sessionFor({ pi, ctx, sessions, contextFiles: options.contextFiles }));
+    });
+    pi.on('tool_result', (event, ctx) => attachToResult(pi, event, ctx, sessions.get(sessionIdOf(ctx))));
+    const rearm = (_event, ctx) => {
+        sessions.get(sessionIdOf(ctx))?.ledger.reset();
+    };
+    pi.on('session_compact', rearm);
+    pi.on('session_tree', rearm);
+    pi.on('session_shutdown', (_event, ctx) => {
+        sessions.delete(sessionIdOf(ctx));
+    });
+}
+const sessionIdOf = (ctx) => ctx.sessionManager.getSessionId();
+async function sessionFor({ pi, ctx, sessions, contextFiles }) {
+    const session = sessions.get(sessionIdOf(ctx)) ?? (await openSessionInstructions(pi, ctx, contextFiles));
+    sessions.set(sessionIdOf(ctx), session);
+    return session;
+}
+function addToPrompt(options, session) {
+    tidyContextFiles(options.contextFiles, session.excludePatterns);
+    if (session.section !== '') {
+        options.sections = { ...options.sections, [SECTION_NAME]: session.section };
+    }
+}
+function attachToResult(pi, event, ctx, session) {
+    const attachments = session === undefined ? [] : touchedFiles(event, ctx.cwd).flatMap((file) => session.ledger.attachFor(file));
+    if (attachments.length === 0) {
+        return undefined;
+    }
+    attachments.forEach(({ load }) => {
+        announceInstructionLoad(pi.events, load);
+    });
+    return { content: [...event.content, ...attachments.map(({ text }) => ({ type: 'text', text }))] };
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/extensions/instructions/instruction-files.d.ts

@@ -0,0 +1,17 @@
+import type { InstructionMemoryType } from '../../kernel/instruction-events/instruction-events.js';
+export type InstructionOrigin = 'user' | 'project';
+export type InstructionKind = 'memory' | 'rule';
+export interface InstructionFile {
+    readonly path: string;
+    readonly origin: InstructionOrigin;
+    readonly kind: InstructionKind;
+    readonly root: string;
+}
+export interface InstructionPaths {
+    readonly configDir: string;
+    readonly cwd: string;
+    readonly projectFolders: readonly string[];
+}
+export declare function instructionFiles({ configDir, cwd, projectFolders }: InstructionPaths): readonly InstructionFile[];
+export declare function nestedInstructionFiles(cwd: string, touchedFile: string): readonly InstructionFile[];
+export declare const memoryTypeOf: ({ origin, path }: Pick<InstructionFile, "origin" | "path">) => InstructionMemoryType;