@primo-ai/sdk 0.1.3 → 0.1.4

package/dist/index.d.ts

@@ -106,11 +106,11 @@ export interface IterationRegion {
     loopDirective?: LoopDirective;
     /** AI SDK fullStream yielding text-delta, tool-call, finish-step, error events. */
     fullStream?: AsyncIterable<unknown>;
-    usagePromise?: Promise<TokenUsage>;
+    usagePromise?: Promise<TokenUsage | null>;
     /** Promise resolving to reasoning text from the model (e.g. DeepSeek reasoning_content). */
     reasoningPromise?: Promise<string | undefined>;
     response?: string;
-    tokenUsage?: TokenUsage;
+    tokenUsage?: TokenUsage | null;
     /** Tool calls extracted from the LLM response by PipelineRunner stream consumption. */
     pendingToolCalls?: ToolCall[];
     /** Reasoning content from thinking-mode models (e.g. DeepSeek). Must be passed back on subsequent turns. */
@@ -156,7 +156,13 @@ export interface SuspensionSignal {
     checkpoint: PipelineCheckpoint;
     expiresAt?: string;
 }
-export type ProcessorResult = PipelineContext | AbortSignal | SuspensionSignal;
+export interface ErrorResult {
+    type: 'error';
+    error: Error;
+    stage: StageName;
+    recoverable?: boolean;
+}
+export type ProcessorResult = PipelineContext | AbortSignal | SuspensionSignal | ErrorResult;
 export interface Processor {
     stage: StageName;
     execute(context: PipelineContext): Promise<ProcessorResult>;
@@ -282,6 +288,34 @@ export type StreamEvent = {
     suspensionId: string;
     reason: string;
     checkpoint: PipelineCheckpoint;
+} | {
+    type: 'error';
+    error: Error;
+    stage: StageName;
+    recoverable?: boolean;
+};
+export type ServerStreamEvent = StreamEvent | {
+    type: 'session.started';
+    sessionId: string;
+} | {
+    type: 'session.completed';
+    sessionId: string;
+    tokenUsage: TokenUsage;
+} | {
+    type: 'session.aborted';
+    sessionId: string;
+} | {
+    type: 'permission.request';
+    sessionId: string;
+    permissionId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    reason: string;
+} | {
+    type: 'permission.resolved';
+    sessionId: string;
+    permissionId: string;
+    decision: 'allow' | 'deny';
 };
 export type EventType = 'agent:start' | 'agent:end' | 'tool:before' | 'tool:after' | string;
 export type HookPoint = 'agent.start' | 'agent.end' | 'stage.before' | 'stage.after' | 'llm.before' | 'llm.after' | 'tool.before' | 'tool.after' | 'iteration.end' | 'error';
@@ -483,7 +517,7 @@ export interface HarnessConfig {
         facts: string[] | ((ctx: PipelineContext) => string[] | Promise<string[]>);
     };
 }
-export type SessionStatus = 'active' | 'completed' | 'suspended' | 'error';
+export type SessionStatus = 'active' | 'completed' | 'suspended' | 'cancelled' | 'error';
 export interface SessionRecord {
     sessionId: string;
     parentSessionId?: string;
@@ -507,6 +541,12 @@ export interface SessionStorage {
         status?: SessionStatus;
     }): Promise<SessionRecord[]>;
     updateMeta(sessionId: string, meta: Partial<SessionRecord>): Promise<void>;
+    get(sessionId: string): Promise<SessionRecord | undefined>;
+    delete(sessionId: string): Promise<void>;
+    getMessages(sessionId: string, options?: {
+        limit?: number;
+        before?: string;
+    }): Promise<Message[]>;
 }
 export interface CheckpointStore<T = unknown> {
     save(sessionId: string, data: T): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primo-ai/sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",