@gajae-code/coding-agent 0.2.2 → 0.2.4

package/dist/types/cli/setup-cli.d.ts

@@ -5,6 +5,7 @@ export interface SetupCommandArgs {
         json?: boolean;
         check?: boolean;
         force?: boolean;
+        preset?: string;
         compat?: string;
         provider?: string;
         baseUrl?: string;

package/dist/types/cli/update-cli.d.ts

@@ -21,6 +21,9 @@ export declare function parseUpdateArgs(args: string[]): {
     check: boolean;
 } | undefined;
 export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: string | undefined): "bun" | "binary";
+export declare function formatBinaryDownloadFailureMessageForTest(binaryName: string, url: string, status: string | number, platform?: NodeJS.Platform): string;
+export declare function buildReleaseBinaryUrlForTest(version: string, platform?: NodeJS.Platform, arch?: string): string;
+export declare function formatManualUpdateInstructionsForTest(platform?: NodeJS.Platform): string;
 /**
  * Atomically replace the installed binary and roll back if version verification fails.
  */

package/dist/types/commands/deep-interview.d.ts

@@ -2,6 +2,47 @@ import { Command } from "@gajae-code/utils/cli";
 export default class DeepInterview extends Command {
     static description: string;
     static strict: boolean;
+    static flags: {
+        quick: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        standard: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        deep: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        threshold: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "threshold-source": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "session-id": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        write: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        stage: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        slug: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        spec: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        handoff: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        deliberate: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
     static examples: string[];
     run(): Promise<void>;
 }

package/dist/types/commands/setup.d.ts

@@ -24,6 +24,9 @@ export default class Setup extends Command {
         json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };
+        preset: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
         compat: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };

package/dist/types/config/settings-schema.d.ts

@@ -982,6 +982,24 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Maximum wait between retries, in ms. When the provider asks us to wait longer than this and no credential or model fallback succeeds, the request fails fast instead of sleeping (e.g. 3-hour Anthropic rate-limit windows).";
         };
     };
+    readonly "retry.requestMaxRetries": {
+        readonly type: "number";
+        readonly default: 5;
+        readonly ui: {
+            readonly tab: "model";
+            readonly label: "Provider Request Retries";
+            readonly description: "Maximum provider request retries before a stream is established. Counts retries, not the first attempt. Set to 0 to disable provider request retries.";
+        };
+    };
+    readonly "retry.streamMaxRetries": {
+        readonly type: "number";
+        readonly default: 5;
+        readonly ui: {
+            readonly tab: "model";
+            readonly label: "Provider Stream Retries";
+            readonly description: "Maximum provider stream replay retries for replay-safe transient stream failures. Counts retries, not the first attempt. Set to 0 to disable provider stream retries.";
+        };
+    };
     readonly "retry.fallbackChains": {
         readonly type: "record";
         readonly default: Record<string, string[]>;
@@ -2295,6 +2313,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the checkpoint and rewind tools for context checkpointing";
         };
     };
+    readonly "skill.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Skill";
+            readonly description: "Enable the skill tool so the agent can chain into another available skill on its next turn";
+        };
+    };
     readonly "fetch.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -2705,6 +2732,33 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Allow subagents spawned via the task tool to use the lsp tool. Off by default to keep subagents cheap; enable when LSP-aware delegation is worth the extra tokens.";
         };
     };
+    readonly "task.forkContext.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Fork Context for Subagents";
+            readonly description: "Allow explicitly opted-in subagents to start from a sanitized snapshot of parent context when both the agent and task item also opt in.";
+        };
+    };
+    readonly "task.forkContext.maxMessages": {
+        readonly type: "number";
+        readonly default: 50;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Fork Context Max Messages";
+            readonly description: "Maximum parent messages copied into an explicitly opted-in subagent fork-context seed.";
+        };
+    };
+    readonly "task.forkContext.maxTokens": {
+        readonly type: "number";
+        readonly default: 0;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Fork Context Max Tokens";
+            readonly description: "Approximate token cap for fork-context seeds. 0 uses 25% of the target model context window.";
+        };
+    };
     readonly "task.maxRecursionDepth": {
         readonly type: "number";
         readonly default: 2;
@@ -3204,6 +3258,8 @@ export interface RetrySettings {
     maxRetries: number;
     baseDelayMs: number;
     maxDelayMs: number;
+    requestMaxRetries: number;
+    streamMaxRetries: number;
 }
 export interface MemoriesSettings {
     enabled: boolean;

package/dist/types/defaults/gjc-defaults.d.ts

@@ -1,6 +1,6 @@
 export declare const DEFAULT_GJC_DEFINITION_NAMES: readonly ["deep-interview", "ralplan", "team", "ultragoal"];
 export type DefaultGjcDefinitionName = (typeof DEFAULT_GJC_DEFINITION_NAMES)[number];
-export type DefaultGjcDefinitionKind = "skill";
+export type DefaultGjcDefinitionKind = "skill" | "skill-fragment";
 export type EmbeddedDefaultGjcSkill = {
     name: DefaultGjcDefinitionName;
     description: string;
@@ -11,23 +11,35 @@ export type EmbeddedDefaultGjcSkill = {
     content: string;
 };
 export type DefaultGjcInstallStatus = "different" | "matching" | "missing" | "skipped" | "written";
-export interface DefaultGjcDefinition {
-    kind: DefaultGjcDefinitionKind;
+export interface DefaultGjcSkillDefinition {
+    kind: "skill";
     name: DefaultGjcDefinitionName;
     relativePath: string;
     content: string;
 }
+export interface DefaultGjcSkillFragmentDefinition {
+    kind: "skill-fragment";
+    parentSkillName: DefaultGjcDefinitionName;
+    relativePath: string;
+    content: string;
+}
+export type DefaultGjcDefinition = DefaultGjcSkillDefinition | DefaultGjcSkillFragmentDefinition;
 export interface InstallDefaultGjcDefinitionsOptions {
     check?: boolean;
     force?: boolean;
     targetRoot?: string;
 }
-export interface DefaultGjcDefinitionInstallFile {
-    kind: DefaultGjcDefinitionKind;
+export type DefaultGjcDefinitionInstallFile = {
+    kind: "skill";
     name: DefaultGjcDefinitionName;
     path: string;
     status: DefaultGjcInstallStatus;
-}
+} | {
+    kind: "skill-fragment";
+    parentSkillName: DefaultGjcDefinitionName;
+    path: string;
+    status: DefaultGjcInstallStatus;
+};
 export interface DefaultGjcDefinitionInstallResult {
     targetRoot: string;
     total: number;
@@ -40,5 +52,6 @@ export interface DefaultGjcDefinitionInstallResult {
 }
 export declare function getDefaultGjcDefinitions(): readonly DefaultGjcDefinition[];
 export declare function getDefaultGjcAgentDefinitions(): readonly DefaultGjcDefinition[];
+export declare function getEmbeddedDefaultGjcSkillFragments(parentSkillName: DefaultGjcDefinitionName): DefaultGjcSkillFragmentDefinition[];
 export declare function getEmbeddedDefaultGjcSkills(): EmbeddedDefaultGjcSkill[];
 export declare function installDefaultGjcDefinitions(options?: InstallDefaultGjcDefinitionsOptions): Promise<DefaultGjcDefinitionInstallResult>;

package/dist/types/discovery/helpers.d.ts

@@ -3,6 +3,7 @@ import type { ExtensionModule } from "../capability/extension-module";
 import { type Rule } from "../capability/rule";
 import type { Skill } from "../capability/skill";
 import type { LoadContext, LoadResult, SourceMeta } from "../capability/types";
+import type { ForkContextPolicy } from "../task/types";
 /**
  * Standard paths for each config source.
  */
@@ -104,6 +105,7 @@ export interface ParsedAgentFields {
     autoloadSkills?: string[];
     blocking?: boolean;
     hide?: boolean;
+    forkContext?: ForkContextPolicy;
 }
 /**
  * Parse agent fields from frontmatter.

package/dist/types/extensibility/extensions/types.d.ts

@@ -50,6 +50,12 @@ export interface ExtensionUIDialogOptions {
     onExternalEditor?: () => void;
     /** Optional footer hint text rendered by interactive selector */
     helpText?: string;
+    /**
+     * For interactive TUI select dialogs, render the focused option across
+     * multiple rows instead of truncating it. This is a select-only rendering
+     * hint; non-TUI bridges (RPC, ACP) drop it and do not serialize it.
+     */
+    wrapFocused?: boolean;
 }
 /** Raw terminal input listener for extensions. */
 export type TerminalInputHandler = (data: string) => {

package/dist/types/gjc-runtime/deep-interview-runtime.d.ts

@@ -12,4 +12,22 @@ export interface DeepInterviewCommandResult {
     stdout?: string;
     stderr?: string;
 }
+export interface ResolvedDeepInterviewSpecWriteArgs {
+    stage: "final";
+    slug: string;
+    spec: string;
+    sessionId?: string;
+    json: boolean;
+    deliberate: boolean;
+    handoff?: "ralplan";
+}
+export interface PersistedDeepInterviewSpec {
+    slug: string;
+    path: string;
+    stage: "final";
+    sha256: string;
+    createdAt: string;
+    statePath: string;
+}
+export declare function persistDeepInterviewSpec(cwd: string, resolved: ResolvedDeepInterviewSpecWriteArgs): Promise<PersistedDeepInterviewSpec>;
 export declare function runNativeDeepInterviewCommand(args: string[], cwd?: string): Promise<DeepInterviewCommandResult>;

package/dist/types/hooks/skill-state.d.ts

@@ -50,6 +50,9 @@ export interface ModeState {
     thread_id?: string;
     cwd?: string;
     updated_at?: string;
+    handoff_from?: string;
+    handoff_to?: string;
+    handoff_at?: string;
     [key: string]: unknown;
 }
 export interface RecordSkillActivationInput {
@@ -79,6 +82,8 @@ export interface UserPromptSubmitStateInput {
 export declare function detectSkillKeywords(text: string): SkillKeywordMatch[];
 export declare function detectPrimarySkillKeyword(text: string): SkillKeywordMatch | null;
 export declare function resolveGjcStateDir(cwd: string, stateDir?: string): string;
+import { initialPhaseForSkill } from "../skill-state/initial-phase";
+export { initialPhaseForSkill };
 export declare function readVisibleSkillActiveState(cwd: string, sessionId?: string, stateDir?: string): Promise<SkillActiveState | null>;
 export declare function recordSkillActivation(input: RecordSkillActivationInput): Promise<SkillActiveState | null>;
 export declare function buildActiveUltragoalPromptContext(input: UserPromptSubmitStateInput): Promise<string | null>;

package/dist/types/memories/index.d.ts

@@ -16,7 +16,7 @@ export declare function startMemoryStartupTask(options: {
 /**
  * Build memory usage instructions for prompt injection.
  */
-export declare function buildMemoryToolDeveloperInstructions(agentDir: string, settings: Settings): Promise<string | undefined>;
+export declare function buildMemoryToolDeveloperInstructions(agentDir: string, settings: Settings, session?: AgentSession): Promise<string | undefined>;
 /**
  * Clear all persisted memory state and generated artifacts.
  */

package/dist/types/memory-backend/local-backend.d.ts

@@ -2,8 +2,8 @@ import type { MemoryBackend } from "./types";
 /**
  * Wraps the existing `memories/` module as a `MemoryBackend`.
  *
- * No behavioural change — every call delegates to the legacy entry points so
- * the local memory pipeline (rollout summarisation → SQLite → memory_summary.md)
- * keeps working exactly as before.
+ * The local pipeline owns rollout summarisation, SQLite retention, and
+ * `memory_summary.md`. Prompt reads use the live session cwd when available so
+ * manual enqueue/rebuild and startup hydration address the same memory root.
  */
 export declare const localBackend: MemoryBackend;

package/dist/types/modes/components/hook-selector.d.ts

@@ -14,6 +14,13 @@ export interface HookSelectorOptions {
     onRight?: () => void;
     onExternalEditor?: () => void;
     helpText?: string;
+    /**
+     * When true, the focused option's label wraps across multiple rows so the
+     * full text is visible. Non-focused options remain single-row with the
+     * existing `…` truncation hint. When unset/false, rendering is
+     * byte-identical to the previous implementation for all consumers.
+     */
+    wrapFocused?: boolean;
 }
 export declare class HookSelectorComponent extends Container {
     #private;

package/dist/types/modes/components/settings-selector.d.ts

@@ -29,8 +29,10 @@ export interface StatusLinePreviewSettings {
 export interface SettingsCallbacks {
     /** Called when any setting value changes */
     onChange: (path: SettingPath, newValue: unknown) => void;
-    /** Called for theme preview while browsing */
+    /** Called for theme preview while browsing theme settings */
     onThemePreview?: (theme: string) => void | Promise<void>;
+    /** Called to restore the rendered theme when theme settings preview is cancelled */
+    onThemePreviewCancel?: (theme: string) => void | Promise<void>;
     /** Called for status line preview while configuring */
     onStatusLinePreview?: (settings: StatusLinePreviewSettings) => void;
     /** Get current rendered status line for inline preview */

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -15,6 +15,7 @@ export declare class SelectorController {
     }): void;
     showProviderOnboarding(): void;
     showSettingsSelector(): void;
+    showThemeSelector(): void;
     showHistorySearch(): void;
     /**
      * Show the Extension Control Center dashboard.

package/dist/types/modes/interactive-mode.d.ts

@@ -200,6 +200,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     showSettingsSelector(): void;
+    showThemeSelector(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
     showAgentsDashboard(): void;

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

@@ -467,6 +467,132 @@ export declare const defaultThemes: {
             "infoBg": string;
         };
     };
+    "blue-crab": {
+        $schema: string;
+        name: string;
+        vars: {
+            "cyan": string;
+            "blue": string;
+            "green": string;
+            "red": string;
+            "yellow": string;
+            "gray": string;
+            "dimGray": string;
+            "darkGray": string;
+            "accent": string;
+            "selectedBg": string;
+            "userMsgBg": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "customMsgBg": string;
+            "abyss": string;
+            "deepNavy": string;
+            "crabShell": string;
+            "claw": string;
+            "ocean": string;
+            "azure": string;
+            "seafoam": string;
+            "kelp": string;
+            "sand": string;
+            "coral": string;
+            "ink": string;
+            "mantle": string;
+            "surface": string;
+            "surfaceBright": string;
+            "foam": string;
+            "mutedShell": string;
+            "dimShell": string;
+            "brandBlue": string;
+            "shell": string;
+            "dangerRed": string;
+            "warningAmber": string;
+            "diffRemovalRed": 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;
+            "link": 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;
+            "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;
+            "pythonMode": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+            "overrides": {
+                "icon.pi": string;
+                "icon.agents": string;
+                "status.running": string;
+                "md.bullet": string;
+            };
+        };
+    };
     "dark-abyss": {
         $schema: string;
         name: string;

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

@@ -186,6 +186,7 @@ export interface ThemeInfo {
 }
 export declare function getAvailableThemesWithPaths(): Promise<ThemeInfo[]>;
 export declare function getThemeByName(name: string): Promise<Theme | undefined>;
+export declare function getDetectedThemeSettingsPath(): "theme.dark" | "theme.light";
 export declare var theme: Theme;
 /** Get the name of the currently active theme. */
 export declare function getCurrentThemeName(): string | undefined;
@@ -198,6 +199,10 @@ export declare function previewTheme(name: string): Promise<{
     success: boolean;
     error?: string;
 }>;
+export declare function restoreThemePreview(name: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
 /**
  * Enable auto-detection mode, switching to the appropriate dark/light theme.
  */

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

@@ -208,6 +208,7 @@ export interface InteractiveModeContext {
     openInBrowser(urlOrPath: string): void;
     refreshSlashCommandState(cwd?: string): Promise<void>;
     showSettingsSelector(): void;
+    showThemeSelector(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
     showAgentsDashboard(): void;

package/dist/types/modes/utils/context-usage.d.ts

@@ -1,9 +1,10 @@
+import type { AgentMessage } from "@gajae-code/agent-core";
 import type { Model } from "@gajae-code/ai";
 import type { Skill } from "../../extensibility/skills";
 import type { AgentSession } from "../../session/agent-session";
 import type { Tool } from "../../tools";
 import type { theme as Theme } from "../theme/theme";
-type CategoryId = "systemPrompt" | "systemContext" | "systemTools" | "skills" | "messages";
+type CategoryId = "systemPrompt" | "systemContext" | "rules" | "tools" | "skills" | "messages" | "lastUserTurn";
 interface CategoryInfo {
     id: CategoryId;
     label: string;
@@ -15,6 +16,7 @@ export interface ContextBreakdown {
     model: Model | undefined;
     contextWindow: number;
     categories: CategoryInfo[];
+    lastUserTurnTokens: number;
     usedTokens: number;
     autoCompactBufferTokens: number;
     freeTokens: number;
@@ -38,7 +40,9 @@ export declare function computeNonMessageTokens(session: AgentSession): number;
  * Compute a breakdown of estimated context usage by category for the active
  * session and model.
  */
-export declare function computeContextBreakdown(session: AgentSession): ContextBreakdown;
+export declare function computeContextBreakdown(session: AgentSession, options?: {
+    messages?: readonly AgentMessage[];
+}): ContextBreakdown;
 /**
  * Render a colorful context-usage panel as ANSI text. Output is a series of
  * lines pairing the grid (left) with the legend (right).

package/dist/types/sdk.d.ts

@@ -1,5 +1,5 @@
 import { type AgentTelemetryConfig, type ThinkingLevel } from "@gajae-code/agent-core";
-import { type Model } from "@gajae-code/ai";
+import { type Model, type ProviderSessionState } from "@gajae-code/ai";
 import { type Rule } from "./capability/rule";
 import { ModelRegistry } from "./config/model-registry";
 import { type ScopedModelSelection } from "./config/model-resolver";
@@ -15,7 +15,7 @@ import type { HindsightSessionState } from "./hindsight/state";
 import { type LocalProtocolOptions } from "./internal-urls";
 import { AgentRegistry } from "./registry/agent-registry";
 import { MCPManager } from "./runtime-mcp";
-import { AgentSession } from "./session/agent-session";
+import { AgentSession, type ForkContextSeed } from "./session/agent-session";
 import { AuthStorage } from "./session/auth-storage";
 import { SessionManager } from "./session/session-manager";
 import { type BuildSystemPromptResult } from "./system-prompt";
@@ -121,6 +121,10 @@ export interface CreateAgentSessionOptions {
      * `@opentelemetry/api` package returns a no-op tracer in that case.
      */
     telemetry?: AgentTelemetryConfig;
+    /** Optional fork-context seed used to initialize a child session before its first prompt. */
+    forkContextSeed?: ForkContextSeed;
+    /** Optional provider state override. Fork-context children should omit this by default. */
+    providerSessionState?: Map<string, ProviderSessionState>;
 }
 /** Result from createAgentSession */
 export interface CreateAgentSessionResult {