@agentuity/runtime 0.1.14 → 0.1.16

package/dist/_services.js

@@ -0,0 +1,248 @@
+import { context, SpanKind, SpanStatusCode, trace } from '@opentelemetry/api';
+import { KeyValueStorageService, StreamStorageService, VectorStorageService, StructuredError, } from '@agentuity/core';
+import { APIClient, createServerFetchAdapter, getServiceUrls } from '@agentuity/server';
+import { HTTPSandboxService } from './services/sandbox';
+import { CompositeSessionEventProvider, LocalSessionEventProvider, JSONSessionEventProvider, HTTPSessionEventProvider, } from './services/session';
+import { CompositeEvalRunEventProvider, LocalEvalRunEventProvider, JSONEvalRunEventProvider, HTTPEvalRunEventProvider, } from './services/evalrun';
+import { LocalThreadProvider } from './services/thread/local';
+import { injectTraceContextToHeaders } from './otel/http';
+import { getTracer } from './_server';
+import { populateAgentsRegistry } from './agent.js';
+import { getSDKVersion, isAuthenticated, isProduction } from './_config';
+import { DefaultSessionProvider, DefaultThreadProvider, } from './session';
+import { LocalKeyValueStorage, LocalStreamStorage, LocalVectorStorage, getLocalDB, normalizeProjectPath, createLocalStorageRouter, } from './services/local';
+const userAgent = `Agentuity SDK/${getSDKVersion()}`;
+// Lazy getters - these must be functions to read env vars AFTER bootstrapRuntimeEnv() runs
+const getSdkKey = () => process.env.AGENTUITY_SDK_KEY;
+const getBearerKey = () => `Bearer ${getSdkKey()}`;
+const getRegion = () => process.env.AGENTUITY_REGION ?? 'usc';
+const getLazyServiceUrls = () => getServiceUrls(getRegion());
+const getKvBaseUrl = () => getLazyServiceUrls().keyvalue;
+const getStreamBaseUrl = () => getLazyServiceUrls().stream;
+const getVectorBaseUrl = () => getLazyServiceUrls().vector;
+const getCatalystBaseUrl = () => getLazyServiceUrls().catalyst;
+let adapter;
+const createFetchAdapter = (logger) => createServerFetchAdapter({
+    headers: {
+        Authorization: getBearerKey(),
+        'User-Agent': userAgent,
+    },
+    onBefore: async (url, options, callback) => {
+        logger.debug('before request: %s with options: %s', url, options);
+        if (!options.telemetry) {
+            return callback();
+        }
+        options.headers = { ...options.headers, ...injectTraceContextToHeaders() };
+        const tracer = getTracer() ?? trace.getTracer('agentuity');
+        const currentContext = context.active();
+        const span = tracer.startSpan(options.telemetry.name, { attributes: options.telemetry.attributes, kind: SpanKind.CLIENT }, currentContext);
+        const spanContext = trace.setSpan(currentContext, span);
+        try {
+            await context.with(spanContext, callback);
+            span.setStatus({ code: SpanStatusCode.OK });
+        }
+        catch (err) {
+            const e = err;
+            span.recordException(e);
+            span.setStatus({ code: SpanStatusCode.ERROR, message: e?.message ?? String(err) });
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    },
+    onAfter: async (url, options, result, err) => {
+        logger.debug('after request: %s (%d) => %s', url, result.response.status, err);
+        if (err) {
+            return;
+        }
+        const span = trace.getSpan(context.active());
+        switch (options.telemetry?.name) {
+            case 'agentuity.keyvalue.get': {
+                if (result.response.status === 404) {
+                    span?.addEvent('miss');
+                }
+                else if (result.response.ok) {
+                    span?.addEvent('hit');
+                }
+                break;
+            }
+            case 'agentuity.stream.create': {
+                if (result.response.ok) {
+                    const res = result.data;
+                    span?.setAttributes({
+                        'stream.id': res.id,
+                        'stream.url': `${getStreamBaseUrl()}/${res.id}`,
+                    });
+                }
+                break;
+            }
+            case 'agentuity.stream.list': {
+                const response = result.data;
+                if (response && span) {
+                    span.setAttributes({
+                        'stream.count': response.streams.length,
+                        'stream.total': response.total,
+                    });
+                }
+                break;
+            }
+            case 'agentuity.vector.upsert': {
+                if (result.response.ok) {
+                    const data = result.data;
+                    span?.setAttributes({
+                        'vector.count': data.length,
+                    });
+                }
+                break;
+            }
+            case 'agentuity.vector.search': {
+                if (result.response.ok) {
+                    const data = result.data;
+                    span?.setAttributes({
+                        'vector.results': data.length,
+                    });
+                }
+                break;
+            }
+            case 'agentuity.vector.get': {
+                if (result.response.status === 404) {
+                    span?.addEvent('miss');
+                }
+                else if (result.response.ok) {
+                    span?.addEvent('hit');
+                }
+                break;
+            }
+        }
+    },
+}, logger);
+let kv;
+let stream;
+let vector;
+let sandbox;
+let session;
+let thread;
+let sessionEvent;
+let evalRunEvent;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let localRouter = null;
+const ServerUrlMissingError = StructuredError('ServerUrlMissingError', 'serverUrl is required when using local services');
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function createServices(logger, config, serverUrl) {
+    const authenticated = isAuthenticated();
+    const useLocal = config?.services?.useLocal ?? false;
+    adapter = createFetchAdapter(logger);
+    // Use local services if explicitly requested OR if not authenticated
+    const shouldUseLocal = useLocal || !authenticated || process.env.AGENTUITY_FORCE_LOCAL_SERVICES === 'true';
+    if (shouldUseLocal) {
+        const db = getLocalDB();
+        const projectPath = normalizeProjectPath();
+        if (!serverUrl) {
+            throw new ServerUrlMissingError();
+        }
+        logger.info('Using local services (development only)');
+        kv = config?.services?.keyvalue || new LocalKeyValueStorage(db, projectPath);
+        stream = config?.services?.stream || new LocalStreamStorage(db, projectPath, serverUrl);
+        vector = config?.services?.vector || new LocalVectorStorage(db, projectPath);
+        session = config?.services?.session || new DefaultSessionProvider();
+        thread = config?.services?.thread || new LocalThreadProvider();
+        sessionEvent = config?.services?.sessionEvent
+            ? new CompositeSessionEventProvider(new LocalSessionEventProvider(), config.services.sessionEvent)
+            : new LocalSessionEventProvider();
+        evalRunEvent = config?.services?.evalRunEvent
+            ? new CompositeEvalRunEventProvider(new LocalEvalRunEventProvider(), config.services.evalRunEvent)
+            : new LocalEvalRunEventProvider();
+        localRouter = createLocalStorageRouter(db, projectPath);
+        return { localRouter };
+    }
+    // Reset local router if not using local services
+    localRouter = null;
+    // At this point we must be authenticated (since !authenticated would trigger local services above)
+    const catalystUrl = getCatalystBaseUrl();
+    const streamBaseUrl = getStreamBaseUrl();
+    kv = config?.services?.keyvalue || new KeyValueStorageService(getKvBaseUrl(), adapter);
+    stream = config?.services?.stream || new StreamStorageService(streamBaseUrl, adapter);
+    vector = config?.services?.vector || new VectorStorageService(getVectorBaseUrl(), adapter);
+    sandbox = new HTTPSandboxService(new APIClient(catalystUrl, logger), streamBaseUrl);
+    session = config?.services?.session || new DefaultSessionProvider();
+    thread = config?.services?.thread || new DefaultThreadProvider();
+    // FIXME: this is turned off for now for production until we have the new changes deployed
+    sessionEvent =
+        isProduction() && process.env.AGENTUITY_CLOUD_EXPORT_DIR
+            ? new JSONSessionEventProvider(process.env.AGENTUITY_CLOUD_EXPORT_DIR)
+            : new HTTPSessionEventProvider(new APIClient(catalystUrl, logger), logger);
+    if (config?.services?.sessionEvent) {
+        sessionEvent = new CompositeSessionEventProvider(sessionEvent, config.services.sessionEvent);
+    }
+    // FIXME: this is turned off for now for production until we have the new changes deployed
+    logger.debug('[SERVICES] Initializing eval run provider - region: %s, catalystBaseUrl: %s, isProduction: %s', getRegion(), catalystUrl, isProduction());
+    evalRunEvent =
+        isProduction() && process.env.AGENTUITY_CLOUD_EXPORT_DIR
+            ? new JSONEvalRunEventProvider(process.env.AGENTUITY_CLOUD_EXPORT_DIR)
+            : new HTTPEvalRunEventProvider(new APIClient(catalystUrl, logger), logger, catalystUrl);
+    if (config?.services?.evalRunEvent) {
+        evalRunEvent = new CompositeEvalRunEventProvider(evalRunEvent, config.services.evalRunEvent);
+    }
+    return {};
+}
+export function getThreadProvider() {
+    return thread;
+}
+export function getSessionProvider() {
+    return session;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getLocalRouter() {
+    return localRouter;
+}
+export function getSessionEventProvider() {
+    return sessionEvent;
+}
+export function getEvalRunEventProvider() {
+    return evalRunEvent;
+}
+export function getServices() {
+    return { kv, stream, vector, sandbox };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function registerServices(o, includeAgents = false) {
+    Object.defineProperty(o, 'kv', {
+        get: () => kv,
+        enumerable: false,
+        configurable: false,
+    });
+    Object.defineProperty(o, 'stream', {
+        get: () => stream,
+        enumerable: false,
+        configurable: false,
+    });
+    Object.defineProperty(o, 'vector', {
+        get: () => vector,
+        enumerable: false,
+        configurable: false,
+    });
+    Object.defineProperty(o, 'sandbox', {
+        get: () => sandbox,
+        enumerable: false,
+        configurable: false,
+    });
+    // Also register agent registry if requested
+    if (includeAgents) {
+        // Cache the populated registry to avoid re-creating on every access
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let cachedRegistry;
+        Object.defineProperty(o, 'agent', {
+            get: () => {
+                if (!cachedRegistry) {
+                    // ESM-friendly: populateAgentsRegistry is imported statically
+                    cachedRegistry = populateAgentsRegistry(o);
+                }
+                return cachedRegistry;
+            },
+            enumerable: false,
+            configurable: false,
+        });
+    }
+}
+//# sourceMappingURL=_services.js.map

package/dist/_services.js.map

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

package/dist/_standalone.d.ts

@@ -0,0 +1,208 @@
+import { type Context } from '@opentelemetry/api';
+import type { KeyValueStorage, StreamStorage, VectorStorage, SandboxService, Logger } from '@agentuity/core';
+import type { AgentContext, AgentRegistry, AgentRuntimeState, AgentMetadata, AgentRunner } from './agent';
+import { AGENT_RUNTIME, AGENT_IDS } from './_config';
+import type { Thread, Session } from './session';
+/**
+ * Options for creating a standalone agent context.
+ *
+ * Use this when executing agents outside of HTTP requests (Discord bots, cron jobs, etc.)
+ */
+export interface StandaloneContextOptions {
+    /**
+     * Session ID for this execution. If not provided, will be auto-generated from trace context.
+     */
+    sessionId?: string;
+    /**
+     * Thread for multi-turn conversations. If not provided, will be restored/created from thread provider.
+     */
+    thread?: Thread;
+    /**
+     * Session for this execution. If not provided, will be created.
+     */
+    session?: Session;
+    /**
+     * Parent OpenTelemetry context for distributed tracing.
+     */
+    parentContext?: Context;
+    /**
+     * Trigger type for this execution (used in telemetry and session events).
+     */
+    trigger?: import('@agentuity/core').SessionStartEvent['trigger'];
+}
+/**
+ * Options for invoke() method.
+ */
+export interface InvokeOptions {
+    /**
+     * Span name for OpenTelemetry trace (default: 'agent-invocation')
+     */
+    spanName?: string;
+}
+/**
+ * Standalone agent context for executing agents outside of HTTP requests.
+ *
+ * This context provides the same infrastructure as HTTP request contexts:
+ * - OpenTelemetry tracing with proper span hierarchy
+ * - Session and thread management (save/restore)
+ * - Background task handling (waitUntil)
+ * - Session event tracking (start/complete)
+ * - Access to all services (kv, stream, vector)
+ *
+ * @example
+ * ```typescript
+ * import { createAgentContext } from '@agentuity/runtime';
+ * import myAgent from './agents/my-agent';
+ *
+ * // Simple usage:
+ * const ctx = createAgentContext();
+ * const result = await ctx.invoke(() => myAgent.run(input));
+ *
+ * // With custom session tracking:
+ * const ctx = createAgentContext({
+ *   sessionId: discordMessage.id,
+ *   trigger: 'discord'
+ * });
+ * const result = await ctx.invoke(() => myAgent.run(input));
+ *
+ * // Reuse context for multiple agents:
+ * const ctx = createAgentContext();
+ * const result1 = await ctx.invoke(() => agent1.run(input1));
+ * const result2 = await ctx.invoke(() => agent2.run(result1));
+ * ```
+ */
+export declare class StandaloneAgentContext<TAgentMap extends AgentRegistry = AgentRegistry, TConfig = unknown, TAppState = Record<string, never>> implements AgentContext<TAgentMap, TConfig, TAppState> {
+    agent: TAgentMap;
+    logger: Logger;
+    tracer: import('@opentelemetry/api').Tracer;
+    kv: KeyValueStorage;
+    stream: StreamStorage;
+    vector: VectorStorage;
+    sandbox: SandboxService;
+    config: TConfig;
+    app: TAppState;
+    current: AgentMetadata;
+    [AGENT_RUNTIME]: AgentRuntimeState;
+    sessionId: string;
+    state: Map<string, unknown>;
+    session: Session;
+    thread: Thread;
+    auth: import('@agentuity/auth/types').AuthInterface | null;
+    [AGENT_IDS]?: Set<string>;
+    private readonly parentContext;
+    private readonly trigger;
+    private readonly initialSessionId?;
+    constructor(options?: StandaloneContextOptions);
+    waitUntil(_callback: Promise<void> | (() => void | Promise<void>)): void;
+    /**
+     * Execute a function within this agent context.
+     *
+     * This method:
+     * 1. Creates an OpenTelemetry span for the invocation
+     * 2. Restores/creates session and thread
+     * 3. Sends session start event
+     * 4. Executes the function within AsyncLocalStorage context
+     * 5. Waits for background tasks (waitUntil)
+     * 6. Saves session and thread
+     * 7. Sends session complete event
+     *
+     * @param fn - Function to execute (typically () => agent.run(input))
+     * @param options - Optional configuration for the invocation
+     * @returns Promise that resolves to the function's return value
+     *
+     * @example
+     * ```typescript
+     * const result = await ctx.invoke(() => myAgent.run({ userId: '123' }));
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Multiple agents in sequence:
+     * const result = await ctx.invoke(async () => {
+     *   const step1 = await agent1.run(input);
+     *   return agent2.run(step1);
+     * });
+     * ```
+     */
+    invoke<T>(fn: () => Promise<T>, options?: InvokeOptions): Promise<T>;
+    /**
+     * Execute an agent with the given input within this context.
+     *
+     * This is a convenience method that wraps `invoke()` for cleaner syntax
+     * when running a single agent.
+     *
+     * @param agent - The agent to execute (must have a `run` method)
+     * @param input - Input to pass to the agent (if agent requires input)
+     * @returns Promise that resolves to the agent's output
+     *
+     * @example
+     * ```typescript
+     * import { createAgentContext } from '@agentuity/runtime';
+     * import myAgent from './agents/my-agent';
+     *
+     * const ctx = createAgentContext();
+     * const result = await ctx.run(myAgent, { name: 'World' });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Agent without input
+     * const result = await ctx.run(statusAgent);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Multiple agents in sequence
+     * const ctx = createAgentContext();
+     * const step1 = await ctx.run(preprocessAgent, rawData);
+     * const step2 = await ctx.run(processAgent, step1);
+     * const result = await ctx.run(postprocessAgent, step2);
+     * ```
+     */
+    run<TOutput>(agent: AgentRunner<any, any, any>, input?: unknown): Promise<TOutput>;
+}
+/**
+ * Create a standalone agent context for executing agents outside of HTTP requests.
+ *
+ * This is useful for Discord bots, cron jobs, CLI scripts, sandboxes, or any scenario
+ * where you need to run agents but don't have an HTTP request context.
+ *
+ * **Auto-initialization**: When running outside of the Agentuity runtime (dev server or cloud),
+ * this function automatically initializes minimal runtime globals. No manual setup required.
+ *
+ * @param options - Optional configuration for the context
+ * @returns A StandaloneAgentContext instance
+ *
+ * @example
+ * ```typescript
+ * import { createAgentContext } from '@agentuity/runtime';
+ * import myAgent from './agents/my-agent';
+ *
+ * // Simple usage with ctx.run() (recommended):
+ * const ctx = createAgentContext();
+ * const result = await ctx.run(myAgent, { name: 'World' });
+ *
+ * // Discord bot example:
+ * client.on('messageCreate', async (message) => {
+ *   const ctx = createAgentContext({
+ *     sessionId: message.id,
+ *     trigger: 'discord'
+ *   });
+ *   const response = await ctx.run(chatAgent, { message: message.content });
+ *   await message.reply(response.text);
+ * });
+ *
+ * // Cron job example:
+ * cron.schedule('0 * * * *', async () => {
+ *   const ctx = createAgentContext({ trigger: 'cron' });
+ *   await ctx.run(cleanupAgent);
+ * });
+ *
+ * // Multiple agents in sequence:
+ * const ctx = createAgentContext();
+ * const step1 = await ctx.run(preprocessAgent, rawData);
+ * const result = await ctx.run(processAgent, step1);
+ * ```
+ */
+export declare function createAgentContext<TAppState = Record<string, never>>(options?: StandaloneContextOptions): StandaloneAgentContext<AgentRegistry, unknown, TAppState>;
+//# sourceMappingURL=_standalone.d.ts.map

package/dist/_standalone.d.ts.map

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