@gajae-code/coding-agent 0.5.1 → 0.5.2

package/dist/types/modes/theme/defaults/index.d.ts

@@ -125,6 +125,308 @@ export declare const defaultThemes: {
             };
         };
     };
+    "claude-code": {
+        $schema: string;
+        name: string;
+        vars: {
+            "bg": string;
+            "surface": string;
+            "surfaceSubtle": string;
+            "separator": string;
+            "fg": string;
+            "muted": string;
+            "dim": string;
+            "brandTerracotta": string;
+            "shimmerTerracotta": string;
+            "toolPink": string;
+            "lavender": string;
+            "autoAcceptPurple": string;
+            "successGreen": string;
+            "warningAmber": string;
+            "errorSoftRed": string;
+            "diffAddedBg": string;
+            "diffRemovedBg": string;
+            "diffRemovedFg": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
+    codex: {
+        $schema: string;
+        name: string;
+        vars: {
+            "bg": string;
+            "surface": string;
+            "surfaceBright": string;
+            "selection": string;
+            "fg": string;
+            "muted": string;
+            "dim": string;
+            "borderNeutral": string;
+            "ansiCyan": string;
+            "cyanSoft": string;
+            "brandMagenta": string;
+            "magentaSoft": string;
+            "successGreen": string;
+            "errorRed": string;
+            "warningOrange": string;
+            "diffRemovalRed": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
+    opencode: {
+        $schema: string;
+        name: string;
+        vars: {
+            "background": string;
+            "currentLine": string;
+            "selection": string;
+            "backgroundDarker": string;
+            "foreground": string;
+            "comment": string;
+            "primary": string;
+            "secondary": string;
+            "accentPurple": string;
+            "errorRed": string;
+            "warningOrange": string;
+            "successGreen": string;
+            "infoCyan": string;
+            "emphasizedYellow": string;
+            "border": string;
+            "diffAdded": string;
+            "diffRemoved": string;
+            "diffContext": string;
+            "addedBg": string;
+            "removedBg": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
     "red-claw": {
         $schema: string;
         name: string;

package/dist/types/modes/theme/theme.d.ts

@@ -8,6 +8,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
  */
 export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
 export type SpinnerType = "status" | "activity";
+export declare const THEME_COLOR_KEYS: readonly ["accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text", "thinkingText", "selectedBg", "userMessageBg", "userMessageText", "customMessageBg", "customMessageText", "customMessageLabel", "toolPendingBg", "toolSuccessBg", "toolErrorBg", "toolTitle", "toolOutput", "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder", "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword", "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation", "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "bashMode", "pythonMode", "statusLineBg", "statusLineSep", "statusLineModel", "statusLinePath", "statusLineGitClean", "statusLineGitDirty", "statusLineContext", "statusLineSpend", "statusLineStaged", "statusLineDirty", "statusLineUntracked", "statusLineOutput", "statusLineCost", "statusLineSubagents"];
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
 export declare function isValidThemeColor(color: string): color is ThemeColor;

package/dist/types/modes/types.d.ts

@@ -93,7 +93,7 @@ export interface InteractiveModeContext {
     retryLoader: Loader | undefined;
     autoCompactionEscapeHandler?: () => void;
     retryEscapeHandler?: () => void;
-    retryCountdownTimer?: ReturnType<typeof setInterval>;
+    retryCountdownTimer?: NodeJS.Timeout;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
     optimisticUserMessageSignature: string | undefined;

package/dist/types/session/history-storage.d.ts

@@ -11,6 +11,6 @@ export declare class HistoryStorage {
     /** @internal Reset the singleton — test-only. */
     static resetInstance(): void;
     add(prompt: string, cwd?: string): Promise<void>;
-    getRecent(limit: number): HistoryEntry[];
-    search(query: string, limit: number): HistoryEntry[];
+    getRecent(limit: number, cwd?: string): HistoryEntry[];
+    search(query: string, limit: number, cwd?: string): HistoryEntry[];
 }

package/dist/types/session/session-manager.d.ts

@@ -1,7 +1,7 @@
 import type { AgentMessage } from "@gajae-code/agent-core";
 import type { ImageContent, Message, MessageAttribution, ServiceTier, TextContent } from "@gajae-code/ai";
 import { ArtifactManager } from "./artifacts";
-import { type BlobPutResult } from "./blob-store";
+import { type BlobPutResult, BlobStore } from "./blob-store";
 import { type BashExecutionMessage, type CustomMessage, type FileMentionMessage, type HookMessage, type PythonExecutionMessage } from "./messages";
 import type { SessionStorage } from "./session-storage";
 export declare const CURRENT_SESSION_VERSION = 3;
@@ -234,6 +234,15 @@ declare class RecentSessionInfo {
 export declare function recoverOrphanedBackups(sessionDir: string, storage: SessionStorage): Promise<void>;
 /** Exported for testing */
 export declare function findMostRecentSession(sessionDir: string, storage?: SessionStorage): Promise<string | null>;
+declare const RESIDENT_BLOB_SENTINEL_KEY = "__gjcResidentBlob";
+type ResidentBlobKind = "text" | "imageUrl" | "imageData";
+interface ResidentBlobSentinel {
+    [RESIDENT_BLOB_SENTINEL_KEY]: true;
+    kind: ResidentBlobKind;
+    ref: string;
+}
+export declare function residentBlobSentinelForTests(kind: ResidentBlobKind, ref: string): ResidentBlobSentinel;
+export declare function materializeResidentEntriesForPersistenceForTests<T>(entries: T[], textStore: BlobStore, imageStore?: BlobStore): T[];
 /** Get recent sessions for display in welcome screen */
 export declare function getRecentSessions(sessionDir: string, limit?: number, storage?: SessionStorage): Promise<RecentSessionInfo[]>;
 /**

package/dist/types/setup/credential-import.d.ts

@@ -0,0 +1,79 @@
+import type { AuthCredential } from "@gajae-code/ai";
+/** gjc provider ids that external credentials map onto. */
+export type ExternalProvider = "anthropic" | "openai-codex";
+/** Where a discovered credential came from. */
+export type CredentialOrigin = "claude-code-file" | "claude-code-keychain" | "codex-file";
+/** Human labels for providers, used in redacted summaries. */
+export declare const EXTERNAL_PROVIDER_LABELS: Record<ExternalProvider, string>;
+/** A credential that can be safely imported into gjc's store. */
+export interface ImportableCredential {
+    provider: ExternalProvider;
+    origin: CredentialOrigin;
+    /** Redacted, human-readable description of where this came from. */
+    source: string;
+    kind: AuthCredential["type"];
+    identity?: {
+        email?: string;
+        accountId?: string;
+    };
+    /** Epoch-ms expiry for OAuth credentials, when known. */
+    expiresAt?: number;
+    /** Redacted access token / API key — safe to display. */
+    redactedToken: string;
+    /** Opaque credential payload. Never include this in any summary output. */
+    credential: AuthCredential;
+}
+/** A source that was found but could not be imported. */
+export interface SkippedCredential {
+    origin: CredentialOrigin;
+    source: string;
+    reason: string;
+}
+/** Ambient environment-backed auth that is already usable without import. */
+export interface EnvironmentCredentialHint {
+    provider: ExternalProvider;
+    variable: string;
+    redactedValue: string;
+}
+export interface CredentialDiscoveryResult {
+    importable: ImportableCredential[];
+    skipped: SkippedCredential[];
+    environment: EnvironmentCredentialHint[];
+}
+export interface DiscoveryOptions {
+    /** Override the home directory (defaults to `os.homedir()`). */
+    homeDir?: string;
+    /** Override the environment (defaults to `process.env`). */
+    env?: Record<string, string | undefined>;
+    /** Override the platform (defaults to `process.platform`). */
+    platform?: NodeJS.Platform;
+    /**
+     * Reader for the macOS Keychain `Claude Code-credentials` entry. Defaults to
+     * shelling out to `security`; injected in tests. Returns the raw JSON string,
+     * or `null` when no entry exists.
+     */
+    readClaudeKeychain?: () => Promise<string | null>;
+}
+export type CredentialUpserter = (provider: string, credential: AuthCredential) => unknown | Promise<unknown>;
+export interface ImportSummary {
+    imported: ImportableCredential[];
+    failed: Array<{
+        credential: ImportableCredential;
+        error: string;
+    }>;
+}
+/**
+ * Discover Claude Code and Codex CLI credentials across files, the macOS
+ * Keychain, and environment variables. Never throws for individual unreadable or
+ * malformed sources — those land in {@link CredentialDiscoveryResult.skipped}.
+ */
+export declare function discoverExternalCredentials(options?: DiscoveryOptions): Promise<CredentialDiscoveryResult>;
+/** Redacted one-line summary of an importable credential. Never includes secrets. */
+export declare function formatCredentialSummary(credential: ImportableCredential): string;
+/** Redacted summary lines for an entire discovery result. Never includes secrets. */
+export declare function formatDiscoverySummary(result: CredentialDiscoveryResult): string[];
+/**
+ * Persist discovered credentials via `upsert`. Each credential is imported
+ * independently; a failure on one is recorded without aborting the rest.
+ */
+export declare function importCredentials(credentials: readonly ImportableCredential[], upsert: CredentialUpserter): Promise<ImportSummary>;

package/dist/types/task/executor.d.ts

@@ -105,6 +105,7 @@ interface FinalizeSubprocessOutputResult {
 export declare const SUBAGENT_WARNING_NULL_YIELD = "SYSTEM WARNING: Subagent called yield with null data.";
 export declare const SUBAGENT_WARNING_MISSING_YIELD = "SYSTEM WARNING: Subagent exited without calling yield tool after 3 reminders.";
 export declare function finalizeSubprocessOutput(args: FinalizeSubprocessOutputArgs): FinalizeSubprocessOutputResult;
+export declare function createSubagentSettings(baseSettings: Settings): Settings;
 /**
  * Run a single agent in-process.
  */

package/dist/types/task/render.d.ts

@@ -11,7 +11,7 @@ export declare function renderCall(args: TaskParams, _options: RenderResultOptio
  * `subagent` await panel. Reuses the internal task-progress renderer so the
  * await panel stays at parity with the inline task panel.
  */
-export declare function renderSubagentLiveProgress(progress: AgentProgress, expanded: boolean, theme: Theme, spinnerFrame?: number): string[];
+export declare function renderSubagentLiveProgress(progress: AgentProgress, expanded: boolean, theme: Theme, spinnerFrame?: number, staticTime?: boolean): string[];
 /**
  * Render the tool result.
  */

package/dist/types/tools/subagent-render.d.ts

@@ -10,7 +10,13 @@
 import type { Component } from "@gajae-code/tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { Theme } from "../modes/theme/theme";
-import type { SubagentToolDetails } from "./subagent";
+import { type SubagentToolDetails } from "./subagent";
+/** Test-only seam (PR3 deterministic cache-hit assertions). */
+export declare const subagentBodyCacheTestHooks: {
+    readonly bodyRenders: number;
+    readonly size: number;
+    reset(): void;
+};
 export declare const subagentToolRenderer: {
     inline: boolean;
     renderCall(_args: unknown, _options: RenderResultOptions, theme: Theme): Component;

package/dist/types/tools/subagent.d.ts

@@ -90,4 +90,25 @@ export declare class SubagentTool implements AgentTool<typeof subagentSchema, Su
     constructor(session: ToolSession);
     execute(_toolCallId: string, params: SubagentParams, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<SubagentToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<SubagentToolDetails>>;
 }
+/**
+ * Canonical, value-based rendered-state signature for the `subagent` await panel.
+ *
+ * Producer-side await gating compares this signature against the last emitted one
+ * and only fires `onUpdate` when the *rendered* state actually changed. Unchanged
+ * idle ticks therefore stop rebuilding the renderer component and stop mutating
+ * transcript lines above the viewport, which is what triggers TUI full-redraw
+ * storms (`tui.ts` `firstChanged < viewportTop`).
+ *
+ * It is deliberately value-based, never object identity: `AsyncJobManager.record-
+ * SubagentProgress` stores a `structuredClone` but `getSubagentProgress` returns
+ * the retained object by reference, so identity comparison would be both noisy and
+ * unsafe.
+ *
+ * Time-derived fields are intentionally excluded so the panel does not churn while
+ * idle: raw durations (`durationMs`), current-tool elapsed (`currentToolStartMs`),
+ * and retry countdowns (`retryState.startedAtMs`) are omitted. Idle duration and
+ * countdown ticking is sacrificed by design; every real transition still changes
+ * the signature.
+ */
+export declare function subagentAwaitRenderedStateSignature(subagents: readonly SubagentSnapshot[]): string;
 export {};

package/dist/types/tools/ultragoal-ask-guard.d.ts

@@ -0,0 +1,5 @@
+import type { AgentTool } from "@gajae-code/agent-core";
+import { type UltragoalAskBlockDiagnostic } from "../gjc-runtime/ultragoal-guard";
+export declare function formatUltragoalAskBlockMessage(diagnostic: UltragoalAskBlockDiagnostic): string;
+export declare function assertUltragoalAskAllowed(cwd: string): Promise<void>;
+export declare function guardToolForUltragoalAsk<T extends AgentTool>(tool: T, getCwd: () => string): T;

package/dist/types/web/search/index.d.ts

@@ -10,7 +10,7 @@ import * as z from "zod/v4";
 import type { CustomTool } from "../../extensibility/custom-tools/types";
 import type { ToolSession } from "../../tools";
 import { type SearchRenderDetails } from "./render";
-import type { SearchProviderId } from "./types";
+import type { ActiveSearchModelContext, SearchProviderId } from "./types";
 /** Web search tool parameters schema */
 export declare const webSearchSchema: z.ZodObject<{
     query: z.ZodString;
@@ -40,7 +40,7 @@ export declare function runSearchQuery(params: SearchQueryParams, options?: {
     authStorage?: AuthStorage;
     sessionId?: string;
     signal?: AbortSignal;
-    activeModelProvider?: string;
+    activeModelContext?: ActiveSearchModelContext;
 }): Promise<{
     content: Array<{
         type: "text";
@@ -80,6 +80,6 @@ export declare class WebSearchTool implements AgentTool<typeof webSearchSchema,
 /** Web search tool as CustomTool (for TUI rendering support) */
 export declare const webSearchCustomTool: CustomTool<typeof webSearchSchema, SearchRenderDetails>;
 export declare function getSearchTools(): CustomTool<any, any>[];
-export { getSearchProvider, setPreferredSearchProvider } from "./provider";
+export { getSearchProvider, setPreferredSearchProvider, setSearchFallbackProviders } from "./provider";
 export type { SearchProviderId as SearchProvider, SearchResponse } from "./types";
-export { isSearchProviderPreference } from "./types";
+export { isConfigurableSearchProviderId, isSearchProviderPreference } from "./types";

package/dist/types/web/search/provider.d.ts

@@ -1,28 +1,24 @@
 import type { AuthStorage } from "@gajae-code/ai";
 import type { SearchProvider } from "./providers/base";
-import type { SearchProviderId } from "./types";
+import type { ActiveSearchModelContext, SearchProviderId } from "./types";
 export type { SearchParams } from "./providers/base";
 export { SearchProvider } from "./providers/base";
-/** Cheap, sync metadata accessor — never triggers a provider load. */
 export declare function getSearchProviderLabel(id: SearchProviderId): string;
-/**
- * Resolve and cache a provider instance. First call for a given id loads the
- * underlying module; subsequent calls return the cached singleton.
- */
 export declare function getSearchProvider(id: SearchProviderId): Promise<SearchProvider>;
 export declare const SEARCH_PROVIDER_ORDER: SearchProviderId[];
-/** Set the preferred web search provider from settings */
 export declare function setPreferredSearchProvider(provider: SearchProviderId | "auto"): void;
-/**
- * Resolve the ordered provider chain for a search request.
- *
- * Resolution is active-model-gated, never credential-scanning:
- *   1. An explicitly preferred provider (settings) that is available is primary.
- *   2. Otherwise the active model's own native search is primary, but only when
- *      that provider's own credentials are present (its `isAvailable()`).
- *   3. DuckDuckGo (keyless) is always appended as the terminal fallback, so a
- *      missing primary — or a primary runtime failure — still returns results
- *      with zero configuration. Keyed standalone providers are never
- *      auto-selected; they are reachable only via explicit selection (step 1).
- */
-export declare function resolveProviderChain(authStorage: AuthStorage, preferredProvider?: SearchProviderId | "auto", activeModelProvider?: string): Promise<SearchProvider[]>;
+export declare function setSearchFallbackProviders(ids: readonly string[]): void;
+export interface ResolveProviderChainOptions {
+    authStorage: AuthStorage;
+    sessionId?: string;
+    signal?: AbortSignal;
+    preferredProvider?: SearchProviderId | "auto";
+    activeModelContext?: ActiveSearchModelContext;
+    fallbackProviders?: readonly SearchProviderId[];
+}
+export declare function looksHostedModelId(modelId: string | undefined): boolean;
+export declare function isLocalBaseUrl(baseUrl: string | undefined): boolean;
+export declare function inferNativeProviderFromModel(ctx: ActiveSearchModelContext | undefined): SearchProviderId | undefined;
+export declare function canUseGenericCredentials(authStorage: AuthStorage, ctx: ActiveSearchModelContext | undefined, sessionId?: string, signal?: AbortSignal): Promise<boolean>;
+export declare function shouldTryGenericOpenAICompat(authStorage: AuthStorage, ctx: ActiveSearchModelContext | undefined, sessionId?: string, signal?: AbortSignal): Promise<boolean>;
+export declare function resolveProviderChain(options: ResolveProviderChainOptions): Promise<SearchProvider[]>;

package/dist/types/web/search/providers/base.d.ts

@@ -1,5 +1,5 @@
 import type { AuthStorage } from "@gajae-code/ai";
-import type { SearchProviderId, SearchResponse } from "../types";
+import type { ActiveSearchModelContext, SearchProviderId, SearchResponse } from "../types";
 /**
  * Shared web search parameters passed to providers.
  *
@@ -49,6 +49,7 @@ export interface SearchParams {
      * caller's agent session when available; otherwise omit.
      */
     sessionId?: string;
+    activeModelContext?: ActiveSearchModelContext;
 }
 /** Base class for web search providers. */
 export declare abstract class SearchProvider {

package/dist/types/web/search/providers/openai-compatible.d.ts

@@ -0,0 +1,9 @@
+import type { SearchResponse } from "../types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+export declare class OpenAICompatibleSearchProvider extends SearchProvider {
+    readonly id: "openai-compatible";
+    readonly label = "OpenAI-compatible";
+    isAvailable(): boolean;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

package/dist/types/web/search/types.d.ts

@@ -4,9 +4,21 @@
  * Unified types for web search responses across supported providers.
  */
 /** Supported web search providers */
-export type SearchProviderId = "duckduckgo" | "exa" | "brave" | "jina" | "kimi" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "tavily" | "parallel" | "kagi" | "synthetic" | "searxng";
+export type SearchProviderId = "duckduckgo" | "exa" | "brave" | "jina" | "kimi" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "tavily" | "parallel" | "kagi" | "synthetic" | "searxng" | "openai-compatible";
+export type WebSearchMode = "on" | "off" | "auto";
+export interface ActiveSearchModelContext {
+    provider: string;
+    modelId: string;
+    wireModelId?: string;
+    api: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    webSearch?: WebSearchMode;
+}
+export declare const CONFIGURABLE_SEARCH_PROVIDER_IDS: readonly ["duckduckgo", "exa", "brave", "jina", "kimi", "zai", "anthropic", "perplexity", "gemini", "codex", "tavily", "parallel", "kagi", "synthetic", "searxng"];
 export declare function isSearchProviderId(value: string): value is SearchProviderId;
-export declare function isSearchProviderPreference(value: string): value is SearchProviderId | "auto";
+export declare function isConfigurableSearchProviderId(value: string): value is (typeof CONFIGURABLE_SEARCH_PROVIDER_IDS)[number];
+export declare function isSearchProviderPreference(value: string): value is (typeof CONFIGURABLE_SEARCH_PROVIDER_IDS)[number] | "auto";
 /** Source returned by search (all providers) */
 export interface SearchSource {
     title: string;