@openrouter/agent 0.1.0

package/esm/lib/tool.d.ts

@@ -0,0 +1,108 @@
+import type { $ZodObject, $ZodShape, $ZodType, infer as zodInfer } from 'zod/v4/core';
+import { type ManualTool, type NextTurnParamsFunctions, type Tool, type ToolApprovalCheck, type ToolExecuteContext, type ToolWithExecute, type ToolWithGenerator } from './tool-types.js';
+/**
+ * Configuration for a regular tool with outputSchema
+ */
+type RegularToolConfigWithOutput<TInput extends $ZodObject<$ZodShape>, TOutput extends $ZodType, TContext extends Record<string, unknown> = Record<string, unknown>, TName extends string = string> = {
+    name: TName;
+    description?: string;
+    inputSchema: TInput;
+    outputSchema: TOutput;
+    eventSchema?: undefined;
+    /** Zod schema declaring the context data this tool needs */
+    contextSchema?: $ZodObject<$ZodShape>;
+    nextTurnParams?: NextTurnParamsFunctions<zodInfer<TInput>>;
+    requireApproval?: boolean | ToolApprovalCheck<zodInfer<TInput>>;
+    execute: (params: zodInfer<TInput>, context?: ToolExecuteContext<TName, TContext>) => Promise<zodInfer<TOutput>> | zodInfer<TOutput>;
+};
+/**
+ * Configuration for a regular tool without outputSchema (infers return type from execute)
+ */
+type RegularToolConfigWithoutOutput<TInput extends $ZodObject<$ZodShape>, TReturn, TContext extends Record<string, unknown> = Record<string, unknown>, TName extends string = string> = {
+    name: TName;
+    description?: string;
+    inputSchema: TInput;
+    outputSchema?: undefined;
+    eventSchema?: undefined;
+    /** Zod schema declaring the context data this tool needs */
+    contextSchema?: $ZodObject<$ZodShape>;
+    nextTurnParams?: NextTurnParamsFunctions<zodInfer<TInput>>;
+    requireApproval?: boolean | ToolApprovalCheck<zodInfer<TInput>>;
+    execute: (params: zodInfer<TInput>, context?: ToolExecuteContext<TName, TContext>) => Promise<TReturn> | TReturn;
+};
+/**
+ * Configuration for a generator tool (with eventSchema)
+ */
+type GeneratorToolConfig<TInput extends $ZodObject<$ZodShape>, TEvent extends $ZodType, TOutput extends $ZodType, TContext extends Record<string, unknown> = Record<string, unknown>, TName extends string = string> = {
+    name: TName;
+    description?: string;
+    inputSchema: TInput;
+    eventSchema: TEvent;
+    outputSchema: TOutput;
+    /** Zod schema declaring the context data this tool needs */
+    contextSchema?: $ZodObject<$ZodShape>;
+    nextTurnParams?: NextTurnParamsFunctions<zodInfer<TInput>>;
+    requireApproval?: boolean | ToolApprovalCheck<zodInfer<TInput>>;
+    execute: (params: zodInfer<TInput>, context?: ToolExecuteContext<TName, TContext>) => AsyncGenerator<zodInfer<TEvent> | zodInfer<TOutput>>;
+};
+/**
+ * Configuration for a manual tool (execute: false, no eventSchema or outputSchema)
+ */
+type ManualToolConfig<TInput extends $ZodObject<$ZodShape>> = {
+    name: string;
+    description?: string;
+    inputSchema: TInput;
+    /** Zod schema declaring the context data this tool needs */
+    contextSchema?: $ZodObject<$ZodShape>;
+    nextTurnParams?: NextTurnParamsFunctions<zodInfer<TInput>>;
+    requireApproval?: boolean | ToolApprovalCheck<zodInfer<TInput>>;
+    execute: false;
+};
+/**
+ * Loose config type for the `tool<TShared>()` overload.
+ * Accepts any valid tool config while typing `ctx.shared` from TShared.
+ */
+type ToolConfigWithSharedContext<TShared extends Record<string, unknown>> = {
+    name: string;
+    description?: string;
+    inputSchema: $ZodObject<$ZodShape>;
+    outputSchema?: $ZodType;
+    eventSchema?: $ZodType;
+    contextSchema?: $ZodObject<$ZodShape>;
+    nextTurnParams?: NextTurnParamsFunctions<Record<string, unknown>>;
+    requireApproval?: boolean | ToolApprovalCheck<Record<string, unknown>>;
+    execute: ((params: Record<string, unknown>, context?: ToolExecuteContext<string, Record<string, unknown>, TShared>) => unknown) | ((params: Record<string, unknown>, context?: ToolExecuteContext<string, Record<string, unknown>, TShared>) => AsyncGenerator<unknown>) | false;
+};
+/**
+ * Creates a tool with full type inference from Zod schemas.
+ *
+ * The tool type is automatically determined based on the configuration:
+ * - **Generator tool**: When `eventSchema` is provided
+ * - **Regular tool**: When `execute` is a function (no `eventSchema`)
+ * - **Manual tool**: When `execute: false` is set
+ *
+ * Shared context typing: Pass a type parameter to type `ctx.shared`
+ * in the execute callback. Runtime validation happens at callModel
+ * via `sharedContextSchema`.
+ *
+ * @example Regular tool with typed shared context:
+ * ```typescript
+ * type SharedCtx = z.infer<typeof SharedContextSchema>;
+ *
+ * const execTool = tool<SharedCtx>({
+ *   name: "sandbox_exec",
+ *   inputSchema: z.object({ command: z.string() }),
+ *   execute: async (params, ctx) => {
+ *     ctx?.shared._sessionId;       // string | undefined
+ *     return { output: '...' };
+ *   },
+ * });
+ * ```
+ */
+export declare function tool<TInput extends $ZodObject<$ZodShape>, TEvent extends $ZodType, TOutput extends $ZodType, TContext extends Record<string, unknown> = Record<string, unknown>, TName extends string = string>(config: GeneratorToolConfig<TInput, TEvent, TOutput, TContext, TName>): ToolWithGenerator<TInput, TEvent, TOutput, TContext>;
+export declare function tool<TInput extends $ZodObject<$ZodShape>>(config: ManualToolConfig<TInput>): ManualTool<TInput>;
+export declare function tool<TInput extends $ZodObject<$ZodShape>, TOutput extends $ZodType, TContext extends Record<string, unknown> = Record<string, unknown>, TName extends string = string>(config: RegularToolConfigWithOutput<TInput, TOutput, TContext, TName>): ToolWithExecute<TInput, TOutput, TContext>;
+export declare function tool<TInput extends $ZodObject<$ZodShape>, TReturn, TContext extends Record<string, unknown> = Record<string, unknown>, TName extends string = string>(config: RegularToolConfigWithoutOutput<TInput, TReturn, TContext, TName>): ToolWithExecute<TInput, $ZodType<TReturn>, TContext>;
+export declare function tool<TShared extends Record<string, unknown>>(config: ToolConfigWithSharedContext<TShared>): Tool;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/esm/lib/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/lib/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,uBAAuB,EAE5B,KAAK,IAAI,EACT,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAIzB;;GAEG;AACH,KAAK,2BAA2B,CAC9B,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACpC,OAAO,SAAS,QAAQ,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,KAAK,SAAS,MAAM,GAAG,MAAM,IAC3B;IACF,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,CACP,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,KAAK,8BAA8B,CACjC,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACpC,OAAO,EACP,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,KAAK,SAAS,MAAM,GAAG,MAAM,IAC3B;IACF,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,CACP,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAC1C,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,KAAK,mBAAmB,CACtB,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACpC,MAAM,SAAS,QAAQ,EACvB,OAAO,SAAS,QAAQ,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,KAAK,SAAS,MAAM,GAAG,MAAM,IAC3B;IACF,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,CACP,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAC1C,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,KAAK,gBAAgB,CAAC,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,IAAI;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,KAAK,2BAA2B,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,eAAe,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,OAAO,EACH,CAAC,CACC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,KACnE,OAAO,CAAC,GACb,CAAC,CACC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,KACnE,cAAc,CAAC,OAAO,CAAC,CAAC,GAC7B,KAAK,CAAC;CACX,CAAC;AAuBF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wBAAgB,IAAI,CAClB,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACpC,MAAM,SAAS,QAAQ,EACvB,OAAO,SAAS,QAAQ,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,KAAK,SAAS,MAAM,GAAG,MAAM,EAE7B,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAGxD,wBAAgB,IAAI,CAAC,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACvD,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAC/B,UAAU,CAAC,MAAM,CAAC,CAAC;AAGtB,wBAAgB,IAAI,CAClB,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACpC,OAAO,SAAS,QAAQ,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,KAAK,SAAS,MAAM,GAAG,MAAM,EAE7B,MAAM,EAAE,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAG9C,wBAAgB,IAAI,CAClB,MAAM,SAAS,UAAU,CAAC,SAAS,CAAC,EACpC,OAAO,EACP,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,KAAK,SAAS,MAAM,GAAG,MAAM,EAE7B,MAAM,EAAE,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,GACvE,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAMxD,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,MAAM,EAAE,2BAA2B,CAAC,OAAO,CAAC,GAC3C,IAAI,CAAC"}

package/esm/lib/tool.js

@@ -0,0 +1,84 @@
+import { SHARED_CONTEXT_KEY, ToolType, } from './tool-types.js';
+// Implementation
+export function tool(config) {
+    // 'shared' is reserved for shared context — forbid it as a tool name
+    if (config.name === SHARED_CONTEXT_KEY) {
+        throw new Error(`Tool name "${SHARED_CONTEXT_KEY}" is reserved for shared context. Choose a different name.`);
+    }
+    // Check for manual tool first (execute === false)
+    if (config.execute === false) {
+        const fn = {
+            name: config.name,
+            inputSchema: config.inputSchema,
+        };
+        if (config.description !== undefined) {
+            fn.description = config.description;
+        }
+        if (config.contextSchema !== undefined) {
+            fn.contextSchema = config.contextSchema;
+        }
+        if (config.nextTurnParams !== undefined) {
+            fn.nextTurnParams = config.nextTurnParams;
+        }
+        if (config.requireApproval !== undefined) {
+            fn.requireApproval = config.requireApproval;
+        }
+        return {
+            type: ToolType.Function,
+            function: fn,
+        };
+    }
+    // Check for generator tool (has eventSchema)
+    if ('eventSchema' in config && config.eventSchema !== undefined) {
+        const fn = {
+            name: config.name,
+            inputSchema: config.inputSchema,
+            eventSchema: config.eventSchema,
+            outputSchema: config.outputSchema,
+            execute: config.execute,
+        };
+        if (config.description !== undefined) {
+            fn.description = config.description;
+        }
+        if (config.contextSchema !== undefined) {
+            fn.contextSchema = config.contextSchema;
+        }
+        if (config.nextTurnParams !== undefined) {
+            fn.nextTurnParams = config.nextTurnParams;
+        }
+        if (config.requireApproval !== undefined) {
+            fn.requireApproval = config.requireApproval;
+        }
+        return {
+            type: ToolType.Function,
+            function: fn,
+        };
+    }
+    // Regular tool (has execute function, no eventSchema)
+    const functionObj = {
+        name: config.name,
+        inputSchema: config.inputSchema,
+        execute: config.execute,
+        ...(config.description !== undefined && {
+            description: config.description,
+        }),
+        ...(config.outputSchema !== undefined && {
+            outputSchema: config.outputSchema,
+        }),
+        ...(config.contextSchema !== undefined && {
+            contextSchema: config.contextSchema,
+        }),
+        ...(config.nextTurnParams !== undefined && {
+            nextTurnParams: config.nextTurnParams,
+        }),
+        ...(config.requireApproval !== undefined && {
+            requireApproval: config.requireApproval,
+        }),
+    };
+    return {
+        type: ToolType.Function,
+        function: functionObj,
+    };
+}
+//#endregion
+//# sourceMappingURL=tool.js.map

package/esm/lib/tool.js.map

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

package/esm/lib/turn-context.d.ts

@@ -0,0 +1,50 @@
+import type { TurnContext } from './tool-types.js';
+import * as models from '@openrouter/sdk/models';
+/**
+ * Options for building a turn context
+ */
+export interface BuildTurnContextOptions {
+    /** Number of turns so far (1-indexed for tool execution, 0 for initial request) */
+    numberOfTurns: number;
+    /** The specific tool call being executed (optional for initial/async resolution contexts) */
+    toolCall?: models.FunctionCallItem;
+    /** The full request being sent to the API (optional for initial/async resolution contexts) */
+    turnRequest?: models.ResponsesRequest;
+}
+/**
+ * Build a turn context for tool execution or async parameter resolution
+ *
+ * @param options - Options for building the context
+ * @returns A TurnContext object
+ *
+ * @example
+ * ```typescript
+ * // For tool execution with full context
+ * const context = buildTurnContext({
+ *   numberOfTurns: 1,
+ *   toolCall: rawToolCall,
+ *   turnRequest: currentRequest,
+ * });
+ *
+ * // For async parameter resolution (partial context)
+ * const context = buildTurnContext({
+ *   numberOfTurns: 0,
+ * });
+ * ```
+ */
+export declare function buildTurnContext(options: BuildTurnContextOptions): TurnContext;
+/**
+ * Normalize OpenResponsesInput to an array format
+ * Converts string input to array with single user message
+ *
+ * @param input - The input to normalize
+ * @returns Array format of the input
+ *
+ * @example
+ * ```typescript
+ * const arrayInput = normalizeInputToArray("Hello!");
+ * // Returns: [{ role: "user", content: "Hello!" }]
+ * ```
+ */
+export declare function normalizeInputToArray(input: models.InputsUnion): Array<models.BaseInputsUnion>;
+//# sourceMappingURL=turn-context.d.ts.map

package/esm/lib/turn-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../../src/lib/turn-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC;IACnC,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CAc9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAY9F"}

package/esm/lib/turn-context.js

@@ -0,0 +1,61 @@
+import * as models from '@openrouter/sdk/models';
+/**
+ * Build a turn context for tool execution or async parameter resolution
+ *
+ * @param options - Options for building the context
+ * @returns A TurnContext object
+ *
+ * @example
+ * ```typescript
+ * // For tool execution with full context
+ * const context = buildTurnContext({
+ *   numberOfTurns: 1,
+ *   toolCall: rawToolCall,
+ *   turnRequest: currentRequest,
+ * });
+ *
+ * // For async parameter resolution (partial context)
+ * const context = buildTurnContext({
+ *   numberOfTurns: 0,
+ * });
+ * ```
+ */
+export function buildTurnContext(options) {
+    const context = {
+        numberOfTurns: options.numberOfTurns,
+    };
+    if (options.toolCall !== undefined) {
+        context.toolCall = options.toolCall;
+    }
+    if (options.turnRequest !== undefined) {
+        context.turnRequest = options.turnRequest;
+    }
+    return context;
+}
+/**
+ * Normalize OpenResponsesInput to an array format
+ * Converts string input to array with single user message
+ *
+ * @param input - The input to normalize
+ * @returns Array format of the input
+ *
+ * @example
+ * ```typescript
+ * const arrayInput = normalizeInputToArray("Hello!");
+ * // Returns: [{ role: "user", content: "Hello!" }]
+ * ```
+ */
+export function normalizeInputToArray(input) {
+    if (typeof input === 'string') {
+        // Construct object with all required fields - type is optional
+        const message = {
+            role: models.EasyInputMessageRoleUser.User,
+            content: input,
+        };
+        return [
+            message,
+        ];
+    }
+    return input;
+}
+//# sourceMappingURL=turn-context.js.map

package/esm/lib/turn-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-context.js","sourceRoot":"","sources":["../../src/lib/turn-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAC;AAcjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,OAAO,GAAgB;QAC3B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC;IAEF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,+DAA+D;QAC/D,MAAM,OAAO,GAA4B;YACvC,IAAI,EAAE,MAAM,CAAC,wBAAwB,CAAC,IAAI;YAC1C,OAAO,EAAE,KAAK;SACf,CAAC;QACF,OAAO;YACL,OAAO;SACR,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "@openrouter/agent",
+  "version": "0.1.0",
+  "author": "OpenRouter",
+  "description": "Agent toolkit for building AI applications with OpenRouter — tool orchestration, streaming, multi-turn conversations, and format compatibility.",
+  "keywords": [
+    "openrouter",
+    "agent",
+    "typescript",
+    "ai",
+    "tools",
+    "streaming",
+    "llm"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./esm/index.js",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "default": "./esm/index.js"
+    },
+    "./call-model": {
+      "types": "./esm/inner-loop/call-model.d.ts",
+      "default": "./esm/inner-loop/call-model.js"
+    },
+    "./tool-types": {
+      "types": "./esm/lib/tool-types.d.ts",
+      "default": "./esm/lib/tool-types.js"
+    },
+    "./model-result": {
+      "types": "./esm/lib/model-result.d.ts",
+      "default": "./esm/lib/model-result.js"
+    },
+    "./async-params": {
+      "types": "./esm/lib/async-params.d.ts",
+      "default": "./esm/lib/async-params.js"
+    },
+    "./stop-conditions": {
+      "types": "./esm/lib/stop-conditions.d.ts",
+      "default": "./esm/lib/stop-conditions.js"
+    },
+    "./tool": {
+      "types": "./esm/lib/tool.d.ts",
+      "default": "./esm/lib/tool.js"
+    },
+    "./anthropic-compat": {
+      "types": "./esm/lib/anthropic-compat.d.ts",
+      "default": "./esm/lib/anthropic-compat.js"
+    },
+    "./chat-compat": {
+      "types": "./esm/lib/chat-compat.d.ts",
+      "default": "./esm/lib/chat-compat.js"
+    },
+    "./claude-constants": {
+      "types": "./esm/lib/claude-constants.d.ts",
+      "default": "./esm/lib/claude-constants.js"
+    },
+    "./claude-type-guards": {
+      "types": "./esm/lib/claude-type-guards.d.ts",
+      "default": "./esm/lib/claude-type-guards.js"
+    },
+    "./conversation-state": {
+      "types": "./esm/lib/conversation-state.d.ts",
+      "default": "./esm/lib/conversation-state.js"
+    },
+    "./next-turn-params": {
+      "types": "./esm/lib/next-turn-params.d.ts",
+      "default": "./esm/lib/next-turn-params.js"
+    },
+    "./stream-transformers": {
+      "types": "./esm/lib/stream-transformers.d.ts",
+      "default": "./esm/lib/stream-transformers.js"
+    },
+    "./tool-context": {
+      "types": "./esm/lib/tool-context.d.ts",
+      "default": "./esm/lib/tool-context.js"
+    },
+    "./tool-event-broadcaster": {
+      "types": "./esm/lib/tool-event-broadcaster.d.ts",
+      "default": "./esm/lib/tool-event-broadcaster.js"
+    },
+    "./turn-context": {
+      "types": "./esm/lib/turn-context.d.ts",
+      "default": "./esm/lib/turn-context.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenRouterTeam/typescript-agent.git"
+  },
+  "files": [
+    "esm",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@openrouter/sdk": "git+https://github.com/OpenRouterTeam/typescript-sdk.git#add-prepare-script",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
+    "@eslint/js": "^9.19.0",
+    "@types/node": "^22.13.12",
+    "dotenv": "^16.4.7",
+    "eslint": "^9.19.0",
+    "globals": "^15.14.0",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.26.0",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "lint": "eslint --cache --max-warnings=0 src",
+    "build": "tsc",
+    "test": "vitest --run --project unit",
+    "test:e2e": "vitest --run --project e2e",
+    "test:watch": "vitest --watch --project unit",
+    "typecheck": "tsc --noEmit",
+    "compile": "tsc"
+  }
+}