agentsdk-agent 0.1.0

package/src/types.ts

@@ -0,0 +1,101 @@
+/**
+ * AgentSDK Agent Runtime — Types
+ * MIT License — see LICENSE. Copyright (c) 2026 Shetan Mehra.
+ *
+ * An "agent" is a model + system prompt + tools + a step loop. Each step the
+ * model may emit text or tool calls; tool calls are executed and their results
+ * fed back, until the model stops calling tools or maxSteps is reached.
+ */
+
+import type {
+  Cost,
+  Message,
+  ResolvedTool,
+  ToolCall,
+  ToolResult,
+  Usage,
+} from 'agentsdk-core';
+
+export type MemoryStrategy = 'none' | 'full' | 'summary' | 'window';
+
+export interface AgentConfig {
+  /** Stable id for this agent within a graph. */
+  id: string;
+  /** Display name. */
+  name: string;
+  /** Provider id, defaults to "glm". */
+  provider?: string;
+  /** Model id, e.g. "glm-4.6". */
+  model: string;
+  /** System prompt. */
+  systemPrompt: string;
+  /** Tools available to the agent. */
+  tools?: ResolvedTool[];
+  /** Max number of LLM round-trips before the loop is forced to stop. */
+  maxSteps?: number;
+  /** Sampling temperature. */
+  temperature?: number;
+  /** Max tokens per step. */
+  maxTokens?: number;
+  /** Enable thinking/reasoning mode if the provider supports it. */
+  thinking?: boolean;
+  /** How conversation history is carried between steps. */
+  memoryStrategy?: MemoryStrategy;
+  /** For 'window' strategy: how many most-recent messages to keep. */
+  memoryWindow?: number;
+  /** Extra provider-specific options. */
+  providerOptions?: Record<string, unknown>;
+}
+
+export type StepKind = 'text' | 'tool_call' | 'tool_result' | 'error';
+
+export interface StepEvent {
+  /** 1-indexed step number. */
+  step: number;
+  kind: StepKind;
+  /** The assistant message produced at this step (if any). */
+  text?: string;
+  /** Tool calls requested by the model at this step (if any). */
+  toolCalls?: ToolCall[];
+  /** Tool results produced this step (if any). */
+  toolResults?: ToolResult[];
+  /** Error message, if kind === 'error'. */
+  error?: string;
+  /** Token usage for this step's LLM call. */
+  usage?: Usage;
+  /** Cost for this step's LLM call. */
+  cost?: Cost;
+  /** ISO timestamp. */
+  timestamp: string;
+}
+
+export interface AgentRunResult {
+  agentId: string;
+  /** Final text answer from the agent. */
+  text: string;
+  /** Full message history (post-run). */
+  messages: Message[];
+  /** Every step event, in order. */
+  steps: StepEvent[];
+  /** Aggregated token usage across all steps. */
+  usage: Usage;
+  /** Aggregated cost across all steps. */
+  cost: Cost;
+  /** Number of steps actually executed. */
+  stepsExecuted: number;
+  /** True if the loop hit maxSteps without a clean stop. */
+  truncated: boolean;
+}
+
+export type StepHook = (event: StepEvent) => void | Promise<void>;
+
+export interface AgentRunOptions {
+  /** The user/input message(s) to seed the run. */
+  messages: Message[];
+  /** Called after each step completes. */
+  onStepFinish?: StepHook;
+  /** Optional run id (auto-generated if omitted). */
+  runId?: string;
+  /** Override maxSteps for this run only. */
+  maxSteps?: number;
+}