@lssm/lib.ai-agent 0.0.0-canary-20251207012602 → 0.0.0-canary-20251207043720

package/dist/types.d.ts

@@ -1,194 +0,0 @@
-import { LanguageModelUsage, ModelMessage, StepResult, ToolSet } from "ai";
-
-//#region src/types.d.ts
-
-/**
- * Simplified tool call type for ContractSpec usage.
- * Compatible with AI SDK v6 TypedToolCall.
- */
-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;
-}
-/**
- * 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>;
-}
-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';
-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>;
-}
-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;
-}
-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: 'stop' | 'tool-calls' | 'length' | 'content-filter' | 'error' | 'other' | 'unknown';
-  /** 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;
-}
-/**
- * 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;
-}
-type AgentEventEmitter = (event: AgentEventName, payload: AgentEventPayload) => void | Promise<void>;
-/** @deprecated Use AgentGenerateParams instead */
-interface AgentRunRequestInput {
-  agent: string;
-  version?: number;
-  input: string;
-  tenantId?: string;
-  actorId?: string;
-  sessionId?: string;
-  metadata?: Record<string, string>;
-  instructionsOverride?: string;
-}
-/** @deprecated Use AgentGenerateResult instead */
-interface AgentRunResult {
-  session: AgentSessionState;
-  outputText: string;
-  confidence: number;
-  iterations: number;
-  requiresEscalation: boolean;
-  approvalRequestId?: string;
-  finishReason: string;
-  toolInvocations: AgentToolInvocation[];
-}
-/** @deprecated Use ToolCallInfo instead */
-interface AgentToolInvocation {
-  name: string;
-  arguments: unknown;
-  startedAt: Date;
-  completedAt?: Date;
-  durationMs?: number;
-  success: boolean;
-  error?: string;
-}
-/** @deprecated Use ToolExecutionContext instead */
-interface AgentToolContext {
-  session: AgentSessionState;
-  tenantId?: string;
-  actorId?: string;
-  metadata?: Record<string, string>;
-  emit: (event: AgentEventName, payload: AgentEventPayload) => void;
-}
-/** @deprecated Use ToolHandler instead */
-interface AgentToolResult {
-  content: string;
-  citations?: {
-    label: string;
-    url?: string;
-    snippet?: string;
-  }[];
-  metadata?: Record<string, string>;
-}
-//#endregion
-export { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentRunRequestInput, AgentRunResult, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, AgentToolContext, AgentToolInvocation, AgentToolResult, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo };