@gajae-code/coding-agent 0.2.3 → 0.2.5

package/README.md

@@ -34,4 +34,4 @@ Switching backends mid-session is honoured on the next system-prompt rebuild and
 
 ## Red-claw TUI theme
 
-The interactive TUI defaults to the bundled `red-claw` crustacean theme for dark terminals, with matching welcome/icon assets. Explicit user theme settings still win; set `theme.dark: red-claw` in `~/.gjc/agent/config.yml` to pin it.
+The interactive TUI defaults to the bundled `red-claw` crustacean theme for dark terminals and the bundled `blue-crab` theme for light-appearance terminals, with matching welcome/icon assets. Explicit user theme settings still win; set `theme.dark: red-claw` and `theme.light: blue-crab` in `~/.gjc/agent/config.yml` to pin them.

package/dist/types/async/job-manager.d.ts

@@ -54,6 +54,27 @@ export interface AsyncJobRegisterOptions {
 export interface AsyncJobFilter {
     ownerId?: string;
 }
+/**
+ * A slice of process-stream output for a background job, as recorded by
+ * `appendOutput` / read by `readOutputSince`.
+ *
+ * The cursor model is monotonic UTF-8 byte offsets. `nextOffset` is the offset
+ * to pass to the next read to receive only fresh bytes; `startOffset` is the
+ * first byte the manager still retains for this job. When the requested offset
+ * is older than `startOffset`, the manager returns the retained tail and sets
+ * `truncated: true`.
+ */
+export interface AsyncJobOutputSlice {
+    jobId: string;
+    status: AsyncJob["status"];
+    text: string;
+    startOffset: number;
+    nextOffset: number;
+    truncated: boolean;
+}
+/** Default retention cap for per-job captured output. ~512 KiB matches the
+ *  bash tail-buffer order of magnitude without dominating session memory. */
+export declare const DEFAULT_JOB_OUTPUT_RETENTION_BYTES: number;
 export declare class AsyncJobManager {
     #private;
     /** Process-global instance shared by internal URL protocol handlers and tools. */
@@ -78,6 +99,46 @@ export declare class AsyncJobManager {
     getRunningJobs(filter?: AsyncJobFilter): AsyncJob[];
     getRecentJobs(limit?: number, filter?: AsyncJobFilter): AsyncJob[];
     getAllJobs(filter?: AsyncJobFilter): AsyncJob[];
+    /**
+     * Append a sanitized process-stream chunk for a background job. Called from
+     * the unthrottled bash-executor capture hook (`onRawChunk`) so monitor sees
+     * every chunk even when preview/progress callbacks are throttled.
+     *
+     * Offsets are in UTF-8 bytes. Storing chunk metadata avoids unsafe byte
+     * slicing across multibyte characters at read time. The retention window is
+     * a per-job rolling cap (`DEFAULT_JOB_OUTPUT_RETENTION_BYTES`); when it
+     * overflows, oldest whole chunks are evicted and `startOffset` advances —
+     * subsequent reads from a stale offset get `truncated: true`.
+     */
+    appendOutput(jobId: string, chunk: string): void;
+    /**
+     * Read fresh process-stream output for a job since `offset` (in UTF-8
+     * bytes). Returns `undefined` when the job does not exist or when an
+     * `ownerId` filter is set and the job belongs to a different owner — this
+     * mirrors the manager-level "not found" pattern used by `cancel`.
+     *
+     * - `offset < startOffset` returns the retained tail with `truncated: true`.
+     * - `offset > nextOffset` clamps to `nextOffset` and returns an empty text
+     *   slice with `truncated: false`.
+     * - Assembled text slices the leading retained chunk at a UTF-8 codepoint
+     *   boundary when needed, so multibyte characters cannot be split.
+     */
+    readOutputSince(jobId: string, offset: number, filter?: AsyncJobFilter): AsyncJobOutputSlice | undefined;
+    /**
+     * Register an owner-scoped cleanup callback. Returns an unregister function.
+     *
+     * Used by Cron* tools to clear session-scoped timers when the owning agent
+     * is torn down. Invoked by `runOwnerCleanups({ ownerId })` before
+     * `cancelAll({ ownerId })` so timers cannot register new jobs during
+     * teardown.
+     */
+    registerOwnerCleanup(ownerId: string, cleanup: () => void): () => void;
+    /**
+     * Run and clear every registered cleanup for the given filter. Idempotent
+     * and error-isolated: a throwing cleanup does not prevent siblings from
+     * running and never escalates to the caller.
+     */
+    runOwnerCleanups(filter?: AsyncJobFilter): void;
     getDeliveryState(filter?: AsyncJobFilter): AsyncJobDeliveryState;
     hasPendingDeliveries(filter?: AsyncJobFilter): boolean;
     watchJobs(jobIds: string[]): number;

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/config/settings-schema.d.ts

@@ -212,7 +212,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "theme.light": {
         readonly type: "string";
-        readonly default: "light";
+        readonly default: "blue-crab";
         readonly ui: {
             readonly tab: "appearance";
             readonly label: "Light Theme";
@@ -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[]>;
@@ -2899,7 +2917,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "providers.webSearch": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "exa", "brave", "jina", "kimi", "zai", "perplexity", "anthropic", "gemini", "codex", "tavily", "kagi", "synthetic", "parallel", "searxng"];
+        readonly values: readonly ["auto", "duckduckgo", "exa", "brave", "jina", "kimi", "zai", "perplexity", "anthropic", "gemini", "codex", "tavily", "kagi", "synthetic", "parallel", "searxng"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
@@ -2908,7 +2926,11 @@ export declare const SETTINGS_SCHEMA: {
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
-                readonly description: "Preferred web-search provider";
+                readonly description: "Active model's native search if its creds exist, else keyless DuckDuckGo";
+            }, {
+                readonly value: "duckduckgo";
+                readonly label: "DuckDuckGo";
+                readonly description: "Keyless default \u2014 no API key or OAuth required";
             }, {
                 readonly value: "exa";
                 readonly label: "Exa";
@@ -3240,6 +3262,8 @@ export interface RetrySettings {
     maxRetries: number;
     baseDelayMs: number;
     maxDelayMs: number;
+    requestMaxRetries: number;
+    streamMaxRetries: number;
 }
 export interface MemoriesSettings {
     enabled: boolean;

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

@@ -5,7 +5,7 @@
  *   import { settings } from "./settings";
  *
  *   const enabled = settings.get("compaction.enabled");  // sync read
- *   settings.set("theme.dark", "titanium");               // sync write, saves in background
+ *   settings.set("theme.dark", "red-claw");              // sync write, saves in background
  *
  * For tests:
  *   const isolated = Settings.isolated({ "compaction.enabled": false });

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

@@ -106,6 +106,7 @@ export interface ParsedAgentFields {
     blocking?: boolean;
     hide?: boolean;
     forkContext?: ForkContextPolicy;
+    bashAllowedPrefixes?: string[];
 }
 /**
  * Parse agent fields from frontmatter.

package/dist/types/exec/bash-executor.d.ts

@@ -2,8 +2,15 @@ import { type MinimizerOptions } from "@gajae-code/natives";
 import { type ShellMinimizerSettings } from "../config/settings";
 export interface BashExecutorOptions {
     cwd?: string;
-    timeout?: number;
+    timeout?: number | null;
     onChunk?: (chunk: string) => void;
+    /**
+     * Unthrottled per-chunk callback that fires for every sanitized stdout/stderr
+     * chunk *before* preview throttling. Background-job substrate uses this to
+     * record the complete process stream for the Monitor tool while keeping
+     * `onChunk` cheap for UI/progress rendering.
+     */
+    onRawChunk?: (chunk: string) => void;
     signal?: AbortSignal;
     /** Session key suffix to isolate shell sessions per agent */
     sessionKey?: string;

package/dist/types/gjc-runtime/restricted-role-agent-bash.d.ts

@@ -0,0 +1,2 @@
+export declare const GJC_RESTRICTED_ROLE_AGENT_BASH_ENV = "GJC_RESTRICTED_ROLE_AGENT_BASH";
+export declare function isRestrictedRoleAgentBash(): boolean;

package/dist/types/modes/acp/acp-client-bridge.d.ts

@@ -1,6 +1,6 @@
 /**
  * ACP-side `ClientBridge` implementation. Wraps `AgentSideConnection` so the
- * `read`/`write`/`bash`/`edit` tools (and the permission gate in
+ * `read`/`write`/`bash`/`monitor`/`edit` tools (and the permission gate in
  * `AgentSession`) can route through the client when it advertises the
  * relevant capabilities at `initialize` time.
  */

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

@@ -29,6 +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 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/components/skill-hud/render.d.ts

@@ -1,2 +1,2 @@
-import type { SkillActiveEntry } from "../../../skill-state/active-state";
+import { type SkillActiveEntry } from "../../../skill-state/active-state";
 export declare function renderSkillHudBar(entries: readonly SkillActiveEntry[], width: number): string | null;

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

@@ -61,6 +61,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     isInitialized: boolean;
     isBackgrounded: boolean;
     isBashMode: boolean;
+    isBashNoContext: boolean;
     toolOutputExpanded: boolean;
     todoExpanded: boolean;
     planModeEnabled: boolean;
@@ -200,6 +201,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;