@umsai/ums-code 0.1.4-v2 → 0.3.0-v2

package/dist/src/nonInteractive/types.d.ts

@@ -0,0 +1,344 @@
+/**
+ * Annotation for attaching metadata to content blocks
+ */
+export interface Annotation {
+    type: string;
+    value: string;
+}
+/**
+ * Usage information types
+ */
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+    total_tokens?: number;
+}
+export interface ExtendedUsage extends Usage {
+    server_tool_use?: {
+        web_search_requests: number;
+    };
+    service_tier?: string;
+    cache_creation?: {
+        ephemeral_1h_input_tokens: number;
+        ephemeral_5m_input_tokens: number;
+    };
+}
+export interface ModelUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    webSearchRequests: number;
+    contextWindow: number;
+}
+/**
+ * Permission denial information
+ */
+export interface CLIPermissionDenial {
+    tool_name: string;
+    tool_use_id: string;
+    tool_input: unknown;
+}
+/**
+ * Content block types from Anthropic SDK
+ */
+export interface TextBlock {
+    type: 'text';
+    text: string;
+    annotations?: Annotation[];
+}
+export interface ThinkingBlock {
+    type: 'thinking';
+    thinking: string;
+    signature?: string;
+    annotations?: Annotation[];
+}
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+    annotations?: Annotation[];
+}
+export interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content?: string | ContentBlock[];
+    is_error?: boolean;
+    annotations?: Annotation[];
+}
+export type ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock;
+/**
+ * Anthropic SDK Message types
+ */
+export interface APIUserMessage {
+    role: 'user';
+    content: string | ContentBlock[];
+}
+export interface APIAssistantMessage {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    model: string;
+    content: ContentBlock[];
+    stop_reason?: string | null;
+    usage: Usage;
+}
+/**
+ * CLI Message wrapper types
+ */
+export interface CLIUserMessage {
+    type: 'user';
+    uuid?: string;
+    session_id: string;
+    message: APIUserMessage;
+    parent_tool_use_id: string | null;
+    options?: Record<string, unknown>;
+}
+export interface CLIAssistantMessage {
+    type: 'assistant';
+    uuid: string;
+    session_id: string;
+    message: APIAssistantMessage;
+    parent_tool_use_id: string | null;
+}
+export interface CLISystemMessage {
+    type: 'system';
+    subtype: string;
+    uuid: string;
+    session_id: string;
+    data?: unknown;
+    cwd?: string;
+    tools?: string[];
+    mcp_servers?: Array<{
+        name: string;
+        status: string;
+    }>;
+    model?: string;
+    permissionMode?: string;
+    slash_commands?: string[];
+    apiKeySource?: string;
+    qwen_code_version?: string;
+    output_style?: string;
+    agents?: string[];
+    skills?: string[];
+    capabilities?: Record<string, unknown>;
+    compact_metadata?: {
+        trigger: 'manual' | 'auto';
+        pre_tokens: number;
+    };
+}
+export interface CLIResultMessageSuccess {
+    type: 'result';
+    subtype: 'success';
+    uuid: string;
+    session_id: string;
+    is_error: false;
+    duration_ms: number;
+    duration_api_ms: number;
+    num_turns: number;
+    result: string;
+    usage: ExtendedUsage;
+    modelUsage?: Record<string, ModelUsage>;
+    permission_denials: CLIPermissionDenial[];
+    [key: string]: unknown;
+}
+export interface CLIResultMessageError {
+    type: 'result';
+    subtype: 'error_max_turns' | 'error_during_execution';
+    uuid: string;
+    session_id: string;
+    is_error: true;
+    duration_ms: number;
+    duration_api_ms: number;
+    num_turns: number;
+    usage: ExtendedUsage;
+    modelUsage?: Record<string, ModelUsage>;
+    permission_denials: CLIPermissionDenial[];
+    error?: {
+        type?: string;
+        message: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export type CLIResultMessage = CLIResultMessageSuccess | CLIResultMessageError;
+/**
+ * Stream event types for real-time message updates
+ */
+export interface MessageStartStreamEvent {
+    type: 'message_start';
+    message: {
+        id: string;
+        role: 'assistant';
+        model: string;
+    };
+}
+export interface ContentBlockStartEvent {
+    type: 'content_block_start';
+    index: number;
+    content_block: ContentBlock;
+}
+export type ContentBlockDelta = {
+    type: 'text_delta';
+    text: string;
+} | {
+    type: 'thinking_delta';
+    thinking: string;
+} | {
+    type: 'input_json_delta';
+    partial_json: string;
+};
+export interface ContentBlockDeltaEvent {
+    type: 'content_block_delta';
+    index: number;
+    delta: ContentBlockDelta;
+}
+export interface ContentBlockStopEvent {
+    type: 'content_block_stop';
+    index: number;
+}
+export interface MessageStopStreamEvent {
+    type: 'message_stop';
+}
+export type StreamEvent = MessageStartStreamEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockStopEvent | MessageStopStreamEvent;
+export interface CLIPartialAssistantMessage {
+    type: 'stream_event';
+    uuid: string;
+    session_id: string;
+    event: StreamEvent;
+    parent_tool_use_id: string | null;
+}
+export type PermissionMode = 'default' | 'plan' | 'auto-edit' | 'yolo';
+/**
+ * Permission suggestion for tool use requests
+ * TODO: Align with `ToolCallConfirmationDetails`
+ */
+export interface PermissionSuggestion {
+    type: 'allow' | 'deny' | 'modify';
+    label: string;
+    description?: string;
+    modifiedInput?: unknown;
+}
+/**
+ * Hook callback placeholder for future implementation
+ */
+export interface HookRegistration {
+    event: string;
+    callback_id: string;
+}
+/**
+ * Hook callback result placeholder for future implementation
+ */
+export interface HookCallbackResult {
+    shouldSkip?: boolean;
+    shouldInterrupt?: boolean;
+    suppressOutput?: boolean;
+    message?: string;
+}
+export interface CLIControlInterruptRequest {
+    subtype: 'interrupt';
+}
+export interface CLIControlPermissionRequest {
+    subtype: 'can_use_tool';
+    tool_name: string;
+    tool_use_id: string;
+    input: unknown;
+    permission_suggestions: PermissionSuggestion[] | null;
+    blocked_path: string | null;
+}
+export interface CLIControlInitializeRequest {
+    subtype: 'initialize';
+    hooks?: HookRegistration[] | null;
+    sdkMcpServers?: string[];
+}
+export interface CLIControlSetPermissionModeRequest {
+    subtype: 'set_permission_mode';
+    mode: PermissionMode;
+}
+export interface CLIHookCallbackRequest {
+    subtype: 'hook_callback';
+    callback_id: string;
+    input: unknown;
+    tool_use_id: string | null;
+}
+export interface CLIControlMcpMessageRequest {
+    subtype: 'mcp_message';
+    server_name: string;
+    message: {
+        jsonrpc?: string;
+        method: string;
+        params?: Record<string, unknown>;
+        id?: string | number | null;
+    };
+}
+export interface CLIControlSetModelRequest {
+    subtype: 'set_model';
+    model: string;
+}
+export interface CLIControlMcpStatusRequest {
+    subtype: 'mcp_server_status';
+}
+export interface CLIControlSupportedCommandsRequest {
+    subtype: 'supported_commands';
+}
+export type ControlRequestPayload = CLIControlInterruptRequest | CLIControlPermissionRequest | CLIControlInitializeRequest | CLIControlSetPermissionModeRequest | CLIHookCallbackRequest | CLIControlMcpMessageRequest | CLIControlSetModelRequest | CLIControlMcpStatusRequest | CLIControlSupportedCommandsRequest;
+export interface CLIControlRequest {
+    type: 'control_request';
+    request_id: string;
+    request: ControlRequestPayload;
+}
+/**
+ * Permission approval result
+ */
+export interface PermissionApproval {
+    allowed: boolean;
+    reason?: string;
+    modifiedInput?: unknown;
+}
+export interface ControlResponse {
+    subtype: 'success';
+    request_id: string;
+    response: unknown;
+}
+export interface ControlErrorResponse {
+    subtype: 'error';
+    request_id: string;
+    error: string | {
+        message: string;
+        [key: string]: unknown;
+    };
+}
+export interface CLIControlResponse {
+    type: 'control_response';
+    response: ControlResponse | ControlErrorResponse;
+}
+export interface ControlCancelRequest {
+    type: 'control_cancel_request';
+    request_id?: string;
+}
+export type ControlMessage = CLIControlRequest | CLIControlResponse | ControlCancelRequest;
+/**
+ * Union of all CLI message types
+ */
+export type CLIMessage = CLIUserMessage | CLIAssistantMessage | CLISystemMessage | CLIResultMessage | CLIPartialAssistantMessage;
+/**
+ * Type guard functions for message discrimination
+ */
+export declare function isCLIUserMessage(msg: any): msg is CLIUserMessage;
+export declare function isCLIAssistantMessage(msg: any): msg is CLIAssistantMessage;
+export declare function isCLISystemMessage(msg: any): msg is CLISystemMessage;
+export declare function isCLIResultMessage(msg: any): msg is CLIResultMessage;
+export declare function isCLIPartialAssistantMessage(msg: any): msg is CLIPartialAssistantMessage;
+export declare function isControlRequest(msg: any): msg is CLIControlRequest;
+export declare function isControlResponse(msg: any): msg is CLIControlResponse;
+export declare function isControlCancel(msg: any): msg is ControlCancelRequest;
+/**
+ * Content block type guards
+ */
+export declare function isTextBlock(block: any): block is TextBlock;
+export declare function isThinkingBlock(block: any): block is ThinkingBlock;
+export declare function isToolUseBlock(block: any): block is ToolUseBlock;
+export declare function isToolResultBlock(block: any): block is ToolResultBlock;

package/dist/src/nonInteractive/types.js

@@ -0,0 +1,78 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Type guard functions for message discrimination
+ */
+export function isCLIUserMessage(msg) {
+    return (msg && typeof msg === 'object' && msg.type === 'user' && 'message' in msg);
+}
+export function isCLIAssistantMessage(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'assistant' &&
+        'uuid' in msg &&
+        'message' in msg &&
+        'session_id' in msg &&
+        'parent_tool_use_id' in msg);
+}
+export function isCLISystemMessage(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'system' &&
+        'subtype' in msg &&
+        'uuid' in msg &&
+        'session_id' in msg);
+}
+export function isCLIResultMessage(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'result' &&
+        'subtype' in msg &&
+        'duration_ms' in msg &&
+        'is_error' in msg &&
+        'uuid' in msg &&
+        'session_id' in msg);
+}
+export function isCLIPartialAssistantMessage(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'stream_event' &&
+        'uuid' in msg &&
+        'session_id' in msg &&
+        'event' in msg &&
+        'parent_tool_use_id' in msg);
+}
+export function isControlRequest(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'control_request' &&
+        'request_id' in msg &&
+        'request' in msg);
+}
+export function isControlResponse(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'control_response' &&
+        'response' in msg);
+}
+export function isControlCancel(msg) {
+    return (msg &&
+        typeof msg === 'object' &&
+        msg.type === 'control_cancel_request' &&
+        'request_id' in msg);
+}
+/**
+ * Content block type guards
+ */
+export function isTextBlock(block) {
+    return block && typeof block === 'object' && block.type === 'text';
+}
+export function isThinkingBlock(block) {
+    return block && typeof block === 'object' && block.type === 'thinking';
+}
+export function isToolUseBlock(block) {
+    return block && typeof block === 'object' && block.type === 'tool_use';
+}
+export function isToolResultBlock(block) {
+    return block && typeof block === 'object' && block.type === 'tool_result';
+}
+//# sourceMappingURL=types.js.map

package/dist/src/nonInteractive/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/nonInteractive/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAkZvD;;GAEG;AAEH,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,OAAO,CACL,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,IAAI,GAAG,CAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAQ;IAC5C,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,WAAW;QACxB,MAAM,IAAI,GAAG;QACb,SAAS,IAAI,GAAG;QAChB,YAAY,IAAI,GAAG;QACnB,oBAAoB,IAAI,GAAG,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,QAAQ;QACrB,SAAS,IAAI,GAAG;QAChB,MAAM,IAAI,GAAG;QACb,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,QAAQ;QACrB,SAAS,IAAI,GAAG;QAChB,aAAa,IAAI,GAAG;QACpB,UAAU,IAAI,GAAG;QACjB,MAAM,IAAI,GAAG;QACb,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,GAAQ;IAER,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,cAAc;QAC3B,MAAM,IAAI,GAAG;QACb,YAAY,IAAI,GAAG;QACnB,OAAO,IAAI,GAAG;QACd,oBAAoB,IAAI,GAAG,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,iBAAiB;QAC9B,YAAY,IAAI,GAAG;QACnB,SAAS,IAAI,GAAG,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,kBAAkB;QAC/B,UAAU,IAAI,GAAG,CAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAQ;IACtC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,IAAI,KAAK,wBAAwB;QACrC,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AAEH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAU;IACxC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAU;IAC1C,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AAC5E,CAAC"}

package/dist/src/nonInteractiveCli.d.ts

@@ -5,4 +5,24 @@
  */
 import type { Config } from '@umsai/ums-code-core';
 import type { LoadedSettings } from './config/settings.js';
-export declare function runNonInteractive(config: Config, settings: LoadedSettings, input: string, prompt_id: string): Promise<void>;
+import type { CLIUserMessage } from './nonInteractive/types.js';
+import type { JsonOutputAdapterInterface } from './nonInteractive/io/BaseJsonOutputAdapter.js';
+import type { ControlService } from './nonInteractive/control/ControlService.js';
+/**
+ * Provides optional overrides for `runNonInteractive` execution.
+ *
+ * @param abortController - Optional abort controller for cancellation.
+ * @param adapter - Optional JSON output adapter for structured output formats.
+ * @param userMessage - Optional CLI user message payload for preformatted input.
+ * @param controlService - Optional control service for future permission handling.
+ */
+export interface RunNonInteractiveOptions {
+    abortController?: AbortController;
+    adapter?: JsonOutputAdapterInterface;
+    userMessage?: CLIUserMessage;
+    controlService?: ControlService;
+}
+/**
+ * Executes the non-interactive CLI flow for a single request.
+ */
+export declare function runNonInteractive(config: Config, settings: LoadedSettings, input: string, prompt_id: string, options?: RunNonInteractiveOptions): Promise<void>;