@contractspec/lib.ai-agent 1.56.1 → 1.58.0

package/dist/types.d.ts

@@ -1,146 +1,142 @@
-import { LanguageModelUsage, ModelMessage, StepResult, ToolSet } from "ai";
-
-//#region src/types.d.ts
-
+import type { LanguageModelUsage, ModelMessage, StepResult, ToolSet } from 'ai';
+export type { LanguageModelUsage };
 /**
  * Simplified tool call type for ContractSpec usage.
  * Compatible with AI SDK v6 TypedToolCall.
  */
-interface ToolCallInfo {
-  type: 'tool-call';
-  toolCallId: string;
-  toolName: string;
-  args: unknown;
+export interface ToolCallInfo {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
 }
 /**
  * Simplified tool result type for ContractSpec usage.
  * Compatible with AI SDK v6 TypedToolResult.
  */
-interface ToolResultInfo {
-  type: 'tool-result';
-  toolCallId: string;
-  toolName: string;
-  output: unknown;
+export interface ToolResultInfo {
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
 }
 /**
  * Extended message type that adds metadata support to ModelMessage.
  * Used for session memory tracking.
  */
-interface AgentMessage {
-  role: 'user' | 'assistant' | 'system' | 'tool';
-  content: string | {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-  }[];
-  metadata?: Record<string, string>;
+export interface AgentMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string | {
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }[];
+    metadata?: Record<string, string>;
 }
-type AgentStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed' | 'escalated';
-type AgentEventName = 'agent.session.created' | 'agent.session.updated' | 'agent.step.started' | 'agent.step.completed' | 'agent.tool.called' | 'agent.tool.completed' | 'agent.tool.failed' | 'agent.tool.approval_requested' | 'agent.escalated' | 'agent.completed' | 'agent.failed';
-type AgentFinishReason = 'stop' | 'tool-calls' | 'length' | 'content-filter' | 'error' | 'other' | 'unknown';
-interface AgentEventPayload {
-  sessionId: string;
-  agentId: string;
-  tenantId?: string;
-  stepIndex?: number;
-  toolName?: string;
-  metadata?: Record<string, unknown>;
+export type AgentStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed' | 'escalated';
+export type AgentEventName = 'agent.session.created' | 'agent.session.updated' | 'agent.step.started' | 'agent.step.completed' | 'agent.tool.called' | 'agent.tool.completed' | 'agent.tool.failed' | 'agent.tool.approval_requested' | 'agent.escalated' | 'agent.completed' | 'agent.failed';
+export type AgentFinishReason = 'stop' | 'tool-calls' | 'length' | 'content-filter' | 'error' | 'other' | 'unknown';
+export interface AgentEventPayload {
+    sessionId: string;
+    agentId: string;
+    tenantId?: string;
+    stepIndex?: number;
+    toolName?: string;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Runtime context passed to agent calls via AI SDK v6 callOptionsSchema.
  * Maps to ContractSpec's tenant/actor system.
  */
-interface AgentCallOptions {
-  /** Tenant scoping for guardrails and data isolation */
-  tenantId?: string;
-  /** Unique end-user identifier (for personalization) */
-  actorId?: string;
-  /** Session to resume; new session created when omitted */
-  sessionId?: string;
-  /** Arbitrary metadata forwarded to events and tool handlers */
-  metadata?: Record<string, string>;
+export interface AgentCallOptions {
+    /** Tenant scoping for guardrails and data isolation */
+    tenantId?: string;
+    /** Unique end-user identifier (for personalization) */
+    actorId?: string;
+    /** Session to resume; new session created when omitted */
+    sessionId?: string;
+    /** Arbitrary metadata forwarded to events and tool handlers */
+    metadata?: Record<string, string>;
 }
-interface AgentSessionState {
-  sessionId: string;
-  agentId: string;
-  tenantId?: string;
-  actorId?: string;
-  status: AgentStatus;
-  messages: ModelMessage[];
-  steps: StepResult<ToolSet>[];
-  createdAt: Date;
-  updatedAt: Date;
-  metadata?: Record<string, string>;
+export interface AgentSessionState {
+    sessionId: string;
+    agentId: string;
+    tenantId?: string;
+    actorId?: string;
+    status: AgentStatus;
+    messages: ModelMessage[];
+    steps: StepResult<ToolSet>[];
+    createdAt: Date;
+    updatedAt: Date;
+    metadata?: Record<string, string>;
 }
-interface AgentGenerateParams {
-  /** User prompt or message */
-  prompt: string;
-  /** System prompt override (appended to agent instructions) */
-  systemOverride?: string;
-  /** Runtime context options */
-  options?: AgentCallOptions;
-  /** Maximum number of steps/iterations */
-  maxSteps?: number;
-  /** Abort signal for cancellation */
-  signal?: AbortSignal;
+export interface AgentGenerateParams {
+    /** User prompt or message */
+    prompt: string;
+    /** System prompt override (appended to agent instructions) */
+    systemOverride?: string;
+    /** Runtime context options */
+    options?: AgentCallOptions;
+    /** Maximum number of steps/iterations */
+    maxSteps?: number;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
 }
-interface AgentStreamParams extends AgentGenerateParams {
-  /** Called when a step completes */
-  onStepFinish?: (step: StepResult<ToolSet>) => void | Promise<void>;
+export interface AgentStreamParams extends AgentGenerateParams {
+    /** Called when a step completes */
+    onStepFinish?: (step: StepResult<ToolSet>) => void | Promise<void>;
 }
-interface AgentGenerateResult<TOutput = string> {
-  /** The final text response */
-  text: string;
-  /** Structured output if configured */
-  output?: TOutput;
-  /** All steps taken during generation */
-  steps: StepResult<ToolSet>[];
-  /** All tool calls made during generation */
-  toolCalls: ToolCallInfo[];
-  /** All tool results */
-  toolResults: ToolResultInfo[];
-  /** Reason generation finished */
-  finishReason: AgentFinishReason;
-  /** Token usage statistics */
-  usage?: LanguageModelUsage;
-  /** Updated session state */
-  session?: AgentSessionState;
-  /** Whether approval is pending for a tool call */
-  pendingApproval?: {
-    toolName: string;
-    toolCallId: string;
-    args: unknown;
-  };
+export interface AgentGenerateResult<TOutput = string> {
+    /** The final text response */
+    text: string;
+    /** Structured output if configured */
+    output?: TOutput;
+    /** All steps taken during generation */
+    steps: StepResult<ToolSet>[];
+    /** All tool calls made during generation */
+    toolCalls: ToolCallInfo[];
+    /** All tool results */
+    toolResults: ToolResultInfo[];
+    /** Reason generation finished */
+    finishReason: AgentFinishReason;
+    /** Token usage statistics */
+    usage?: LanguageModelUsage;
+    /** Updated session state */
+    session?: AgentSessionState;
+    /** Whether approval is pending for a tool call */
+    pendingApproval?: {
+        toolName: string;
+        toolCallId: string;
+        args: unknown;
+    };
 }
 /**
  * Context provided to tool handlers during execution.
  */
-interface ToolExecutionContext {
-  agentId: string;
-  sessionId: string;
-  tenantId?: string;
-  actorId?: string;
-  metadata?: Record<string, string>;
-  signal?: AbortSignal;
+export interface ToolExecutionContext {
+    agentId: string;
+    sessionId: string;
+    tenantId?: string;
+    actorId?: string;
+    metadata?: Record<string, string>;
+    signal?: AbortSignal;
 }
 /**
  * Handler function for a tool.
  */
-type ToolHandler<TInput = unknown, TOutput = string> = (input: TInput, context: ToolExecutionContext) => Promise<TOutput>;
-interface AgentStepMetrics {
-  agentId: string;
-  stepIndex: number;
-  toolCalls: {
-    toolName: string;
-    durationMs?: number;
-    success: boolean;
-    error?: string;
-  }[];
-  finishReason: string;
-  usage?: LanguageModelUsage;
-  timestamp: Date;
+export type ToolHandler<TInput = unknown, TOutput = string> = (input: TInput, context: ToolExecutionContext) => Promise<TOutput>;
+export interface AgentStepMetrics {
+    agentId: string;
+    stepIndex: number;
+    toolCalls: {
+        toolName: string;
+        durationMs?: number;
+        success: boolean;
+        error?: string;
+    }[];
+    finishReason: string;
+    usage?: LanguageModelUsage;
+    timestamp: Date;
 }
-type AgentEventEmitter = (event: AgentEventName, payload: AgentEventPayload) => void | Promise<void>;
-//#endregion
-export { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, type LanguageModelUsage, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo };
+export type AgentEventEmitter = (event: AgentEventName, payload: AgentEventPayload) => void | Promise<void>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;AAWA;AAWA;AAeA;AAUY,UApCK,YAAA,CAoCM;EAQX,IAAA,EAAA,WAAc;EAad,UAAA,EAAA,MAAA;EASK,QAAA,EAAA,MAAA;EAiBA,IAAA,EAAA,OAAA;AAejB;;;;;AAQa,UA/FI,cAAA,CA+FJ;EACA,IAAA,EAAA,aAAA;EACA,UAAA,EAAA,MAAA;EAAM,QAAA,EAAA,MAAA;EAOF,MAAA,EAAA,OAAA;AAajB;;;;;AAA8D,UAtG7C,YAAA,CAsG6C;EAS7C,IAAA,EAAA,MAAA,GAAA,WAAmB,GAAA,QAAA,GAAA,MAAA;EAIzB,OAAA,EAAA,MAAA,GAAA;IAES,IAAA,EAAA,MAAA;IAAX,IAAA,CAAA,EAAA,MAAA;IAEI,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EAEE,CAAA,EAAA;EAEC,QAAA,CAAA,EAxHH,MAwHG,CAAA,MAAA,EAAA,MAAA,CAAA;;AAIJ,KArHA,WAAA,GAqHA,MAAA,GAAA,SAAA,GAAA,SAAA,GAAA,WAAA,GAAA,QAAA,GAAA,WAAA;AAAiB,KA7GjB,cAAA,GA6GiB,uBAAA,GAAA,uBAAA,GAAA,oBAAA,GAAA,sBAAA,GAAA,mBAAA,GAAA,sBAAA,GAAA,mBAAA,GAAA,+BAAA,GAAA,iBAAA,GAAA,iBAAA,GAAA,cAAA;AAgBZ,KAhHL,iBAAA,GAgHyB,MAAA,GAKxB,YACF,GAAA,QAAW,GAAA,gBAAA,GAAA,OAAA,GAAA,OAAA,GAAA,SAAA;AAMV,UAnHK,iBAAA,CAmHM;EACd,SAAA,EAAA,MAAA;EACE,OAAA,EAAA,MAAA;EACE,QAAA,CAAA,EAAA,MAAA;EAAR,SAAA,CAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EAAA,MAAA;EAMK,QAAA,CAAA,EAtHJ,MAsHI,CAAA,MAAgB,EAAA,OAUvB,CAAA;AAQV;;;;;UA7HiB,gBAAA;;;;;;;;aAQJ;;UAOI,iBAAA;;;;;UAKP;YACE;SACH,WAAW;aACP;aACA;aACA;;UAOI,mBAAA;;;;;;YAML;;;;WAID;;UAGM,iBAAA,SAA0B;;wBAEnB,WAAW,oBAAoB;;UAOtC;;;;WAIN;;SAEF,WAAW;;aAEP;;eAEE;;gBAEC;;UAEN;;YAEE;;;;;;;;;;;UAgBK,oBAAA;;;;;aAKJ;WACF;;;;;KAMC,0DACH,iBACE,yBACN,QAAQ;UAMI,gBAAA;;;;;;;;;;UAUP;aACG;;KAOD,iBAAA,WACH,yBACE,6BACC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+// @bun