@usestratus/sdk 0.12.0

package/dist/core/errors.d.ts

@@ -0,0 +1,48 @@
+export declare class StratusError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class MaxTurnsExceededError extends StratusError {
+    constructor(maxTurns: number);
+}
+export declare class ModelError extends StratusError {
+    readonly status?: number;
+    readonly code?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        cause?: unknown;
+    });
+}
+export declare class ContentFilterError extends ModelError {
+    constructor(message?: string, options?: {
+        status?: number;
+        cause?: unknown;
+    });
+}
+export declare class OutputParseError extends StratusError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class InputGuardrailTripwireTriggered extends StratusError {
+    readonly guardrailName: string;
+    readonly outputInfo?: unknown;
+    constructor(guardrailName: string, outputInfo?: unknown);
+}
+export declare class RunAbortedError extends StratusError {
+    constructor(message?: string);
+}
+export declare class MaxBudgetExceededError extends StratusError {
+    readonly budgetUsd: number;
+    readonly spentUsd: number;
+    constructor(budgetUsd: number, spentUsd: number);
+}
+export declare class ToolTimeoutError extends StratusError {
+    readonly toolName: string;
+    readonly timeoutMs: number;
+    constructor(toolName: string, timeoutMs: number);
+}
+export declare class OutputGuardrailTripwireTriggered extends StratusError {
+    readonly guardrailName: string;
+    readonly outputInfo?: unknown;
+    constructor(guardrailName: string, outputInfo?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAInD;AAED,qBAAa,qBAAsB,SAAQ,YAAY;gBAC1C,QAAQ,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,YAAY;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAM1F;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACrC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ5E;AAED,qBAAa,gBAAiB,SAAQ,YAAY;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAInD;AAED,qBAAa,+BAAgC,SAAQ,YAAY;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAMvD;AAED,qBAAa,eAAgB,SAAQ,YAAY;gBACpC,OAAO,CAAC,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,YAAY;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAQ/C;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM/C;AAED,qBAAa,gCAAiC,SAAQ,YAAY;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAMvD"}

package/dist/core/errors.js

@@ -0,0 +1,85 @@
+export class StratusError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "StratusError";
+    }
+}
+export class MaxTurnsExceededError extends StratusError {
+    constructor(maxTurns) {
+        super(`Agent exceeded maximum turns (${maxTurns})`);
+        this.name = "MaxTurnsExceededError";
+    }
+}
+export class ModelError extends StratusError {
+    status;
+    code;
+    constructor(message, options) {
+        super(message, { cause: options?.cause });
+        this.name = "ModelError";
+        this.status = options?.status;
+        this.code = options?.code;
+    }
+}
+export class ContentFilterError extends ModelError {
+    constructor(message, options) {
+        super(message ?? "Content was filtered by the content management policy", {
+            status: options?.status,
+            code: "content_filter",
+            cause: options?.cause,
+        });
+        this.name = "ContentFilterError";
+    }
+}
+export class OutputParseError extends StratusError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "OutputParseError";
+    }
+}
+export class InputGuardrailTripwireTriggered extends StratusError {
+    guardrailName;
+    outputInfo;
+    constructor(guardrailName, outputInfo) {
+        super(`Input guardrail "${guardrailName}" tripwire triggered`);
+        this.name = "InputGuardrailTripwireTriggered";
+        this.guardrailName = guardrailName;
+        this.outputInfo = outputInfo;
+    }
+}
+export class RunAbortedError extends StratusError {
+    constructor(message) {
+        super(message ?? "Run was aborted");
+        this.name = "RunAbortedError";
+    }
+}
+export class MaxBudgetExceededError extends StratusError {
+    budgetUsd;
+    spentUsd;
+    constructor(budgetUsd, spentUsd) {
+        super(`Agent exceeded maximum budget ($${budgetUsd.toFixed(4)}, spent $${spentUsd.toFixed(4)})`);
+        this.name = "MaxBudgetExceededError";
+        this.budgetUsd = budgetUsd;
+        this.spentUsd = spentUsd;
+    }
+}
+export class ToolTimeoutError extends StratusError {
+    toolName;
+    timeoutMs;
+    constructor(toolName, timeoutMs) {
+        super(`Tool "${toolName}" timed out after ${timeoutMs}ms`);
+        this.name = "ToolTimeoutError";
+        this.toolName = toolName;
+        this.timeoutMs = timeoutMs;
+    }
+}
+export class OutputGuardrailTripwireTriggered extends StratusError {
+    guardrailName;
+    outputInfo;
+    constructor(guardrailName, outputInfo) {
+        super(`Output guardrail "${guardrailName}" tripwire triggered`);
+        this.name = "OutputGuardrailTripwireTriggered";
+        this.guardrailName = guardrailName;
+        this.outputInfo = outputInfo;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/guardrails.d.ts

@@ -0,0 +1,39 @@
+export interface GuardrailResult {
+    tripwireTriggered: boolean;
+    outputInfo?: unknown;
+}
+export interface GuardrailRunResult {
+    guardrailName: string;
+    result: GuardrailResult;
+}
+export interface InputGuardrail<TContext = unknown> {
+    name: string;
+    execute: (input: string, context: TContext) => GuardrailResult | Promise<GuardrailResult>;
+}
+export interface OutputGuardrail<TContext = unknown> {
+    name: string;
+    execute: (output: string, context: TContext) => GuardrailResult | Promise<GuardrailResult>;
+}
+/** Guardrail that runs before a tool call */
+export interface ToolInputGuardrail<TContext = unknown> {
+    name: string;
+    execute: (params: {
+        toolName: string;
+        toolArgs: Record<string, unknown>;
+        context: TContext;
+    }) => GuardrailResult | Promise<GuardrailResult>;
+}
+/** Guardrail that runs after a tool call */
+export interface ToolOutputGuardrail<TContext = unknown> {
+    name: string;
+    execute: (params: {
+        toolName: string;
+        toolResult: string;
+        context: TContext;
+    }) => GuardrailResult | Promise<GuardrailResult>;
+}
+export declare function runInputGuardrails<TContext>(guardrails: InputGuardrail<TContext>[], input: string, context: TContext): Promise<GuardrailRunResult[]>;
+export declare function runOutputGuardrails<TContext>(guardrails: OutputGuardrail<TContext>[], output: string, context: TContext): Promise<GuardrailRunResult[]>;
+export declare function runToolInputGuardrails<TContext>(guardrails: ToolInputGuardrail<TContext>[], toolName: string, toolArgs: Record<string, unknown>, context: TContext): Promise<GuardrailRunResult[]>;
+export declare function runToolOutputGuardrails<TContext>(guardrails: ToolOutputGuardrail<TContext>[], toolName: string, toolResult: string, context: TContext): Promise<GuardrailRunResult[]>;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/core/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,OAAO;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1F;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC3F;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,OAAO;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,EAAE,QAAQ,CAAC;KAClB,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjD;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,OAAO;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,QAAQ,CAAC;KAClB,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjD;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAChD,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,EACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAe/B;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EACjD,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAe/B;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EACpD,UAAU,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,QAAQ,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAS/B;AAED,wBAAsB,uBAAuB,CAAC,QAAQ,EACrD,UAAU,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAC3C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,QAAQ,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAS/B"}

package/dist/core/guardrails.js

@@ -0,0 +1,40 @@
+import { InputGuardrailTripwireTriggered, OutputGuardrailTripwireTriggered } from "./errors";
+export async function runInputGuardrails(guardrails, input, context) {
+    const results = await Promise.all(guardrails.map(async (g) => {
+        const result = await g.execute(input, context);
+        return { guardrailName: g.name, result };
+    }));
+    for (const { guardrailName, result } of results) {
+        if (result.tripwireTriggered) {
+            throw new InputGuardrailTripwireTriggered(guardrailName, result.outputInfo);
+        }
+    }
+    return results;
+}
+export async function runOutputGuardrails(guardrails, output, context) {
+    const results = await Promise.all(guardrails.map(async (g) => {
+        const result = await g.execute(output, context);
+        return { guardrailName: g.name, result };
+    }));
+    for (const { guardrailName, result } of results) {
+        if (result.tripwireTriggered) {
+            throw new OutputGuardrailTripwireTriggered(guardrailName, result.outputInfo);
+        }
+    }
+    return results;
+}
+export async function runToolInputGuardrails(guardrails, toolName, toolArgs, context) {
+    const results = await Promise.all(guardrails.map(async (g) => {
+        const result = await g.execute({ toolName, toolArgs, context });
+        return { guardrailName: g.name, result };
+    }));
+    return results;
+}
+export async function runToolOutputGuardrails(guardrails, toolName, toolResult, context) {
+    const results = await Promise.all(guardrails.map(async (g) => {
+        const result = await g.execute({ toolName, toolResult, context });
+        return { guardrailName: g.name, result };
+    }));
+    return results;
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/core/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AA0C7F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,UAAsC,EACtC,KAAa,EACb,OAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC,CAAC,CACF,CAAC;IAEF,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,IAAI,+BAA+B,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7E,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,UAAuC,EACvC,MAAc,EACd,OAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC,CAAC,CACF,CAAC;IAEF,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,IAAI,gCAAgC,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,UAA0C,EAC1C,QAAgB,EAChB,QAAiC,EACjC,OAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC,CAAC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,UAA2C,EAC3C,QAAgB,EAChB,UAAkB,EAClB,OAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC,CAAC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/core/handoff.d.ts

@@ -0,0 +1,35 @@
+import type { z } from "zod";
+import { Agent } from "./agent";
+import type { ChatMessage, ToolDefinition } from "./types";
+export interface HandoffInputData {
+    /** The full conversation history before the handoff */
+    history: ChatMessage[];
+    /** The input from the LLM's tool call (parsed if inputType is set) */
+    input?: unknown;
+}
+export type HandoffInputFilter = (data: HandoffInputData) => ChatMessage[];
+export interface HandoffConfig<TContext = unknown> {
+    agent: Agent<TContext>;
+    toolName?: string;
+    toolDescription?: string;
+    onHandoff?: (context: TContext) => void | Promise<void>;
+    /** Zod schema for structured input the LLM can send with the handoff */
+    inputType?: z.ZodType;
+    /** Transform conversation history passed to the next agent */
+    inputFilter?: HandoffInputFilter;
+    /** If false or returns false, the handoff is excluded from tools sent to the LLM */
+    isEnabled?: boolean | ((context: TContext) => boolean | Promise<boolean>);
+}
+export interface Handoff<TContext = unknown> {
+    type: "handoff";
+    agent: Agent<TContext>;
+    toolName: string;
+    toolDescription: string;
+    onHandoff?: (context: TContext) => void | Promise<void>;
+    inputType?: z.ZodType;
+    inputFilter?: HandoffInputFilter;
+    isEnabled?: boolean | ((context: TContext) => boolean | Promise<boolean>);
+}
+export declare function handoff<TContext = unknown>(agentOrConfig: Agent<TContext> | HandoffConfig<TContext>): Handoff<TContext>;
+export declare function handoffToDefinition(h: Handoff): ToolDefinition;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/core/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/core/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG3D,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,WAAW,EAAE,CAAC;AAE3E,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO;IAChD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACtB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,OAAO,CAAC,QAAQ,GAAG,OAAO;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1E;AAED,wBAAgB,OAAO,CAAC,QAAQ,GAAG,OAAO,EACzC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,GACtD,OAAO,CAAC,QAAQ,CAAC,CAwBnB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAa9D"}

package/dist/core/handoff.js

@@ -0,0 +1,39 @@
+import { Agent } from "./agent";
+import { zodToJsonSchema } from "./utils/zod";
+export function handoff(agentOrConfig) {
+    if (agentOrConfig instanceof Agent) {
+        return {
+            type: "handoff",
+            agent: agentOrConfig,
+            toolName: `transfer_to_${agentOrConfig.name}`,
+            toolDescription: agentOrConfig.handoffDescription ?? `Transfer to ${agentOrConfig.name}`,
+        };
+    }
+    const config = agentOrConfig;
+    return {
+        type: "handoff",
+        agent: config.agent,
+        toolName: config.toolName ?? `transfer_to_${config.agent.name}`,
+        toolDescription: config.toolDescription ??
+            config.agent.handoffDescription ??
+            `Transfer to ${config.agent.name}`,
+        onHandoff: config.onHandoff,
+        inputType: config.inputType,
+        inputFilter: config.inputFilter,
+        isEnabled: config.isEnabled,
+    };
+}
+export function handoffToDefinition(h) {
+    const parameters = h.inputType
+        ? zodToJsonSchema(h.inputType)
+        : { type: "object", properties: {} };
+    return {
+        type: "function",
+        function: {
+            name: h.toolName,
+            description: h.toolDescription,
+            parameters,
+        },
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/core/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/core/handoff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAmC9C,MAAM,UAAU,OAAO,CACtB,aAAwD;IAExD,IAAI,aAAa,YAAY,KAAK,EAAE,CAAC;QACpC,OAAO;YACN,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,eAAe,aAAa,CAAC,IAAI,EAAE;YAC7C,eAAe,EAAE,aAAa,CAAC,kBAAkB,IAAI,eAAe,aAAa,CAAC,IAAI,EAAE;SACxF,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC;IAC7B,OAAO;QACN,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,eAAe,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAC/D,eAAe,EACd,MAAM,CAAC,eAAe;YACtB,MAAM,CAAC,KAAK,CAAC,kBAAkB;YAC/B,eAAe,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC7C,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS;QAC7B,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAEtC,OAAO;QACN,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACT,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,WAAW,EAAE,CAAC,CAAC,eAAe;YAC9B,UAAU;SACV;KACD,CAAC;AACH,CAAC"}

package/dist/core/hooks.d.ts

@@ -0,0 +1,154 @@
+import type { Agent } from "./agent";
+import type { ModelRequest } from "./model";
+import type { RunResult } from "./result";
+import type { SubAgent } from "./subagent";
+import type { ChatMessage, ToolCall } from "./types";
+export type ToolCallDecision = {
+    decision: "allow";
+} | {
+    decision: "deny";
+    reason?: string;
+} | {
+    decision: "modify";
+    modifiedParams: Record<string, unknown>;
+};
+export type HandoffDecision = {
+    decision: "allow";
+} | {
+    decision: "deny";
+    reason?: string;
+};
+export type ToolMatcher = string | RegExp;
+export interface MatchedToolCallHook<TContext = unknown> {
+    match: ToolMatcher | ToolMatcher[];
+    hook: (params: {
+        agent: Agent<TContext, any>;
+        toolCall: ToolCall;
+        context: TContext;
+    }) => undefined | ToolCallDecision | Promise<undefined | ToolCallDecision>;
+}
+export interface MatchedAfterToolCallHook<TContext = unknown> {
+    match: ToolMatcher | ToolMatcher[];
+    hook: (params: {
+        agent: Agent<TContext, any>;
+        toolCall: ToolCall;
+        result: string;
+        context: TContext;
+    }) => void | Promise<void>;
+}
+export type BeforeToolCallHook<TContext = unknown> = ((params: {
+    agent: Agent<TContext, any>;
+    toolCall: ToolCall;
+    context: TContext;
+}) => undefined | ToolCallDecision | Promise<undefined | ToolCallDecision>) | MatchedToolCallHook<TContext>[];
+export type AfterToolCallHook<TContext = unknown> = ((params: {
+    agent: Agent<TContext, any>;
+    toolCall: ToolCall;
+    result: string;
+    context: TContext;
+}) => void | Promise<void>) | MatchedAfterToolCallHook<TContext>[];
+export interface AgentHooks<TContext = unknown> {
+    beforeRun?: (params: {
+        agent: Agent<TContext, any>;
+        input: string;
+        context: TContext;
+    }) => void | Promise<void>;
+    afterRun?: (params: {
+        agent: Agent<TContext, any>;
+        result: RunResult<any>;
+        context: TContext;
+    }) => void | Promise<void>;
+    beforeToolCall?: BeforeToolCallHook<TContext>;
+    afterToolCall?: AfterToolCallHook<TContext>;
+    beforeHandoff?: (params: {
+        fromAgent: Agent<TContext, any>;
+        toAgent: Agent<TContext, any>;
+        context: TContext;
+    }) => undefined | HandoffDecision | Promise<undefined | HandoffDecision>;
+    onStop?: (params: {
+        agent: Agent<TContext, any>;
+        context: TContext;
+        reason: "max_turns" | "max_budget";
+    }) => void | Promise<void>;
+    onSubagentStart?: (params: {
+        agent: Agent<TContext, any>;
+        subagent: SubAgent;
+        context: TContext;
+    }) => void | Promise<void>;
+    onSubagentStop?: (params: {
+        agent: Agent<TContext, any>;
+        subagent: SubAgent;
+        result: string;
+        context: TContext;
+    }) => void | Promise<void>;
+    onSessionStart?: (params: {
+        context: TContext;
+    }) => void | Promise<void>;
+    onSessionEnd?: (params: {
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called before each LLM API call */
+    onLlmStart?: (params: {
+        agent: Agent<TContext, any>;
+        messages: ChatMessage[];
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called after each LLM API call */
+    onLlmEnd?: (params: {
+        agent: Agent<TContext, any>;
+        response: {
+            content: string | null;
+            toolCallCount: number;
+        };
+        context: TContext;
+    }) => void | Promise<void>;
+}
+/** Run-level hooks that fire across all agents in a run */
+export interface RunHooks<TContext = unknown> {
+    /** Called when an agent starts processing (including after handoffs) */
+    onAgentStart?: (params: {
+        agent: Agent<TContext, any>;
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called when an agent finishes (before handoff or at end) */
+    onAgentEnd?: (params: {
+        agent: Agent<TContext, any>;
+        output: string;
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called on every handoff */
+    onHandoff?: (params: {
+        fromAgent: Agent<TContext, any>;
+        toAgent: Agent<TContext, any>;
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called before every tool execution */
+    onToolStart?: (params: {
+        agent: Agent<TContext, any>;
+        toolName: string;
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called after every tool execution */
+    onToolEnd?: (params: {
+        agent: Agent<TContext, any>;
+        toolName: string;
+        result: string;
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called before every LLM API call */
+    onLlmStart?: (params: {
+        agent: Agent<TContext, any>;
+        request: ModelRequest;
+        context: TContext;
+    }) => void | Promise<void>;
+    /** Called after every LLM API call */
+    onLlmEnd?: (params: {
+        agent: Agent<TContext, any>;
+        response: {
+            content: string | null;
+            toolCallCount: number;
+        };
+        context: TContext;
+    }) => void | Promise<void>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/core/hooks.d.ts.map

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

package/dist/core/hooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/core/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":""}

package/dist/core/hosted-tool.d.ts

@@ -0,0 +1,11 @@
+import type { FunctionTool } from "./tool";
+import type { HostedToolDefinition } from "./types";
+export interface HostedTool {
+    type: "hosted";
+    name: string;
+    definition: HostedToolDefinition;
+}
+export type AgentTool = FunctionTool | HostedTool;
+export declare function isHostedTool(tool: AgentTool): tool is HostedTool;
+export declare function isFunctionTool(tool: AgentTool): tool is FunctionTool;
+//# sourceMappingURL=hosted-tool.d.ts.map

package/dist/core/hosted-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-tool.d.ts","sourceRoot":"","sources":["../../src/core/hosted-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;AAElD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,UAAU,CAEhE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,YAAY,CAEpE"}

package/dist/core/hosted-tool.js

@@ -0,0 +1,7 @@
+export function isHostedTool(tool) {
+    return tool.type === "hosted";
+}
+export function isFunctionTool(tool) {
+    return tool.type === "function";
+}
+//# sourceMappingURL=hosted-tool.js.map

package/dist/core/hosted-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-tool.js","sourceRoot":"","sources":["../../src/core/hosted-tool.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,YAAY,CAAC,IAAe;IAC3C,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAe;IAC7C,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;AACjC,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,35 @@
+export { Agent } from "./agent";
+export type { AgentConfig, HandoffInput, Instructions } from "./agent";
+export { RunContext } from "./context";
+export { RunResult } from "./result";
+export type { RunResultOptions } from "./result";
+export { run, stream } from "./run";
+export type { RunOptions, StreamOptions, StreamedRunResult, ToolErrorFormatter, CallModelInputFilter, MaxTurnsErrorHandler, } from "./run";
+export { createSession, forkSession, prompt, resumeSession, Session } from "./session";
+export type { SessionConfig, SessionSnapshot } from "./session";
+export { tool, toolToDefinition } from "./tool";
+export type { FunctionTool, ToolExecuteOptions } from "./tool";
+export { isHostedTool, isFunctionTool } from "./hosted-tool";
+export type { HostedTool, AgentTool } from "./hosted-tool";
+export { webSearchTool, codeInterpreterTool, mcpTool, imageGenerationTool, fileSearchTool, computerUseTool, } from "./builtin-tools";
+export type { WebSearchToolConfig, CodeInterpreterToolConfig, McpToolConfig, FileSearchToolConfig, ComputerUseToolConfig, } from "./builtin-tools";
+export { TodoList, todoTool } from "./todo";
+export type { Todo, TodoStatus, TodoUpdateListener } from "./todo";
+export { subagent, subagentToDefinition, subagentToTool } from "./subagent";
+export type { SubAgent, SubAgentConfig } from "./subagent";
+export { handoff, handoffToDefinition } from "./handoff";
+export type { Handoff, HandoffConfig, HandoffInputData, HandoffInputFilter } from "./handoff";
+export { runInputGuardrails, runOutputGuardrails, runToolInputGuardrails, runToolOutputGuardrails, } from "./guardrails";
+export type { GuardrailResult, GuardrailRunResult, InputGuardrail, OutputGuardrail, ToolInputGuardrail, ToolOutputGuardrail, } from "./guardrails";
+export type { AgentHooks, RunHooks, ToolCallDecision, HandoffDecision, ToolMatcher, MatchedToolCallHook, MatchedAfterToolCallHook, BeforeToolCallHook, AfterToolCallHook, } from "./hooks";
+export { TraceContext, getCurrentTrace, withTrace } from "./tracing";
+export type { Span, Trace } from "./tracing";
+export { createCostEstimator } from "./cost";
+export type { CostEstimator, PricingConfig } from "./cost";
+export type { FinishReason, Model, ModelRequest, ModelRequestOptions, ModelResponse, StreamEvent, UsageInfo, } from "./model";
+export type { ChatMessage, SystemMessage, DeveloperMessage, UserMessage, AssistantMessage, ToolMessage, ToolCall, ToolDefinition, HostedToolDefinition, ModelSettings, ReasoningEffort, ReasoningSummary, Truncation, ResponseFormat, ToolChoice, ToolUseBehavior, ContentPart, TextContentPart, ImageContentPart, } from "./types";
+export { StratusError, MaxTurnsExceededError, MaxBudgetExceededError, ModelError, ContentFilterError, OutputParseError, RunAbortedError, InputGuardrailTripwireTriggered, OutputGuardrailTripwireTriggered, ToolTimeoutError, } from "./errors";
+export { zodToJsonSchema } from "./utils/zod";
+export { createCodeModeTool, FunctionExecutor, WorkerExecutor, generateTypes, normalizeCode, sanitizeToolName, } from "./codemode/index";
+export type { CodeModeToolOptions, CodeModeOutput, Executor, ExecuteResult, FunctionExecutorOptions, WorkerExecutorOptions, } from "./codemode/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

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

package/dist/core/index.js

@@ -0,0 +1,18 @@
+export { Agent } from "./agent";
+export { RunContext } from "./context";
+export { RunResult } from "./result";
+export { run, stream } from "./run";
+export { createSession, forkSession, prompt, resumeSession, Session } from "./session";
+export { tool, toolToDefinition } from "./tool";
+export { isHostedTool, isFunctionTool } from "./hosted-tool";
+export { webSearchTool, codeInterpreterTool, mcpTool, imageGenerationTool, fileSearchTool, computerUseTool, } from "./builtin-tools";
+export { TodoList, todoTool } from "./todo";
+export { subagent, subagentToDefinition, subagentToTool } from "./subagent";
+export { handoff, handoffToDefinition } from "./handoff";
+export { runInputGuardrails, runOutputGuardrails, runToolInputGuardrails, runToolOutputGuardrails, } from "./guardrails";
+export { TraceContext, getCurrentTrace, withTrace } from "./tracing";
+export { createCostEstimator } from "./cost";
+export { StratusError, MaxTurnsExceededError, MaxBudgetExceededError, ModelError, ContentFilterError, OutputParseError, RunAbortedError, InputGuardrailTripwireTriggered, OutputGuardrailTripwireTriggered, ToolTimeoutError, } from "./errors";
+export { zodToJsonSchema } from "./utils/zod";
+export { createCodeModeTool, FunctionExecutor, WorkerExecutor, generateTypes, normalizeCode, sanitizeToolName, } from "./codemode/index";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAUpC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGvF,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,eAAe,GACf,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAsBtB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAmC7C,OAAO,EACN,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,+BAA+B,EAC/B,gCAAgC,EAChC,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}