@lingxiao-office/sdk 1.0.0

package/dist/contracts/types/Event.js

@@ -0,0 +1,197 @@
+export const EVENT_ENVELOPE_SCHEMA_VERSION = 1;
+let eventSequenceCounter = 0;
+export function nextEventSequence() {
+    eventSequenceCounter = eventSequenceCounter >= Number.MAX_SAFE_INTEGER ? 1 : eventSequenceCounter + 1;
+    return eventSequenceCounter;
+}
+export function createEventId(type, sequence, timestamp) {
+    return `evt_${timestamp}_${sequence}_${type.replace(/[^a-zA-Z0-9]+/g, '_')}`;
+}
+export const EVENT_TYPES = [
+    'leader:text',
+    'leader:text_chunk',
+    'leader:thinking_chunk',
+    'leader:tool_call',
+    'leader:tool_result',
+    'leader:tool_call_delta',
+    'leader:status',
+    'leader:error',
+    'leader:route',
+    'leader:control_mode_changed',
+    'leader:blueprint_updated',
+    'leader:phase_change',
+    'leader:busy',
+    'leader:round_complete',
+    'leader:watchdog_alert',
+    'leader:progress_stagnant',
+    'leader:tool_output',
+    'leader:tool_progress',
+    'leader:plan_approved',
+    'leader:plan_rejected',
+    'leader:llm_retry',
+    'agent:spawned',
+    'agent:started',
+    'agent:completed',
+    'agent:terminated',
+    'agent:failed',
+    'agent:status',
+    'agent:progress',
+    'agent:heartbeat',
+    'agent:interactive_state',
+    'agent:tool_call',
+    'agent:tool_result',
+    'agent:tool_call_delta',
+    'agent:tool_output',
+    'agent:shell_state',
+    'agent:activity',
+    'agent:tool_progress',
+    'agent:text_chunk',
+    'agent:thinking_chunk',
+    'agent:text',
+    'agent:error',
+    'agent:context_updated',
+    'agent:llm_retry',
+    'task:created',
+    'task:updated',
+    'task:assigned',
+    'task:completed',
+    'task:failed',
+    'task:cancelled',
+    'task:deleted',
+    'session:created',
+    'session:failed',
+    'session:deleted',
+    'session:renamed',
+    'session:focus',
+    'session:completed',
+    'session:interrupted',
+    'session:runtime_state',
+    'session:collaboration_mode_changed',
+    'session:autonomy_mode_changed',
+    'session:execution_route_changed',
+    'settings:changed',
+    'chat:user_message',
+    'conversation:message_saved',
+    'permission:mode_changed',
+    'permission:request',
+    'permission:resolved',
+    'context:runtime_updated',
+    'context:mutation',
+    'context:compressed',
+    'context:compacting',
+    'context:overflow',
+    'eternal:goal_changed',
+    'blackboard:delta',
+    'blackboard:initialized',
+    'work_note:written',
+    'team:message_sent',
+    'team:message_read',
+    'leader:capability_intent',
+    'leader:autonomy_decision',
+    'leader:message_queued',
+    'leader:message_dequeued',
+    'agent:crashed',
+    'agent:intervention',
+    'wiki:generation_started',
+    'wiki:generation_progress',
+    'wiki:generation_stream',
+    'wiki:generation_completed',
+    'wiki:generation_failed',
+    'workflow:created',
+    'workflow:updated',
+    'workflow:deleted',
+    'workflow:node_added',
+    'workflow:node_updated',
+    'workflow:node_deleted',
+    'workflow:edge_added',
+    'workflow:edge_updated',
+    'workflow:edge_deleted',
+    'workflow:execution_started',
+    'workflow:node_started',
+    'workflow:node_completed',
+    'workflow:node_failed',
+    'workflow:node_retrying',
+    'workflow:node_skipped',
+    'workflow:execution_completed',
+    'workflow:execution_failed',
+    'workflow:execution_cancelled',
+    'workflow:execution_paused',
+    'workflow:execution_resumed',
+    'workflow:execution_progress',
+    'orchestration:status',
+    'orchestration:run_state',
+    'orchestration:node_update',
+    'orchestration:dag_updated',
+    'orchestration:event_applied',
+    'orchestration:event_rejected',
+    'run:explanation_updated',
+    'token:usage',
+    'plan:submitted',
+    'plan:updated',
+    'plan:finalized',
+    'skills:loaded',
+    'skill:invoked',
+    'session:soul_extracted',
+    'plugin:toggled',
+    'terminal:output',
+    'terminal:state',
+    'notification:new',
+    'notification:mark_read',
+    'user:input_needed',
+    'user:question_answered',
+    'langfuse:trace',
+    'canvas:version_pushed',
+];
+const EVENT_TYPE_SET = new Set(EVENT_TYPES);
+export function isEventType(value) {
+    return EVENT_TYPE_SET.has(value);
+}
+export function isToolCallEvent(type) {
+    return type === 'leader:tool_call' || type === 'agent:tool_call';
+}
+export function isToolResultEvent(type) {
+    return type === 'leader:tool_result' || type === 'agent:tool_result';
+}
+export function parseEventEnvelope(input) {
+    if (!input || typeof input !== 'object') {
+        return null;
+    }
+    const raw = input;
+    const type = typeof raw.type === 'string'
+        ? raw.type
+        : typeof raw.eventType === 'string'
+            ? raw.eventType
+            : undefined;
+    if (!type || !isEventType(type)) {
+        return null;
+    }
+    const payload = raw.payload && typeof raw.payload === 'object'
+        ? raw.payload
+        : raw;
+    const sessionId = typeof raw.sessionId === 'string'
+        ? raw.sessionId
+        : typeof payload.sessionId === 'string'
+            ? payload.sessionId
+            : '';
+    const timestamp = typeof raw.timestamp === 'number' ? raw.timestamp : Date.now();
+    const sequence = typeof raw.sequence === 'number' && Number.isFinite(raw.sequence)
+        ? raw.sequence
+        : nextEventSequence();
+    const hasCanonicalFields = Boolean(raw.payload)
+        || typeof raw.schemaVersion === 'number'
+        || typeof raw.sequence === 'number';
+    return {
+        schemaVersion: typeof raw.schemaVersion === 'number' ? raw.schemaVersion : EVENT_ENVELOPE_SCHEMA_VERSION,
+        type,
+        eventId: hasCanonicalFields && typeof raw.eventId === 'string'
+            ? raw.eventId
+            : createEventId(type, sequence, timestamp),
+        sequence,
+        source: typeof raw.source === 'string' ? raw.source : 'unknown',
+        method: typeof raw.method === 'string' ? raw.method : undefined,
+        sessionId,
+        timestamp,
+        payload,
+    };
+}
+//# sourceMappingURL=Event.js.map

package/dist/contracts/types/Event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Event.js","sourceRoot":"","sources":["../../../src/contracts/types/Event.ts"],"names":[],"mappings":"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"}

package/dist/contracts/types/Message.d.ts

@@ -0,0 +1,94 @@
+import type { ToolCallStatus } from './Status.js';
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ThinkingBlock {
+    type: 'thinking';
+    text: string;
+    signature?: string;
+}
+export interface RedactedThinkingBlock {
+    type: 'redacted_thinking';
+    data: string;
+}
+export interface ToolCallBlock {
+    type: 'tool_call';
+    toolCallId: string;
+    name: string;
+    input: unknown;
+}
+export interface ToolResultBlock {
+    type: 'tool_result';
+    toolCallId: string;
+    result: unknown;
+    status: ToolCallStatus;
+}
+export type ContentBlock = TextBlock | ThinkingBlock | ToolCallBlock | ToolResultBlock;
+export interface BaseMessage {
+    id: string;
+    role: MessageRole;
+    content: string | ContentBlock[];
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ImageUrlContentPart {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+export interface ImageBlobRefContentPart {
+    type: 'image_blob_ref';
+    blob_id: string;
+    mime: string;
+    size: number;
+    blob_path: string;
+    source?: string;
+}
+/**
+ * MCP Apps 交互式 UI 组件 part。
+ * 当 MCP Server 在 CallToolResult content block 的 _meta.lingxiao_app 中标记交互式 HTML 时，
+ * BaseAgentRuntime 提取为 mcp_app part，前端以 sandbox iframe 渲染。
+ */
+export interface McpAppContentPart {
+    type: 'mcp_app';
+    html: string;
+    title?: string;
+    height?: number | 'auto';
+    actions?: Array<{
+        label: string;
+        event: string;
+        data?: unknown;
+    }>;
+}
+export type MessageContentPart = TextBlock | ImageUrlContentPart | ImageBlobRefContentPart | McpAppContentPart;
+export type MessageContent = string | MessageContentPart[] | null;
+export type LlmThinkingBlock = ThinkingBlock | RedactedThinkingBlock;
+export declare function isContentPartArray(content: MessageContent | unknown): content is MessageContentPart[];
+export declare function contentToPlainText(content: MessageContent | unknown): string;
+export declare function hasImageContent(content: MessageContent | unknown): boolean;
+/**
+ * Directive prefix `@<agent> <body>` that routes a user message directly to a
+ * specific agent instead of the Leader. The match runs against the leading text
+ * of the message — a plain string, or the first text part of a structured
+ * (multimodal) array. Non-text parts (images, file refs) are preserved verbatim
+ * in `rest` so attachments route together with the directive.
+ *
+ * Returns null when there is no leading `@agent` directive (or no text part to
+ * match against), so callers fall through to normal Leader input. Routing is
+ * keyed off message *semantics*, never the wire shape (string vs array), which
+ * is why a message with an image attachment still routes correctly.
+ */
+export interface AgentMention {
+    agentName: string;
+    /** Message content with the `@agent ` prefix stripped; non-text parts kept intact. */
+    rest: MessageContent;
+}
+export declare function extractAgentMention(content: MessageContent | unknown): AgentMention | null;
+export declare function isEmptyContent(content: MessageContent | unknown): boolean;
+export declare function normalizeMessageContent(content: unknown): MessageContent;
+export declare function thinkingBlocksToText(blocks?: LlmThinkingBlock[] | null): string;
+//# sourceMappingURL=Message.d.ts.map

package/dist/contracts/types/Message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../../src/contracts/types/Message.ts"],"names":[],"mappings":"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"}

package/dist/contracts/types/Message.js

@@ -0,0 +1,151 @@
+export function isContentPartArray(content) {
+    return Array.isArray(content);
+}
+export function contentToPlainText(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return content == null ? '' : JSON.stringify(content);
+    }
+    return content
+        .map((part) => {
+        if (!part || typeof part !== 'object' || !('type' in part)) {
+            return '';
+        }
+        if (part.type === 'text') {
+            return part.text || '';
+        }
+        if (part.type === 'image_url') {
+            return '[image]';
+        }
+        if (part.type === 'image_blob_ref') {
+            const blobId = part.blob_id ?? 'unknown';
+            return `[image: ${part.mime}, ${Math.max(1, Math.round(part.size / 1024))}KB stored as blob:${blobId.slice(0, 12)}]`;
+        }
+        try {
+            return JSON.stringify(part);
+        }
+        catch { /* expected: fallback to default */
+            return '';
+        }
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+export function hasImageContent(content) {
+    return Array.isArray(content) && content.some((part) => part?.type === 'image_url' || part?.type === 'image_blob_ref');
+}
+const AGENT_MENTION_PATTERN = /^@([A-Za-z0-9_.-]+)\s+([\s\S]+)$/;
+export function extractAgentMention(content) {
+    if (typeof content === 'string') {
+        const match = content.match(AGENT_MENTION_PATTERN);
+        if (!match)
+            return null;
+        return { agentName: match[1], rest: match[2].trim() };
+    }
+    if (Array.isArray(content)) {
+        const firstTextIndex = content.findIndex((part) => part && typeof part === 'object' && part.type === 'text');
+        if (firstTextIndex === -1)
+            return null;
+        const firstText = content[firstTextIndex];
+        const match = (firstText.text || '').match(AGENT_MENTION_PATTERN);
+        if (!match)
+            return null;
+        // Rebuild content with the directive stripped from the matched text part;
+        // every other part (images, file refs) is carried through unchanged so the
+        // attachment lands in the agent's inbox, not the Leader's.
+        const rest = content.map((part, index) => index === firstTextIndex ? { type: 'text', text: match[2].trim() } : part);
+        return { agentName: match[1], rest };
+    }
+    return null;
+}
+export function isEmptyContent(content) {
+    if (content === null || content === undefined) {
+        return true;
+    }
+    if (typeof content === 'string') {
+        return !content.trim();
+    }
+    if (Array.isArray(content)) {
+        if (content.length === 0) {
+            return true;
+        }
+        return content.every((part) => {
+            if (!part || typeof part !== 'object')
+                return false;
+            if (part.type === 'text') {
+                return !part.text?.trim();
+            }
+            return false;
+        });
+    }
+    return false;
+}
+export function normalizeMessageContent(content) {
+    if (content === null || content === undefined) {
+        return null;
+    }
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return JSON.stringify(content);
+    }
+    const normalized = [];
+    for (const part of content) {
+        if (!part || typeof part !== 'object' || !('type' in part)) {
+            continue;
+        }
+        if (part.type === 'text' && 'text' in part && typeof part.text === 'string') {
+            normalized.push({ type: 'text', text: part.text });
+            continue;
+        }
+        if (part.type === 'image_url' &&
+            'image_url' in part &&
+            part.image_url &&
+            typeof part.image_url === 'object' &&
+            'url' in part.image_url &&
+            typeof part.image_url.url === 'string') {
+            normalized.push({
+                type: 'image_url',
+                image_url: {
+                    url: part.image_url.url,
+                    detail: 'detail' in part.image_url &&
+                        (part.image_url.detail === 'auto' || part.image_url.detail === 'low' || part.image_url.detail === 'high')
+                        ? part.image_url.detail
+                        : undefined,
+                },
+            });
+            continue;
+        }
+        if (part.type === 'image_blob_ref' &&
+            'blob_id' in part &&
+            typeof part.blob_id === 'string' &&
+            'mime' in part &&
+            typeof part.mime === 'string' &&
+            'size' in part &&
+            typeof part.size === 'number' &&
+            'blob_path' in part &&
+            typeof part.blob_path === 'string') {
+            normalized.push({
+                type: 'image_blob_ref',
+                blob_id: part.blob_id,
+                mime: part.mime,
+                size: part.size,
+                blob_path: part.blob_path,
+                source: 'source' in part && typeof part.source === 'string' ? part.source : undefined,
+            });
+        }
+    }
+    return normalized.length > 0 ? normalized : contentToPlainText(content);
+}
+export function thinkingBlocksToText(blocks) {
+    if (!blocks || blocks.length === 0)
+        return '';
+    return blocks
+        .map((block) => (block.type === 'thinking' ? block.text : '[redacted]'))
+        .filter(Boolean)
+        .join('\n');
+}
+//# sourceMappingURL=Message.js.map

package/dist/contracts/types/Message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../../src/contracts/types/Message.ts"],"names":[],"mappings":"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"}

package/dist/contracts/types/Session.d.ts

@@ -0,0 +1,9 @@
+export type LeaderExecutionMode = 'direct' | 'hybrid' | 'delegate';
+export type ControlMode = 'manual' | 'eternal';
+export interface SessionIdentity {
+    id: string;
+    workspace: string;
+}
+export type { AutonomyMode, AutonomyDecisionKind, AutonomyDecision, AutonomyLifecyclePhase, Capability, CapabilityDeny, CapabilityGrant, CapabilityIntentProfile, IntentConstraints, IntentPhase, IntentScope, IntentScopeKind, PrimaryIntent, RequiredGate, } from './Autonomy.js';
+export { AUTONOMY_MODES, AUTONOMY_DECISION_KINDS, AUTONOMY_LIFECYCLE_PHASES, AUTONOMY_MODE_ALIASES, CAPABILITIES, CAPABILITY_DENIES, CAPABILITY_GRANTS, DEFAULT_AUTONOMY_MODE, DEFAULT_AUTONOMY_LIFECYCLE_PHASE, INTENT_PHASES, INTENT_SCOPE_KINDS, PRIMARY_INTENTS, REQUIRED_GATES, isAutonomyMode, isAutonomyLifecyclePhase, isAutonomyDecisionKind, isCapability, isCapabilityDeny, isCapabilityGrant, isIntentPhase, isIntentScopeKind, isPrimaryIntent, isRequiredGate, normalizeAutonomyMode, coerceAutonomyModeAlias, normalizeAutonomyLifecyclePhase, } from './Autonomy.js';
+//# sourceMappingURL=Session.d.ts.map

package/dist/contracts/types/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../../src/contracts/types/Session.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gCAAgC,EAChC,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,eAAe,CAAC"}

package/dist/contracts/types/Session.js

@@ -0,0 +1,2 @@
+export { AUTONOMY_MODES, AUTONOMY_DECISION_KINDS, AUTONOMY_LIFECYCLE_PHASES, AUTONOMY_MODE_ALIASES, CAPABILITIES, CAPABILITY_DENIES, CAPABILITY_GRANTS, DEFAULT_AUTONOMY_MODE, DEFAULT_AUTONOMY_LIFECYCLE_PHASE, INTENT_PHASES, INTENT_SCOPE_KINDS, PRIMARY_INTENTS, REQUIRED_GATES, isAutonomyMode, isAutonomyLifecyclePhase, isAutonomyDecisionKind, isCapability, isCapabilityDeny, isCapabilityGrant, isIntentPhase, isIntentScopeKind, isPrimaryIntent, isRequiredGate, normalizeAutonomyMode, coerceAutonomyModeAlias, normalizeAutonomyLifecyclePhase, } from './Autonomy.js';
+//# sourceMappingURL=Session.js.map

package/dist/contracts/types/Session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.js","sourceRoot":"","sources":["../../../src/contracts/types/Session.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gCAAgC,EAChC,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,eAAe,CAAC"}

package/dist/contracts/types/Status.d.ts

@@ -0,0 +1,12 @@
+export type ToolCallStatus = 'streaming_input' | 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+export type AgentRunStatus = 'spawning' | 'starting' | 'running' | 'completed' | 'failed' | 'interrupted' | 'stopped' | 'crashed' | 'recovering' | 'idle' | 'unknown';
+export declare const AGENT_RUN_STATUSES: readonly AgentRunStatus[];
+export declare function isAgentRunStatus(status: string): status is AgentRunStatus;
+export type SessionPhase = 'idle' | 'preparing' | 'model_requesting' | 'streaming' | 'thinking' | 'tool_executing' | 'observing' | 'waiting_for_permission' | 'waiting_for_user' | 'retrying' | 'compacting' | 'cancelling' | 'done' | 'error' | 'interrupted';
+export type TaskStatus = 'pending' | 'queued' | 'dispatchable' | 'in_progress' | 'running' | 'completed' | 'failed' | 'blocked' | 'cancelled' | 'terminal';
+export type WorkflowState = 'idle' | 'planning' | 'running' | 'blocked' | 'completed' | 'failed' | 'cancelled' | 'repairing' | 'evaluating' | 'waiting_for_dependency' | 'waiting_for_user' | 'working';
+export declare function isTerminalToolCallStatus(status: ToolCallStatus): boolean;
+export declare function isTerminalAgentStatus(status: AgentRunStatus): boolean;
+export declare function isTerminalTaskStatus(status: TaskStatus): boolean;
+export declare function isActiveSessionPhase(status: SessionPhase): boolean;
+//# sourceMappingURL=Status.d.ts.map

package/dist/contracts/types/Status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Status.d.ts","sourceRoot":"","sources":["../../../src/contracts/types/Status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,GACR,aAAa,GACb,SAAS,GACT,SAAS,GACT,YAAY,GACZ,MAAM,GACN,SAAS,CAAC;AAEd,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAY9C,CAAC;AAIX,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,cAAc,CAEzE;AAED,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,wBAAwB,GACxB,kBAAkB,GAClB,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,MAAM,GACN,OAAO,GACP,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,QAAQ,GACR,cAAc,GACd,aAAa,GACb,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,WAAW,GACX,YAAY,GACZ,wBAAwB,GACxB,kBAAkB,GAClB,SAAS,CAAC;AAEd,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAExE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAElE"}

package/dist/contracts/types/Status.js

@@ -0,0 +1,30 @@
+export const AGENT_RUN_STATUSES = [
+    'spawning',
+    'starting',
+    'running',
+    'completed',
+    'failed',
+    'interrupted',
+    'stopped',
+    'crashed',
+    'recovering',
+    'idle',
+    'unknown',
+];
+const AGENT_RUN_STATUS_SET = new Set(AGENT_RUN_STATUSES);
+export function isAgentRunStatus(status) {
+    return AGENT_RUN_STATUS_SET.has(status);
+}
+export function isTerminalToolCallStatus(status) {
+    return status === 'completed' || status === 'failed' || status === 'cancelled';
+}
+export function isTerminalAgentStatus(status) {
+    return status === 'completed' || status === 'failed' || status === 'interrupted' || status === 'stopped' || status === 'crashed';
+}
+export function isTerminalTaskStatus(status) {
+    return status === 'completed' || status === 'failed' || status === 'cancelled' || status === 'terminal';
+}
+export function isActiveSessionPhase(status) {
+    return status !== 'idle' && status !== 'done' && status !== 'error' && status !== 'interrupted';
+}
+//# sourceMappingURL=Status.js.map

package/dist/contracts/types/Status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Status.js","sourceRoot":"","sources":["../../../src/contracts/types/Status.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC3D,UAAU;IACV,UAAU;IACV,SAAS;IACT,WAAW;IACX,QAAQ;IACR,aAAa;IACb,SAAS;IACT,SAAS;IACT,YAAY;IACZ,MAAM;IACN,SAAS;CACD,CAAC;AAEX,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAE9E,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AA6CD,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC;AACnI,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,UAAU,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,OAAO,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,aAAa,CAAC;AAClG,CAAC"}

package/dist/contracts/types/TokenUsage.d.ts

@@ -0,0 +1,46 @@
+/** Canonical token usage aligned with provider API response fields. */
+export interface TokenUsage {
+    /** Gross input tokens: normal input plus cache read/hit and cache creation/write. */
+    prompt_tokens: number;
+    /** Output tokens. Reasoning/thinking tokens are a subset and must not be added again. */
+    completion_tokens: number;
+    /** Canonical total, normally prompt_tokens + completion_tokens. */
+    total_tokens: number;
+    /** Cached input tokens written/created in provider cache. */
+    cache_creation_input_tokens?: number;
+    /** Cached input tokens read from provider cache / prompt cache hit. */
+    cache_read_input_tokens?: number;
+    /** Reasoning/thinking output tokens, if reported separately by the provider. */
+    reasoning_tokens?: number;
+    /** Provider-specific credit/charge diagnostic, not included in token totals. */
+    credit?: number;
+}
+/** Persistence row shape for token usage records. */
+export interface TokenUsageRecord extends TokenUsage {
+    id?: number;
+    session_id: string;
+    agent_id: string;
+    agent_name: string;
+    timestamp: number;
+}
+/** UI projection derived from TokenUsage. This shape should not be persisted. */
+export interface TokenUsageView {
+    prompt: number;
+    completion: number;
+    total: number;
+    cache_read?: number;
+    cache_creation?: number;
+    reasoning?: number;
+    credit?: number;
+}
+/** Eternal runtime UI projection kept separate from persisted token usage. */
+export interface EternalTokenSnapshot {
+    promptTokens: number;
+    completionTokens: number;
+    timestamp: number;
+}
+export declare const EMPTY_TOKEN_USAGE: TokenUsage;
+export declare function toView(usage: TokenUsage): TokenUsageView;
+export declare function fromView(view: TokenUsageView): TokenUsage;
+export declare function merge(base: TokenUsage, patch: Partial<TokenUsage>): TokenUsage;
+//# sourceMappingURL=TokenUsage.d.ts.map

package/dist/contracts/types/TokenUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenUsage.d.ts","sourceRoot":"","sources":["../../../src/contracts/types/TokenUsage.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,EAAE,UAI9B,CAAC;AAEH,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAUxD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAUzD;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAY9E"}

package/dist/contracts/types/TokenUsage.js

@@ -0,0 +1,41 @@
+export const EMPTY_TOKEN_USAGE = Object.freeze({
+    prompt_tokens: 0,
+    completion_tokens: 0,
+    total_tokens: 0,
+});
+export function toView(usage) {
+    return {
+        prompt: usage.prompt_tokens,
+        completion: usage.completion_tokens,
+        total: usage.total_tokens,
+        ...(usage.cache_read_input_tokens !== undefined ? { cache_read: usage.cache_read_input_tokens } : {}),
+        ...(usage.cache_creation_input_tokens !== undefined ? { cache_creation: usage.cache_creation_input_tokens } : {}),
+        ...(usage.reasoning_tokens !== undefined ? { reasoning: usage.reasoning_tokens } : {}),
+        ...(usage.credit !== undefined ? { credit: usage.credit } : {}),
+    };
+}
+export function fromView(view) {
+    return {
+        prompt_tokens: view.prompt,
+        completion_tokens: view.completion,
+        total_tokens: view.total,
+        ...(view.cache_read !== undefined ? { cache_read_input_tokens: view.cache_read } : {}),
+        ...(view.cache_creation !== undefined ? { cache_creation_input_tokens: view.cache_creation } : {}),
+        ...(view.reasoning !== undefined ? { reasoning_tokens: view.reasoning } : {}),
+        ...(view.credit !== undefined ? { credit: view.credit } : {}),
+    };
+}
+export function merge(base, patch) {
+    const prompt = patch.prompt_tokens ?? base.prompt_tokens;
+    const completion = patch.completion_tokens ?? base.completion_tokens;
+    return {
+        prompt_tokens: prompt,
+        completion_tokens: completion,
+        total_tokens: patch.total_tokens ?? prompt + completion,
+        cache_creation_input_tokens: patch.cache_creation_input_tokens ?? base.cache_creation_input_tokens,
+        cache_read_input_tokens: patch.cache_read_input_tokens ?? base.cache_read_input_tokens,
+        reasoning_tokens: patch.reasoning_tokens ?? base.reasoning_tokens,
+        credit: patch.credit ?? base.credit,
+    };
+}
+//# sourceMappingURL=TokenUsage.js.map

package/dist/contracts/types/TokenUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenUsage.js","sourceRoot":"","sources":["../../../src/contracts/types/TokenUsage.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,MAAM,iBAAiB,GAAe,MAAM,CAAC,MAAM,CAAC;IACzD,aAAa,EAAE,CAAC;IAChB,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,UAAU,MAAM,CAAC,KAAiB;IACtC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,aAAa;QAC3B,UAAU,EAAE,KAAK,CAAC,iBAAiB;QACnC,KAAK,EAAE,KAAK,CAAC,YAAY;QACzB,GAAG,CAAC,KAAK,CAAC,uBAAuB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrG,GAAG,CAAC,KAAK,CAAC,2BAA2B,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,GAAG,CAAC,KAAK,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAoB;IAC3C,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,MAAM;QAC1B,iBAAiB,EAAE,IAAI,CAAC,UAAU;QAClC,YAAY,EAAE,IAAI,CAAC,KAAK;QACxB,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,2BAA2B,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAgB,EAAE,KAA0B;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC;IACzD,MAAM,UAAU,GAAG,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,iBAAiB,CAAC;IACrE,OAAO;QACL,aAAa,EAAE,MAAM;QACrB,iBAAiB,EAAE,UAAU;QAC7B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,MAAM,GAAG,UAAU;QACvD,2BAA2B,EAAE,KAAK,CAAC,2BAA2B,IAAI,IAAI,CAAC,2BAA2B;QAClG,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAI,IAAI,CAAC,uBAAuB;QACtF,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB;QACjE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;KACpC,CAAC;AACJ,CAAC"}