@bastani/atomic 0.8.25 → 0.8.26-alpha.2

package/dist/builtin/workflows/src/runs/shared/worktree.ts

@@ -2,7 +2,7 @@ import { spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import { APP_NAME } from "@bastani/atomic";
+import { APP_NAME, createGitEnvironment } from "@bastani/atomic";
 
 export interface WorktreeSetup {
 	cwd: string;
@@ -110,7 +110,7 @@ function runGit(cwd: string, args: string[]): GitResult {
 	], {
 		cwd,
 		encoding: "utf-8",
-		env: { ...process.env, GIT_OPTIONAL_LOCKS: "0" },
+		env: createGitEnvironment({ GIT_OPTIONAL_LOCKS: "0" }),
 		timeout: 5000,
 	});
 	return {

package/dist/builtin/workflows/src/shared/store.ts

@@ -151,6 +151,16 @@ export interface Store {
   ): boolean;
   /** Wait for a stage/node-scoped HIL prompt to resolve. */
   awaitStagePendingPrompt(runId: string, stageId: string, promptId: string): Promise<unknown>;
+  /**
+   * Record a live-only draft for an active stage-local input/editor prompt.
+   * Draft text may contain secrets and must never be copied into snapshots,
+   * status output, logs, notifications, or persisted metadata.
+   */
+  recordStagePromptDraft(runId: string, stageId: string, promptId: string, text: string): boolean;
+  /** Return a live-only draft for an active stage-local input/editor prompt, if present. */
+  getStagePromptDraft(runId: string, stageId: string, promptId: string): string | undefined;
+  /** Clear a live-only draft for a stage-local prompt. */
+  clearStagePromptDraft(runId: string, stageId: string, promptId: string): boolean;
   /**
    * Return the live-only prompt answer record for a completed prompt stage, if
    * still available. The returned value may contain secrets and must never be
@@ -239,6 +249,7 @@ export function createStore(): Store {
   const _notices: WorkflowNotice[] = [];
   const _listeners: Set<(snap: StoreSnapshot) => void> = new Set();
   const _stagePromptAnswers = new Map<string, PromptAnswerRecord>();
+  const _stagePromptDrafts = new Map<string, string>();
   let _version = 0;
 
   /**
@@ -285,16 +296,36 @@ export function createStore(): Store {
     return JSON.stringify([runId, stageId]);
   }
 
-  function rejectStagePrompt(stage: StageSnapshot, reason: string): void {
+  function stagePromptDraftKey(runId: string, stageId: string, promptId: string): string {
+    return JSON.stringify([runId, stageId, promptId]);
+  }
+
+  function stageHasActiveTextPrompt(
+    runId: string,
+    stageId: string,
+    promptId: string,
+  ): { prompt: PendingPrompt } | undefined {
+    const run = findRun(runId);
+    if (!run || TERMINAL_STATUSES.has(run.status)) return undefined;
+    const stage = findStage(run, stageId);
+    if (!stage || isTerminalStageStatus(stage.status)) return undefined;
+    const prompt = stage.pendingPrompt;
+    if (!prompt || prompt.id !== promptId) return undefined;
+    if (prompt.kind !== "input" && prompt.kind !== "editor") return undefined;
+    return { prompt };
+  }
+
+  function rejectStagePrompt(runId: string, stage: StageSnapshot, reason: string): void {
     const prompt = stage.pendingPrompt;
     if (!prompt) return;
     stage.pendingPrompt = undefined;
+    _stagePromptDrafts.delete(stagePromptDraftKey(runId, stage.id, prompt.id));
     rejectPrompt(prompt.id, reason);
   }
 
-  function rejectAllStagePrompts(run: RunSnapshot, reason: string): void {
+  function rejectAllStagePrompts(runId: string, run: RunSnapshot, reason: string): void {
     for (const stage of run.stages) {
-      rejectStagePrompt(stage, reason);
+      rejectStagePrompt(runId, stage, reason);
     }
   }
 
@@ -427,7 +458,7 @@ export function createStore(): Store {
       if (stage.workflowChild !== undefined) existing.workflowChild = structuredClone(stage.workflowChild);
       delete existing.awaitingInputSince;
       delete existing.inputRequest;
-      rejectStagePrompt(existing, `atomic-workflows: stage ${stage.id} ended before prompt resolved`);
+      rejectStagePrompt(runId, existing, `atomic-workflows: stage ${stage.id} ended before prompt resolved`);
       _version++;
       notify();
     },
@@ -474,7 +505,7 @@ export function createStore(): Store {
         run.pendingPrompt = undefined;
         rejectPrompt(pending.id, `atomic-workflows: run ${runId} ended before prompt resolved`);
       }
-      rejectAllStagePrompts(run, `atomic-workflows: run ${runId} ended before prompt resolved`);
+      rejectAllStagePrompts(runId, run, `atomic-workflows: run ${runId} ended before prompt resolved`);
       _version++;
       notify();
       return true;
@@ -488,7 +519,7 @@ export function createStore(): Store {
       if (pending) {
         rejectPrompt(pending.id, `atomic-workflows: run ${runId} was removed before prompt resolved`);
       }
-      rejectAllStagePrompts(run, `atomic-workflows: run ${runId} was removed before prompt resolved`);
+      rejectAllStagePrompts(runId, run, `atomic-workflows: run ${runId} was removed before prompt resolved`);
       for (const stage of run.stages) {
         _stagePromptAnswers.delete(stagePromptAnswerKey(runId, stage.id));
       }
@@ -599,6 +630,7 @@ export function createStore(): Store {
       if (!stage) return false;
       const pending = stage.pendingPrompt;
       if (!pending || pending.id !== promptId) return false;
+      _stagePromptDrafts.delete(stagePromptDraftKey(runId, stageId, promptId));
       if (options.recordAnswer !== false) {
         _stagePromptAnswers.set(stagePromptAnswerKey(runId, stageId), {
           runId,
@@ -654,6 +686,21 @@ export function createStore(): Store {
       });
     },
 
+    recordStagePromptDraft(runId: string, stageId: string, promptId: string, text: string): boolean {
+      if (stageHasActiveTextPrompt(runId, stageId, promptId) === undefined) return false;
+      _stagePromptDrafts.set(stagePromptDraftKey(runId, stageId, promptId), text);
+      return true;
+    },
+
+    getStagePromptDraft(runId: string, stageId: string, promptId: string): string | undefined {
+      if (stageHasActiveTextPrompt(runId, stageId, promptId) === undefined) return undefined;
+      return _stagePromptDrafts.get(stagePromptDraftKey(runId, stageId, promptId));
+    },
+
+    clearStagePromptDraft(runId: string, stageId: string, promptId: string): boolean {
+      return _stagePromptDrafts.delete(stagePromptDraftKey(runId, stageId, promptId));
+    },
+
     getStagePromptAnswer(runId: string, stageId: string): PromptAnswerRecord | undefined {
       return _stagePromptAnswers.get(stagePromptAnswerKey(runId, stageId));
     },
@@ -896,7 +943,13 @@ export function createStore(): Store {
     },
 
     clear(): void {
-      if (_runs.length === 0 && _notices.length === 0 && _resolvers.size === 0 && _stagePromptAnswers.size === 0) return;
+      if (
+        _runs.length === 0 &&
+        _notices.length === 0 &&
+        _resolvers.size === 0 &&
+        _stagePromptAnswers.size === 0 &&
+        _stagePromptDrafts.size === 0
+      ) return;
       _runs.length = 0;
       _notices.length = 0;
       // Reject any outstanding HIL waiters so background promises terminate
@@ -907,6 +960,7 @@ export function createStore(): Store {
       }
       _resolvers.clear();
       _stagePromptAnswers.clear();
+      _stagePromptDrafts.clear();
       _version++;
       notify();
     },

package/dist/builtin/workflows/src/tui/inline-form-overlay.ts

@@ -79,7 +79,7 @@ interface CardComponent {
   invalidate?(): void;
 }
 
-type RawRenderer = (payload: unknown) => string | CardComponent | undefined;
+type RawRenderer = (payload: unknown) => CardComponent | null | undefined;
 
 /**
  * Wire the message renderer once per live ExtensionAPI host. pi creates a new
@@ -106,8 +106,11 @@ export function registerInlineFormRenderer(pi: ExtensionAPI, theme: GraphTheme):
     if (!formId) return undefined;
     const state = getForm(formId);
     if (!state) {
-      // Process restart / map evicted — tombstone the entry.
-      return `  ${message.content ?? "workflow form"}  ·  (snapshot lost)`;
+      // No backing state — the session was resumed/replaced (the store is
+      // cleared on session_start) or the map was evicted. Return null so the
+      // host renders nothing: the input widget must not reappear in chat after
+      // /resume rather than showing a stale or "snapshot lost" placeholder.
+      return null;
     }
     return {
       // The card is fully reactive: read fresh state on every render call,
@@ -291,11 +294,17 @@ export async function openInlineInputsForm(
           display?: boolean;
           details?: FormMessageDetails;
         },
+        options?: { excludeFromContext?: boolean },
       ) => void).call(pi, {
         customType: CUSTOM_TYPE,
         content: opts.workflowName,
         display: true,
         details: { formId },
+      }, {
+        // The input form is a transient UI surface, not conversation. Keep it
+        // out of LLM context so spawning the picker and exiting without
+        // running the workflow never leaks the form into the model.
+        excludeFromContext: true,
       });
     } catch {
       activeEditor?.dispose?.();

package/dist/builtin/workflows/src/tui/inline-form-store.ts

@@ -12,11 +12,12 @@
  *   `finalizeForm(id, "submit")` → status = "submitted", values frozen
  *   `finalizeForm(id, "cancel")` → status = "cancelled"
  *
- * After finalize the state stays in the map forever (module-lifetime). The
- * renderer reads it to display the historical card. If the process restarts,
- * the map is empty and the renderer falls back to a "form (snapshot lost)"
- * placeholder — acceptable because frozen cards are decorative, not
- * functional.
+ * After finalize the state stays in the map for the lifetime of the session.
+ * The renderer reads it to display the historical card. On a session boundary
+ * (`session_start`: new/resume/fork/reload) the store is cleared via
+ * {@link clearForms}, so a rehydrated `workflows:input-form` message has no
+ * backing state and its renderer suppresses output (returns null) — the input
+ * widget never reappears in chat after `/resume`.
  *
  * Why a global registry instead of closure capture: the message renderer is
  * registered ONCE at factory time and called many times for any number of
@@ -73,7 +74,17 @@ export function finalizeForm(formId: string, outcome: "submit" | "cancel"): void
   touch(s);
 }
 
+/**
+ * Clear all inline form state. Called on `session_start` so a resumed or
+ * replaced session never renders a stale live form, and so a rehydrated
+ * `workflows:input-form` message resolves to no backing state (its renderer
+ * then returns null and the host renders nothing).
+ */
+export function clearForms(): void {
+  FORMS.clear();
+}
+
 /** Test helper — clear the registry between tests. */
 export function _resetForms(): void {
-  FORMS.clear();
+  clearForms();
 }

package/dist/builtin/workflows/src/tui/stage-chat-view.ts

@@ -521,6 +521,7 @@ export class StageChatView implements Component, Focusable {
     }
     if (!this.promptState || this.promptState.prompt.id !== prompt.id) {
       this.promptState = createPromptCardState(prompt);
+      this._seedPromptTextState(prompt);
       this._resetPromptEditor(prompt);
       this._resetPromptScroll();
       return true;
@@ -533,19 +534,49 @@ export class StageChatView implements Component, Focusable {
     this.promptMaxScroll = 0;
   }
 
+  private _promptSeedText(prompt: PendingPrompt): string {
+    const draft = this.store.getStagePromptDraft(this.runId, this.stageId, prompt.id);
+    if (draft !== undefined) return draft;
+    return typeof prompt.initial === "string" ? prompt.initial : "";
+  }
+
+  private _seedPromptTextState(prompt: PendingPrompt): void {
+    if (prompt.kind !== "input" && prompt.kind !== "editor") return;
+    if (!this.promptState || this.promptState.prompt.id !== prompt.id) return;
+    const seed = this._promptSeedText(prompt);
+    this.promptState.rawText = seed;
+    this.promptState.caret = seed.length;
+  }
+
+  private _recordPromptDraft(promptId: string, text: string): void {
+    this.store.recordStagePromptDraft(this.runId, this.stageId, promptId, text);
+  }
+
+  private _recordCurrentPromptDraft(): void {
+    const state = this.promptState;
+    if (!state) return;
+    const prompt = state.prompt;
+    if (prompt.kind !== "input" && prompt.kind !== "editor") return;
+    const text = this.promptEditor && this.promptEditorPromptId === prompt.id
+      ? this.promptEditor.getText()
+      : state.rawText;
+    this._recordPromptDraft(prompt.id, text);
+  }
+
   private _resetPromptEditor(prompt: PendingPrompt): void {
     this._disposePromptEditor();
     if ((prompt.kind !== "input" && prompt.kind !== "editor") || !this.piTui) return;
     const editor = this.piEditorFactory
       ? this.piEditorFactory(this.piTui, editorThemeFromGraphTheme(this.theme), this.piKeybindings)
       : new Editor(this.piTui, editorThemeFromGraphTheme(this.theme), { paddingX: 0 });
-    editor.setText(typeof prompt.initial === "string" ? prompt.initial : "");
+    editor.setText(this.promptState?.prompt.id === prompt.id ? this.promptState.rawText : this._promptSeedText(prompt));
     setEditorPlaceholder(editor, "Type your response…");
     setEditorBorderColor(editor, (text) => hexToAnsi(this.theme.accent) + text + RESET);
     editor.onChange = (text: string) => {
       if (this.promptState?.prompt.id !== prompt.id) return;
       this.promptState.rawText = text;
       this.promptState.caret = text.length;
+      this._recordPromptDraft(prompt.id, text);
       this.requestRender?.();
     };
     editor.onSubmit = (text: string) => {
@@ -1248,11 +1279,14 @@ export class StageChatView implements Component, Focusable {
       return;
     }
     const action = handlePromptCardInput(data, state, this._promptKeybindings());
+    const prompt = state.prompt;
+    if (prompt.kind === "input" || prompt.kind === "editor") {
+      this._recordPromptDraft(prompt.id, state.rawText);
+    }
     if (action.kind === "noop") {
       this.requestRender?.();
       return;
     }
-    const prompt = state.prompt;
     const response = action.kind === "submit"
       ? action.response
       : defaultResponseFor(prompt);
@@ -1306,6 +1340,7 @@ export class StageChatView implements Component, Focusable {
     const readOnlyPromptArchive = readOnlyArchive && stage?.promptFootprint !== undefined;
     if (matchesKey(data, Key.ctrl("d"))) {
       if (!this.promptState && this.chatHost.hasInputText()) return this.chatHost.handleInput(data);
+      this._recordCurrentPromptDraft();
       this.onDetach();
       return true;
     }

package/dist/core/agent-session-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-services.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-services.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,KAAK,4BAA4B,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,KAAK,yBAAyB,EAAE,KAAK,wBAAwB,EAAsB,MAAM,UAAU,CAAC;AAC7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC7C,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iCAAiC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IACpD,qBAAqB,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,KAAK,GAAG,UAAU,GAAG,iBAAiB,CAAC,CAAC;CACnG;AAED;;;;;GAKG;AACH,MAAM,WAAW,qCAAqC;IACrD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,aAAa,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,yBAAyB,CAAC,eAAe,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAkDD;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC/C,OAAO,EAAE,iCAAiC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAuC/B;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CACnD,OAAO,EAAE,qCAAqC,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAkBnC","sourcesContent":["import { join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport type { SessionStartEvent, ToolDefinition } from \"./extensions/index.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { DefaultResourceLoader, type DefaultResourceLoaderOptions, type ResourceLoader } from \"./resource-loader.ts\";\nimport { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession } from \"./sdk.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\n\n/**\n * Non-fatal issues collected while creating services or sessions.\n *\n * Runtime creation returns diagnostics to the caller instead of printing or\n * exiting. The app layer decides whether warnings should be shown and whether\n * errors should abort startup.\n */\nexport interface AgentSessionRuntimeDiagnostic {\n\ttype: \"info\" | \"warning\" | \"error\";\n\tmessage: string;\n}\n\n/**\n * Inputs for creating cwd-bound runtime services.\n *\n * These services are recreated whenever the effective session cwd changes.\n * CLI-provided resource paths should be resolved to absolute paths before they\n * reach this function, so later cwd switches do not reinterpret them.\n */\nexport interface CreateAgentSessionServicesOptions {\n\tcwd: string;\n\tagentDir?: string;\n\tauthStorage?: AuthStorage;\n\tsettingsManager?: SettingsManager;\n\tmodelRegistry?: ModelRegistry;\n\textensionFlagValues?: Map<string, boolean | string>;\n\tresourceLoaderOptions?: Omit<DefaultResourceLoaderOptions, \"cwd\" | \"agentDir\" | \"settingsManager\">;\n}\n\n/**\n * Inputs for creating an AgentSession from already-created services.\n *\n * Use this after services exist and any cwd-bound model/tool/session options\n * have been resolved against those services.\n */\nexport interface CreateAgentSessionFromServicesOptions {\n\tservices: AgentSessionServices;\n\tsessionManager: SessionManager;\n\tsessionStartEvent?: SessionStartEvent;\n\tmodel?: Model<Api>;\n\tthinkingLevel?: ThinkingLevel;\n\tscopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\ttools?: CreateAgentSessionOptions[\"tools\"];\n\texcludedTools?: CreateAgentSessionOptions[\"excludedTools\"];\n\tnoTools?: CreateAgentSessionOptions[\"noTools\"];\n\tcustomTools?: ToolDefinition[];\n}\n\n/**\n * Coherent cwd-bound runtime services for one effective session cwd.\n *\n * This is infrastructure only. The AgentSession itself is created separately so\n * session options can be resolved against these services first.\n */\nexport interface AgentSessionServices {\n\tcwd: string;\n\tagentDir: string;\n\tauthStorage: AuthStorage;\n\tsettingsManager: SettingsManager;\n\tmodelRegistry: ModelRegistry;\n\tresourceLoader: ResourceLoader;\n\tdiagnostics: AgentSessionRuntimeDiagnostic[];\n}\n\nfunction applyExtensionFlagValues(\n\tresourceLoader: ResourceLoader,\n\textensionFlagValues: Map<string, boolean | string> | undefined,\n): AgentSessionRuntimeDiagnostic[] {\n\tif (!extensionFlagValues) {\n\t\treturn [];\n\t}\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tconst registeredFlags = new Map<string, { type: \"boolean\" | \"string\" }>();\n\tfor (const extension of extensionsResult.extensions) {\n\t\tfor (const [name, flag] of extension.flags) {\n\t\t\tregisteredFlags.set(name, { type: flag.type });\n\t\t}\n\t}\n\n\tconst unknownFlags: string[] = [];\n\tfor (const [name, value] of extensionFlagValues) {\n\t\tconst flag = registeredFlags.get(name);\n\t\tif (!flag) {\n\t\t\tunknownFlags.push(name);\n\t\t\tcontinue;\n\t\t}\n\t\tif (flag.type === \"boolean\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, true);\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"string\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, value);\n\t\t\tcontinue;\n\t\t}\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Extension flag \"--${name}\" requires a value`,\n\t\t});\n\t}\n\n\tif (unknownFlags.length > 0) {\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Unknown option${unknownFlags.length === 1 ? \"\" : \"s\"}: ${unknownFlags.map((name) => `--${name}`).join(\", \")}`,\n\t\t});\n\t}\n\n\treturn diagnostics;\n}\n\n/**\n * Create cwd-bound runtime services.\n *\n * Returns services plus diagnostics. It does not create an AgentSession.\n */\nexport async function createAgentSessionServices(\n\toptions: CreateAgentSessionServicesOptions,\n): Promise<AgentSessionServices> {\n\tconst cwd = resolvePath(options.cwd);\n\tconst agentDir = options.agentDir ? resolvePath(options.agentDir) : getAgentDir();\n\tconst authStorage = options.authStorage ?? AuthStorage.create(join(agentDir, \"auth.json\"));\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, join(agentDir, \"models.json\"));\n\tconst resourceLoader = new DefaultResourceLoader({\n\t\t...(options.resourceLoaderOptions ?? {}),\n\t\tcwd,\n\t\tagentDir,\n\t\tsettingsManager,\n\t});\n\tawait resourceLoader.reload();\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tfor (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {\n\t\ttry {\n\t\t\tmodelRegistry.registerProvider(name, config);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tdiagnostics.push({\n\t\t\t\ttype: \"error\",\n\t\t\t\tmessage: `Extension \"${extensionPath}\" error: ${message}`,\n\t\t\t});\n\t\t}\n\t}\n\textensionsResult.runtime.pendingProviderRegistrations = [];\n\tdiagnostics.push(...applyExtensionFlagValues(resourceLoader, options.extensionFlagValues));\n\n\treturn {\n\t\tcwd,\n\t\tagentDir,\n\t\tauthStorage,\n\t\tsettingsManager,\n\t\tmodelRegistry,\n\t\tresourceLoader,\n\t\tdiagnostics,\n\t};\n}\n\n/**\n * Create an AgentSession from previously created services.\n *\n * This keeps session creation separate from service creation so callers can\n * resolve model, thinking, tools, and other session inputs against the target\n * cwd before constructing the session.\n */\nexport async function createAgentSessionFromServices(\n\toptions: CreateAgentSessionFromServicesOptions,\n): Promise<CreateAgentSessionResult> {\n\treturn createAgentSession({\n\t\tcwd: options.services.cwd,\n\t\tagentDir: options.services.agentDir,\n\t\tauthStorage: options.services.authStorage,\n\t\tsettingsManager: options.services.settingsManager,\n\t\tmodelRegistry: options.services.modelRegistry,\n\t\tresourceLoader: options.services.resourceLoader,\n\t\tsessionManager: options.sessionManager,\n\t\tmodel: options.model,\n\t\tthinkingLevel: options.thinkingLevel,\n\t\tscopedModels: options.scopedModels,\n\t\ttools: options.tools,\n\t\texcludedTools: options.excludedTools,\n\t\tnoTools: options.noTools,\n\t\tcustomTools: options.customTools,\n\t\tsessionStartEvent: options.sessionStartEvent,\n\t});\n}\n"]}
+{"version":3,"file":"agent-session-services.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-services.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,KAAK,4BAA4B,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,KAAK,yBAAyB,EAAE,KAAK,wBAAwB,EAAsB,MAAM,UAAU,CAAC;AAC7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC7C,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iCAAiC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IACpD,qBAAqB,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,KAAK,GAAG,UAAU,GAAG,iBAAiB,CAAC,CAAC;CACnG;AAED;;;;;GAKG;AACH,MAAM,WAAW,qCAAqC;IACrD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,aAAa,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,yBAAyB,CAAC,eAAe,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAkDD;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC/C,OAAO,EAAE,iCAAiC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAmD/B;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CACnD,OAAO,EAAE,qCAAqC,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAkBnC","sourcesContent":["import { join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport type { SessionStartEvent, ToolDefinition } from \"./extensions/index.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { DefaultResourceLoader, type DefaultResourceLoaderOptions, type ResourceLoader } from \"./resource-loader.ts\";\nimport { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession } from \"./sdk.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { endTimingSpan, startTimingSpan } from \"./timings.ts\";\n\n/**\n * Non-fatal issues collected while creating services or sessions.\n *\n * Runtime creation returns diagnostics to the caller instead of printing or\n * exiting. The app layer decides whether warnings should be shown and whether\n * errors should abort startup.\n */\nexport interface AgentSessionRuntimeDiagnostic {\n\ttype: \"info\" | \"warning\" | \"error\";\n\tmessage: string;\n}\n\n/**\n * Inputs for creating cwd-bound runtime services.\n *\n * These services are recreated whenever the effective session cwd changes.\n * CLI-provided resource paths should be resolved to absolute paths before they\n * reach this function, so later cwd switches do not reinterpret them.\n */\nexport interface CreateAgentSessionServicesOptions {\n\tcwd: string;\n\tagentDir?: string;\n\tauthStorage?: AuthStorage;\n\tsettingsManager?: SettingsManager;\n\tmodelRegistry?: ModelRegistry;\n\textensionFlagValues?: Map<string, boolean | string>;\n\tresourceLoaderOptions?: Omit<DefaultResourceLoaderOptions, \"cwd\" | \"agentDir\" | \"settingsManager\">;\n}\n\n/**\n * Inputs for creating an AgentSession from already-created services.\n *\n * Use this after services exist and any cwd-bound model/tool/session options\n * have been resolved against those services.\n */\nexport interface CreateAgentSessionFromServicesOptions {\n\tservices: AgentSessionServices;\n\tsessionManager: SessionManager;\n\tsessionStartEvent?: SessionStartEvent;\n\tmodel?: Model<Api>;\n\tthinkingLevel?: ThinkingLevel;\n\tscopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\ttools?: CreateAgentSessionOptions[\"tools\"];\n\texcludedTools?: CreateAgentSessionOptions[\"excludedTools\"];\n\tnoTools?: CreateAgentSessionOptions[\"noTools\"];\n\tcustomTools?: ToolDefinition[];\n}\n\n/**\n * Coherent cwd-bound runtime services for one effective session cwd.\n *\n * This is infrastructure only. The AgentSession itself is created separately so\n * session options can be resolved against these services first.\n */\nexport interface AgentSessionServices {\n\tcwd: string;\n\tagentDir: string;\n\tauthStorage: AuthStorage;\n\tsettingsManager: SettingsManager;\n\tmodelRegistry: ModelRegistry;\n\tresourceLoader: ResourceLoader;\n\tdiagnostics: AgentSessionRuntimeDiagnostic[];\n}\n\nfunction applyExtensionFlagValues(\n\tresourceLoader: ResourceLoader,\n\textensionFlagValues: Map<string, boolean | string> | undefined,\n): AgentSessionRuntimeDiagnostic[] {\n\tif (!extensionFlagValues) {\n\t\treturn [];\n\t}\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tconst registeredFlags = new Map<string, { type: \"boolean\" | \"string\" }>();\n\tfor (const extension of extensionsResult.extensions) {\n\t\tfor (const [name, flag] of extension.flags) {\n\t\t\tregisteredFlags.set(name, { type: flag.type });\n\t\t}\n\t}\n\n\tconst unknownFlags: string[] = [];\n\tfor (const [name, value] of extensionFlagValues) {\n\t\tconst flag = registeredFlags.get(name);\n\t\tif (!flag) {\n\t\t\tunknownFlags.push(name);\n\t\t\tcontinue;\n\t\t}\n\t\tif (flag.type === \"boolean\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, true);\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"string\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, value);\n\t\t\tcontinue;\n\t\t}\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Extension flag \"--${name}\" requires a value`,\n\t\t});\n\t}\n\n\tif (unknownFlags.length > 0) {\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Unknown option${unknownFlags.length === 1 ? \"\" : \"s\"}: ${unknownFlags.map((name) => `--${name}`).join(\", \")}`,\n\t\t});\n\t}\n\n\treturn diagnostics;\n}\n\n/**\n * Create cwd-bound runtime services.\n *\n * Returns services plus diagnostics. It does not create an AgentSession.\n */\nexport async function createAgentSessionServices(\n\toptions: CreateAgentSessionServicesOptions,\n): Promise<AgentSessionServices> {\n\tconst cwd = resolvePath(options.cwd);\n\tconst agentDir = options.agentDir ? resolvePath(options.agentDir) : getAgentDir();\n\tconst authStorageSpan = startTimingSpan(\"createAgentSessionServices.authStorage\");\n\tconst authStorage = options.authStorage ?? AuthStorage.create(join(agentDir, \"auth.json\"));\n\tendTimingSpan(authStorageSpan);\n\tconst settingsSpan = startTimingSpan(\"createAgentSessionServices.settingsManager\");\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tendTimingSpan(settingsSpan);\n\tconst modelRegistrySpan = startTimingSpan(\"createAgentSessionServices.modelRegistry\");\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, join(agentDir, \"models.json\"));\n\tendTimingSpan(modelRegistrySpan);\n\tconst resourceLoader = new DefaultResourceLoader({\n\t\t...(options.resourceLoaderOptions ?? {}),\n\t\tcwd,\n\t\tagentDir,\n\t\tsettingsManager,\n\t});\n\tconst reloadSpan = startTimingSpan(\"createAgentSessionServices.resourceLoader.reload\");\n\tawait resourceLoader.reload();\n\tendTimingSpan(reloadSpan);\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst providerSpan = startTimingSpan(\"createAgentSessionServices.providerRegistrations\");\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tfor (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {\n\t\ttry {\n\t\t\tmodelRegistry.registerProvider(name, config);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tdiagnostics.push({\n\t\t\t\ttype: \"error\",\n\t\t\t\tmessage: `Extension \"${extensionPath}\" error: ${message}`,\n\t\t\t});\n\t\t}\n\t}\n\textensionsResult.runtime.pendingProviderRegistrations = [];\n\tendTimingSpan(providerSpan);\n\tconst flagSpan = startTimingSpan(\"createAgentSessionServices.extensionFlagValidation\");\n\tdiagnostics.push(...applyExtensionFlagValues(resourceLoader, options.extensionFlagValues));\n\tendTimingSpan(flagSpan);\n\n\treturn {\n\t\tcwd,\n\t\tagentDir,\n\t\tauthStorage,\n\t\tsettingsManager,\n\t\tmodelRegistry,\n\t\tresourceLoader,\n\t\tdiagnostics,\n\t};\n}\n\n/**\n * Create an AgentSession from previously created services.\n *\n * This keeps session creation separate from service creation so callers can\n * resolve model, thinking, tools, and other session inputs against the target\n * cwd before constructing the session.\n */\nexport async function createAgentSessionFromServices(\n\toptions: CreateAgentSessionFromServicesOptions,\n): Promise<CreateAgentSessionResult> {\n\treturn createAgentSession({\n\t\tcwd: options.services.cwd,\n\t\tagentDir: options.services.agentDir,\n\t\tauthStorage: options.services.authStorage,\n\t\tsettingsManager: options.services.settingsManager,\n\t\tmodelRegistry: options.services.modelRegistry,\n\t\tresourceLoader: options.services.resourceLoader,\n\t\tsessionManager: options.sessionManager,\n\t\tmodel: options.model,\n\t\tthinkingLevel: options.thinkingLevel,\n\t\tscopedModels: options.scopedModels,\n\t\ttools: options.tools,\n\t\texcludedTools: options.excludedTools,\n\t\tnoTools: options.noTools,\n\t\tcustomTools: options.customTools,\n\t\tsessionStartEvent: options.sessionStartEvent,\n\t});\n}\n"]}

package/dist/core/agent-session-services.js

@@ -6,6 +6,7 @@ import { ModelRegistry } from "./model-registry.js";
 import { DefaultResourceLoader } from "./resource-loader.js";
 import { createAgentSession } from "./sdk.js";
 import { SettingsManager } from "./settings-manager.js";
+import { endTimingSpan, startTimingSpan } from "./timings.js";
 function applyExtensionFlagValues(resourceLoader, extensionFlagValues) {
     if (!extensionFlagValues) {
         return [];
@@ -54,17 +55,26 @@ function applyExtensionFlagValues(resourceLoader, extensionFlagValues) {
 export async function createAgentSessionServices(options) {
     const cwd = resolvePath(options.cwd);
     const agentDir = options.agentDir ? resolvePath(options.agentDir) : getAgentDir();
+    const authStorageSpan = startTimingSpan("createAgentSessionServices.authStorage");
     const authStorage = options.authStorage ?? AuthStorage.create(join(agentDir, "auth.json"));
+    endTimingSpan(authStorageSpan);
+    const settingsSpan = startTimingSpan("createAgentSessionServices.settingsManager");
     const settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);
+    endTimingSpan(settingsSpan);
+    const modelRegistrySpan = startTimingSpan("createAgentSessionServices.modelRegistry");
     const modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, join(agentDir, "models.json"));
+    endTimingSpan(modelRegistrySpan);
     const resourceLoader = new DefaultResourceLoader({
         ...(options.resourceLoaderOptions ?? {}),
         cwd,
         agentDir,
         settingsManager,
     });
+    const reloadSpan = startTimingSpan("createAgentSessionServices.resourceLoader.reload");
     await resourceLoader.reload();
+    endTimingSpan(reloadSpan);
     const diagnostics = [];
+    const providerSpan = startTimingSpan("createAgentSessionServices.providerRegistrations");
     const extensionsResult = resourceLoader.getExtensions();
     for (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {
         try {
@@ -79,7 +89,10 @@ export async function createAgentSessionServices(options) {
         }
     }
     extensionsResult.runtime.pendingProviderRegistrations = [];
+    endTimingSpan(providerSpan);
+    const flagSpan = startTimingSpan("createAgentSessionServices.extensionFlagValidation");
     diagnostics.push(...applyExtensionFlagValues(resourceLoader, options.extensionFlagValues));
+    endTimingSpan(flagSpan);
     return {
         cwd,
         agentDir,

package/dist/core/agent-session-services.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-services.js","sourceRoot":"","sources":["../../src/core/agent-session-services.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport type { SessionStartEvent, ToolDefinition } from \"./extensions/index.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { DefaultResourceLoader, type DefaultResourceLoaderOptions, type ResourceLoader } from \"./resource-loader.ts\";\nimport { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession } from \"./sdk.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\n\n/**\n * Non-fatal issues collected while creating services or sessions.\n *\n * Runtime creation returns diagnostics to the caller instead of printing or\n * exiting. The app layer decides whether warnings should be shown and whether\n * errors should abort startup.\n */\nexport interface AgentSessionRuntimeDiagnostic {\n\ttype: \"info\" | \"warning\" | \"error\";\n\tmessage: string;\n}\n\n/**\n * Inputs for creating cwd-bound runtime services.\n *\n * These services are recreated whenever the effective session cwd changes.\n * CLI-provided resource paths should be resolved to absolute paths before they\n * reach this function, so later cwd switches do not reinterpret them.\n */\nexport interface CreateAgentSessionServicesOptions {\n\tcwd: string;\n\tagentDir?: string;\n\tauthStorage?: AuthStorage;\n\tsettingsManager?: SettingsManager;\n\tmodelRegistry?: ModelRegistry;\n\textensionFlagValues?: Map<string, boolean | string>;\n\tresourceLoaderOptions?: Omit<DefaultResourceLoaderOptions, \"cwd\" | \"agentDir\" | \"settingsManager\">;\n}\n\n/**\n * Inputs for creating an AgentSession from already-created services.\n *\n * Use this after services exist and any cwd-bound model/tool/session options\n * have been resolved against those services.\n */\nexport interface CreateAgentSessionFromServicesOptions {\n\tservices: AgentSessionServices;\n\tsessionManager: SessionManager;\n\tsessionStartEvent?: SessionStartEvent;\n\tmodel?: Model<Api>;\n\tthinkingLevel?: ThinkingLevel;\n\tscopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\ttools?: CreateAgentSessionOptions[\"tools\"];\n\texcludedTools?: CreateAgentSessionOptions[\"excludedTools\"];\n\tnoTools?: CreateAgentSessionOptions[\"noTools\"];\n\tcustomTools?: ToolDefinition[];\n}\n\n/**\n * Coherent cwd-bound runtime services for one effective session cwd.\n *\n * This is infrastructure only. The AgentSession itself is created separately so\n * session options can be resolved against these services first.\n */\nexport interface AgentSessionServices {\n\tcwd: string;\n\tagentDir: string;\n\tauthStorage: AuthStorage;\n\tsettingsManager: SettingsManager;\n\tmodelRegistry: ModelRegistry;\n\tresourceLoader: ResourceLoader;\n\tdiagnostics: AgentSessionRuntimeDiagnostic[];\n}\n\nfunction applyExtensionFlagValues(\n\tresourceLoader: ResourceLoader,\n\textensionFlagValues: Map<string, boolean | string> | undefined,\n): AgentSessionRuntimeDiagnostic[] {\n\tif (!extensionFlagValues) {\n\t\treturn [];\n\t}\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tconst registeredFlags = new Map<string, { type: \"boolean\" | \"string\" }>();\n\tfor (const extension of extensionsResult.extensions) {\n\t\tfor (const [name, flag] of extension.flags) {\n\t\t\tregisteredFlags.set(name, { type: flag.type });\n\t\t}\n\t}\n\n\tconst unknownFlags: string[] = [];\n\tfor (const [name, value] of extensionFlagValues) {\n\t\tconst flag = registeredFlags.get(name);\n\t\tif (!flag) {\n\t\t\tunknownFlags.push(name);\n\t\t\tcontinue;\n\t\t}\n\t\tif (flag.type === \"boolean\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, true);\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"string\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, value);\n\t\t\tcontinue;\n\t\t}\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Extension flag \"--${name}\" requires a value`,\n\t\t});\n\t}\n\n\tif (unknownFlags.length > 0) {\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Unknown option${unknownFlags.length === 1 ? \"\" : \"s\"}: ${unknownFlags.map((name) => `--${name}`).join(\", \")}`,\n\t\t});\n\t}\n\n\treturn diagnostics;\n}\n\n/**\n * Create cwd-bound runtime services.\n *\n * Returns services plus diagnostics. It does not create an AgentSession.\n */\nexport async function createAgentSessionServices(\n\toptions: CreateAgentSessionServicesOptions,\n): Promise<AgentSessionServices> {\n\tconst cwd = resolvePath(options.cwd);\n\tconst agentDir = options.agentDir ? resolvePath(options.agentDir) : getAgentDir();\n\tconst authStorage = options.authStorage ?? AuthStorage.create(join(agentDir, \"auth.json\"));\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, join(agentDir, \"models.json\"));\n\tconst resourceLoader = new DefaultResourceLoader({\n\t\t...(options.resourceLoaderOptions ?? {}),\n\t\tcwd,\n\t\tagentDir,\n\t\tsettingsManager,\n\t});\n\tawait resourceLoader.reload();\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tfor (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {\n\t\ttry {\n\t\t\tmodelRegistry.registerProvider(name, config);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tdiagnostics.push({\n\t\t\t\ttype: \"error\",\n\t\t\t\tmessage: `Extension \"${extensionPath}\" error: ${message}`,\n\t\t\t});\n\t\t}\n\t}\n\textensionsResult.runtime.pendingProviderRegistrations = [];\n\tdiagnostics.push(...applyExtensionFlagValues(resourceLoader, options.extensionFlagValues));\n\n\treturn {\n\t\tcwd,\n\t\tagentDir,\n\t\tauthStorage,\n\t\tsettingsManager,\n\t\tmodelRegistry,\n\t\tresourceLoader,\n\t\tdiagnostics,\n\t};\n}\n\n/**\n * Create an AgentSession from previously created services.\n *\n * This keeps session creation separate from service creation so callers can\n * resolve model, thinking, tools, and other session inputs against the target\n * cwd before constructing the session.\n */\nexport async function createAgentSessionFromServices(\n\toptions: CreateAgentSessionFromServicesOptions,\n): Promise<CreateAgentSessionResult> {\n\treturn createAgentSession({\n\t\tcwd: options.services.cwd,\n\t\tagentDir: options.services.agentDir,\n\t\tauthStorage: options.services.authStorage,\n\t\tsettingsManager: options.services.settingsManager,\n\t\tmodelRegistry: options.services.modelRegistry,\n\t\tresourceLoader: options.services.resourceLoader,\n\t\tsessionManager: options.sessionManager,\n\t\tmodel: options.model,\n\t\tthinkingLevel: options.thinkingLevel,\n\t\tscopedModels: options.scopedModels,\n\t\ttools: options.tools,\n\t\texcludedTools: options.excludedTools,\n\t\tnoTools: options.noTools,\n\t\tcustomTools: options.customTools,\n\t\tsessionStartEvent: options.sessionStartEvent,\n\t});\n}\n"]}
+{"version":3,"file":"agent-session-services.js","sourceRoot":"","sources":["../../src/core/agent-session-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAA0D,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAiE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE7G,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAkE9D,SAAS,wBAAwB,CAChC,cAA8B,EAC9B,mBAA8D;IAE9D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,WAAW,GAAoC,EAAE,CAAC;IACxD,MAAM,gBAAgB,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC;IACxD,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0C,CAAC;IAC1E,KAAK,MAAM,SAAS,IAAI,gBAAgB,CAAC,UAAU,EAAE,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5C,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACF,CAAC;IAED,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACV,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACpD,SAAS;QACV,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrD,SAAS;QACV,CAAC;QACD,WAAW,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,qBAAqB,IAAI,oBAAoB;SACtD,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,WAAW,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,iBAAiB,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACvH,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC/C,OAA0C;IAE1C,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAClF,MAAM,eAAe,GAAG,eAAe,CAAC,wCAAwC,CAAC,CAAC;IAClF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3F,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,eAAe,CAAC,4CAA4C,CAAC,CAAC;IACnF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzF,aAAa,CAAC,YAAY,CAAC,CAAC;IAC5B,MAAM,iBAAiB,GAAG,eAAe,CAAC,0CAA0C,CAAC,CAAC;IACtF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAChH,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACjC,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAC;QACxC,GAAG;QACH,QAAQ;QACR,eAAe;KACf,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,eAAe,CAAC,kDAAkD,CAAC,CAAC;IACvF,MAAM,cAAc,CAAC,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,UAAU,CAAC,CAAC;IAE1B,MAAM,WAAW,GAAoC,EAAE,CAAC;IACxD,MAAM,YAAY,GAAG,eAAe,CAAC,kDAAkD,CAAC,CAAC;IACzF,MAAM,gBAAgB,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC;IACxD,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC;QACrG,IAAI,CAAC;YACJ,aAAa,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,WAAW,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,cAAc,aAAa,YAAY,OAAO,EAAE;aACzD,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IACD,gBAAgB,CAAC,OAAO,CAAC,4BAA4B,GAAG,EAAE,CAAC;IAC3D,aAAa,CAAC,YAAY,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,oDAAoD,CAAC,CAAC;IACvF,WAAW,CAAC,IAAI,CAAC,GAAG,wBAAwB,CAAC,cAAc,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC3F,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExB,OAAO;QACN,GAAG;QACH,QAAQ;QACR,WAAW;QACX,eAAe;QACf,aAAa;QACb,cAAc;QACd,WAAW;KACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CACnD,OAA8C;IAE9C,OAAO,kBAAkB,CAAC;QACzB,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG;QACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ;QACnC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW;QACzC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,eAAe;QACjD,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa;QAC7C,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;QAC/C,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC5C,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport type { SessionStartEvent, ToolDefinition } from \"./extensions/index.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { DefaultResourceLoader, type DefaultResourceLoaderOptions, type ResourceLoader } from \"./resource-loader.ts\";\nimport { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession } from \"./sdk.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { endTimingSpan, startTimingSpan } from \"./timings.ts\";\n\n/**\n * Non-fatal issues collected while creating services or sessions.\n *\n * Runtime creation returns diagnostics to the caller instead of printing or\n * exiting. The app layer decides whether warnings should be shown and whether\n * errors should abort startup.\n */\nexport interface AgentSessionRuntimeDiagnostic {\n\ttype: \"info\" | \"warning\" | \"error\";\n\tmessage: string;\n}\n\n/**\n * Inputs for creating cwd-bound runtime services.\n *\n * These services are recreated whenever the effective session cwd changes.\n * CLI-provided resource paths should be resolved to absolute paths before they\n * reach this function, so later cwd switches do not reinterpret them.\n */\nexport interface CreateAgentSessionServicesOptions {\n\tcwd: string;\n\tagentDir?: string;\n\tauthStorage?: AuthStorage;\n\tsettingsManager?: SettingsManager;\n\tmodelRegistry?: ModelRegistry;\n\textensionFlagValues?: Map<string, boolean | string>;\n\tresourceLoaderOptions?: Omit<DefaultResourceLoaderOptions, \"cwd\" | \"agentDir\" | \"settingsManager\">;\n}\n\n/**\n * Inputs for creating an AgentSession from already-created services.\n *\n * Use this after services exist and any cwd-bound model/tool/session options\n * have been resolved against those services.\n */\nexport interface CreateAgentSessionFromServicesOptions {\n\tservices: AgentSessionServices;\n\tsessionManager: SessionManager;\n\tsessionStartEvent?: SessionStartEvent;\n\tmodel?: Model<Api>;\n\tthinkingLevel?: ThinkingLevel;\n\tscopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\ttools?: CreateAgentSessionOptions[\"tools\"];\n\texcludedTools?: CreateAgentSessionOptions[\"excludedTools\"];\n\tnoTools?: CreateAgentSessionOptions[\"noTools\"];\n\tcustomTools?: ToolDefinition[];\n}\n\n/**\n * Coherent cwd-bound runtime services for one effective session cwd.\n *\n * This is infrastructure only. The AgentSession itself is created separately so\n * session options can be resolved against these services first.\n */\nexport interface AgentSessionServices {\n\tcwd: string;\n\tagentDir: string;\n\tauthStorage: AuthStorage;\n\tsettingsManager: SettingsManager;\n\tmodelRegistry: ModelRegistry;\n\tresourceLoader: ResourceLoader;\n\tdiagnostics: AgentSessionRuntimeDiagnostic[];\n}\n\nfunction applyExtensionFlagValues(\n\tresourceLoader: ResourceLoader,\n\textensionFlagValues: Map<string, boolean | string> | undefined,\n): AgentSessionRuntimeDiagnostic[] {\n\tif (!extensionFlagValues) {\n\t\treturn [];\n\t}\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tconst registeredFlags = new Map<string, { type: \"boolean\" | \"string\" }>();\n\tfor (const extension of extensionsResult.extensions) {\n\t\tfor (const [name, flag] of extension.flags) {\n\t\t\tregisteredFlags.set(name, { type: flag.type });\n\t\t}\n\t}\n\n\tconst unknownFlags: string[] = [];\n\tfor (const [name, value] of extensionFlagValues) {\n\t\tconst flag = registeredFlags.get(name);\n\t\tif (!flag) {\n\t\t\tunknownFlags.push(name);\n\t\t\tcontinue;\n\t\t}\n\t\tif (flag.type === \"boolean\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, true);\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"string\") {\n\t\t\textensionsResult.runtime.flagValues.set(name, value);\n\t\t\tcontinue;\n\t\t}\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Extension flag \"--${name}\" requires a value`,\n\t\t});\n\t}\n\n\tif (unknownFlags.length > 0) {\n\t\tdiagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `Unknown option${unknownFlags.length === 1 ? \"\" : \"s\"}: ${unknownFlags.map((name) => `--${name}`).join(\", \")}`,\n\t\t});\n\t}\n\n\treturn diagnostics;\n}\n\n/**\n * Create cwd-bound runtime services.\n *\n * Returns services plus diagnostics. It does not create an AgentSession.\n */\nexport async function createAgentSessionServices(\n\toptions: CreateAgentSessionServicesOptions,\n): Promise<AgentSessionServices> {\n\tconst cwd = resolvePath(options.cwd);\n\tconst agentDir = options.agentDir ? resolvePath(options.agentDir) : getAgentDir();\n\tconst authStorageSpan = startTimingSpan(\"createAgentSessionServices.authStorage\");\n\tconst authStorage = options.authStorage ?? AuthStorage.create(join(agentDir, \"auth.json\"));\n\tendTimingSpan(authStorageSpan);\n\tconst settingsSpan = startTimingSpan(\"createAgentSessionServices.settingsManager\");\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tendTimingSpan(settingsSpan);\n\tconst modelRegistrySpan = startTimingSpan(\"createAgentSessionServices.modelRegistry\");\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, join(agentDir, \"models.json\"));\n\tendTimingSpan(modelRegistrySpan);\n\tconst resourceLoader = new DefaultResourceLoader({\n\t\t...(options.resourceLoaderOptions ?? {}),\n\t\tcwd,\n\t\tagentDir,\n\t\tsettingsManager,\n\t});\n\tconst reloadSpan = startTimingSpan(\"createAgentSessionServices.resourceLoader.reload\");\n\tawait resourceLoader.reload();\n\tendTimingSpan(reloadSpan);\n\n\tconst diagnostics: AgentSessionRuntimeDiagnostic[] = [];\n\tconst providerSpan = startTimingSpan(\"createAgentSessionServices.providerRegistrations\");\n\tconst extensionsResult = resourceLoader.getExtensions();\n\tfor (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {\n\t\ttry {\n\t\t\tmodelRegistry.registerProvider(name, config);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tdiagnostics.push({\n\t\t\t\ttype: \"error\",\n\t\t\t\tmessage: `Extension \"${extensionPath}\" error: ${message}`,\n\t\t\t});\n\t\t}\n\t}\n\textensionsResult.runtime.pendingProviderRegistrations = [];\n\tendTimingSpan(providerSpan);\n\tconst flagSpan = startTimingSpan(\"createAgentSessionServices.extensionFlagValidation\");\n\tdiagnostics.push(...applyExtensionFlagValues(resourceLoader, options.extensionFlagValues));\n\tendTimingSpan(flagSpan);\n\n\treturn {\n\t\tcwd,\n\t\tagentDir,\n\t\tauthStorage,\n\t\tsettingsManager,\n\t\tmodelRegistry,\n\t\tresourceLoader,\n\t\tdiagnostics,\n\t};\n}\n\n/**\n * Create an AgentSession from previously created services.\n *\n * This keeps session creation separate from service creation so callers can\n * resolve model, thinking, tools, and other session inputs against the target\n * cwd before constructing the session.\n */\nexport async function createAgentSessionFromServices(\n\toptions: CreateAgentSessionFromServicesOptions,\n): Promise<CreateAgentSessionResult> {\n\treturn createAgentSession({\n\t\tcwd: options.services.cwd,\n\t\tagentDir: options.services.agentDir,\n\t\tauthStorage: options.services.authStorage,\n\t\tsettingsManager: options.services.settingsManager,\n\t\tmodelRegistry: options.services.modelRegistry,\n\t\tresourceLoader: options.services.resourceLoader,\n\t\tsessionManager: options.sessionManager,\n\t\tmodel: options.model,\n\t\tthinkingLevel: options.thinkingLevel,\n\t\tscopedModels: options.scopedModels,\n\t\ttools: options.tools,\n\t\texcludedTools: options.excludedTools,\n\t\tnoTools: options.noTools,\n\t\tcustomTools: options.customTools,\n\t\tsessionStartEvent: options.sessionStartEvent,\n\t});\n}\n"]}

package/dist/core/extensions/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EACV,SAAS,EAET,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AA8FpB,MAAM,WAAW,wBAAwB;IACvC,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC1B,OAAO,CAAC,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,GAAG,gBAAgB,EAAE,CAAC;AAc1F;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAsDzD;AAiRD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAa,EAC1B,wBAAwB,GAAE,6BAA6D,GACtF,OAAO,CAAC,SAAS,CAAC,CAYpB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,QAAQ,EACnB,wBAAwB,GAAE,6BAA6D,GACtF,OAAO,CAAC,oBAAoB,CAAC,CA+B/B;AAqID;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,MAAM,EAAE,EACzB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAsB,EAChC,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,oBAAoB,CAAC,CA4C/B","sourcesContent":["/**\n * Extension loader - loads TypeScript extension modules using jiti.\n *\n */\n\nimport * as fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport * as _bundledPiAgentCore from \"@earendil-works/pi-agent-core\";\nimport * as _bundledPiAi from \"@earendil-works/pi-ai\";\nimport * as _bundledPiAiOauth from \"@earendil-works/pi-ai/oauth\";\nimport type { KeyId } from \"@earendil-works/pi-tui\";\nimport * as _bundledPiTui from \"@earendil-works/pi-tui\";\nimport { createJiti } from \"jiti/static\";\n// Static imports of packages that extensions may use.\n// These MUST be static so Bun bundles them into the compiled binary.\n// The virtualModules option then makes them available to extensions.\nimport * as _bundledTypebox from \"typebox\";\nimport * as _bundledTypeboxCompile from \"typebox/compile\";\nimport * as _bundledTypeboxValue from \"typebox/value\";\nimport {\n  APP_NAME,\n  CONFIG_DIR_NAME,\n  getAgentDir,\n  isBunBinary,\n} from \"../../config.ts\";\n// NOTE: This import works because loader.ts exports are NOT re-exported from index.ts,\n// avoiding a circular dependency. Extensions can import from the Atomic package\n// name (or upstream-compatible pi package names).\nimport * as _bundledPiCodingAgent from \"../../index.ts\";\nimport { resolvePath } from \"../../utils/paths.ts\";\nimport { createEventBus, type EventBus } from \"../event-bus.ts\";\nimport type { ExecOptions } from \"../exec.ts\";\nimport type { ResolvedResource } from \"../package-manager.ts\";\nimport { execCommand } from \"../exec.ts\";\nimport { createSyntheticSourceInfo } from \"../source-info.ts\";\nimport type {\n  Extension,\n  ExtensionAPI,\n  ExtensionFactory,\n  ExtensionRuntime,\n  LoadExtensionsResult,\n  MessageRenderer,\n  ProviderConfig,\n  RegisteredCommand,\n  ToolDefinition,\n} from \"./types.ts\";\n\n/** Modules available to extensions via virtualModules (for compiled Bun binary) */\nconst VIRTUAL_MODULES: Record<string, unknown> = {\n  typebox: _bundledTypebox,\n  \"typebox/compile\": _bundledTypeboxCompile,\n  \"typebox/value\": _bundledTypeboxValue,\n  \"@sinclair/typebox\": _bundledTypebox,\n  \"@sinclair/typebox/compile\": _bundledTypeboxCompile,\n  \"@sinclair/typebox/value\": _bundledTypeboxValue,\n  \"@earendil-works/pi-agent-core\": _bundledPiAgentCore,\n  \"@earendil-works/pi-tui\": _bundledPiTui,\n  \"@earendil-works/pi-ai\": _bundledPiAi,\n  \"@earendil-works/pi-ai/oauth\": _bundledPiAiOauth,\n  \"@bastani/atomic\": _bundledPiCodingAgent,\n  \"@mariozechner/pi-agent-core\": _bundledPiAgentCore,\n  \"@mariozechner/pi-tui\": _bundledPiTui,\n  \"@mariozechner/pi-ai\": _bundledPiAi,\n  \"@mariozechner/pi-ai/oauth\": _bundledPiAiOauth,\n};\n\nconst require = createRequire(import.meta.url);\n\n/**\n * Get aliases for jiti (used in Node.js/development mode).\n * In Bun binary mode, virtualModules is used instead.\n */\nlet _aliases: Record<string, string> | null = null;\n\nfunction getAliases(): Record<string, string> {\n  if (_aliases) return _aliases;\n\n  const __dirname = path.dirname(fileURLToPath(import.meta.url));\n  const packageIndex = path.resolve(__dirname, \"../..\", \"index.js\");\n\n  const typeboxEntry = require.resolve(\"typebox\");\n  const typeboxCompileEntry = require.resolve(\"typebox/compile\");\n  const typeboxValueEntry = require.resolve(\"typebox/value\");\n\n  const packagesRoot = path.resolve(__dirname, \"../../../../\");\n  const resolveWorkspaceOrImport = (\n    workspaceRelativePath: string,\n    specifier: string,\n  ): string => {\n    const workspacePath = path.join(packagesRoot, workspaceRelativePath);\n    if (fs.existsSync(workspacePath)) {\n      return workspacePath;\n    }\n    return fileURLToPath(import.meta.resolve(specifier));\n  };\n\n  const piCodingAgentEntry = packageIndex;\n  const piAgentCoreEntry = resolveWorkspaceOrImport(\n    \"agent/dist/index.js\",\n    \"@earendil-works/pi-agent-core\",\n  );\n  const piTuiEntry = resolveWorkspaceOrImport(\n    \"tui/dist/index.js\",\n    \"@earendil-works/pi-tui\",\n  );\n  const piAiEntry = resolveWorkspaceOrImport(\n    \"ai/dist/index.js\",\n    \"@earendil-works/pi-ai\",\n  );\n  const piAiOauthEntry = resolveWorkspaceOrImport(\n    \"ai/dist/oauth.js\",\n    \"@earendil-works/pi-ai/oauth\",\n  );\n\n  _aliases = {\n    \"@bastani/atomic\": piCodingAgentEntry,\n    \"@earendil-works/pi-coding-agent\": piCodingAgentEntry,\n    \"@earendil-works/pi-agent-core\": piAgentCoreEntry,\n    \"@earendil-works/pi-tui\": piTuiEntry,\n    \"@earendil-works/pi-ai\": piAiEntry,\n    \"@earendil-works/pi-ai/oauth\": piAiOauthEntry,\n    \"@mariozechner/pi-agent-core\": piAgentCoreEntry,\n    \"@mariozechner/pi-tui\": piTuiEntry,\n    \"@mariozechner/pi-ai\": piAiEntry,\n    \"@mariozechner/pi-ai/oauth\": piAiOauthEntry,\n    typebox: typeboxEntry,\n    \"typebox/compile\": typeboxCompileEntry,\n    \"typebox/value\": typeboxValueEntry,\n    \"@sinclair/typebox\": typeboxEntry,\n    \"@sinclair/typebox/compile\": typeboxCompileEntry,\n    \"@sinclair/typebox/value\": typeboxValueEntry,\n  };\n\n  return _aliases;\n}\n\n\ntype HandlerFn = (...args: unknown[]) => Promise<unknown>;\n\nexport interface WorkflowResourceProvider {\n  get(): ResolvedResource[];\n  refresh?(): Promise<ResolvedResource[]>;\n}\n\nexport type WorkflowResourceProviderInput = WorkflowResourceProvider | ResolvedResource[];\n\nfunction createStaticWorkflowResourceProvider(workflowResources: ResolvedResource[]): WorkflowResourceProvider {\n  return {\n    get: () => workflowResources,\n  };\n}\n\nfunction normalizeWorkflowResourceProvider(input: WorkflowResourceProviderInput): WorkflowResourceProvider {\n  return Array.isArray(input) ? createStaticWorkflowResourceProvider(input) : input;\n}\n\nconst emptyWorkflowResourceProvider = createStaticWorkflowResourceProvider([]);\n\n/**\n * Create a runtime with throwing stubs for action methods.\n * Runner.bindCore() replaces these with real implementations.\n */\nexport function createExtensionRuntime(): ExtensionRuntime {\n  const notInitialized = () => {\n    throw new Error(\n      \"Extension runtime not initialized. Action methods cannot be called during extension loading.\",\n    );\n  };\n  const state: { staleMessage?: string } = {};\n  const assertActive = () => {\n    if (state.staleMessage) {\n      throw new Error(state.staleMessage);\n    }\n  };\n\n  const runtime: ExtensionRuntime = {\n    sendMessage: notInitialized,\n    sendUserMessage: notInitialized,\n    appendEntry: notInitialized,\n    setSessionName: notInitialized,\n    getSessionName: notInitialized,\n    setLabel: notInitialized,\n    getActiveTools: notInitialized,\n    getAllTools: notInitialized,\n    setActiveTools: notInitialized,\n    // registerTool() is valid during extension load; refresh is only needed post-bind.\n    refreshTools: () => {},\n    getCommands: notInitialized,\n    setModel: () =>\n      Promise.reject(new Error(\"Extension runtime not initialized\")),\n    getThinkingLevel: notInitialized,\n    setThinkingLevel: notInitialized,\n    flagValues: new Map(),\n    pendingProviderRegistrations: [],\n    assertActive,\n    invalidate: (message) => {\n      state.staleMessage ??=\n        message ??\n        \"This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().\";\n    },\n    // Pre-bind: queue registrations so bindCore() can flush them once the\n    // model registry is available. bindCore() replaces both with direct calls.\n    registerProvider: (name, config, extensionPath = \"<unknown>\") => {\n      runtime.pendingProviderRegistrations.push({\n        name,\n        config,\n        extensionPath,\n      });\n    },\n    unregisterProvider: (name) => {\n      runtime.pendingProviderRegistrations =\n        runtime.pendingProviderRegistrations.filter((r) => r.name !== name);\n    },\n  };\n\n  return runtime;\n}\n\n/**\n * Create the ExtensionAPI for an extension.\n * Registration methods write to the extension object.\n * Action methods delegate to the shared runtime.\n */\nfunction createExtensionAPI(\n  extension: Extension,\n  runtime: ExtensionRuntime,\n  cwd: string,\n  eventBus: EventBus,\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): ExtensionAPI {\n  const workflowResources = normalizeWorkflowResourceProvider(workflowResourceProvider);\n  const api = {\n    // Registration methods - write to extension\n    on(event: string, handler: HandlerFn): void {\n      runtime.assertActive();\n      const list = extension.handlers.get(event) ?? [];\n      list.push(handler);\n      extension.handlers.set(event, list);\n    },\n\n    registerTool(tool: ToolDefinition): void {\n      runtime.assertActive();\n      extension.tools.set(tool.name, {\n        definition: tool,\n        sourceInfo: extension.sourceInfo,\n      });\n      runtime.refreshTools();\n    },\n\n    registerCommand(\n      name: string,\n      options: Omit<RegisteredCommand, \"name\" | \"sourceInfo\">,\n    ): void {\n      runtime.assertActive();\n      extension.commands.set(name, {\n        name,\n        sourceInfo: extension.sourceInfo,\n        ...options,\n      });\n    },\n\n    registerShortcut(\n      shortcut: KeyId,\n      options: {\n        description?: string;\n        handler: (\n          ctx: import(\"./types.ts\").ExtensionContext,\n        ) => Promise<void> | void;\n      },\n    ): void {\n      runtime.assertActive();\n      extension.shortcuts.set(shortcut, {\n        shortcut,\n        extensionPath: extension.path,\n        ...options,\n      });\n    },\n\n    registerFlag(\n      name: string,\n      options: {\n        description?: string;\n        type: \"boolean\" | \"string\";\n        default?: boolean | string;\n      },\n    ): void {\n      runtime.assertActive();\n      extension.flags.set(name, {\n        name,\n        extensionPath: extension.path,\n        ...options,\n      });\n      if (options.default !== undefined && !runtime.flagValues.has(name)) {\n        runtime.flagValues.set(name, options.default);\n      }\n    },\n\n    registerMessageRenderer<T>(\n      customType: string,\n      renderer: MessageRenderer<T>,\n    ): void {\n      runtime.assertActive();\n      extension.messageRenderers.set(customType, renderer as MessageRenderer);\n    },\n\n    // Flag access - checks extension registered it, reads from runtime\n    getFlag(name: string): boolean | string | undefined {\n      runtime.assertActive();\n      if (!extension.flags.has(name)) return undefined;\n      return runtime.flagValues.get(name);\n    },\n\n    getWorkflowResources(): ResolvedResource[] {\n      runtime.assertActive();\n      return [...workflowResources.get()];\n    },\n\n    async refreshWorkflowResources(): Promise<ResolvedResource[]> {\n      runtime.assertActive();\n      const refreshed = await workflowResources.refresh?.();\n      return [...(refreshed ?? workflowResources.get())];\n    },\n\n    // Action methods - delegate to shared runtime\n    sendMessage(message, options): void {\n      runtime.assertActive();\n      runtime.sendMessage(message, options);\n    },\n\n    sendUserMessage(content, options): void {\n      runtime.assertActive();\n      runtime.sendUserMessage(content, options);\n    },\n\n    appendEntry(customType: string, data?: unknown): void {\n      runtime.assertActive();\n      runtime.appendEntry(customType, data);\n    },\n\n    setSessionName(name: string): void {\n      runtime.assertActive();\n      runtime.setSessionName(name);\n    },\n\n    getSessionName(): string | undefined {\n      runtime.assertActive();\n      return runtime.getSessionName();\n    },\n\n    setLabel(entryId: string, label: string | undefined): void {\n      runtime.assertActive();\n      runtime.setLabel(entryId, label);\n    },\n\n    exec(command: string, args: string[], options?: ExecOptions) {\n      runtime.assertActive();\n      return execCommand(command, args, options?.cwd ?? cwd, options);\n    },\n\n    getActiveTools(): string[] {\n      runtime.assertActive();\n      return runtime.getActiveTools();\n    },\n\n    getAllTools() {\n      runtime.assertActive();\n      return runtime.getAllTools();\n    },\n\n    setActiveTools(toolNames: string[]): void {\n      runtime.assertActive();\n      runtime.setActiveTools(toolNames);\n    },\n\n    getCommands() {\n      runtime.assertActive();\n      return runtime.getCommands();\n    },\n\n    setModel(model) {\n      runtime.assertActive();\n      return runtime.setModel(model);\n    },\n\n    getThinkingLevel() {\n      runtime.assertActive();\n      return runtime.getThinkingLevel();\n    },\n\n    setThinkingLevel(level) {\n      runtime.assertActive();\n      runtime.setThinkingLevel(level);\n    },\n\n    registerProvider(name: string, config: ProviderConfig) {\n      runtime.assertActive();\n      runtime.registerProvider(name, config, extension.path);\n    },\n\n    unregisterProvider(name: string) {\n      runtime.assertActive();\n      runtime.unregisterProvider(name, extension.path);\n    },\n\n    events: eventBus,\n  } as ExtensionAPI;\n\n  return api;\n}\n\nasync function loadExtensionModule(extensionPath: string) {\n  const jiti = createJiti(import.meta.url, {\n    moduleCache: false,\n    // In Bun binary: use virtualModules for bundled packages (no filesystem resolution)\n    // Also disable tryNative so jiti handles ALL imports (not just the entry point)\n    // In Node.js/dev: use aliases to resolve to node_modules paths\n    ...(isBunBinary\n      ? { virtualModules: VIRTUAL_MODULES, tryNative: false }\n      : { alias: getAliases() }),\n  });\n\n  const module = await jiti.import(extensionPath, { default: true });\n  const factory = module as ExtensionFactory;\n  return typeof factory !== \"function\" ? undefined : factory;\n}\n\n/**\n * Create an Extension object with empty collections.\n */\nfunction createExtension(\n  extensionPath: string,\n  resolvedPath: string,\n): Extension {\n  const source =\n    extensionPath.startsWith(\"<\") && extensionPath.endsWith(\">\")\n      ? extensionPath.slice(1, -1).split(\":\")[0] || \"temporary\"\n      : \"local\";\n  const baseDir = extensionPath.startsWith(\"<\")\n    ? undefined\n    : path.dirname(resolvedPath);\n\n  return {\n    path: extensionPath,\n    resolvedPath,\n    sourceInfo: createSyntheticSourceInfo(extensionPath, { source, baseDir }),\n    handlers: new Map(),\n    tools: new Map(),\n    messageRenderers: new Map(),\n    commands: new Map(),\n    flags: new Map(),\n    shortcuts: new Map(),\n  };\n}\n\nasync function loadExtension(\n  extensionPath: string,\n  cwd: string,\n  eventBus: EventBus,\n  runtime: ExtensionRuntime,\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): Promise<{ extension: Extension | null; error: string | null }> {\n  const resolvedPath = resolvePath(extensionPath, cwd, { normalizeUnicodeSpaces: true });\n\n  try {\n    const factory = await loadExtensionModule(resolvedPath);\n    if (!factory) {\n      return {\n        extension: null,\n        error: `Extension does not export a valid factory function: ${extensionPath}`,\n      };\n    }\n\n    const extension = createExtension(extensionPath, resolvedPath);\n    const api = createExtensionAPI(\n      extension,\n      runtime,\n      cwd,\n      eventBus,\n      workflowResourceProvider,\n    );\n    await factory(api);\n\n    return { extension, error: null };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { extension: null, error: `Failed to load extension: ${message}` };\n  }\n}\n\n/**\n * Create an Extension from an inline factory function.\n */\nexport async function loadExtensionFromFactory(\n  factory: ExtensionFactory,\n  cwd: string,\n  eventBus: EventBus,\n  runtime: ExtensionRuntime,\n  extensionPath = \"<inline>\",\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): Promise<Extension> {\n  const extension = createExtension(extensionPath, extensionPath);\n  const resolvedCwd = resolvePath(cwd);\n  const api = createExtensionAPI(\n    extension,\n    runtime,\n    resolvedCwd,\n    eventBus,\n    workflowResourceProvider,\n  );\n  await factory(api);\n  return extension;\n}\n\n/**\n * Load extensions from paths.\n */\nexport async function loadExtensions(\n  paths: string[],\n  cwd: string,\n  eventBus?: EventBus,\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): Promise<LoadExtensionsResult> {\n  const extensions: Extension[] = [];\n  const errors: Array<{ path: string; error: string }> = [];\n  const resolvedCwd = resolvePath(cwd);\n  const resolvedEventBus = eventBus ?? createEventBus();\n  const runtime = createExtensionRuntime();\n\n  for (const extPath of paths) {\n    const { extension, error } = await loadExtension(\n      extPath,\n      resolvedCwd,\n      resolvedEventBus,\n      runtime,\n      workflowResourceProvider,\n    );\n\n    if (error) {\n      errors.push({ path: extPath, error });\n      continue;\n    }\n\n    if (extension) {\n      extensions.push(extension);\n    }\n  }\n\n  return {\n    extensions,\n    errors,\n    runtime,\n  };\n}\n\ninterface PiManifest {\n  extensions?: string[];\n  themes?: string[];\n  skills?: string[];\n  prompts?: string[];\n}\n\nfunction manifestFromPackageJson(\n  pkg: Record<string, unknown>,\n): PiManifest | null {\n  const appManifest = pkg[APP_NAME];\n  if (\n    appManifest &&\n    typeof appManifest === \"object\" &&\n    !Array.isArray(appManifest)\n  ) {\n    return appManifest as PiManifest;\n  }\n  const legacyManifest = pkg.pi;\n  if (\n    legacyManifest &&\n    typeof legacyManifest === \"object\" &&\n    !Array.isArray(legacyManifest)\n  ) {\n    return legacyManifest as PiManifest;\n  }\n  return null;\n}\n\nfunction readPiManifest(packageJsonPath: string): PiManifest | null {\n  try {\n    const content = fs.readFileSync(packageJsonPath, \"utf-8\");\n    const pkg = JSON.parse(content) as Record<string, unknown>;\n    return manifestFromPackageJson(pkg);\n  } catch {\n    return null;\n  }\n}\n\nfunction isExtensionFile(name: string): boolean {\n  return name.endsWith(\".ts\") || name.endsWith(\".js\");\n}\n\n/**\n * Resolve extension entry points from a directory.\n *\n * Checks for:\n * 1. package.json with \"pi.extensions\" field -> returns declared paths\n * 2. index.ts or index.js -> returns the index file\n *\n * Returns resolved paths or null if no entry points found.\n */\nfunction resolveExtensionEntries(dir: string): string[] | null {\n  // Check for package.json with \"pi\" field first\n  const packageJsonPath = path.join(dir, \"package.json\");\n  if (fs.existsSync(packageJsonPath)) {\n    const manifest = readPiManifest(packageJsonPath);\n    if (manifest?.extensions?.length) {\n      const entries: string[] = [];\n      for (const extPath of manifest.extensions) {\n        const resolvedExtPath = path.resolve(dir, extPath);\n        if (fs.existsSync(resolvedExtPath)) {\n          entries.push(resolvedExtPath);\n        }\n      }\n      if (entries.length > 0) {\n        return entries;\n      }\n    }\n  }\n\n  // Check for index.ts or index.js\n  const indexTs = path.join(dir, \"index.ts\");\n  const indexJs = path.join(dir, \"index.js\");\n  if (fs.existsSync(indexTs)) {\n    return [indexTs];\n  }\n  if (fs.existsSync(indexJs)) {\n    return [indexJs];\n  }\n\n  return null;\n}\n\n/**\n * Discover extensions in a directory.\n *\n * Discovery rules:\n * 1. Direct files: `extensions/*.ts` or `*.js` → load\n * 2. Subdirectory with index: `extensions/* /index.ts` or `index.js` → load\n * 3. Subdirectory with package.json: `extensions/* /package.json` with \"pi\" field → load what it declares\n *\n * No recursion beyond one level. Complex packages must use package.json manifest.\n */\nfunction discoverExtensionsInDir(dir: string): string[] {\n  if (!fs.existsSync(dir)) {\n    return [];\n  }\n\n  const discovered: string[] = [];\n\n  try {\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const entryPath = path.join(dir, entry.name);\n\n      // 1. Direct files: *.ts or *.js\n      if (\n        (entry.isFile() || entry.isSymbolicLink()) &&\n        isExtensionFile(entry.name)\n      ) {\n        discovered.push(entryPath);\n        continue;\n      }\n\n      // 2 & 3. Subdirectories\n      if (entry.isDirectory() || entry.isSymbolicLink()) {\n        const entries = resolveExtensionEntries(entryPath);\n        if (entries) {\n          discovered.push(...entries);\n        }\n      }\n    }\n  } catch {\n    return [];\n  }\n\n  return discovered;\n}\n\n/**\n * Discover and load extensions from standard locations.\n */\nexport async function discoverAndLoadExtensions(\n  configuredPaths: string[],\n  cwd: string,\n  agentDir: string = getAgentDir(),\n  eventBus?: EventBus,\n): Promise<LoadExtensionsResult> {\n  const resolvedCwd = resolvePath(cwd);\n  const resolvedAgentDir = resolvePath(agentDir);\n  const allPaths: string[] = [];\n  const seen = new Set<string>();\n\n  const addPaths = (paths: string[]) => {\n    for (const p of paths) {\n      const resolved = path.resolve(p);\n      if (!seen.has(resolved)) {\n        seen.add(resolved);\n        allPaths.push(p);\n      }\n    }\n  };\n\n  // 1. Project-local extensions: cwd/${CONFIG_DIR_NAME}/extensions/\n  const localExtDir = path.join(resolvedCwd, CONFIG_DIR_NAME, \"extensions\");\n  addPaths(discoverExtensionsInDir(localExtDir));\n\n  // 2. Global extensions: agentDir/extensions/\n  const globalExtDir = path.join(resolvedAgentDir, \"extensions\");\n  addPaths(discoverExtensionsInDir(globalExtDir));\n\n  // 3. Explicitly configured paths\n  for (const p of configuredPaths) {\n    const resolved = resolvePath(p, resolvedCwd, { normalizeUnicodeSpaces: true });\n    if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {\n      // Check for package.json with pi manifest or index.ts\n      const entries = resolveExtensionEntries(resolved);\n      if (entries) {\n        addPaths(entries);\n        continue;\n      }\n      // No explicit entries - discover individual files in directory\n      addPaths(discoverExtensionsInDir(resolved));\n      continue;\n    }\n\n    addPaths([resolved]);\n  }\n\n  return loadExtensions(allPaths, resolvedCwd, eventBus);\n\n}\n"]}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,OAAO,KAAK,EACV,SAAS,EAET,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AA8FpB,MAAM,WAAW,wBAAwB;IACvC,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC1B,OAAO,CAAC,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,GAAG,gBAAgB,EAAE,CAAC;AAc1F;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAsDzD;AAqRD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAa,EAC1B,wBAAwB,GAAE,6BAA6D,GACtF,OAAO,CAAC,SAAS,CAAC,CAYpB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,QAAQ,EACnB,wBAAwB,GAAE,6BAA6D,GACtF,OAAO,CAAC,oBAAoB,CAAC,CAiC/B;AAqID;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,MAAM,EAAE,EACzB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAsB,EAChC,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,oBAAoB,CAAC,CA4C/B","sourcesContent":["/**\n * Extension loader - loads TypeScript extension modules using jiti.\n *\n */\n\nimport * as fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport * as _bundledPiAgentCore from \"@earendil-works/pi-agent-core\";\nimport * as _bundledPiAi from \"@earendil-works/pi-ai\";\nimport * as _bundledPiAiOauth from \"@earendil-works/pi-ai/oauth\";\nimport type { KeyId } from \"@earendil-works/pi-tui\";\nimport * as _bundledPiTui from \"@earendil-works/pi-tui\";\nimport { createJiti } from \"jiti/static\";\n// Static imports of packages that extensions may use.\n// These MUST be static so Bun bundles them into the compiled binary.\n// The virtualModules option then makes them available to extensions.\nimport * as _bundledTypebox from \"typebox\";\nimport * as _bundledTypeboxCompile from \"typebox/compile\";\nimport * as _bundledTypeboxValue from \"typebox/value\";\nimport {\n  APP_NAME,\n  CONFIG_DIR_NAME,\n  getAgentDir,\n  isBunBinary,\n} from \"../../config.ts\";\n// NOTE: This import works because loader.ts exports are NOT re-exported from index.ts,\n// avoiding a circular dependency. Extensions can import from the Atomic package\n// name (or upstream-compatible pi package names).\nimport * as _bundledPiCodingAgent from \"../../index.ts\";\nimport { resolvePath } from \"../../utils/paths.ts\";\nimport { createEventBus, type EventBus } from \"../event-bus.ts\";\nimport type { ExecOptions } from \"../exec.ts\";\nimport type { ResolvedResource } from \"../package-manager.ts\";\nimport { execCommand } from \"../exec.ts\";\nimport { createSyntheticSourceInfo } from \"../source-info.ts\";\nimport { endTimingSpan, startTimingSpan } from \"../timings.ts\";\nimport type {\n  Extension,\n  ExtensionAPI,\n  ExtensionFactory,\n  ExtensionRuntime,\n  LoadExtensionsResult,\n  MessageRenderer,\n  ProviderConfig,\n  RegisteredCommand,\n  ToolDefinition,\n} from \"./types.ts\";\n\n/** Modules available to extensions via virtualModules (for compiled Bun binary) */\nconst VIRTUAL_MODULES: Record<string, unknown> = {\n  typebox: _bundledTypebox,\n  \"typebox/compile\": _bundledTypeboxCompile,\n  \"typebox/value\": _bundledTypeboxValue,\n  \"@sinclair/typebox\": _bundledTypebox,\n  \"@sinclair/typebox/compile\": _bundledTypeboxCompile,\n  \"@sinclair/typebox/value\": _bundledTypeboxValue,\n  \"@earendil-works/pi-agent-core\": _bundledPiAgentCore,\n  \"@earendil-works/pi-tui\": _bundledPiTui,\n  \"@earendil-works/pi-ai\": _bundledPiAi,\n  \"@earendil-works/pi-ai/oauth\": _bundledPiAiOauth,\n  \"@bastani/atomic\": _bundledPiCodingAgent,\n  \"@mariozechner/pi-agent-core\": _bundledPiAgentCore,\n  \"@mariozechner/pi-tui\": _bundledPiTui,\n  \"@mariozechner/pi-ai\": _bundledPiAi,\n  \"@mariozechner/pi-ai/oauth\": _bundledPiAiOauth,\n};\n\nconst require = createRequire(import.meta.url);\n\n/**\n * Get aliases for jiti (used in Node.js/development mode).\n * In Bun binary mode, virtualModules is used instead.\n */\nlet _aliases: Record<string, string> | null = null;\n\nfunction getAliases(): Record<string, string> {\n  if (_aliases) return _aliases;\n\n  const __dirname = path.dirname(fileURLToPath(import.meta.url));\n  const packageIndex = path.resolve(__dirname, \"../..\", \"index.js\");\n\n  const typeboxEntry = require.resolve(\"typebox\");\n  const typeboxCompileEntry = require.resolve(\"typebox/compile\");\n  const typeboxValueEntry = require.resolve(\"typebox/value\");\n\n  const packagesRoot = path.resolve(__dirname, \"../../../../\");\n  const resolveWorkspaceOrImport = (\n    workspaceRelativePath: string,\n    specifier: string,\n  ): string => {\n    const workspacePath = path.join(packagesRoot, workspaceRelativePath);\n    if (fs.existsSync(workspacePath)) {\n      return workspacePath;\n    }\n    return fileURLToPath(import.meta.resolve(specifier));\n  };\n\n  const piCodingAgentEntry = packageIndex;\n  const piAgentCoreEntry = resolveWorkspaceOrImport(\n    \"agent/dist/index.js\",\n    \"@earendil-works/pi-agent-core\",\n  );\n  const piTuiEntry = resolveWorkspaceOrImport(\n    \"tui/dist/index.js\",\n    \"@earendil-works/pi-tui\",\n  );\n  const piAiEntry = resolveWorkspaceOrImport(\n    \"ai/dist/index.js\",\n    \"@earendil-works/pi-ai\",\n  );\n  const piAiOauthEntry = resolveWorkspaceOrImport(\n    \"ai/dist/oauth.js\",\n    \"@earendil-works/pi-ai/oauth\",\n  );\n\n  _aliases = {\n    \"@bastani/atomic\": piCodingAgentEntry,\n    \"@earendil-works/pi-coding-agent\": piCodingAgentEntry,\n    \"@earendil-works/pi-agent-core\": piAgentCoreEntry,\n    \"@earendil-works/pi-tui\": piTuiEntry,\n    \"@earendil-works/pi-ai\": piAiEntry,\n    \"@earendil-works/pi-ai/oauth\": piAiOauthEntry,\n    \"@mariozechner/pi-agent-core\": piAgentCoreEntry,\n    \"@mariozechner/pi-tui\": piTuiEntry,\n    \"@mariozechner/pi-ai\": piAiEntry,\n    \"@mariozechner/pi-ai/oauth\": piAiOauthEntry,\n    typebox: typeboxEntry,\n    \"typebox/compile\": typeboxCompileEntry,\n    \"typebox/value\": typeboxValueEntry,\n    \"@sinclair/typebox\": typeboxEntry,\n    \"@sinclair/typebox/compile\": typeboxCompileEntry,\n    \"@sinclair/typebox/value\": typeboxValueEntry,\n  };\n\n  return _aliases;\n}\n\n\ntype HandlerFn = (...args: unknown[]) => Promise<unknown>;\n\nexport interface WorkflowResourceProvider {\n  get(): ResolvedResource[];\n  refresh?(): Promise<ResolvedResource[]>;\n}\n\nexport type WorkflowResourceProviderInput = WorkflowResourceProvider | ResolvedResource[];\n\nfunction createStaticWorkflowResourceProvider(workflowResources: ResolvedResource[]): WorkflowResourceProvider {\n  return {\n    get: () => workflowResources,\n  };\n}\n\nfunction normalizeWorkflowResourceProvider(input: WorkflowResourceProviderInput): WorkflowResourceProvider {\n  return Array.isArray(input) ? createStaticWorkflowResourceProvider(input) : input;\n}\n\nconst emptyWorkflowResourceProvider = createStaticWorkflowResourceProvider([]);\n\n/**\n * Create a runtime with throwing stubs for action methods.\n * Runner.bindCore() replaces these with real implementations.\n */\nexport function createExtensionRuntime(): ExtensionRuntime {\n  const notInitialized = () => {\n    throw new Error(\n      \"Extension runtime not initialized. Action methods cannot be called during extension loading.\",\n    );\n  };\n  const state: { staleMessage?: string } = {};\n  const assertActive = () => {\n    if (state.staleMessage) {\n      throw new Error(state.staleMessage);\n    }\n  };\n\n  const runtime: ExtensionRuntime = {\n    sendMessage: notInitialized,\n    sendUserMessage: notInitialized,\n    appendEntry: notInitialized,\n    setSessionName: notInitialized,\n    getSessionName: notInitialized,\n    setLabel: notInitialized,\n    getActiveTools: notInitialized,\n    getAllTools: notInitialized,\n    setActiveTools: notInitialized,\n    // registerTool() is valid during extension load; refresh is only needed post-bind.\n    refreshTools: () => {},\n    getCommands: notInitialized,\n    setModel: () =>\n      Promise.reject(new Error(\"Extension runtime not initialized\")),\n    getThinkingLevel: notInitialized,\n    setThinkingLevel: notInitialized,\n    flagValues: new Map(),\n    pendingProviderRegistrations: [],\n    assertActive,\n    invalidate: (message) => {\n      state.staleMessage ??=\n        message ??\n        \"This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().\";\n    },\n    // Pre-bind: queue registrations so bindCore() can flush them once the\n    // model registry is available. bindCore() replaces both with direct calls.\n    registerProvider: (name, config, extensionPath = \"<unknown>\") => {\n      runtime.pendingProviderRegistrations.push({\n        name,\n        config,\n        extensionPath,\n      });\n    },\n    unregisterProvider: (name) => {\n      runtime.pendingProviderRegistrations =\n        runtime.pendingProviderRegistrations.filter((r) => r.name !== name);\n    },\n  };\n\n  return runtime;\n}\n\n/**\n * Create the ExtensionAPI for an extension.\n * Registration methods write to the extension object.\n * Action methods delegate to the shared runtime.\n */\nfunction createExtensionAPI(\n  extension: Extension,\n  runtime: ExtensionRuntime,\n  cwd: string,\n  eventBus: EventBus,\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): ExtensionAPI {\n  const workflowResources = normalizeWorkflowResourceProvider(workflowResourceProvider);\n  const api = {\n    // Registration methods - write to extension\n    on(event: string, handler: HandlerFn): void {\n      runtime.assertActive();\n      const list = extension.handlers.get(event) ?? [];\n      list.push(handler);\n      extension.handlers.set(event, list);\n    },\n\n    registerTool(tool: ToolDefinition): void {\n      runtime.assertActive();\n      extension.tools.set(tool.name, {\n        definition: tool,\n        sourceInfo: extension.sourceInfo,\n      });\n      runtime.refreshTools();\n    },\n\n    registerCommand(\n      name: string,\n      options: Omit<RegisteredCommand, \"name\" | \"sourceInfo\">,\n    ): void {\n      runtime.assertActive();\n      extension.commands.set(name, {\n        name,\n        sourceInfo: extension.sourceInfo,\n        ...options,\n      });\n    },\n\n    registerShortcut(\n      shortcut: KeyId,\n      options: {\n        description?: string;\n        handler: (\n          ctx: import(\"./types.ts\").ExtensionContext,\n        ) => Promise<void> | void;\n      },\n    ): void {\n      runtime.assertActive();\n      extension.shortcuts.set(shortcut, {\n        shortcut,\n        extensionPath: extension.path,\n        ...options,\n      });\n    },\n\n    registerFlag(\n      name: string,\n      options: {\n        description?: string;\n        type: \"boolean\" | \"string\";\n        default?: boolean | string;\n      },\n    ): void {\n      runtime.assertActive();\n      extension.flags.set(name, {\n        name,\n        extensionPath: extension.path,\n        ...options,\n      });\n      if (options.default !== undefined && !runtime.flagValues.has(name)) {\n        runtime.flagValues.set(name, options.default);\n      }\n    },\n\n    registerMessageRenderer<T>(\n      customType: string,\n      renderer: MessageRenderer<T>,\n    ): void {\n      runtime.assertActive();\n      extension.messageRenderers.set(customType, renderer as MessageRenderer);\n    },\n\n    // Flag access - checks extension registered it, reads from runtime\n    getFlag(name: string): boolean | string | undefined {\n      runtime.assertActive();\n      if (!extension.flags.has(name)) return undefined;\n      return runtime.flagValues.get(name);\n    },\n\n    getWorkflowResources(): ResolvedResource[] {\n      runtime.assertActive();\n      return [...workflowResources.get()];\n    },\n\n    async refreshWorkflowResources(): Promise<ResolvedResource[]> {\n      runtime.assertActive();\n      const refreshed = await workflowResources.refresh?.();\n      return [...(refreshed ?? workflowResources.get())];\n    },\n\n    // Action methods - delegate to shared runtime\n    sendMessage(message, options): void {\n      runtime.assertActive();\n      runtime.sendMessage(message, options);\n    },\n\n    sendUserMessage(content, options): void {\n      runtime.assertActive();\n      runtime.sendUserMessage(content, options);\n    },\n\n    appendEntry(customType: string, data?: unknown): void {\n      runtime.assertActive();\n      runtime.appendEntry(customType, data);\n    },\n\n    setSessionName(name: string): void {\n      runtime.assertActive();\n      runtime.setSessionName(name);\n    },\n\n    getSessionName(): string | undefined {\n      runtime.assertActive();\n      return runtime.getSessionName();\n    },\n\n    setLabel(entryId: string, label: string | undefined): void {\n      runtime.assertActive();\n      runtime.setLabel(entryId, label);\n    },\n\n    exec(command: string, args: string[], options?: ExecOptions) {\n      runtime.assertActive();\n      return execCommand(command, args, options?.cwd ?? cwd, options);\n    },\n\n    getActiveTools(): string[] {\n      runtime.assertActive();\n      return runtime.getActiveTools();\n    },\n\n    getAllTools() {\n      runtime.assertActive();\n      return runtime.getAllTools();\n    },\n\n    setActiveTools(toolNames: string[]): void {\n      runtime.assertActive();\n      runtime.setActiveTools(toolNames);\n    },\n\n    getCommands() {\n      runtime.assertActive();\n      return runtime.getCommands();\n    },\n\n    setModel(model) {\n      runtime.assertActive();\n      return runtime.setModel(model);\n    },\n\n    getThinkingLevel() {\n      runtime.assertActive();\n      return runtime.getThinkingLevel();\n    },\n\n    setThinkingLevel(level) {\n      runtime.assertActive();\n      runtime.setThinkingLevel(level);\n    },\n\n    registerProvider(name: string, config: ProviderConfig) {\n      runtime.assertActive();\n      runtime.registerProvider(name, config, extension.path);\n    },\n\n    unregisterProvider(name: string) {\n      runtime.assertActive();\n      runtime.unregisterProvider(name, extension.path);\n    },\n\n    events: eventBus,\n  } as ExtensionAPI;\n\n  return api;\n}\n\nasync function loadExtensionModule(extensionPath: string) {\n  const jiti = createJiti(import.meta.url, {\n    moduleCache: false,\n    // In Bun binary: use virtualModules for bundled packages (no filesystem resolution)\n    // Also disable tryNative so jiti handles ALL imports (not just the entry point)\n    // In Node.js/dev: use aliases to resolve to node_modules paths\n    ...(isBunBinary\n      ? { virtualModules: VIRTUAL_MODULES, tryNative: false }\n      : { alias: getAliases() }),\n  });\n\n  const module = await jiti.import(extensionPath, { default: true });\n  const factory = module as ExtensionFactory;\n  return typeof factory !== \"function\" ? undefined : factory;\n}\n\n/**\n * Create an Extension object with empty collections.\n */\nfunction createExtension(\n  extensionPath: string,\n  resolvedPath: string,\n): Extension {\n  const source =\n    extensionPath.startsWith(\"<\") && extensionPath.endsWith(\">\")\n      ? extensionPath.slice(1, -1).split(\":\")[0] || \"temporary\"\n      : \"local\";\n  const baseDir = extensionPath.startsWith(\"<\")\n    ? undefined\n    : path.dirname(resolvedPath);\n\n  return {\n    path: extensionPath,\n    resolvedPath,\n    sourceInfo: createSyntheticSourceInfo(extensionPath, { source, baseDir }),\n    handlers: new Map(),\n    tools: new Map(),\n    messageRenderers: new Map(),\n    commands: new Map(),\n    flags: new Map(),\n    shortcuts: new Map(),\n  };\n}\n\nasync function loadExtension(\n  extensionPath: string,\n  cwd: string,\n  eventBus: EventBus,\n  runtime: ExtensionRuntime,\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): Promise<{ extension: Extension | null; error: string | null }> {\n  const resolvedPath = resolvePath(extensionPath, cwd, { normalizeUnicodeSpaces: true });\n\n  try {\n    const moduleSpan = startTimingSpan(`loadExtensions.${extensionPath}.module`);\n    const factory = await loadExtensionModule(resolvedPath);\n    endTimingSpan(moduleSpan);\n    if (!factory) {\n      return {\n        extension: null,\n        error: `Extension does not export a valid factory function: ${extensionPath}`,\n      };\n    }\n\n    const extension = createExtension(extensionPath, resolvedPath);\n    const api = createExtensionAPI(\n      extension,\n      runtime,\n      cwd,\n      eventBus,\n      workflowResourceProvider,\n    );\n    const factorySpan = startTimingSpan(`loadExtensions.${extensionPath}.factory`);\n    await factory(api);\n    endTimingSpan(factorySpan);\n\n    return { extension, error: null };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { extension: null, error: `Failed to load extension: ${message}` };\n  }\n}\n\n/**\n * Create an Extension from an inline factory function.\n */\nexport async function loadExtensionFromFactory(\n  factory: ExtensionFactory,\n  cwd: string,\n  eventBus: EventBus,\n  runtime: ExtensionRuntime,\n  extensionPath = \"<inline>\",\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): Promise<Extension> {\n  const extension = createExtension(extensionPath, extensionPath);\n  const resolvedCwd = resolvePath(cwd);\n  const api = createExtensionAPI(\n    extension,\n    runtime,\n    resolvedCwd,\n    eventBus,\n    workflowResourceProvider,\n  );\n  await factory(api);\n  return extension;\n}\n\n/**\n * Load extensions from paths.\n */\nexport async function loadExtensions(\n  paths: string[],\n  cwd: string,\n  eventBus?: EventBus,\n  workflowResourceProvider: WorkflowResourceProviderInput = emptyWorkflowResourceProvider,\n): Promise<LoadExtensionsResult> {\n  const extensions: Extension[] = [];\n  const errors: Array<{ path: string; error: string }> = [];\n  const resolvedCwd = resolvePath(cwd);\n  const resolvedEventBus = eventBus ?? createEventBus();\n  const runtime = createExtensionRuntime();\n\n  for (const extPath of paths) {\n    const extensionSpan = startTimingSpan(`loadExtensions.${extPath}.total`);\n    const { extension, error } = await loadExtension(\n      extPath,\n      resolvedCwd,\n      resolvedEventBus,\n      runtime,\n      workflowResourceProvider,\n    );\n    endTimingSpan(extensionSpan);\n\n    if (error) {\n      errors.push({ path: extPath, error });\n      continue;\n    }\n\n    if (extension) {\n      extensions.push(extension);\n    }\n  }\n\n  return {\n    extensions,\n    errors,\n    runtime,\n  };\n}\n\ninterface PiManifest {\n  extensions?: string[];\n  themes?: string[];\n  skills?: string[];\n  prompts?: string[];\n}\n\nfunction manifestFromPackageJson(\n  pkg: Record<string, unknown>,\n): PiManifest | null {\n  const appManifest = pkg[APP_NAME];\n  if (\n    appManifest &&\n    typeof appManifest === \"object\" &&\n    !Array.isArray(appManifest)\n  ) {\n    return appManifest as PiManifest;\n  }\n  const legacyManifest = pkg.pi;\n  if (\n    legacyManifest &&\n    typeof legacyManifest === \"object\" &&\n    !Array.isArray(legacyManifest)\n  ) {\n    return legacyManifest as PiManifest;\n  }\n  return null;\n}\n\nfunction readPiManifest(packageJsonPath: string): PiManifest | null {\n  try {\n    const content = fs.readFileSync(packageJsonPath, \"utf-8\");\n    const pkg = JSON.parse(content) as Record<string, unknown>;\n    return manifestFromPackageJson(pkg);\n  } catch {\n    return null;\n  }\n}\n\nfunction isExtensionFile(name: string): boolean {\n  return name.endsWith(\".ts\") || name.endsWith(\".js\");\n}\n\n/**\n * Resolve extension entry points from a directory.\n *\n * Checks for:\n * 1. package.json with \"pi.extensions\" field -> returns declared paths\n * 2. index.ts or index.js -> returns the index file\n *\n * Returns resolved paths or null if no entry points found.\n */\nfunction resolveExtensionEntries(dir: string): string[] | null {\n  // Check for package.json with \"pi\" field first\n  const packageJsonPath = path.join(dir, \"package.json\");\n  if (fs.existsSync(packageJsonPath)) {\n    const manifest = readPiManifest(packageJsonPath);\n    if (manifest?.extensions?.length) {\n      const entries: string[] = [];\n      for (const extPath of manifest.extensions) {\n        const resolvedExtPath = path.resolve(dir, extPath);\n        if (fs.existsSync(resolvedExtPath)) {\n          entries.push(resolvedExtPath);\n        }\n      }\n      if (entries.length > 0) {\n        return entries;\n      }\n    }\n  }\n\n  // Check for index.ts or index.js\n  const indexTs = path.join(dir, \"index.ts\");\n  const indexJs = path.join(dir, \"index.js\");\n  if (fs.existsSync(indexTs)) {\n    return [indexTs];\n  }\n  if (fs.existsSync(indexJs)) {\n    return [indexJs];\n  }\n\n  return null;\n}\n\n/**\n * Discover extensions in a directory.\n *\n * Discovery rules:\n * 1. Direct files: `extensions/*.ts` or `*.js` → load\n * 2. Subdirectory with index: `extensions/* /index.ts` or `index.js` → load\n * 3. Subdirectory with package.json: `extensions/* /package.json` with \"pi\" field → load what it declares\n *\n * No recursion beyond one level. Complex packages must use package.json manifest.\n */\nfunction discoverExtensionsInDir(dir: string): string[] {\n  if (!fs.existsSync(dir)) {\n    return [];\n  }\n\n  const discovered: string[] = [];\n\n  try {\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const entryPath = path.join(dir, entry.name);\n\n      // 1. Direct files: *.ts or *.js\n      if (\n        (entry.isFile() || entry.isSymbolicLink()) &&\n        isExtensionFile(entry.name)\n      ) {\n        discovered.push(entryPath);\n        continue;\n      }\n\n      // 2 & 3. Subdirectories\n      if (entry.isDirectory() || entry.isSymbolicLink()) {\n        const entries = resolveExtensionEntries(entryPath);\n        if (entries) {\n          discovered.push(...entries);\n        }\n      }\n    }\n  } catch {\n    return [];\n  }\n\n  return discovered;\n}\n\n/**\n * Discover and load extensions from standard locations.\n */\nexport async function discoverAndLoadExtensions(\n  configuredPaths: string[],\n  cwd: string,\n  agentDir: string = getAgentDir(),\n  eventBus?: EventBus,\n): Promise<LoadExtensionsResult> {\n  const resolvedCwd = resolvePath(cwd);\n  const resolvedAgentDir = resolvePath(agentDir);\n  const allPaths: string[] = [];\n  const seen = new Set<string>();\n\n  const addPaths = (paths: string[]) => {\n    for (const p of paths) {\n      const resolved = path.resolve(p);\n      if (!seen.has(resolved)) {\n        seen.add(resolved);\n        allPaths.push(p);\n      }\n    }\n  };\n\n  // 1. Project-local extensions: cwd/${CONFIG_DIR_NAME}/extensions/\n  const localExtDir = path.join(resolvedCwd, CONFIG_DIR_NAME, \"extensions\");\n  addPaths(discoverExtensionsInDir(localExtDir));\n\n  // 2. Global extensions: agentDir/extensions/\n  const globalExtDir = path.join(resolvedAgentDir, \"extensions\");\n  addPaths(discoverExtensionsInDir(globalExtDir));\n\n  // 3. Explicitly configured paths\n  for (const p of configuredPaths) {\n    const resolved = resolvePath(p, resolvedCwd, { normalizeUnicodeSpaces: true });\n    if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {\n      // Check for package.json with pi manifest or index.ts\n      const entries = resolveExtensionEntries(resolved);\n      if (entries) {\n        addPaths(entries);\n        continue;\n      }\n      // No explicit entries - discover individual files in directory\n      addPaths(discoverExtensionsInDir(resolved));\n      continue;\n    }\n\n    addPaths([resolved]);\n  }\n\n  return loadExtensions(allPaths, resolvedCwd, eventBus);\n\n}\n"]}