praxis-agent 0.55.1 → 0.55.3

package/dist/cli/protocol.d.ts

@@ -1,4 +1,4 @@
-import type { ModelDocument, ModelDocumentMediaType, ModelImage, ModelImageMediaType, ModelUsage, RuntimeEventSink } from '../core/runtime.js';
+import type { ModelDocument, ModelDocumentMediaType, ModelImage, ModelImageMediaType, ModelTerminalReason, ModelUsage, RuntimeEventSink } from '../core/runtime.js';
 export type CliInputFormat = 'text' | 'stream-json';
 export type CliOutputFormat = 'text' | 'json' | 'stream-json';
 export type CliPermissionMode = 'acceptEdits' | 'auto' | 'bypassPermissions' | 'manual' | 'dontAsk' | 'plan' | 'default';
@@ -225,8 +225,25 @@ export interface ProtocolResult {
      */
     modelCostUsd?: Readonly<Record<string, number>>;
 }
-export declare function createSuccessResult(result: ProtocolResult, info: CliRuntimeInfo, startedAt: number, modelTurns: number): Record<string, unknown>;
-export declare function createErrorResult(message: string, sessionId: string, startedAt: number, modelTurns: number): Record<string, unknown>;
+export interface ProtocolSuccessProjectionContext {
+    localCommand?: boolean;
+    stopReason?: ModelTerminalReason;
+    ttftMs?: number;
+    ttftStreamMs?: number;
+    timeToRequestMs?: number;
+}
+export interface ProtocolErrorProjectionContext {
+    providerApiError?: boolean;
+    apiErrorStatus?: number | null;
+}
+export interface ProtocolTimingProjection {
+    ttftMs?: number;
+    ttftStreamMs?: number;
+    timeToRequestMs?: number;
+}
+export declare function projectProtocolTimings(startedAt: number, requestAt?: number, outputAt?: number): ProtocolTimingProjection;
+export declare function createSuccessResult(result: ProtocolResult, info: CliRuntimeInfo, startedAt: number, modelTurns: number, context?: ProtocolSuccessProjectionContext): Record<string, unknown>;
+export declare function createErrorResult(message: string, sessionId: string, startedAt: number, modelTurns: number, context?: ProtocolErrorProjectionContext): Record<string, unknown>;
 /**
  * Returns the argument text of a headless `/color` prompt, or undefined when
  * the prompt is not a bare `/color` command. A trailing space matches with an
@@ -243,11 +260,9 @@ export declare function parseCliInvocation(argv: readonly string[]): CliInvocati
 export declare function readStreamJsonMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamJsonMessage>;
 export declare function readStreamUserMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamUserMessage>;
 export declare class StreamJsonOutput {
-    private readonly write;
+    private readonly emitRaw;
     private readonly info;
     private readonly sessionId;
-    private readonly includePartialMessages;
-    private readonly includeHookEvents;
     private turnId;
     private turnText;
     private turnThinking;
@@ -261,10 +276,25 @@ export declare class StreamJsonOutput {
     private activeThinkingIndex;
     private nextContentIndex;
     private modelTurns;
+    private projectionStartedAt;
+    private firstRequestAt;
+    private firstOutputAt;
+    private turnHasRealContent;
+    private pendingFailureMessage;
     private compacting;
     private sessionState;
-    constructor(write: (value: unknown) => void, info: CliRuntimeInfo, sessionId: string, includePartialMessages: boolean, includeHookEvents?: boolean);
-    init(): void;
+    private readonly emitSessionStateEvents;
+    private partialEvents;
+    private pendingPartialStop;
+    constructor(emitRaw: (value: unknown) => void, info: CliRuntimeInfo, sessionId: string, options: {
+        includePartialMessages: boolean;
+        includeHookEvents?: boolean;
+        emitSessionStateEvents?: boolean;
+    });
+    private readonly includePartialMessages;
+    private readonly includeHookEvents;
+    private write;
+    init(startedAt?: number): void;
     replayUser(message: StreamUserMessage['message']): void;
     /**
      * Emits the synthetic assistant message for a provider-free local command
@@ -277,16 +307,21 @@ export declare class StreamJsonOutput {
         request: Record<string, unknown>;
     }): void;
     readonly sink: RuntimeEventSink;
-    result(result: ProtocolResult, startedAt: number): void;
+    result(result: ProtocolResult, startedAt: number, context?: ProtocolSuccessProjectionContext): void;
     promptSuggestion(suggestion: string): void;
-    error(message: string, startedAt: number): void;
+    error(message: string, startedAt: number, context?: ProtocolErrorProjectionContext): void;
     private onEvent;
     private writeSessionState;
+    private writeTerminalIdle;
     private ensureTurn;
+    private observeOutput;
     private discardTurn;
     private startTurn;
+    private writePartialMessageStart;
     private partialText;
+    private beginPartialBlock;
     private finishPartial;
+    private finishPartialTail;
     private flushAssistant;
     private finishTurn;
 }