@framers/agentos 0.1.69 → 0.1.71

package/dist/api/agent.d.ts

@@ -1,12 +1,39 @@
+/**
+ * @file agent.ts
+ * Lightweight stateful agent factory for the AgentOS high-level API.
+ *
+ * Wraps {@link generateText} and {@link streamText} with per-session conversation
+ * history, optional HEXACO-inspired personality shaping, and a named-agent system
+ * prompt builder.  For full guardrail enforcement or production multi-agent
+ * orchestration use the AgentOS runtime (`AgentOSOrchestrator`) instead.
+ */
 import { type GenerateTextOptions, type GenerateTextResult, type Message } from './generateText.js';
 import { type StreamTextResult } from './streamText.js';
-import type { ToolDefinitionMap } from './tool-adapter.js';
+import type { ToolDefinitionMap } from './toolAdapter.js';
+/**
+ * Configuration options for the {@link agent} factory function.
+ */
 export interface AgentOptions {
+    /**
+     * Model in `provider:model` format used for every call made by this agent.
+     * @example `"openai:gpt-4o"`, `"anthropic:claude-opus-4-5"`
+     */
     model: string;
+    /** Display name injected into the system prompt (e.g. `"Aria"`). */
     name?: string;
+    /** Free-form system instructions prepended before personality and name lines. */
     instructions?: string;
+    /** Named tools available to the agent on every call. */
     tools?: ToolDefinitionMap;
+    /**
+     * Enable in-memory conversation history for sessions.
+     * When `false`, each `send` / `stream` call is stateless.  Defaults to `true`.
+     */
     memory?: boolean;
+    /**
+     * HEXACO-inspired personality trait overrides (0–1 scale).
+     * Encoded as a human-readable trait string appended to the system prompt.
+     */
     personality?: Partial<{
         honesty: number;
         emotionality: number;
@@ -15,26 +42,95 @@ export interface AgentOptions {
         conscientiousness: number;
         openness: number;
     }>;
+    /**
+     * Guardrail policy identifiers.
+     * **Not supported** in the lightweight API — passing any values throws immediately.
+     * Use `AgentOSOrchestrator` for real guardrail enforcement.
+     */
     guardrails?: string[];
+    /** Override the provider API key instead of reading from environment variables. */
     apiKey?: string;
+    /** Override the provider base URL (useful for local proxies or Ollama). */
     baseUrl?: string;
+    /** Maximum agentic steps per call. Defaults to `5`. */
     maxSteps?: number;
 }
+/**
+ * A named conversation session returned by {@link Agent.session}.
+ * Maintains its own message history independently of other sessions on the same agent.
+ */
 export interface AgentSession {
+    /** Stable session identifier supplied to or auto-generated by {@link Agent.session}. */
     readonly id: string;
+    /**
+     * Sends a user message and returns the complete assistant reply.
+     * Appends both turns to the session history when `memory` is enabled.
+     *
+     * @param text - User message text.
+     * @returns The full generation result including text, usage, and tool calls.
+     */
     send(text: string): Promise<GenerateTextResult>;
+    /**
+     * Streams a user message and returns streaming iterables.
+     * The assistant reply is appended to session history once the `text` promise resolves.
+     *
+     * @param text - User message text.
+     * @returns A {@link StreamTextResult} with async iterables and awaitable aggregates.
+     */
     stream(text: string): StreamTextResult;
+    /** Returns a snapshot of the current conversation history for this session. */
     messages(): Message[];
+    /** Clears all messages from this session's history. */
     clear(): void;
 }
+/**
+ * A stateful agent instance returned by {@link agent}.
+ */
 export interface Agent {
+    /**
+     * Generates a single reply without maintaining session history.
+     *
+     * @param prompt - User prompt text.
+     * @param opts - Optional overrides merged on top of the agent's base options.
+     * @returns The complete generation result.
+     */
     generate(prompt: string, opts?: Partial<GenerateTextOptions>): Promise<GenerateTextResult>;
+    /**
+     * Streams a single reply without maintaining session history.
+     *
+     * @param prompt - User prompt text.
+     * @param opts - Optional overrides merged on top of the agent's base options.
+     * @returns A {@link StreamTextResult}.
+     */
     stream(prompt: string, opts?: Partial<GenerateTextOptions>): StreamTextResult;
+    /**
+     * Returns (or creates) a named {@link AgentSession} with its own conversation history.
+     *
+     * @param id - Optional session ID. A unique ID is generated when omitted.
+     * @returns The session object for this ID.
+     */
     session(id?: string): AgentSession;
+    /** Releases all in-memory session state held by this agent. */
     close(): Promise<void>;
 }
 /**
- * Creates a stateful agent with sessions, memory, and personality.
+ * Creates a lightweight stateful agent backed by in-memory session storage.
+ *
+ * The agent wraps {@link generateText} and {@link streamText} with a persistent
+ * system prompt built from `instructions`, `name`, and `personality` fields.
+ * Multiple independent sessions can be opened via {@link Agent.session}.
+ *
+ * @param opts - Agent configuration including model, instructions, and optional tools.
+ * @returns An {@link Agent} instance with `generate`, `stream`, `session`, and `close` methods.
+ * @throws {Error} If `opts.guardrails` contains any entries (not supported in the lightweight API).
+ *
+ * @example
+ * ```ts
+ * const myAgent = agent({ model: 'openai:gpt-4o', instructions: 'You are a helpful assistant.' });
+ * const session = myAgent.session('user-123');
+ * const reply = await session.send('Hello!');
+ * console.log(reply.text);
+ * ```
  */
 export declare function agent(opts: AgentOptions): Agent;
 //# sourceMappingURL=agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAC5D,aAAa,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;KACpE,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,QAAQ,IAAI,OAAO,EAAE,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAAC;IAC9E,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,KAAK,CAgE/C"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAC5D,aAAa,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;KACpE,CAAC,CAAC;IACH;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,+EAA+E;IAC/E,QAAQ,IAAI,OAAO,EAAE,CAAC;IACtB,uDAAuD;IACvD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3F;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAAC;IAC9E;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACnC,+DAA+D;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,KAAK,CAgF/C"}

package/dist/api/agent.js

@@ -1,14 +1,60 @@
-// packages/agentos/src/api/agent.ts
+/**
+ * @file agent.ts
+ * Lightweight stateful agent factory for the AgentOS high-level API.
+ *
+ * Wraps {@link generateText} and {@link streamText} with per-session conversation
+ * history, optional HEXACO-inspired personality shaping, and a named-agent system
+ * prompt builder.  For full guardrail enforcement or production multi-agent
+ * orchestration use the AgentOS runtime (`AgentOSOrchestrator`) instead.
+ */
 import { generateText } from './generateText.js';
 import { streamText } from './streamText.js';
+function buildSystemPrompt(opts) {
+    const sections = [];
+    if (opts.instructions?.trim()) {
+        sections.push(opts.instructions.trim());
+    }
+    if (opts.name?.trim()) {
+        sections.push(`Assistant name: ${opts.name.trim()}.`);
+    }
+    if (opts.personality) {
+        const traits = Object.entries(opts.personality)
+            .filter(([, value]) => typeof value === 'number' && Number.isFinite(value))
+            .map(([key, value]) => `${key}=${Number(value).toFixed(2)}`);
+        if (traits.length > 0) {
+            sections.push(`Behavior traits: ${traits.join(', ')}.`);
+        }
+    }
+    return sections.length > 0 ? sections.join('\n\n') : undefined;
+}
 /**
- * Creates a stateful agent with sessions, memory, and personality.
+ * Creates a lightweight stateful agent backed by in-memory session storage.
+ *
+ * The agent wraps {@link generateText} and {@link streamText} with a persistent
+ * system prompt built from `instructions`, `name`, and `personality` fields.
+ * Multiple independent sessions can be opened via {@link Agent.session}.
+ *
+ * @param opts - Agent configuration including model, instructions, and optional tools.
+ * @returns An {@link Agent} instance with `generate`, `stream`, `session`, and `close` methods.
+ * @throws {Error} If `opts.guardrails` contains any entries (not supported in the lightweight API).
+ *
+ * @example
+ * ```ts
+ * const myAgent = agent({ model: 'openai:gpt-4o', instructions: 'You are a helpful assistant.' });
+ * const session = myAgent.session('user-123');
+ * const reply = await session.send('Hello!');
+ * console.log(reply.text);
+ * ```
  */
 export function agent(opts) {
+    if (opts.guardrails && opts.guardrails.length > 0) {
+        throw new Error('agent({ guardrails }) is not supported in the lightweight high-level API. Use the full AgentOS runtime for real guardrail enforcement.');
+    }
     const sessions = new Map();
+    const useMemory = opts.memory !== false;
     const baseOpts = {
         model: opts.model,
-        system: opts.instructions,
+        system: buildSystemPrompt(opts),
         tools: opts.tools,
         maxSteps: opts.maxSteps ?? 5,
         apiKey: opts.apiKey,
@@ -29,22 +75,31 @@ export function agent(opts) {
             return {
                 id: sessionId,
                 async send(text) {
-                    history.push({ role: 'user', content: text });
+                    const requestMessages = useMemory
+                        ? [...history, { role: 'user', content: text }]
+                        : [{ role: 'user', content: text }];
                     const result = await generateText({
                         ...baseOpts,
-                        messages: [...history],
+                        messages: requestMessages,
                     });
-                    history.push({ role: 'assistant', content: result.text });
+                    if (useMemory) {
+                        history.push({ role: 'user', content: text });
+                        history.push({ role: 'assistant', content: result.text });
+                    }
                     return result;
                 },
                 stream(text) {
-                    history.push({ role: 'user', content: text });
                     const result = streamText({
                         ...baseOpts,
-                        messages: [...history],
+                        messages: useMemory
+                            ? [...history, { role: 'user', content: text }]
+                            : [{ role: 'user', content: text }],
                     });
                     // Capture text for history when done
-                    result.text.then(t => history.push({ role: 'assistant', content: t }));
+                    if (useMemory) {
+                        history.push({ role: 'user', content: text });
+                        result.text.then((replyText) => history.push({ role: 'assistant', content: replyText }));
+                    }
                     return result;
                 },
                 messages() {

package/dist/api/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,YAAY,EAAmE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAE,UAAU,EAAyB,MAAM,iBAAiB,CAAC;AAkCpE;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,IAAkB;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9C,MAAM,QAAQ,GAAiC;QAC7C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,YAAY;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;QAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,KAAoC;YACjE,OAAO,YAAY,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,MAAM,EAAyB,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,CAAC,MAAc,EAAE,KAAoC;YACzD,OAAO,UAAU,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,MAAM,EAAyB,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,CAAC,EAAW;YACjB,MAAM,SAAS,GAAG,EAAE,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YAEzC,OAAO;gBACL,EAAE,EAAE,SAAS;gBAEb,KAAK,CAAC,IAAI,CAAC,IAAY;oBACrB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC9C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;wBAChC,GAAG,QAAQ;wBACX,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC;qBACA,CAAC,CAAC;oBAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC1D,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,MAAM,CAAC,IAAY;oBACjB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC9C,MAAM,MAAM,GAAG,UAAU,CAAC;wBACxB,GAAG,QAAQ;wBACX,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC;qBACA,CAAC,CAAC;oBAC1B,qCAAqC;oBACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvE,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,QAAQ;oBACN,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;gBACtB,CAAC;gBAED,KAAK;oBACH,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBACrB,CAAC;aACF,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,KAAK;YACT,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"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"}

package/dist/api/generateImage.d.ts

@@ -0,0 +1,109 @@
+/** A single generated image with optional URL and base64 data. */
+export interface GeneratedImage {
+    url?: string;
+    b64_json?: string;
+    revised_prompt?: string;
+}
+/** Result from an image provider. */
+interface ImageGenerationResult {
+    modelId: string;
+    providerId: string;
+    created: number;
+    text?: string;
+    images: GeneratedImage[];
+    usage?: {
+        promptTokens?: number;
+        totalTokens?: number;
+    };
+}
+/** Provider-specific option bag. */
+type ImageProviderOptionBag = Record<string, unknown>;
+/** Response format: URL or base64. */
+type ImageResponseFormat = 'url' | 'b64_json';
+/** Background style. */
+type ImageBackground = 'transparent' | 'opaque' | 'auto';
+/** Image modality. */
+type ImageModality = 'image' | 'text';
+/** Output file format. */
+type ImageOutputFormat = 'png' | 'jpeg' | 'webp' | 'gif';
+/**
+ * Options for a {@link generateImage} call.
+ */
+export interface GenerateImageOptions {
+    /**
+     * Model in `provider:model` format.
+     * @example `"openai:dall-e-3"`, `"stability:stable-diffusion-xl-1024-v1-0"`
+     */
+    model: string;
+    /** Text description of the desired image. */
+    prompt: string;
+    /** Output modalities requested from the provider (provider-dependent). */
+    modalities?: ImageModality[];
+    /** Number of images to generate. Defaults to `1` for most providers. */
+    n?: number;
+    /** Pixel dimensions string, e.g. `"1024x1024"`. Provider-dependent. */
+    size?: string;
+    /** Aspect ratio string, e.g. `"16:9"`. Used by some providers instead of `size`. */
+    aspectRatio?: string;
+    /** Quality hint forwarded to the provider (e.g. `"hd"` for DALL-E 3). */
+    quality?: string;
+    /** Background style for transparent-capable providers. */
+    background?: ImageBackground;
+    /** Desired output file format (e.g. `"png"`, `"jpeg"`, `"webp"`). */
+    outputFormat?: ImageOutputFormat;
+    /** Compression level (0–100) for lossy output formats. */
+    outputCompression?: number;
+    /** Whether the provider should return a URL or base64-encoded data. */
+    responseFormat?: ImageResponseFormat;
+    /** Override the provider API key instead of reading from environment variables. */
+    apiKey?: string;
+    /** Override the provider base URL. */
+    baseUrl?: string;
+    /** Optional user identifier forwarded to the provider for moderation tracking. */
+    userId?: string;
+    /** Random seed for reproducible generation (provider-dependent support). */
+    seed?: number;
+    /** Negative prompt describing content to avoid (provider-dependent support). */
+    negativePrompt?: string;
+    /** Arbitrary provider-specific options not covered by the standard fields. */
+    providerOptions?: ImageProviderOptionBag | Record<string, unknown>;
+}
+/**
+ * The result returned by {@link generateImage}.
+ */
+export interface GenerateImageResult {
+    /** Model identifier reported by the provider. */
+    model: string;
+    /** Provider identifier (e.g. `"openai"`, `"stability"`). */
+    provider: string;
+    /** Unix timestamp (seconds) when the image was created. */
+    created: number;
+    /** Optional text response accompanying the images (provider-dependent). */
+    text?: string;
+    /** Array of generated image objects containing URLs or base64 data. */
+    images: GeneratedImage[];
+    /** Token / credit usage reported by the provider, when available. */
+    usage?: ImageGenerationResult['usage'];
+}
+/**
+ * Generates one or more images using a provider-agnostic `provider:model` string.
+ *
+ * Resolves credentials via {@link resolveMediaProvider}, initialises the matching
+ * image provider, and returns a normalised {@link GenerateImageResult}.
+ *
+ * @param opts - Image generation options including model, prompt, and optional parameters.
+ * @returns A promise resolving to the generation result with image data and metadata.
+ *
+ * @example
+ * ```ts
+ * const result = await generateImage({
+ *   model: 'openai:dall-e-3',
+ *   prompt: 'A photorealistic red panda sitting on a moonlit rooftop.',
+ *   size: '1024x1024',
+ * });
+ * console.log(result.images[0].url);
+ * ```
+ */
+export declare function generateImage(opts: GenerateImageOptions): Promise<GenerateImageResult>;
+export {};
+//# sourceMappingURL=generateImage.d.ts.map

package/dist/api/generateImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateImage.d.ts","sourceRoot":"","sources":["../../src/api/generateImage.ts"],"names":[],"mappings":"AAWA,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAAG,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5F,qCAAqC;AACrC,UAAU,qBAAqB;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE;AAC1L,oCAAoC;AACpC,KAAK,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtD,sCAAsC;AACtC,KAAK,mBAAmB,GAAG,KAAK,GAAG,UAAU,CAAC;AAC9C,wBAAwB;AACxB,KAAK,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AACzD,sBAAsB;AACtB,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AACtC,0BAA0B;AAC1B,KAAK,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,wEAAwE;IACxE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,qEAAqE;IACrE,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,qEAAqE;IACrE,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAc5F"}

package/dist/api/generateImage.js

@@ -0,0 +1,41 @@
+/**
+ * @file generateImage.ts
+ * Provider-agnostic image generation for the AgentOS high-level API.
+ *
+ * Parses a `provider:model` string, resolves media-provider credentials, and
+ * dispatches the request to the appropriate image provider implementation
+ * (e.g. OpenAI DALL-E, Stability AI, Replicate).
+ */
+import { parseModelString, resolveMediaProvider } from './model.js';
+/**
+ * Generates one or more images using a provider-agnostic `provider:model` string.
+ *
+ * Resolves credentials via {@link resolveMediaProvider}, initialises the matching
+ * image provider, and returns a normalised {@link GenerateImageResult}.
+ *
+ * @param opts - Image generation options including model, prompt, and optional parameters.
+ * @returns A promise resolving to the generation result with image data and metadata.
+ *
+ * @example
+ * ```ts
+ * const result = await generateImage({
+ *   model: 'openai:dall-e-3',
+ *   prompt: 'A photorealistic red panda sitting on a moonlit rooftop.',
+ *   size: '1024x1024',
+ * });
+ * console.log(result.images[0].url);
+ * ```
+ */
+export async function generateImage(opts) {
+    const { providerId, modelId } = parseModelString(opts.model);
+    const resolved = resolveMediaProvider(providerId, modelId, {
+        apiKey: opts.apiKey,
+        baseUrl: opts.baseUrl,
+    });
+    // TODO: Wire to core/images/ module once implemented.
+    // For now, throw a descriptive error so callers know the provider layer isn't ready.
+    throw new Error(`generateImage() is not yet wired to a provider backend. ` +
+        `Resolved: ${resolved.providerId}:${resolved.modelId}. ` +
+        `The core/images/ module needs to be implemented first.`);
+}
+//# sourceMappingURL=generateImage.js.map

package/dist/api/generateImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateImage.js","sourceRoot":"","sources":["../../src/api/generateImage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA+EpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE;QACzD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,sDAAsD;IACtD,qFAAqF;IACrF,MAAM,IAAI,KAAK,CACb,0DAA0D;QAC1D,aAAa,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,OAAO,IAAI;QACxD,wDAAwD,CACzD,CAAC;AACJ,CAAC"}

package/dist/api/generateText.d.ts

@@ -1,40 +1,110 @@
-import { type ToolDefinitionMap } from './tool-adapter.js';
+import { type ToolDefinitionMap } from './toolAdapter.js';
+/**
+ * A single chat message in a conversation history.
+ * Mirrors the OpenAI / Anthropic message shape accepted by provider adapters.
+ */
 export interface Message {
+    /** Role of the message author. */
     role: 'system' | 'user' | 'assistant' | 'tool';
+    /** Plain-text or serialised-JSON content of the message. */
     content: string;
 }
+/**
+ * Record of a single tool invocation performed during a {@link generateText} call.
+ * One record is appended per tool call, regardless of whether the call succeeded.
+ */
 export interface ToolCallRecord {
+    /** Name of the tool as registered in the `tools` map. */
     name: string;
+    /** Parsed arguments supplied by the model. */
     args: unknown;
+    /** Return value from the tool's `execute` function (present on success). */
     result?: unknown;
+    /** Error message when the tool threw or returned a failure result. */
     error?: string;
 }
+/**
+ * Token consumption figures reported by the provider for a single completion call.
+ * All values are approximate and provider-dependent.
+ */
 export interface TokenUsage {
+    /** Number of tokens in the prompt / input sent to the model. */
     promptTokens: number;
+    /** Number of tokens in the model's response. */
     completionTokens: number;
+    /** Sum of `promptTokens` and `completionTokens`. */
     totalTokens: number;
 }
+/**
+ * Options for a {@link generateText} call.
+ * Either `prompt` or `messages` (or both) must be provided.
+ */
 export interface GenerateTextOptions {
+    /**
+     * Model identifier in `provider:model` format.
+     * @example `"openai:gpt-4o"`, `"anthropic:claude-opus-4-5"`, `"ollama:llama3.2"`
+     */
     model: string;
+    /** Single user turn to append after any `messages`. Convenience alternative to building a `messages` array. */
     prompt?: string;
+    /** System prompt injected as the first message. */
     system?: string;
+    /** Full conversation history. Appended before `prompt` when both are supplied. */
     messages?: Message[];
+    /** Named tools the model may invoke. Values are {@link ToolDefinition} objects or {@link ITool} instances. */
     tools?: ToolDefinitionMap;
+    /**
+     * Maximum number of agentic steps (LLM calls) to execute before returning.
+     * Each tool-call round trip counts as one step. Defaults to `1`.
+     */
     maxSteps?: number;
+    /** Sampling temperature forwarded to the provider (0–2 for most providers). */
     temperature?: number;
+    /** Hard cap on output tokens. Provider-dependent default applies when omitted. */
     maxTokens?: number;
+    /** Override the API key instead of reading from environment variables. */
     apiKey?: string;
+    /** Override the provider base URL (useful for local proxies or Ollama). */
     baseUrl?: string;
 }
+/**
+ * The completed result returned by {@link generateText}.
+ */
 export interface GenerateTextResult {
+    /** Final assistant text after all agentic steps have completed. */
     text: string;
+    /** Aggregated token usage across all steps. */
     usage: TokenUsage;
+    /** Ordered list of every tool call made during the run. */
     toolCalls: ToolCallRecord[];
+    /**
+     * Reason the model stopped generating.
+     * - `"stop"` — natural end of response.
+     * - `"length"` — `maxTokens` limit reached.
+     * - `"tool-calls"` — loop exhausted `maxSteps` while still calling tools.
+     * - `"error"` — provider returned an error.
+     */
     finishReason: 'stop' | 'length' | 'tool-calls' | 'error';
 }
 /**
- * Stateless text generation. Creates a temporary provider, runs the LLM call,
- * and returns the complete result. Supports multi-step tool calling.
+ * Stateless text generation with optional multi-step tool calling.
+ *
+ * Creates a temporary provider manager, executes one or more LLM completion
+ * steps (each tool-call round trip counts as one step), and returns the final
+ * assembled result.  Provider credentials are resolved from environment
+ * variables unless overridden in `opts`.
+ *
+ * @param opts - Generation options including model, prompt/messages, and optional tools.
+ * @returns A promise that resolves to the final text, token usage, tool call log, and finish reason.
+ *
+ * @example
+ * ```ts
+ * const result = await generateText({
+ *   model: 'openai:gpt-4o',
+ *   prompt: 'Summarise the history of the Roman Empire in two sentences.',
+ * });
+ * console.log(result.text);
+ * ```
  */
 export declare function generateText(opts: GenerateTextOptions): Promise<GenerateTextResult>;
 //# sourceMappingURL=generateText.d.ts.map

package/dist/api/generateText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateText.d.ts","sourceRoot":"","sources":["../../src/api/generateText.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;CAC1D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyHzF"}
+{"version":3,"file":"generateText.d.ts","sourceRoot":"","sources":["../../src/api/generateText.ts"],"names":[],"mappings":"AAUA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,kCAAkC;IAClC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,+GAA+G;IAC/G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,8GAA8G;IAC9G,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,UAAU,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyHzF"}

package/dist/api/generateText.js

@@ -1,8 +1,33 @@
+/**
+ * @file generateText.ts
+ * Stateless, single-call text generation for the AgentOS high-level API.
+ *
+ * Parses a `provider:model` string, resolves credentials from environment
+ * variables or caller-supplied overrides, and invokes the provider's completion
+ * endpoint.  Multi-step tool calling is supported: the loop continues until the
+ * model produces a plain-text reply or `maxSteps` is exhausted.
+ */
 import { parseModelString, resolveProvider, createProviderManager } from './model.js';
-import { adaptTools } from './tool-adapter.js';
+import { adaptTools } from './toolAdapter.js';
 /**
- * Stateless text generation. Creates a temporary provider, runs the LLM call,
- * and returns the complete result. Supports multi-step tool calling.
+ * Stateless text generation with optional multi-step tool calling.
+ *
+ * Creates a temporary provider manager, executes one or more LLM completion
+ * steps (each tool-call round trip counts as one step), and returns the final
+ * assembled result.  Provider credentials are resolved from environment
+ * variables unless overridden in `opts`.
+ *
+ * @param opts - Generation options including model, prompt/messages, and optional tools.
+ * @returns A promise that resolves to the final text, token usage, tool call log, and finish reason.
+ *
+ * @example
+ * ```ts
+ * const result = await generateText({
+ *   model: 'openai:gpt-4o',
+ *   prompt: 'Summarise the history of the Roman Empire in two sentences.',
+ * });
+ * console.log(result.text);
+ * ```
  */
 export async function generateText(opts) {
     const { providerId, modelId } = parseModelString(opts.model);
@@ -32,7 +57,7 @@ export async function generateText(opts) {
         }))
         : undefined;
     const allToolCalls = [];
-    let totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
     const maxSteps = opts.maxSteps ?? 1;
     for (let step = 0; step < maxSteps; step++) {
         const response = await provider.generateCompletion(resolved.modelId, messages, {

package/dist/api/generateText.js.map

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