@rcrsr/rill-agent-foundry 0.18.4

package/dist/harness.js

@@ -0,0 +1,481 @@
+import { Hono } from 'hono';
+import { serve } from '@hono/node-server';
+import { SpanStatusCode } from '@opentelemetry/api';
+import { DefaultAzureCredential } from '@azure/identity';
+import { CapacityError, CredentialError, InputError } from './errors.js';
+import { extractInput } from './extract.js';
+import { createIdGenerator, generateId } from './id.js';
+import { buildErrorResponse, buildSyncResponse } from './response.js';
+import { createSessionManager } from './session.js';
+import { createFoundryStreamResponse } from './stream.js';
+import { createConversationsClient, PersistenceError, } from './conversations.js';
+import { getTracer, initTelemetry, shutdownTelemetry } from './telemetry.js';
+// ============================================================
+// PARAM VALIDATION
+// ============================================================
+/**
+ * Validate extracted params against the handler description for a named agent.
+ * Returns a string describing the first violation, or null when valid.
+ * Returns null when describe() returns null (no description available).
+ */
+function validateParams(params, agentName, router) {
+    const desc = router.describe(agentName);
+    if (desc === null)
+        return null;
+    for (const param of desc.params) {
+        const value = params[param.name];
+        if (param.required && (value === undefined || value === null)) {
+            return `Missing required parameter: ${param.name}`;
+        }
+        if (value !== undefined && value !== null && param.type !== 'any') {
+            const actual = typeof value;
+            const expected = param.type === 'dict' ? 'object' : param.type;
+            if (expected === 'list') {
+                if (!Array.isArray(value)) {
+                    return `Parameter "${param.name}" must be a list, got ${actual}`;
+                }
+            }
+            else if (expected === 'object') {
+                if (actual !== 'object' || value === null || Array.isArray(value)) {
+                    return `Parameter "${param.name}" must be a dict, got ${Array.isArray(value) ? 'list' : actual}`;
+                }
+            }
+            else if (actual !== expected) {
+                return `Parameter "${param.name}" must be ${param.type}, got ${actual}`;
+            }
+        }
+    }
+    return null;
+}
+// ============================================================
+// DEFAULTS
+// ============================================================
+const DEFAULT_PORT = 8088;
+// ============================================================
+// HELPERS
+// ============================================================
+/**
+ * Resolve the port from options or DEFAULT_AD_PORT env var.
+ * Throws when the env var value is non-numeric.
+ */
+function resolvePort(options) {
+    if (options?.port !== undefined) {
+        if (!Number.isFinite(options.port)) {
+            throw new Error(`Invalid port: "${options.port}"`);
+        }
+        return options.port;
+    }
+    const envVal = process.env['DEFAULT_AD_PORT'];
+    if (envVal === undefined) {
+        return DEFAULT_PORT;
+    }
+    const parsed = Number(envVal);
+    if (!Number.isFinite(parsed) || envVal.trim() === '') {
+        throw new Error(`Invalid port: "${envVal}"`);
+    }
+    return parsed;
+}
+/**
+ * Resolve the conversationId from the request body field.
+ * Accepts string or {id: string} object.
+ */
+function resolveConversationId(conversation) {
+    if (conversation === undefined) {
+        return undefined;
+    }
+    if (typeof conversation === 'string') {
+        return conversation;
+    }
+    return conversation.id;
+}
+// ============================================================
+// FACTORY
+// ============================================================
+/**
+ * Create a Foundry harness wrapping an AgentRouter.
+ *
+ * Routes:
+ *   POST /responses  — main Foundry Responses endpoint
+ *   POST /runs       — alias for /responses
+ *   GET  /readiness  — 503 before init, 200 after
+ *   GET  /liveness   — always 200
+ *   GET  /metrics    — FoundryMetrics JSON
+ */
+export function createFoundryHarness(router, options) {
+    const port = resolvePort(options);
+    const debugErrors = options?.debugErrors ??
+        process.env['FOUNDRY_AGENT_DEBUG_ERRORS'] === 'true';
+    const forceSync = options?.forceSync ?? process.env['FOUNDRY_AGENT_FORCE_SYNC'] === 'true';
+    const agentName = options?.agentName ?? process.env['FOUNDRY_AGENT_NAME'];
+    const agentVersion = options?.agentVersion ?? process.env['FOUNDRY_AGENT_VERSION'];
+    initTelemetry({
+        agentName: agentName ?? router.defaultAgent(),
+        agentVersion,
+    });
+    const sessions = createSessionManager();
+    const projectEndpoint = process.env['FOUNDRY_PROJECT_ENDPOINT'];
+    const azureCredential = projectEndpoint !== undefined ? new DefaultAzureCredential() : undefined;
+    const conversationsClient = projectEndpoint !== undefined && azureCredential !== undefined
+        ? createConversationsClient(projectEndpoint, azureCredential)
+        : undefined;
+    let totalRequests = 0;
+    let errorCount = 0;
+    let server;
+    let ready = false;
+    const app = new Hono();
+    // ============================================================
+    // MIDDLEWARE — agent metadata header
+    // ============================================================
+    const metadataHeader = JSON.stringify({
+        package: {
+            name: 'azure-ai-agentserver-core',
+            version: '1.0.0b17',
+        },
+        runtime: {
+            python_version: '3.11.0',
+            platform: 'Linux',
+            host_name: '',
+            replica_name: '',
+        },
+    });
+    app.use('*', async (c, next) => {
+        await next();
+        c.res.headers.set('x-aml-foundry-agents-metadata', metadataHeader);
+    });
+    // ============================================================
+    // PROBE ROUTES
+    // ============================================================
+    app.get('/liveness', (c) => {
+        totalRequests++;
+        return c.json({ status: 'ok' }, 200);
+    });
+    app.get('/readiness', (c) => {
+        totalRequests++;
+        if (!ready) {
+            errorCount++;
+            return c.json({ status: 'initializing' }, 503);
+        }
+        return c.json({ status: 'ready' }, 200);
+    });
+    app.get('/metrics', (c) => {
+        totalRequests++;
+        return c.json({
+            activeSessions: sessions.activeCount(),
+            totalRequests,
+            errorCount,
+        });
+    });
+    // ============================================================
+    // RESPONSE HANDLER
+    // ============================================================
+    async function handleResponseRequest(c) {
+        totalRequests++;
+        // Parse body
+        let body;
+        try {
+            const parsed = await c.req.json();
+            if (parsed === null ||
+                typeof parsed !== 'object' ||
+                Array.isArray(parsed)) {
+                errorCount++;
+                return c.json(buildErrorResponse('INVALID_REQUEST', 'Request body must be a JSON object', debugErrors), 400);
+            }
+            body = parsed;
+        }
+        catch {
+            errorCount++;
+            return c.json(buildErrorResponse('INVALID_REQUEST', 'Invalid JSON in request body', debugErrors), 400);
+        }
+        // Extract input
+        let extracted;
+        try {
+            extracted = extractInput(body.input);
+        }
+        catch (err) {
+            errorCount++;
+            if (err instanceof InputError) {
+                return c.json(buildErrorResponse('INVALID_REQUEST', err.message, debugErrors), 400);
+            }
+            return c.json(buildErrorResponse('SERVER_ERROR', err instanceof Error ? err.message : String(err), debugErrors), 500);
+        }
+        // Resolve conversation ID
+        const conversationId = resolveConversationId(body.conversation);
+        // Resolve agent name early so validation can use it
+        const agentName_ = extracted.targetAgent ?? router.defaultAgent();
+        // Validate params against handler description.
+        const validationError = validateParams(extracted.params, agentName_, router);
+        if (validationError !== null) {
+            errorCount++;
+            return c.json(buildErrorResponse('INVALID_REQUEST', validationError, debugErrors), 400);
+        }
+        // Acquire session
+        let sessionId;
+        try {
+            sessionId = sessions.acquire(conversationId);
+        }
+        catch (err) {
+            errorCount++;
+            if (err instanceof CapacityError) {
+                return c.json(buildErrorResponse('RATE_LIMITED', err.message, debugErrors), 429);
+            }
+            return c.json(buildErrorResponse('SERVER_ERROR', err instanceof Error ? err.message : String(err), debugErrors), 500);
+        }
+        // Use response_id from request metadata (assigned by Foundry gateway)
+        // or generate one for direct/test callers.
+        const idGen = createIdGenerator(body.metadata?.['response_id'], conversationId);
+        const responseId = idGen.responseId;
+        // Session and invocation IDs for sidecar stream correlation.
+        const invocationId = c.req.header('x-agent-invocation-id') ?? generateId('inv_');
+        const agentSessionId = c.req.query('session') ?? c.req.header('x-agent-session-id') ?? sessionId;
+        // Build session vars from headers + body fields.
+        const sessionVars = {};
+        const oid = c.req.header('x-aml-oid');
+        if (oid !== undefined)
+            sessionVars['AZURE_OID'] = oid;
+        const tid = c.req.header('x-aml-tid');
+        if (tid !== undefined)
+            sessionVars['AZURE_TID'] = tid;
+        if (typeof body.user === 'string')
+            sessionVars['FOUNDRY_USER'] = body.user;
+        if (typeof body.model === 'string')
+            sessionVars['FOUNDRY_MODEL'] = body.model;
+        if (typeof body.temperature === 'number')
+            sessionVars['FOUNDRY_TEMPERATURE'] = String(body.temperature);
+        const runContext = {
+            sessionVars,
+        };
+        const runRequest = {
+            params: extracted.params,
+        };
+        // Streaming path.
+        if (body.stream === true && !forceSync) {
+            const tracer = getTracer();
+            const span = tracer.startSpan('foundry.agent.run', {
+                attributes: {
+                    'foundry.agent.name': agentName_,
+                    'foundry.response_id': responseId,
+                    'foundry.stream': true,
+                },
+            });
+            // Build a push-based async iterable: the handler calls onChunk
+            // for each stream chunk, which pushes into a buffer consumed by
+            // the SSE writer.
+            let pushChunk;
+            let endChunks;
+            let failChunks;
+            const chunkBuffer = [];
+            let done = false;
+            let waiting;
+            pushChunk = (chunk) => {
+                if (waiting !== undefined) {
+                    const resolve = waiting;
+                    waiting = undefined;
+                    resolve({ value: chunk, done: false });
+                }
+                else {
+                    chunkBuffer.push(chunk);
+                }
+            };
+            endChunks = () => {
+                done = true;
+                if (waiting !== undefined) {
+                    const resolve = waiting;
+                    waiting = undefined;
+                    resolve({ value: undefined, done: true });
+                }
+            };
+            let pendingError;
+            let rejectWaiting;
+            failChunks = (err) => {
+                pendingError = err;
+                done = true;
+                if (rejectWaiting !== undefined) {
+                    const reject = rejectWaiting;
+                    rejectWaiting = undefined;
+                    waiting = undefined;
+                    reject(err);
+                }
+            };
+            const chunks = {
+                [Symbol.asyncIterator]() {
+                    return {
+                        next() {
+                            if (chunkBuffer.length > 0) {
+                                return Promise.resolve({
+                                    value: chunkBuffer.shift(),
+                                    done: false,
+                                });
+                            }
+                            if (done) {
+                                if (pendingError !== undefined) {
+                                    return Promise.reject(pendingError);
+                                }
+                                return Promise.resolve({
+                                    value: undefined,
+                                    done: true,
+                                });
+                            }
+                            return new Promise((resolve, reject) => {
+                                waiting = resolve;
+                                rejectWaiting = reject;
+                            });
+                        },
+                    };
+                },
+            };
+            // The onChunk callback converts handler chunks to strings and
+            // pushes them into the async iterable consumed by the SSE stream.
+            const onChunk = async (chunk) => {
+                const text = typeof chunk === 'string' ? chunk : JSON.stringify(chunk);
+                pushChunk(text);
+            };
+            const streamContext = { ...runContext, onChunk };
+            // Start the agent run. When it completes (or errors), signal the
+            // chunk iterable so the SSE stream can finalize.
+            router
+                .run(agentName_, runRequest, streamContext)
+                .then((result) => {
+                span.setAttribute('foundry.agent.state', result.state);
+                span.end();
+                sessions.release(sessionId);
+                // If the handler did not stream (no onChunk support), emit
+                // the flat result as a single chunk.
+                if (!result.streamed) {
+                    if (result.result !== null && result.result !== undefined) {
+                        const text = typeof result.result === 'string'
+                            ? result.result
+                            : JSON.stringify(result.result);
+                        if (text !== '')
+                            pushChunk(text);
+                    }
+                }
+                endChunks();
+            })
+                .catch((err) => {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                span.end();
+                sessions.release(sessionId);
+                failChunks(err);
+            });
+            return createFoundryStreamResponse(responseId, {
+                chunks,
+                idGenerator: idGen,
+                onError: (_err) => {
+                    errorCount++;
+                },
+                sessionId: agentSessionId,
+                invocationId,
+                metadataHeader,
+                debugErrors,
+            });
+        }
+        // Synchronous path
+        try {
+            let result;
+            const tracer = getTracer();
+            const span = tracer.startSpan('foundry.agent.run', {
+                attributes: {
+                    'foundry.agent.name': agentName_,
+                    'foundry.response_id': responseId,
+                    'foundry.stream': false,
+                },
+            });
+            try {
+                result = await router.run(agentName_, runRequest, runContext);
+                span.setAttribute('foundry.agent.state', result.state);
+            }
+            catch (err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                span.end();
+                errorCount++;
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes('not found')) {
+                    return c.json(buildErrorResponse('NOT_FOUND', msg, debugErrors), 404);
+                }
+                return c.json(buildErrorResponse('SERVER_ERROR', msg, debugErrors), 500);
+            }
+            span.end();
+            const response = buildSyncResponse(result, responseId);
+            // Conversations persistence.
+            const shouldStore = body.store === true;
+            if (shouldStore &&
+                conversationId !== undefined &&
+                conversationsClient !== undefined) {
+                try {
+                    await conversationsClient.saveItems(conversationId, response.output);
+                }
+                catch (err) {
+                    errorCount++;
+                    if (err instanceof PersistenceError) {
+                        return c.json(buildErrorResponse('SERVER_ERROR', err.message, debugErrors), 502);
+                    }
+                    return c.json(buildErrorResponse('SERVER_ERROR', err instanceof Error ? err.message : String(err), debugErrors), 502);
+                }
+            }
+            if (result.state === 'error') {
+                errorCount++;
+            }
+            return c.json(response, 200);
+        }
+        finally {
+            sessions.release(sessionId);
+        }
+    }
+    app.post('/responses', (c) => handleResponseRequest(c));
+    app.post('/runs', (c) => handleResponseRequest(c));
+    // Mark router as ready after routes are registered
+    ready = true;
+    // ============================================================
+    // LIFECYCLE
+    // ============================================================
+    async function listen() {
+        if (azureCredential !== undefined) {
+            try {
+                const token = await azureCredential.getToken('https://ai.azure.com/.default');
+                if (token === null) {
+                    throw new CredentialError('Failed to acquire token for scope https://ai.azure.com/.default');
+                }
+            }
+            catch (err) {
+                if (!(err instanceof CredentialError)) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    throw new CredentialError(message);
+                }
+                process.exit(1);
+            }
+        }
+        return new Promise((resolve) => {
+            server = serve({ fetch: app.fetch, port }, () => {
+                resolve();
+            });
+            // Disable server timeouts for long-running SSE streams.
+            const srv = server;
+            srv['requestTimeout'] = 0;
+            srv['headersTimeout'] = 0;
+            srv['keepAliveTimeout'] = 0;
+            srv['timeout'] = 0;
+        });
+    }
+    async function close() {
+        if (server !== undefined) {
+            server.close();
+            server = undefined;
+        }
+        await shutdownTelemetry();
+    }
+    function metrics() {
+        return {
+            activeSessions: sessions.activeCount(),
+            totalRequests,
+            errorCount,
+        };
+    }
+    return { listen, close, app, metrics };
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

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

package/dist/id.d.ts

@@ -0,0 +1,26 @@
+export interface IdGenerator {
+    readonly responseId: string;
+    generateMessageId(): string;
+    generateFunctionCallId(): string;
+    generateFunctionOutputId(): string;
+}
+/**
+ * Create an IdGenerator scoped to a single request.
+ *
+ * Partition key extraction priority:
+ *   1. conversationId (preferred for conversation-scoped routing)
+ *   2. responseId (fallback for response-scoped routing)
+ *   3. random 18-char key when neither has a valid format
+ *
+ * If responseId is not provided, one is generated with prefix `resp`.
+ */
+export declare function createIdGenerator(responseId?: string | undefined, conversationId?: string | undefined): IdGenerator;
+/**
+ * Generate a prefixed random ID using crypto-secure entropy.
+ * Format: {prefix}{32 alphanumeric chars}
+ *
+ * Kept for backward compatibility with callers that do not need
+ * partition-key correlation.
+ */
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iBAAiB,IAAI,MAAM,CAAC;IAC5B,sBAAsB,IAAI,MAAM,CAAC;IACjC,wBAAwB,IAAI,MAAM,CAAC;CACpC;AAkDD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,EAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,GAClC,WAAW,CAgBb;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/id.js

@@ -0,0 +1,83 @@
+import { randomBytes } from 'node:crypto';
+// ============================================================
+// HELPERS
+// ============================================================
+const PARTITION_KEY_LENGTH = 18;
+const ENTROPY_LENGTH = 32;
+/**
+ * Generate entropy of the given length using crypto-secure random bytes.
+ * Base64-encodes the bytes and filters to alphanumeric only [A-Za-z0-9].
+ * Retries until enough characters are collected.
+ */
+function generateEntropy(length) {
+    let result = '';
+    while (result.length < length) {
+        const bytes = randomBytes(Math.ceil(length * 1.5));
+        result += bytes.toString('base64').replace(/[^A-Za-z0-9]/g, '');
+    }
+    return result.slice(0, length);
+}
+/**
+ * Extract an 18-character partition key from a prefixed ID string.
+ * The partition key is taken from the first 18 characters of the segment
+ * after the first underscore. Returns null when the ID lacks the expected
+ * format (no underscore or insufficient characters after it).
+ */
+function extractPartitionKey(id) {
+    const underscoreIdx = id.indexOf('_');
+    if (underscoreIdx === -1)
+        return null;
+    const segment = id.slice(underscoreIdx + 1);
+    if (segment.length < PARTITION_KEY_LENGTH)
+        return null;
+    return segment.slice(0, PARTITION_KEY_LENGTH);
+}
+/**
+ * Produce a compliant Foundry ID.
+ * Format: {prefix}_{partitionKey}{entropy}
+ */
+function buildId(prefix, partitionKey) {
+    const entropy = generateEntropy(ENTROPY_LENGTH);
+    return `${prefix}_${partitionKey}${entropy}`;
+}
+// ============================================================
+// FACTORY
+// ============================================================
+/**
+ * Create an IdGenerator scoped to a single request.
+ *
+ * Partition key extraction priority:
+ *   1. conversationId (preferred for conversation-scoped routing)
+ *   2. responseId (fallback for response-scoped routing)
+ *   3. random 18-char key when neither has a valid format
+ *
+ * If responseId is not provided, one is generated with prefix `resp`.
+ */
+export function createIdGenerator(responseId, conversationId) {
+    const partitionKey = (conversationId !== undefined
+        ? extractPartitionKey(conversationId)
+        : null) ??
+        (responseId !== undefined ? extractPartitionKey(responseId) : null) ??
+        generateEntropy(PARTITION_KEY_LENGTH);
+    const resolvedResponseId = responseId ?? buildId('resp', partitionKey);
+    return {
+        responseId: resolvedResponseId,
+        generateMessageId: () => buildId('msg', partitionKey),
+        generateFunctionCallId: () => buildId('func', partitionKey),
+        generateFunctionOutputId: () => buildId('funcout', partitionKey),
+    };
+}
+// ============================================================
+// BACKWARD COMPAT
+// ============================================================
+/**
+ * Generate a prefixed random ID using crypto-secure entropy.
+ * Format: {prefix}{32 alphanumeric chars}
+ *
+ * Kept for backward compatibility with callers that do not need
+ * partition-key correlation.
+ */
+export function generateId(prefix) {
+    return prefix + generateEntropy(ENTROPY_LENGTH);
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa1C,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,EAAU;IACrC,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,aAAa,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,oBAAoB;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,MAAc,EAAE,YAAoB;IACnD,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IAChD,OAAO,GAAG,MAAM,IAAI,YAAY,GAAG,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA+B,EAC/B,cAAmC;IAEnC,MAAM,YAAY,GAChB,CAAC,cAAc,KAAK,SAAS;QAC3B,CAAC,CAAC,mBAAmB,CAAC,cAAc,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC;QACT,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAExC,MAAM,kBAAkB,GAAG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEvE,OAAO;QACL,UAAU,EAAE,kBAAkB;QAC9B,iBAAiB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC;QACrD,sBAAsB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC;QAC3D,wBAAwB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { ContentPart, CreateResponse, ErrorResponse, FoundryHarnessOptions, FoundryMetrics, FoundryResponse, FoundryToolDefinition, InputItem, FunctionCallItem, FunctionCallOutputItem, JSONSchemaObject, JSONSchemaProperty, OutputContentPart, OutputItem, StreamErrorEvent, ToolDefinition, UserMessageItem, } from './types.js';
+export { CapacityError, CredentialError, InputError } from './errors.js';
+export type { IdGenerator } from './id.js';
+export { createIdGenerator, generateId } from './id.js';
+export type { ExtractedInput } from './extract.js';
+export { extractInput } from './extract.js';
+export type { SessionManager } from './session.js';
+export { createSessionManager } from './session.js';
+export { buildErrorResponse, buildSyncResponse, generateToolDefinitions, } from './response.js';
+export { streamFoundryResponse } from './stream.js';
+export type { ConversationsClient } from './conversations.js';
+export { createConversationsClient, PersistenceError, } from './conversations.js';
+export type { TelemetryOptions } from './telemetry.js';
+export { initTelemetry, getTracer, shutdownTelemetry } from './telemetry.js';
+export type { FoundryHarness } from './harness.js';
+export { createFoundryHarness } from './harness.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMxD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMpD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAMpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAM5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAM7E,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}