agent-afk 5.326.2 → 5.327.0

package/dist/agent/daemon/handoff-wiring.d.ts

@@ -17,5 +17,6 @@ export interface RecoveryResult {
     expired: number;
 }
 export declare function recoverPendingHandoffs(handoffsDir?: string, queueDir?: string, bot?: Telegraf): Promise<RecoveryResult>;
+export declare const MAX_ANSWER_BYTES: number;
 export declare function answerHandoff(taskId: string, answer: unknown, source: string, handoffsDir?: string, responderIdentity?: string): Promise<boolean>;
 export declare function cleanupHandoff(taskId: string, handoffsDir?: string): Promise<void>;

package/dist/agent/dag-subagent.d.ts

@@ -27,6 +27,7 @@ export interface SubagentDAGNode {
     maxToolUseIterations?: number;
     maxTurns?: number;
     provider?: ModelProvider;
+    modelFallback?: import('./subagent/fork-types.js').ForkSubagentOptions['modelFallback'];
     depth?: number;
     maxDepth?: number;
     resolvedAttachments?: ImageBlockAttachment[];

package/dist/agent/journal/types.d.ts

@@ -83,7 +83,14 @@ export interface JournalAdoption {
     readonly count: number;
 }
 export type JournalTruncateReason = 'resync' | 'compact' | 'rewind' | 'clear' | 'repair' | 'provider_switch';
-export type JournalMarkLabel = 'compact' | 'rewind' | 'clear' | 'resume' | 'fork' | 'model_switch';
+export type JournalMarkLabel = 'compact' | 'rewind' | 'clear' | 'resume' | 'fork' | 'model_switch' | 'suggestion';
+export type JournalSuggestionDetail = {
+    event: 'generated' | 'accepted' | 'word_accepted' | 'dismissed';
+    source: 'completion' | 'prompt';
+    text: string;
+    buffer?: string;
+    model?: string;
+};
 interface RecordBase {
     v: typeof JOURNAL_VERSION;
     ts: number;

package/dist/agent/outcomes/schema.d.ts

@@ -57,8 +57,8 @@ export declare const VerifiedOutcomeSchema: z.ZodObject<{
         blocked: "blocked";
         done: "done";
         none: "none";
-        asking: "asking";
         interrupted: "interrupted";
+        asking: "asking";
     }>;
     artifacts: z.ZodObject<{
         commits: z.ZodArray<z.ZodString>;

package/dist/agent/provider.d.ts

@@ -2,6 +2,7 @@ import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
 import type { AgentConfig } from './types/config-types.js';
 import type { ToolFailureClass } from './trace/types.js';
 import type { UsageLimitProvider } from '../utils/errors.js';
+import type { OneShotStopReason } from './providers/anthropic-direct/oneshot.js';
 export interface ProviderSessionInfo {
     sessionId: string;
     model?: string;
@@ -313,10 +314,15 @@ export interface ProviderCompleteArgs {
     apiKey?: string;
     baseUrl?: string;
 }
+export interface ProviderCompleteResult {
+    text: string;
+    stopReason: OneShotStopReason;
+}
 export interface ModelProvider {
     readonly name: string;
     query(args: ProviderQueryArgs): ProviderQuery;
     complete?(args: ProviderCompleteArgs): Promise<string>;
+    completeWithStop?(args: ProviderCompleteArgs): Promise<ProviderCompleteResult>;
     close?(): void | Promise<void>;
     grantsTool?(toolName: string): boolean;
 }

package/dist/agent/providers/anthropic-direct/provider-runtime.d.ts

@@ -1,4 +1,4 @@
-import type { ModelProvider, ProviderQuery, ProviderQueryArgs, ProviderCompleteArgs } from '../../provider.js';
+import type { ModelProvider, ProviderQuery, ProviderQueryArgs, ProviderCompleteArgs, ProviderCompleteResult } from '../../provider.js';
 export { resolveEffort, resolveMaxTokens, resolveThinkingParam } from './resolve-params.js';
 import { type AnthropicDirectProviderOptions } from './provider-options.js';
 export { __setAnthropicClientFactory, type AnthropicClientFactory, type AnthropicDirectProviderOptions, } from './provider-options.js';
@@ -43,6 +43,7 @@ export declare class AnthropicDirectProvider implements ModelProvider {
     grantsTool(toolName: string): boolean;
     close(): void;
     complete(args: ProviderCompleteArgs): Promise<string>;
+    completeWithStop(args: ProviderCompleteArgs): Promise<ProviderCompleteResult>;
     addReadRoot(absPath: string, source?: 'slash' | 'tool', sessionId?: string): void;
     addWriteRoot(absPath: string, source?: 'slash' | 'tool', sessionId?: string): void;
     revokeRoot(absPath: string, source?: 'slash' | 'tool', sessionId?: string): void;

package/dist/agent/providers/openai-compatible/complete-wire.d.ts

@@ -1,6 +1,7 @@
 import OpenAI from 'openai';
 import { type AuthResolverDeps } from './auth.js';
 import { type OpenAIOneShotInput } from './oneshot.js';
+import type { ProviderCompleteResult } from '../../provider.js';
 export type { OpenAIOneShotInput } from './oneshot.js';
 export interface CompleteWireClientOptions {
     apiKey: string;
@@ -11,3 +12,4 @@ export interface CompleteWireClientOptions {
 }
 export type CompleteWireClientFactory = (opts: CompleteWireClientOptions) => OpenAI;
 export declare function completeWithWire(input: OpenAIOneShotInput, clientFactory?: CompleteWireClientFactory, authDeps?: AuthResolverDeps): Promise<string>;
+export declare function completeWithWireWithStop(input: OpenAIOneShotInput, clientFactory?: CompleteWireClientFactory, authDeps?: AuthResolverDeps): Promise<ProviderCompleteResult>;

package/dist/agent/providers/openai-compatible/index.d.ts

@@ -1,4 +1,4 @@
-import type { ModelProvider, ProviderQuery, ProviderQueryArgs, ProviderCompleteArgs } from '../../provider.js';
+import type { ModelProvider, ProviderQuery, ProviderQueryArgs, ProviderCompleteArgs, ProviderCompleteResult } from '../../provider.js';
 import { type OpenAICompatibleProviderOptions } from './index.options.js';
 export type { OpenAICompatibleProviderOptions } from './index.options.js';
 export declare class OpenAICompatibleProvider implements ModelProvider {
@@ -39,6 +39,7 @@ export declare class OpenAICompatibleProvider implements ModelProvider {
     grantsTool(toolName: string): boolean;
     close(): void;
     complete(args: ProviderCompleteArgs): Promise<string>;
+    completeWithStop(args: ProviderCompleteArgs): Promise<ProviderCompleteResult>;
 }
 export declare const openaiCompatibleProvider: ModelProvider;
 export { resolveOpenAIAuth, formatAuthDiagnostic, type OpenAIAuthResolution, type OpenAIAuthSource, } from './auth.js';

package/dist/agent/providers/shared/model-rejected-error.d.ts

@@ -0,0 +1,12 @@
+export declare const MODEL_REJECTED_CODE: "model_rejected";
+export declare class ModelRejectedError extends Error {
+    readonly model: string;
+    readonly status: number | undefined;
+    readonly provider: string;
+    readonly code: "model_rejected";
+    constructor(message: string, model: string, status: number | undefined, provider: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function isModelRejectedError(err: unknown): err is ModelRejectedError;
+export declare function classifyModelRejection(err: unknown, model: string, provider: string): ModelRejectedError | undefined;

package/dist/agent/providers/xai/index.d.ts

@@ -1,4 +1,4 @@
-import type { ModelProvider, ProviderQuery, ProviderQueryArgs, ProviderCompleteArgs } from '../../provider.js';
+import type { ModelProvider, ProviderQuery, ProviderQueryArgs, ProviderCompleteArgs, ProviderCompleteResult } from '../../provider.js';
 import type { OpenAICompatibleProviderOptions } from '../openai-compatible/index.js';
 import { OpenAICompatibleProvider } from '../openai-compatible/index.js';
 import { type XaiAuthForceMode, type XaiAuthResolverDeps } from './auth.js';
@@ -33,6 +33,7 @@ export declare class XaiProvider implements ModelProvider {
     get _innerForTesting(): OpenAICompatibleProvider;
     close(): void;
     complete(args: ProviderCompleteArgs): Promise<string>;
+    completeWithStop(args: ProviderCompleteArgs): Promise<ProviderCompleteResult>;
 }
 export { resolveXaiAuth, formatXaiAuthDiagnostic, formatXaiHttpAuthError, type XaiAuthResolution, type XaiAuthSource, } from './auth.js';
 export { resolveXaiEndpoint, DEFAULT_XAI_API_BASE_URL, DEFAULT_XAI_OAUTH_BASE_URL, type XaiAuthMode, } from './endpoints.js';

package/dist/agent/subagent/fork-model-fallback.d.ts

@@ -0,0 +1,15 @@
+import type { AgentConfig } from '../types.js';
+import type { BundledProviderName } from '../providers/index.js';
+import type { ForkSubagentOptions } from './fork-types.js';
+import type { WorkspaceStore } from '../workspace/workspace-store.js';
+import type { HandleModelFallback } from './handle.model-fallback.js';
+export interface BuildForkModelFallbackArgs<T> {
+    options: ForkSubagentOptions<T>;
+    childConfig: AgentConfig;
+    id: string;
+    parentApiKey: string | undefined;
+    parentBaseUrl: string | undefined;
+    parentProvider: BundledProviderName | undefined;
+    workspaceStore: WorkspaceStore | undefined;
+}
+export declare function buildForkModelFallback<T>(args: BuildForkModelFallbackArgs<T>): HandleModelFallback | undefined;

package/dist/agent/subagent/fork-types.d.ts

@@ -30,6 +30,10 @@ export interface ForkSubagentOptions<T = unknown> {
     progressEvents?: boolean;
     phaseRole?: PhaseRole;
     nestedAgentAllowlist?: readonly string[];
+    modelFallback?: {
+        model: string;
+        buildProvider?: (model: string) => import('../provider.js').ModelProvider;
+    };
 }
 export interface ParentCredential {
     key: string | (() => string | undefined);

package/dist/agent/subagent/handle.d.ts

@@ -9,6 +9,7 @@ import type { TraceSink } from '../trace/index.js';
 import { PauseAwareCeiling } from './pause-ceiling.js';
 import type { WorkspaceEntry, WorkspaceStore } from '../workspace/workspace-store.js';
 import { type SubagentResult, type SubagentStatus, type SubagentTrace } from './result.js';
+import { type HandleModelFallback } from './handle.model-fallback.js';
 import { type RunBillingContext } from './handle.billing.js';
 export type { SubagentProgressMeta };
 export interface SubagentHandle<T = unknown> {
@@ -29,7 +30,7 @@ export interface SubagentHandle<T = unknown> {
 }
 export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     readonly id: string;
-    readonly session: IAgentSession;
+    session: IAgentSession;
     readonly _controller: AbortController;
     private readonly abortGraph;
     readonly _outputSchema: ZodType<T> | undefined;
@@ -63,6 +64,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     get pendingBillingStreams(): Promise<void>[];
     get _runBilling(): BillingUsage | undefined;
     set _runBilling(value: BillingUsage | undefined);
+    _modelFallback?: HandleModelFallback;
     _logWriter?: {
         write(event: OutputEvent): void;
         close(): Promise<void>;

package/dist/agent/subagent/handle.model-fallback.d.ts

@@ -0,0 +1,14 @@
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
+import type { IAgentSession, Message } from '../types.js';
+import type { SubagentProgressSink } from '../types/session-types.js';
+import type { RunBillingContext } from './handle.billing.js';
+import type { SubagentHandleImpl } from './handle.js';
+export interface HandleModelFallback {
+    fromModel: string;
+    toModel: string;
+    createSession: () => IAgentSession;
+}
+export declare const MODEL_FALLBACK_WARNING_PREFIX = "[model-fallback]";
+export declare function hasZeroProgress<T>(handle: SubagentHandleImpl<T>): boolean;
+export declare function buildModelFallbackWarning(fromModel: string, toModel: string, reason: string): string;
+export declare function streamWithModelFallback<T>(handle: SubagentHandleImpl<T>, prompt: string | ContentBlockParam[], sinkOverride: SubagentProgressSink | undefined, billingContext: RunBillingContext): Promise<Message>;

package/dist/agent/subagent/resolve-child-model.d.ts

@@ -4,4 +4,15 @@ export interface ResolveChildModelOpts {
     defaultSubagentModel?: string;
     defaultModel?: string;
 }
+export type ChildModelSource = 'callSite' | 'namedAgent' | 'default' | 'parent' | 'floor';
+export interface ResolvedChildModel {
+    model: string;
+    source: ChildModelSource;
+}
 export declare function resolveChildModel(opts: ResolveChildModelOpts): string;
+export declare function resolveChildModel(opts: ResolveChildModelOpts, extra: {
+    withSource: true;
+}): ResolvedChildModel;
+export declare function defaultTierModelFallback(resolved: ResolvedChildModel, parentModel: string | undefined): {
+    model: string;
+} | undefined;

package/dist/agent/tools/skill-executor/fork-dispatch.d.ts

@@ -1,6 +1,7 @@
 import { SubagentManager } from '../../subagent.js';
 import type { ToolCall, ToolResult } from '../types.js';
 import type { AgentConfig } from '../../types/config-types.js';
+import type { ForkSubagentOptions } from '../../subagent/fork-types.js';
 import { type JournalParentHolder } from './fork-child-config.js';
 import type { SkillExecutorInternals } from './types.js';
 export declare function executeForkedRegistrySkill(internals: SkillExecutorInternals, skill: {
@@ -20,6 +21,7 @@ export declare function runForkedSkillToResult(internals: SkillExecutorInternals
     idPrefix: string;
     parentId: string;
     args: string | undefined;
+    modelFallback?: ForkSubagentOptions['modelFallback'];
     noOutputError: string;
     errorPrefix: string;
 }): Promise<ToolResult>;

package/dist/agent/tools/subagent/child-config.d.ts

@@ -1,3 +1,5 @@
+import { type ChildModelSource } from '../../subagent/resolve-child-model.js';
+import type { ForkSubagentOptions } from '../../subagent/fork-types.js';
 import { SubagentManager } from '../../subagent.js';
 import type { ReadScopeInputs } from '../../subagent-read-scope.js';
 import type { ModelProvider } from '../../provider.js';
@@ -52,5 +54,7 @@ export interface BuildChildConfigResult {
     childWriteCapable: boolean;
     childSideEffectFree: boolean;
     nestedAgentAllowlist: readonly string[] | undefined;
+    childModelSource: ChildModelSource;
+    modelFallback: ForkSubagentOptions['modelFallback'];
 }
 export declare function buildChildConfig(args: BuildChildConfigArgs): BuildChildConfigResult;

package/dist/agent/tools/subagent/child-config.helpers.d.ts

@@ -1,3 +1,5 @@
+import type { ModelProvider } from '../../provider.js';
+import { type ChildModelSource } from '../../subagent/resolve-child-model.js';
 import { resolveAgentToolAccess } from '../../agents/index.js';
 import { SubagentManager } from '../../subagent.js';
 import type { RegisteredAgent, AgentRegistry } from '../../agents/index.js';
@@ -9,6 +11,7 @@ import type { BuildChildConfigArgs, ChildParentSession } from './child-config.js
 export interface ResolvedChildModel {
     childModel: string;
     childIsOpenAI: boolean;
+    childModelSource: ChildModelSource;
 }
 export declare function resolveChildModelAndProvider(parsed: Pick<AgentInput, 'model'>, namedAgent: RegisteredAgent | undefined, defaultSubagentModel: AgentModelInput, parentModel: AgentModelInput | undefined): ResolvedChildModel;
 export interface ResolvedChildToolAccess {
@@ -29,6 +32,7 @@ export declare function buildBaseChildConfig(parsed: Pick<AgentInput, 'cwd' | 'w
 export interface WireChildNestingResult {
     childParentSession: ChildParentSession | undefined;
     childManager: SubagentManager | undefined;
+    rebuildProvider?: (model: string) => ModelProvider;
 }
 interface WireChildNestingArgs {
     args: BuildChildConfigArgs;

package/dist/agent/tools/subagent/root-validation.d.ts

@@ -1,2 +1,10 @@
 export declare function isTooBroadRoot(candidate: string): boolean;
 export declare function ungatedSensitiveRoot(candidate: string): string | undefined;
+export type RootField = 'cwd' | 'readRoots' | 'writeRoots';
+export type RootValidationCaller = {
+    kind: 'agent';
+} | {
+    kind: 'compose';
+    nodeId: string;
+};
+export declare function validateRootPath(value: unknown, field: RootField, caller: RootValidationCaller): string;

package/dist/agent/tools/subagent-executor.execute-once.helpers.d.ts

@@ -1,6 +1,7 @@
 import { SubagentManager } from '../subagent.js';
 import type { AgentInput } from './subagent/input-parse.js';
 import type { StreamCutProbe } from '../subagent/stream-cut-retry.js';
+import type { ForkSubagentOptions } from '../subagent/fork-types.js';
 import { type InboundAttachmentReader } from '../content/attachment-registry.js';
 import type { SpawnReceipt } from './delegation-budget.js';
 import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
@@ -18,17 +19,22 @@ export interface IsolationWorktreeResult {
     setupNotice?: string;
 }
 export interface SetupIsolationWorktreeArgs {
-    parsed: AgentInput;
+    parsed: Pick<AgentInput, 'prompt' | 'mode' | 'agent_type' | 'id_prefix'>;
     currentCwd: string | undefined;
     isolationCounterRef: {
         value: number;
     };
-    childConfig: AgentConfig;
+    childConfig: Pick<AgentConfig, 'cwd'>;
+    dagNodeId?: string;
     childWriteCapable: boolean;
     probe: StreamCutProbe | undefined;
     budgetReceipt: SpawnReceipt | undefined;
     signal?: AbortSignal;
 }
+export declare function setupIsolationWorktree(args: SetupIsolationWorktreeArgs & {
+    dagNodeId: string;
+    childWriteCapable: true;
+}): Promise<IsolationWorktreeResult>;
 export declare function setupIsolationWorktree(args: SetupIsolationWorktreeArgs): Promise<IsolationWorktreeResult | {
     skipped: true;
 } | {
@@ -57,6 +63,7 @@ export interface ForkAndCheckCancelArgs {
     depth: number;
     updateCurrentWaveUnit: (callId: string, status: 'running' | 'done' | 'failed', error?: string, cwd?: string) => void;
     callId: string;
+    modelFallback?: ForkSubagentOptions['modelFallback'];
 }
 export type ForkResult = {
     handle: Awaited<ReturnType<SubagentManager['forkSubagent']>>;

package/dist/agent/trace/events.d.ts

@@ -751,6 +751,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
             hook_block_repeat_tripped: "hook_block_repeat_tripped";
             billing_settled: "billing_settled";
+            subagent_model_fallback: "subagent_model_fallback";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -1229,6 +1230,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
             hook_block_repeat_tripped: "hook_block_repeat_tripped";
             billing_settled: "billing_settled";
+            subagent_model_fallback: "subagent_model_fallback";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

package/dist/agent/trace/events.session-phase.d.ts

@@ -50,6 +50,7 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
     hook_block_repeat_tripped: "hook_block_repeat_tripped";
     billing_settled: "billing_settled";
+    subagent_model_fallback: "subagent_model_fallback";
 }>;
 export declare const SessionPhasePayloadSchema: z.ZodObject<{
     phase: z.ZodEnum<{
@@ -103,6 +104,7 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
         hook_block_repeat_tripped: "hook_block_repeat_tripped";
         billing_settled: "billing_settled";
+        subagent_model_fallback: "subagent_model_fallback";
     }>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

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

@@ -1,4 +1,4 @@
-export type SessionPhaseName = 'bootstrap_start' | 'bootstrap_done' | 'session_init_start' | 'session_init_done' | 'mcp_connect_start' | 'mcp_connect_done' | 'mcp_server_start' | 'mcp_server_done' | 'loop_start' | 'loop_end' | 'model_ttfb' | 'context_pressure_wind_down' | 'catalog_model_upgrade' | 'interrupt_halt' | 'rate_limit' | 'ttfb_timeout' | 'usage_limit_pause' | 'usage_limit_resume' | 'overload_pause' | 'overload_resume' | 'idle_watchdog_fired' | 'pause_extension_granted' | 'suspected_loop' | 'compaction_disabled' | 'boot_warning' | 'workspace_subscribed' | 'workspace_delivery' | 'gate_shape' | 'session_id_assigned' | 'many_image_degraded' | 'stream_accepted_after_drop' | 'connection_retry' | 'connection_retry_exhausted' | 'connection_failure' | 'connection_recovered' | 'connection_budget_exhausted' | 'usage_notice' | 'tool_degraded' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair' | 'thinking_block_dropped' | 'background_process_started' | 'background_process_settled' | 'compose_recovery_decision' | 'compose_leaf_tools_stripped' | 'hook_block_repeat_tripped' | 'billing_settled';
+export type SessionPhaseName = 'bootstrap_start' | 'bootstrap_done' | 'session_init_start' | 'session_init_done' | 'mcp_connect_start' | 'mcp_connect_done' | 'mcp_server_start' | 'mcp_server_done' | 'loop_start' | 'loop_end' | 'model_ttfb' | 'context_pressure_wind_down' | 'catalog_model_upgrade' | 'interrupt_halt' | 'rate_limit' | 'ttfb_timeout' | 'usage_limit_pause' | 'usage_limit_resume' | 'overload_pause' | 'overload_resume' | 'idle_watchdog_fired' | 'pause_extension_granted' | 'suspected_loop' | 'compaction_disabled' | 'boot_warning' | 'workspace_subscribed' | 'workspace_delivery' | 'gate_shape' | 'session_id_assigned' | 'many_image_degraded' | 'stream_accepted_after_drop' | 'connection_retry' | 'connection_retry_exhausted' | 'connection_failure' | 'connection_recovered' | 'connection_budget_exhausted' | 'usage_notice' | 'tool_degraded' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair' | 'thinking_block_dropped' | 'background_process_started' | 'background_process_settled' | 'compose_recovery_decision' | 'compose_leaf_tools_stripped' | 'hook_block_repeat_tripped' | 'billing_settled' | 'subagent_model_fallback';
 export interface SessionPhasePayload {
     phase: SessionPhaseName;
     durationMs?: number;

package/dist/cli/commands/interactive/surface-setup.suggest-record.d.ts

@@ -0,0 +1,3 @@
+import type { SessionRef } from '../../../agent/session-ref.js';
+import type { SuggestionRecorder } from '../../input/suggest.js';
+export declare function buildSuggestionJournalRecorder(session: SessionRef): SuggestionRecorder;

package/dist/cli/input/suggest-prompt-state.d.ts

@@ -1,10 +1,11 @@
-import type { CompleteFn, SuggestContext } from './suggest-types.js';
+import type { CompleteFn, SuggestContext, SuggestionRecorder } from './suggest-types.js';
 export interface PromptSuggestionStateDeps {
     pickModel(ctx: SuggestContext): string;
     resolveComplete(model: string, ctx: SuggestContext): CompleteFn | null;
     timeoutMs: number;
     scrub(s: string): string;
     onError?: (err: unknown) => void;
+    onRecord?: SuggestionRecorder;
 }
 export interface PromptSuggestionState {
     prime(ctx: SuggestContext): Promise<void>;

package/dist/cli/input/suggest-prompt.d.ts

@@ -1,4 +1,4 @@
-import type { CompleteRequest, SuggestContext } from './suggest-types.js';
+import type { CompleteFn, CompleteRequest, SuggestContext } from './suggest-types.js';
 export { extractOutcome } from './suggest-prompt.context.js';
 export declare function buildPromptSuggestionSystem(): string;
 export declare function buildPromptSuggestionUser(ctx: SuggestContext): string;
@@ -8,7 +8,7 @@ export declare function isValidPromptSuggestion(reply: string): boolean;
 export declare function normalizePromptSuggestion(raw: string): string | null;
 export type PromptCompleteRequest = CompleteRequest;
 export interface PromptSuggestionDeps {
-    resolveComplete(model: string): ((req: PromptCompleteRequest) => Promise<string>) | null;
+    resolveComplete(model: string): CompleteFn | null;
     model: string;
     timeoutMs: number;
     scrub(s: string): string;

package/dist/cli/input/suggest-reply.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderCompleteResult } from '../../agent/provider.js';
+export interface NormalizedReply {
+    text: string;
+    truncated: boolean;
+}
+export declare function normalizeReply(raw: string | ProviderCompleteResult): NormalizedReply;
+export declare function trailingWord(buffer: string): string;
+export declare function joinContinuation(buffer: string, reply: string): string | null;
+export declare function dropPartialWord(text: string): string;
+export declare function trimTruncatedLine(buffer: string, line: string): string | null;

package/dist/cli/input/suggest-tier2.d.ts

@@ -1,8 +1,9 @@
-import type { CompleteFn } from './suggest-types.js';
+import type { CompleteFn, SuggestionRecorder } from './suggest-types.js';
 import type { SuggestContext } from './suggest.js';
 export declare const MIN_LLM_CHARS = 3;
 export declare const DEBOUNCE_MS = 250;
 export declare const TIMEOUT_MS = 1500;
+export declare const LLM_MAX_TOKENS = 32;
 export declare function buildSystem(): string;
 export declare function buildUser(buffer: string, ctx: SuggestContext): string;
 export interface Tier2Deps {
@@ -11,6 +12,7 @@ export interface Tier2Deps {
     debounceMs: number;
     timeoutMs: number;
     onError?: (err: unknown) => void;
+    onRecord?: SuggestionRecorder;
 }
 export interface Tier2Runner {
     request(buffer: string, ctx: SuggestContext): Promise<string | null>;

package/dist/cli/input/suggest-types.d.ts

@@ -1,4 +1,5 @@
-import type { ModelProvider } from '../../agent/provider.js';
+import type { JournalSuggestionDetail } from '../../agent/journal/types.js';
+import type { ModelProvider, ProviderCompleteResult } from '../../agent/provider.js';
 import type { ProviderRouteHints } from '../../agent/providers/index.js';
 export interface SuggestContext {
     model: string;
@@ -24,7 +25,7 @@ export interface CompleteRequest {
     forceChatgptOAuth?: boolean;
     baseUrl?: string;
 }
-export type CompleteFn = (req: CompleteRequest) => Promise<string>;
+export type CompleteFn = (req: CompleteRequest) => Promise<string | ProviderCompleteResult>;
 export interface SuggestEngineOptions {
     completeFn?: CompleteFn;
     resolveProviderFn?: (model: string | undefined, hints: ProviderRouteHints | undefined) => ModelProvider;
@@ -32,12 +33,16 @@ export interface SuggestEngineOptions {
     debounceMs?: number;
     timeoutMs?: number;
     onError?: (err: unknown) => void;
+    onRecord?: SuggestionRecorder;
 }
+export type SuggestionRecord = JournalSuggestionDetail;
+export type SuggestionRecorder = (record: SuggestionRecord) => void;
 export interface SuggestEngine {
     getDeterministicGhost(buffer: string, ctx: SuggestContext): string | null;
     getGhost(buffer: string, ctx: SuggestContext): Promise<string | null>;
     primePromptSuggestion(ctx: SuggestContext): Promise<void>;
     peekPromptSuggestion(): string | null;
     clearPromptSuggestion(): void;
+    recordOutcome?(record: SuggestionRecord): void;
     dispose(): void;
 }

package/dist/cli/input/suggest.d.ts

@@ -1,5 +1,5 @@
 import type { SuggestEngine, SuggestEngineOptions } from './suggest-types.js';
-export type { CompleteFn, CompleteRequest, SuggestContext, SuggestEngine, SuggestEngineOptions, } from './suggest-types.js';
+export type { CompleteFn, CompleteRequest, SuggestContext, SuggestEngine, SuggestEngineOptions, SuggestionRecord, SuggestionRecorder, } from './suggest-types.js';
 export { stripGhostControlChars } from './suggest-sanitize.js';
 export { pickModel } from './suggest-provider.js';
 export { getDeterministicGhost } from './suggest-tier1.js';

package/dist/cli/slash/commands/handoffs.d.ts

@@ -0,0 +1,4 @@
+import type { SlashCommand } from '../types.js';
+export declare const handoffsCmd: SlashCommand;
+export declare const handoffsAnswerCmd: SlashCommand;
+export declare const handoffsCommands: readonly SlashCommand[];

package/dist/cli/terminal-compositor.ghost.record.d.ts

@@ -0,0 +1,5 @@
+import type { AutocompleteHost } from './terminal-compositor.autocomplete.js';
+export type GhostSource = 'completion' | 'prompt' | null;
+export declare function noteGhostSource(self: AutocompleteHost, ghost: string, source: GhostSource): void;
+export declare function recordGhostAccept(self: AutocompleteHost, ghost: string, full: boolean): void;
+export declare function recordPromptDismiss(self: AutocompleteHost, text: string): void;