@ironflow/node 0.20.0 → 0.20.2

package/dist/agent/tool.js

@@ -1,103 +0,0 @@
-/**
- * tool() — durable, validated, idempotent tool invocation.
- *
- * Wraps step.run with:
- *   - Required Zod input validation (per CEO plan, JS-only)
- *   - Idempotency strategy: "byCall" (default) or "byArgs"
- *   - Per-tool timeout (default 60s)
- *
- * defineTool() is a pass-through factory that preserves the input/output
- * generic types for callers. The runtime call helper is constructed by
- * makeTool() and bound onto AgentContext.tool.
- */
-import { createHash } from "node:crypto";
-import { ToolNotFoundError, ToolValidationError } from "./errors.js";
-import { normalizeDuration } from "./internal.js";
-/** Default per-tool timeout when the definition does not specify one. */
-const DEFAULT_TOOL_TIMEOUT = "60s";
-/**
- * Define a tool. Pass-through factory that preserves the input/output
- * generic types. Tools are typically registered via AgentConfig.tools so
- * the agent can dispatch LLM-requested calls by name.
- */
-export function defineTool(spec) {
-    return spec;
-}
-/**
- * Build a ToolFn closure bound to the given step client and tool registry.
- *
- * Exported for use by agent.ts; not part of the public API surface.
- */
-export function makeTool(step, registry, runtime) {
-    const tool = (async (defOrName, args) => {
-        const def = resolveDefinition(defOrName, registry);
-        return invokeTool(step, def, args, runtime);
-    });
-    return tool;
-}
-function resolveDefinition(defOrName, registry) {
-    if (typeof defOrName === "string") {
-        const found = registry.get(defOrName);
-        if (!found) {
-            throw new ToolNotFoundError(defOrName);
-        }
-        return found;
-    }
-    return defOrName;
-}
-async function invokeTool(step, def, args, runtime) {
-    const validated = validateInput(def, args);
-    const timeout = normalizeDuration(def.timeout) ?? DEFAULT_TOOL_TIMEOUT;
-    const idempotent = def.idempotent ?? "byCall";
-    if (idempotent === "byArgs") {
-        const hash = hashArgs(validated);
-        const cacheKey = `${def.name}:${hash}`;
-        const cached = runtime.byArgsCache.get(cacheKey);
-        if (cached) {
-            return cached;
-        }
-        const promise = step.run(`tool.${def.name}.${hash}`, () => def.handler(validated), { timeout });
-        runtime.byArgsCache.set(cacheKey, promise);
-        return promise;
-    }
-    return step.run(`tool.${def.name}`, () => def.handler(validated), { timeout });
-}
-function validateInput(def, args) {
-    const result = def.input.safeParse(args);
-    if (!result.success) {
-        throw new ToolValidationError(def.name, result.error.issues);
-    }
-    return result.data;
-}
-function hashArgs(args) {
-    const serialized = stableStringify(args);
-    return createHash("sha256").update(serialized).digest("hex").slice(0, 16);
-}
-/**
- * Stable-key JSON stringify so { a: 1, b: 2 } and { b: 2, a: 1 } hash to
- * the same value. Required for byArgs idempotency to behave intuitively
- * across calls that build args from object spreads in different orders.
- *
- * Objects exposing toJSON() (Date, custom serializers) defer to the host
- * JSON.stringify so different Dates do not collapse to the same hash.
- */
-function stableStringify(value) {
-    if (value === null || typeof value !== "object") {
-        return JSON.stringify(value);
-    }
-    if (typeof value.toJSON === "function") {
-        return JSON.stringify(value);
-    }
-    if (Array.isArray(value)) {
-        return `[${value.map(stableStringify).join(",")}]`;
-    }
-    const entries = Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
-    return `{${entries
-        .map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`)
-        .join(",")}}`;
-}
-/** Construct an empty ToolRuntime. Used by agent() per run. */
-export function createToolRuntime() {
-    return { byArgsCache: new Map() };
-}
-//# sourceMappingURL=tool.js.map

package/dist/agent/tool.js.map

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

package/dist/agent/types.d.ts

@@ -1,363 +0,0 @@
-/**
- * Agent module type definitions.
- *
- * AgentContext extends the standard FunctionContext with agent-shaped
- * primitives (tool, llm, approve, memory, spawn). Wrappers compose
- * on top of the existing step client — no new server primitives.
- */
-import type { Duration, FunctionConfig, FunctionContext, IronflowEvent, IronflowFunction, Logger, RunInfo, SecretsClient, StepClient } from "@ironflow/core";
-import type { z } from "zod";
-/**
- * Idempotency strategy for tool() calls.
- *
- * - "byCall": each tool() invocation memoizes by call-site (default).
- *   Matches existing step.run semantics — same call, same memoized result.
- * - "byArgs": memoize by SHA-256 hash of input args. Subsequent calls with
- *   the same input return the cached result, even from different call sites.
- */
-export type ToolIdempotency = "byCall" | "byArgs";
-/**
- * A tool definition produced by defineTool().
- *
- * Tools are registered on AgentConfig.tools so the agent can dispatch
- * LLM-requested tool calls by name. Definitions are also callable
- * directly via ctx.tool(def, args) for type-safe invocation.
- */
-export interface ToolDefinition<TInput = unknown, TOutput = unknown> {
-    /** Unique tool name (used for LLM dispatch). */
-    readonly name: string;
-    /** Optional human-readable description (surfaced to LLMs and MCP). */
-    readonly description?: string;
-    /** Required Zod schema for input validation. */
-    readonly input: z.ZodType<TInput>;
-    /** Idempotency strategy. Default: "byCall". */
-    readonly idempotent?: ToolIdempotency;
-    /** Per-tool timeout. Default: 60s. */
-    readonly timeout?: Duration;
-    /** Tool implementation. */
-    readonly handler: (input: TInput) => Promise<TOutput>;
-}
-/**
- * Erased generic alias for arrays/registries holding tools of mixed
- * narrow input/output types. Use in container positions (e.g.
- * AgentConfig.tools) where TS array invariance otherwise rejects narrow
- * subtypes.
- */
-export type AnyToolDefinition = ToolDefinition<any, any>;
-/**
- * The tool helper available on AgentContext.
- *
- * Has two call shapes:
- *   - by reference: tool(def, args) — type-safe, returns def's output type
- *   - by name:      tool(name, args) — for LLM-driven dispatch, returns unknown
- *
- * Both wrap step.run with Zod validation, idempotency keying, and timeout
- * enforcement. The by-name form requires the tool to be registered via
- * AgentConfig.tools.
- */
-export interface ToolFn {
-    <TInput, TOutput>(def: ToolDefinition<TInput, TOutput>, args: TInput): Promise<TOutput>;
-    (name: string, args: unknown): Promise<unknown>;
-}
-/**
- * Provider-agnostic completion request.
- *
- * The llm() wrapper is sugar — it does not own a provider router. Callers
- * pass a provider call (closure) that does the actual API call. The wrapper
- * memoizes the result and classifies known failure modes.
- */
-export interface LLMCompleteRequest {
-    /** Conversation messages. Provider-shape-agnostic. */
-    messages: ReadonlyArray<{
-        role: string;
-        content: unknown;
-    }>;
-    /** Optional tool definitions for function-calling providers. */
-    tools?: ReadonlyArray<{
-        name: string;
-        description?: string;
-        input?: unknown;
-    }>;
-    /**
-     * Provider call closure. Must return a normalized LLMCompleteResult.
-     *
-     * The wrapper memoizes the closure's resolved value as a step. The
-     * closure is responsible for the actual provider call and for mapping
-     * provider-specific shapes onto LLMCompleteResult.
-     */
-    call: () => Promise<LLMCompleteResult>;
-    /** Optional provider-passthrough metadata (model, temperature, …). */
-    options?: Record<string, unknown>;
-}
-/**
- * Result of an llm() call.
- *
- * Shape is provider-agnostic. Callers narrow as needed.
- */
-export interface LLMCompleteResult {
-    /** Raw assistant message content. */
-    content?: unknown;
-    /** Tool calls requested by the model, if any. */
-    toolCalls?: ReadonlyArray<{
-        name: string;
-        input: unknown;
-    }>;
-    /**
-     * Optional finish reason hint. When set, the wrapper inspects it to
-     * raise classified errors:
-     *   - "refusal" → LLMRefusalError
-     *   - "max_tokens" / "length" → LLMMaxTokensError
-     * Anything else passes through.
-     */
-    finishReason?: string;
-    /** Provider-passthrough metadata (usage, raw, …). */
-    metadata?: Record<string, unknown>;
-}
-/**
- * The llm client surface exposed to handlers.
- */
-export interface LLMClient {
-    /** Run a memoized completion. Increments the agent turn counter. */
-    complete(request: LLMCompleteRequest): Promise<LLMCompleteResult>;
-}
-/**
- * Options for approve().
- */
-export interface ApproveOptions<TPayload = unknown> {
-    /** Time to wait for the approval event before timing out. */
-    ttl: Duration;
-    /** Payload to attach to the pending approval (visible to approvers). */
-    payload?: TPayload;
-}
-/**
- * Result of approve().
- *
- * approved=false on timeout. The handler can distinguish timeout vs
- * explicit rejection by inspecting the reason field.
- */
-export interface ApproveResult<TPayload = unknown> {
-    /** Whether the request was approved. */
-    approved: boolean;
-    /** User who approved/rejected, if recorded by the approver. */
-    approver?: string;
-    /** Payload echoed back from the approval event. */
-    payload?: TPayload;
-    /** Optional reason supplied by the approver, or "timeout". */
-    reason?: string;
-}
-/**
- * Approval helper.
- */
-export type ApproveFn = <TPayload = unknown, TResult = unknown>(name: string, options: ApproveOptions<TPayload>) => Promise<ApproveResult<TResult>>;
-/**
- * Options for memory.get().
- */
-export interface MemoryGetOptions {
-    /**
-     * Disable the in-run cache for this read. Default: false (cache on).
-     *
-     * Cache invalidates on own writes within the same run.
-     */
-    bypassCache?: boolean;
-}
-/**
- * Options for memory.append().
- */
-export interface MemoryAppendOptions {
-    /** Optional metadata attached to the appended event. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Memory client.
- *
- * Wraps an entity stream keyed by the agent run. memory.entityStream()
- * requires a projection — raw replay is not exposed.
- */
-export interface MemoryClient {
-    /**
-     * Read the projected memory state.
-     *
-     * Returns undefined if the projection has no record for this run.
-     */
-    get<T = unknown>(options?: MemoryGetOptions): Promise<T | undefined>;
-    /** Append a memory event (durable). */
-    append<T = unknown>(eventName: string, data: T, options?: MemoryAppendOptions): Promise<void>;
-    /**
-     * Open a projection-backed entity stream view.
-     *
-     * Throws MemoryProjectionRequiredError if no projection name is supplied.
-     */
-    entityStream<T = unknown>(streamId: string, projectionName: string): Promise<T | undefined>;
-}
-/**
- * Configuration for the memory client.
- *
- * Memory is opt-in per agent: callers wire a streamId + projection name
- * via AgentConfig.memory.
- */
-export interface MemoryConfig {
-    /** Entity stream ID for this agent's memory. */
-    streamId: string;
-    /** Projection name used by memory.get(). */
-    projection: string;
-    /**
-     * Entity type recorded with appended events. Informational on the
-     * server side; surfaces in audit/admin views. Defaults to "agent".
-     */
-    entityType?: string;
-}
-/**
- * Options for spawn().
- */
-export interface SpawnOptions<TInput = unknown> {
-    /** Function ID to invoke as a sub-agent. */
-    functionId: string;
-    /** Input event payload for the sub-agent. */
-    input: TInput;
-    /** Whether to wait for completion. Default: true. */
-    await?: boolean;
-}
-/**
- * Result of a spawn() call.
- *
- * Field availability depends on the await mode:
- *   - await=true (default): output is the resolved sub-agent value;
- *     runId is omitted because step.invoke does not return the run ID.
- *   - await=false: runId is present (from step.invokeAsync); output is
- *     omitted because the caller did not wait for completion.
- */
-export interface SpawnResult<TOutput = unknown> {
-    /** Sub-run ID (for log/audit correlation). Present when await=false. */
-    runId?: string;
-    /** Sub-agent output. Present when await=true. */
-    output?: TOutput;
-}
-/**
- * Spawn helper.
- */
-export type SpawnFn = <TInput = unknown, TOutput = unknown>(name: string, options: SpawnOptions<TInput>) => Promise<SpawnResult<TOutput>>;
-/**
- * Definition of a single MCP-exposed tool.
- *
- * Note: client-side scope hints are advisory. Authoritative authorization
- * is enforced server-side via api_keys + tool_scopes. See the agent-runtime
- * licensing docs for the auth model.
- */
-export interface McpToolDef<TInput = unknown, TOutput = unknown> {
-    /** Tool name as exposed via MCP. */
-    name: string;
-    /** Human-readable description for MCP clients. */
-    description: string;
-    /** Zod input schema. */
-    input: z.ZodType<TInput>;
-    /** Optional Zod output schema (recommended). */
-    output?: z.ZodType<TOutput>;
-    /** Required scope strings for server-side RBAC. Hint to clients only. */
-    scopes?: ReadonlyArray<string>;
-    /** Tool implementation. */
-    handler: (input: TInput) => Promise<TOutput>;
-}
-/**
- * Erased generic alias for arrays/registries holding MCP tools of mixed
- * narrow input/output types. Use in container positions where TS array
- * invariance otherwise rejects narrow McpToolDef subtypes (issue #634).
- */
-export type AnyMcpToolDef = McpToolDef<any, any>;
-/**
- * Configuration for exposeMcp().
- *
- * `name` doubles as the agent namespace surfaced to MCP clients
- * (qualified tool name = `${name}.${tool.name}`). The Ironflow server
- * uses it as the registry key — calling exposeMcp() twice with the
- * same name from the same API key rotates the HMAC secret.
- */
-export interface ExposeMcpConfig {
-    /** Agent namespace + server name reported via MCP initialize. */
-    name: string;
-    /** Server version. */
-    version: string;
-    /** Tool registry. */
-    tools: ReadonlyArray<AnyMcpToolDef>;
-    /**
-     * Public URL the Ironflow server will POST signed dispatch requests to.
-     * Must point at the same `serve()` mount that hosts your push functions —
-     * the mount appends `/ironflow/agent-tools/dispatch` and verifies HMAC.
-     *
-     * Required. No env fallback: the public URL is deployment-specific and
-     * cannot be inferred at runtime.
-     */
-    callbackUrl: string;
-    /**
-     * Ironflow control-plane URL. Defaults to `IRONFLOW_URL` then
-     * `IRONFLOW_SERVER_URL` env vars.
-     */
-    serverUrl?: string;
-    /**
-     * API key used to call AgentToolsService/RegisterTool. The key must
-     * hold the `agent:tools:register` action. Defaults to
-     * `IRONFLOW_API_KEY` env var.
-     */
-    apiKey?: string;
-}
-/**
- * Configuration for an agent.
- *
- * Extends FunctionConfig with:
- *   - tools: ToolDefinition[] — registry for ctx.tool(name, args) dispatch
- *   - memory: MemoryConfig — opt-in durable memory
- *   - maxTurns: number — turn budget (default 20)
- */
-export interface AgentConfig<TEventSchema extends z.ZodType = z.ZodType> extends FunctionConfig<TEventSchema> {
-    /** Tool definitions available for LLM-driven dispatch. */
-    tools?: ReadonlyArray<AnyToolDefinition>;
-    /** Durable memory configuration. */
-    memory?: MemoryConfig;
-    /**
-     * Maximum number of agent turns (llm() calls) before
-     * MaxTurnsExceededError is raised. Default: 20.
-     */
-    maxTurns?: number;
-}
-/**
- * Context passed to agent handlers.
- *
- * Extends FunctionContext with tool/llm/approve/memory/spawn helpers.
- * All helpers compose over the underlying StepClient — they record
- * durable steps under the hood.
- */
-export interface AgentContext<TEvent = unknown> extends FunctionContext<TEvent> {
-    /** Standard fields from FunctionContext (re-asserted for IDE clarity). */
-    readonly event: IronflowEvent<TEvent>;
-    readonly step: StepClient;
-    readonly run: RunInfo;
-    readonly logger: Logger;
-    readonly secrets: SecretsClient;
-    /** Run a tool. Wraps step.run with Zod validation, idempotency, timeout. */
-    readonly tool: ToolFn;
-    /** Run an LLM call. Memoized step with classified error surface. */
-    readonly llm: LLMClient;
-    /** Wait for a human approval event. */
-    readonly approve: ApproveFn;
-    /** Read/write durable agent memory. */
-    readonly memory: MemoryClient;
-    /** Spawn a sub-agent. */
-    readonly spawn: SpawnFn;
-    /**
-     * Number of llm() turns consumed so far in this run (read-only).
-     *
-     * Incremented before each llm() call. Comparison against
-     * config.maxTurns drives MaxTurnsExceededError.
-     */
-    readonly turn: number;
-}
-/**
- * Agent handler signature.
- */
-export type AgentHandler<TEvent = unknown, TResult = unknown> = (ctx: AgentContext<TEvent>) => Promise<TResult>;
-/**
- * An agent is a specialized IronflowFunction whose handler accepts an
- * AgentContext. It registers like any other function — `serve()` and
- * `createWorker()` need no agent-specific awareness.
- */
-export type IronflowAgent<TEvent = unknown, TResult = unknown> = IronflowFunction<TEvent, TResult>;
-//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,aAAa,EACb,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,sCAAsC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACrB,CAAC,MAAM,EAAE,OAAO,EACd,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5D,gEAAgE;IAChE,KAAK,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/E;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnE;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,OAAO;IAChD,6DAA6D;IAC7D,GAAG,EAAE,QAAQ,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO;IAC/C,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC5D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,KAC9B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAMrC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAErE,uCAAuC;IACvC,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F;;;;OAIG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC7F;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,OAAO;IAC5C,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACxD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,KAC1B,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAMnC;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC7D,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,yEAAyE;IACzE,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,2BAA2B;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACpC;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,YAAY,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CACrE,SAAQ,cAAc,CAAC,YAAY,CAAC;IACpC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACzC,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,CAAE,SAAQ,eAAe,CAAC,MAAM,CAAC;IAC7E,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IAExB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAE5B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC9D,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,KACtB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/agent/types.js

@@ -1,9 +0,0 @@
-/**
- * Agent module type definitions.
- *
- * AgentContext extends the standard FunctionContext with agent-shaped
- * primitives (tool, llm, approve, memory, spawn). Wrappers compose
- * on top of the existing step client — no new server primitives.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}