@gajae-code/coding-agent 0.2.1 → 0.2.3

package/dist/types/gjc-runtime/tmux-common.d.ts

@@ -0,0 +1,41 @@
+export declare const GJC_DEFAULT_TMUX_SESSION = "gajae_code";
+export declare const GJC_TMUX_SESSION_PREFIX = "gajae_code_";
+export declare const GJC_TMUX_COMMAND_ENV = "GJC_TMUX_COMMAND";
+export declare const GJC_TMUX_PROFILE_ENV = "GJC_TMUX_PROFILE";
+export declare const GJC_TMUX_MOUSE_ENV = "GJC_MOUSE";
+export declare const GJC_TMUX_PROFILE_OPTION = "@gjc-profile";
+export declare const GJC_TMUX_PROFILE_VALUE = "1";
+export declare const GJC_TMUX_BRANCH_OPTION = "@gjc-branch";
+export declare const GJC_TMUX_BRANCH_SLUG_OPTION = "@gjc-branch-slug";
+export declare const GJC_TMUX_PROJECT_OPTION = "@gjc-project";
+export interface GjcTmuxProfileCommand {
+    description: string;
+    args: string[];
+}
+export interface TmuxCommandResult {
+    exitCode: number | null;
+    stdout?: string;
+    stderr?: string;
+    signalCode?: string | null;
+}
+export type TmuxCommandRunner = (args: string[]) => TmuxCommandResult;
+export declare function envDisabled(value: string | undefined): boolean;
+export declare function resolveGjcTmuxCommand(env?: NodeJS.ProcessEnv): string;
+export declare function sanitizeTmuxToken(value: string): string;
+export declare function buildGjcTmuxSessionSlug(value: string): string;
+export declare function buildGjcTmuxSessionName(env?: NodeJS.ProcessEnv, context?: {
+    branch?: string | null;
+    now?: number;
+    id?: string;
+}): string;
+export declare function buildGjcTmuxRequiredProfileCommands(target: string, metadata?: {
+    branch?: string | null;
+    branchSlug?: string | null;
+    project?: string | null;
+}): GjcTmuxProfileCommand[];
+export declare function buildGjcTmuxProfileCommands(target: string, env?: NodeJS.ProcessEnv, metadata?: {
+    branch?: string | null;
+    branchSlug?: string | null;
+    project?: string | null;
+}): GjcTmuxProfileCommand[];
+export declare function normalizeTmuxCreatedAt(raw: string): string;

package/dist/types/gjc-runtime/tmux-sessions.d.ts

@@ -0,0 +1,17 @@
+export interface GjcTmuxSessionStatus {
+    name: string;
+    attached: boolean;
+    windows: number;
+    panes: number;
+    bindings: string;
+    createdAt: string;
+    branch?: string;
+    branchSlug?: string;
+    project?: string;
+}
+export declare function listGjcTmuxSessions(env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus[];
+export declare function findGjcTmuxSessionByBranch(branch: string, env?: NodeJS.ProcessEnv, project?: string | null): GjcTmuxSessionStatus | undefined;
+export declare function statusGjcTmuxSession(sessionName: string, env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus;
+export declare function createGjcTmuxSession(env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus;
+export declare function removeGjcTmuxSession(sessionName: string, env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus;
+export declare function attachGjcTmuxSession(sessionName: string, env?: NodeJS.ProcessEnv): never;

package/dist/types/goals/runtime.d.ts

@@ -1,4 +1,4 @@
-import type { Goal, GoalBudgetSteering, GoalModeState, GoalRuntimeEvent, GoalTokenUsage } from "./state";
+import { type Goal, type GoalModeState, type GoalRuntimeEvent, type GoalTokenUsage } from "./state";
 export interface GoalRuntimeHost {
     getState(): GoalModeState | undefined;
     setState(state: GoalModeState | undefined): void;
@@ -24,16 +24,13 @@ export interface GoalWallClockSnapshot {
 export interface GoalRuntimeSnapshot {
     turnSnapshot?: GoalTurnSnapshot;
     wallClock: GoalWallClockSnapshot;
-    budgetReportedFor?: string;
 }
-export type GoalPromptKind = "active" | "continuation" | "budget-limit";
-export declare function remainingTokens(goal: Goal | null | undefined): number | null;
+export type GoalPromptKind = "active" | "continuation";
 export declare function escapeXmlText(input: string): string;
 export declare function renderTrustedObjective(objective: string): string;
 export declare function validateGoalObjective(objective: string, op: "create" | "replace"): string;
 export declare function goalTokenDelta(current: GoalTokenUsage, baseline: GoalTokenUsage): number;
 export declare function renderGoalPrompt(kind: GoalPromptKind, goal: Goal): string;
-export declare function completionBudgetReport(goal: Goal): string | null;
 export declare class GoalRuntime {
     #private;
     constructor(host: GoalRuntimeHost);
@@ -49,15 +46,12 @@ export declare class GoalRuntime {
         reason?: "interrupted" | "internal";
     }): Promise<void>;
     onThreadResumed(): Promise<GoalModeState | undefined>;
-    onBudgetMutated(newBudget: number | undefined): Promise<GoalModeState | undefined>;
-    flushUsage(steering: GoalBudgetSteering, currentUsage?: GoalTokenUsage): Promise<void>;
+    flushUsage(currentUsage?: GoalTokenUsage): Promise<void>;
     createGoal(input: {
         objective: string;
-        tokenBudget?: number;
     }): Promise<GoalModeState>;
     replaceGoal(input: {
         objective: string;
-        tokenBudget?: number;
     }): Promise<GoalModeState>;
     resumeGoal(): Promise<GoalModeState>;
     pauseGoal(): Promise<GoalModeState | undefined>;

package/dist/types/goals/state.d.ts

@@ -1,10 +1,9 @@
 import type { UsageStatistics } from "../session/session-manager";
-export type GoalStatus = "active" | "paused" | "budget-limited" | "complete" | "dropped";
+export type GoalStatus = "active" | "paused" | "complete" | "dropped";
 export interface Goal {
     id: string;
     objective: string;
     status: GoalStatus;
-    tokenBudget?: number;
     tokensUsed: number;
     timeUsedSeconds: number;
     createdAt: number;
@@ -19,8 +18,6 @@ export interface GoalModeState {
 export interface GoalToolDetails {
     op: "create" | "get" | "complete" | "resume" | "drop";
     goal?: Goal | null;
-    remainingTokens?: number | null;
-    completionBudgetReport?: string | null;
 }
 export type GoalRuntimeEvent = {
     type: "goal_updated";
@@ -31,5 +28,5 @@ export type GoalRuntimeEvent = {
     prompt: string;
 };
 export type GoalTokenUsage = Pick<UsageStatistics, "input" | "output" | "cacheRead" | "cacheWrite">;
-export type GoalBudgetSteering = "allowed" | "suppressed";
-export type GoalTerminalMetricEmission = "emit" | "suppress";
+export declare function normalizeGoal(candidate: unknown): Goal | null;
+export declare function normalizeGoalModeState(candidate: GoalModeState | undefined): GoalModeState | undefined;

package/dist/types/goals/tools/goal-tool.d.ts

@@ -14,31 +14,12 @@ declare const goalSchema: z.ZodObject<{
         resume: "resume";
     }>;
     objective: z.ZodOptional<z.ZodString>;
-    token_budget: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const getGoalSchema: z.ZodObject<{}, z.core.$strip>;
-declare const createGoalSchema: z.ZodObject<{
-    objective: z.ZodString;
-    token_budget: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const updateGoalSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        complete: "complete";
-        dropped: "dropped";
-    }>;
 }, z.core.$strip>;
 export type GoalToolInput = z.infer<typeof goalSchema>;
-export type GetGoalToolInput = z.infer<typeof getGoalSchema>;
-export type CreateGoalToolInput = z.infer<typeof createGoalSchema>;
-export type UpdateGoalToolInput = z.infer<typeof updateGoalSchema>;
 export interface GoalToolResponse {
     goal: Goal | null;
-    remainingTokens: number | null;
-    completionBudgetReport: string | null;
 }
-export declare function buildGoalToolResponse(goal: Goal | null | undefined, options?: {
-    includeCompletionReport?: boolean;
-}): GoalToolResponse;
+export declare function buildGoalToolResponse(goal: Goal | null | undefined): GoalToolResponse;
 export declare class GoalTool implements AgentTool<typeof goalSchema, GoalToolDetails> {
     #private;
     readonly name = "goal";
@@ -54,64 +35,15 @@ export declare class GoalTool implements AgentTool<typeof goalSchema, GoalToolDe
             resume: "resume";
         }>;
         objective: z.ZodOptional<z.ZodString>;
-        token_budget: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly strict = true;
     readonly intent: "omit";
     constructor(session: ToolSession);
     execute(_toolCallId: string, params: GoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
 }
-export declare class GetGoalTool implements AgentTool<typeof getGoalSchema, GoalToolDetails> {
-    #private;
-    readonly name = "get_goal";
-    readonly label = "Get Goal";
-    readonly loadMode: "essential";
-    readonly description: string;
-    readonly parameters: z.ZodObject<{}, z.core.$strip>;
-    readonly strict = true;
-    readonly intent: "omit";
-    static createIf(session: ToolSession): GetGoalTool | null;
-    constructor(session: ToolSession);
-    execute(_toolCallId: string, _params: GetGoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
-}
-export declare class CreateGoalTool implements AgentTool<typeof createGoalSchema, GoalToolDetails> {
-    #private;
-    readonly name = "create_goal";
-    readonly label = "Create Goal";
-    readonly loadMode: "essential";
-    readonly description: string;
-    readonly parameters: z.ZodObject<{
-        objective: z.ZodString;
-        token_budget: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>;
-    readonly strict = true;
-    readonly intent: "omit";
-    static createIf(session: ToolSession): CreateGoalTool | null;
-    constructor(session: ToolSession);
-    execute(_toolCallId: string, params: CreateGoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
-}
-export declare class UpdateGoalTool implements AgentTool<typeof updateGoalSchema, GoalToolDetails> {
-    #private;
-    readonly name = "update_goal";
-    readonly label = "Update Goal";
-    readonly loadMode: "essential";
-    readonly description: string;
-    readonly parameters: z.ZodObject<{
-        status: z.ZodEnum<{
-            complete: "complete";
-            dropped: "dropped";
-        }>;
-    }, z.core.$strip>;
-    readonly strict = true;
-    readonly intent: "omit";
-    static createIf(session: ToolSession): UpdateGoalTool | null;
-    constructor(session: ToolSession);
-    execute(_toolCallId: string, params: UpdateGoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
-}
 interface GoalRenderArgs {
     op?: GoalToolInput["op"];
     objective?: string;
-    token_budget?: number;
 }
 export declare const goalToolRenderer: {
     renderCall(args: GoalRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;

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,6 @@ export interface StatusLinePreviewSettings {
 export interface SettingsCallbacks {
     /** Called when any setting value changes */
     onChange: (path: SettingPath, newValue: unknown) => void;
-    /** Called for theme preview while browsing */
-    onThemePreview?: (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/status-line/types.d.ts

@@ -11,9 +11,6 @@ export interface SegmentContext {
         enabled: boolean;
         paused: boolean;
     } | null;
-    loopMode: {
-        enabled: boolean;
-    } | null;
     goalMode: {
         enabled: boolean;
         paused: boolean;

package/dist/types/modes/components/status-line.d.ts

@@ -44,9 +44,6 @@ export declare class StatusLineComponent implements Component {
         enabled: boolean;
         paused: boolean;
     } | undefined): void;
-    setLoopModeStatus(status: {
-        enabled: boolean;
-    } | undefined): void;
     setGoalModeStatus(status: {
         enabled: boolean;
         paused: boolean;

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

@@ -32,5 +32,6 @@ export declare class CommandController {
     handleSkillCommand(skillPath: string, args: string): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleContributionPrepCommand(customInstructions?: string): Promise<void>;
 }
 export declare function renderProviderSection(details: ProviderDetails, uiTheme: Pick<typeof theme, "fg">): string;

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

@@ -23,7 +23,6 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
-import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
 import type { CompactionQueuedMessage, InteractiveModeContext, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
@@ -69,9 +68,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     goalModeEnabled: boolean;
     goalModePaused: boolean;
     planModePlanFilePath: string | undefined;
-    loopModeEnabled: boolean;
-    loopPrompt: string | undefined;
-    loopLimit: LoopLimitRuntime | undefined;
     todoPhases: TodoPhase[];
     hideThinkingBlock: boolean;
     pendingImages: ImageContent[];
@@ -111,14 +107,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
     getUserInput(): Promise<SubmittedUserInput>;
-    disableLoopMode(message?: string): void;
-    /**
-     * Pause the loop without exiting it: drops the captured prompt and any
-     * pending auto-resubmit. Loop mode stays enabled — the next prompt the
-     * user submits becomes the new loop prompt and resumes iteration.
-     */
-    pauseLoop(): void;
-    handleLoopCommand(args?: string): Promise<void>;
     recordLocalSubmission(text: string, imageCount?: number): () => void;
     withLocalSubmission<T>(text: string, fn: () => Promise<T>, options?: {
         imageCount?: number;
@@ -208,6 +196,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleSSHCommand(text: string): Promise<void>;
     handleCompactCommand(customInstructions?: string): Promise<CompactionOutcome>;
     handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleContributionPrepCommand(customInstructions?: string): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     showSettingsSelector(): void;

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

@@ -2921,7 +2921,6 @@ export declare const defaultThemes: {
                 "icon.plan": string;
                 "icon.goal": string;
                 "icon.pause": string;
-                "icon.loop": string;
                 "icon.folder": string;
                 "icon.scratchFolder": string;
                 "icon.pi": string;
@@ -7439,7 +7438,6 @@ export declare const defaultThemes: {
                 "icon.plan": string;
                 "icon.goal": string;
                 "icon.pause": string;
-                "icon.loop": string;
                 "icon.folder": string;
                 "icon.scratchFolder": string;
                 "icon.pi": string;

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

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-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.loop" | "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" | "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 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" | "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 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 */
@@ -110,7 +110,6 @@ export declare class Theme {
         plan: string;
         goal: string;
         pause: string;
-        loop: string;
         folder: string;
         scratchFolder: string;
         file: string;

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

@@ -22,7 +22,6 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
-import type { LoopLimitRuntime } from "./loop-limit";
 import type { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
 export type CompactionQueuedMessage = {
@@ -76,9 +75,6 @@ export interface InteractiveModeContext {
     planModeEnabled: boolean;
     goalModeEnabled: boolean;
     goalModePaused: boolean;
-    loopModeEnabled: boolean;
-    loopPrompt?: string;
-    loopLimit?: LoopLimitRuntime;
     planModePlanFilePath?: string;
     hideThinkingBlock: boolean;
     pendingImages: ImageContent[];
@@ -203,6 +199,7 @@ export interface InteractiveModeContext {
     handleSSHCommand(text: string): Promise<void>;
     handleCompactCommand(customInstructions?: string): Promise<CompactionOutcome>;
     handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleContributionPrepCommand(customInstructions?: string): Promise<void>;
     handleMoveCommand(targetPath: string): Promise<void>;
     handleRenameCommand(title: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
@@ -249,9 +246,6 @@ export interface InteractiveModeContext {
     registerExtensionShortcuts(): void;
     handlePlanModeCommand(initialPrompt?: string): Promise<void>;
     handleGoalModeCommand(rest?: string): Promise<void>;
-    handleLoopCommand(args?: string): Promise<void>;
-    disableLoopMode(): void;
-    pauseLoop(): void;
     handlePlanApproval(details: PlanApprovalDetails): Promise<void>;
     initHooksAndCustomTools(): Promise<void>;
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<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 {

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

@@ -12,9 +12,32 @@
  *
  * Modes use this class and add their own I/O layer on top.
  */
-import { type Agent, type AgentEvent, type AgentMessage, type AgentState, type AgentTool, ThinkingLevel } from "@gajae-code/agent-core";
+import { type Agent, type AgentEvent, type AgentMessage, type AgentState, type AgentTool, type StablePrefixSnapshot, ThinkingLevel } from "@gajae-code/agent-core";
 import { type CompactionResult } from "@gajae-code/agent-core/compaction";
 import type { AssistantMessage, Effort, ImageContent, Message, MessageAttribution, Model, ProviderSessionState, ServiceTier, SimpleStreamOptions, TextContent, ToolChoice, UsageReport } from "@gajae-code/ai";
+export interface ForkContextSeedMetadata {
+    sourceSessionId: string;
+    parentMessageCount: number;
+    includedMessages: number;
+    skippedMessages: number;
+    approximateTokens: number;
+    maxMessages: number;
+    maxTokens: number;
+    skippedReasons: Record<string, number>;
+}
+export interface ForkContextSeed {
+    messages: Message[];
+    agentMessages: AgentMessage[];
+    metadata: ForkContextSeedMetadata;
+    cacheIdentity?: string;
+    appendOnlyPrefixSnapshot?: StablePrefixSnapshot;
+}
+export interface ForkContextSeedOptions {
+    maxMessages: number;
+    maxTokens: number;
+    cacheIdentity?: string;
+    signal?: AbortSignal;
+}
 import { type AsyncJob, type AsyncJobDeliveryState, AsyncJobManager } from "../async";
 import type { Rule } from "../capability/rule";
 import { type ModelRegistry } from "../config/model-registry";
@@ -42,6 +65,7 @@ import { type DiscoverableTool, type DiscoverableToolSearchIndex } from "../tool
 import type { CheckpointState } from "../tools/checkpoint";
 import { type TodoItem, type TodoPhase } from "../tools/todo-write";
 import type { ClientBridge } from "./client-bridge";
+import { type ContributionPrepOptions, type ContributionPrepResult } from "./contribution-prep";
 import { type CustomMessage } from "./messages";
 import type { BranchSummaryEntry, NewSessionOptions, SessionContext, SessionManager } from "./session-manager";
 import { ToolChoiceQueue } from "./tool-choice-queue";
@@ -137,6 +161,8 @@ export interface AgentSessionConfig {
     skillsSettings?: SkillsSettings;
     /** Model registry for API key resolution and model discovery */
     modelRegistry: ModelRegistry;
+    /** Task recursion depth for nested sessions. Top-level sessions use 0. */
+    taskDepth?: number;
     /** Tool registry for LSP and settings */
     toolRegistry?: Map<string, AgentTool>;
     /** Current session pre-LLM message transform pipeline */
@@ -187,6 +213,10 @@ export interface AgentSessionConfig {
      * **MUST NOT** dispose it on their own teardown.
      */
     ownedAsyncJobManager?: AsyncJobManager;
+    /** 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>;
     /** Agent identity (registry id like "0-Main" or "3-Alice") used for IRC routing. */
     agentId?: string;
     /** Shared agent registry (for forwarding IRC observations to the main session UI). */
@@ -198,6 +228,8 @@ export interface AgentSessionConfig {
      * so that credential sticky selection is consistent with the session's streaming calls.
      */
     providerSessionId?: string;
+    /** Optional provider-facing cache identity, distinct from logical session identity. */
+    providerCacheSessionId?: string;
 }
 /** Options for AgentSession.prompt() */
 export interface PromptOptions {
@@ -262,6 +294,7 @@ export declare class AgentSession {
     readonly agent: Agent;
     readonly sessionManager: SessionManager;
     readonly settings: Settings;
+    readonly taskDepth: number;
     readonly yieldQueue: YieldQueue;
     readonly configWarnings: string[];
     readonly rawSseDebugBuffer: RawSseDebugBuffer;
@@ -278,12 +311,24 @@ export declare class AgentSession {
     setForcedToolChoice(toolName: string): void;
     /** The tool-choice queue: forces forthcoming tool invocations and carries handlers. */
     get toolChoiceQueue(): ToolChoiceQueue;
+    /** Current skill prompt executing in this session, if any. */
+    getActiveSkillState(): {
+        skill: string;
+        session_id?: string;
+    } | undefined;
+    /** Best-effort accessor for the active skill's `current_phase` field from
+     *  its persisted mode-state file. Used by the `skill` tool to enforce the
+     *  terminal-phase chain guard. Returns undefined when no active skill is
+     *  recorded or the mode-state file is missing/unreadable; callers should
+     *  treat undefined as a non-terminal phase (refuses to chain). */
+    getActiveSkillPhase(): string | undefined;
     /** Peek the in-flight directive's invocation handler for use by the resolve tool. */
     peekQueueInvoker(): ((input: unknown) => Promise<unknown> | unknown) | undefined;
     peekStandingResolveHandler(): ((input: unknown) => Promise<unknown> | unknown) | undefined;
     setStandingResolveHandler(handler: ((input: unknown) => Promise<unknown> | unknown) | null): void;
     /** Provider-scoped mutable state store for transport/session caches. */
     get providerSessionState(): Map<string, ProviderSessionState>;
+    buildForkContextSeed(options: ForkContextSeedOptions): Promise<ForkContextSeed>;
     getHindsightSessionState(): HindsightSessionState | undefined;
     setHindsightSessionState(state: HindsightSessionState | undefined): HindsightSessionState | undefined;
     /** TTSR manager for time-traveling stream rules */
@@ -696,6 +741,7 @@ export declare class AgentSession {
      * @returns The handoff document text, or undefined if cancelled/failed
      */
     handoff(customInstructions?: string, options?: SessionHandoffOptions): Promise<HandoffResult | undefined>;
+    prepareContributionPrep(options?: ContributionPrepOptions): Promise<ContributionPrepResult>;
     /**
      * Toggle auto-compaction setting.
      */