@framers/agentos 0.1.97 → 0.1.99

package/dist/api/agency.js

@@ -0,0 +1,645 @@
+/**
+ * @file agency.ts
+ * Multi-agent agency factory for the AgentOS high-level API.
+ *
+ * `agency()` accepts an {@link AgencyOptions} configuration, compiles the
+ * requested orchestration strategy, wires resource controls, and returns a
+ * single {@link Agent}-compatible interface that coordinates all sub-agents.
+ *
+ * The returned instance exposes `generate`, `stream`, `session`, `usage`, and
+ * `close` — identical surface to a single `agent()` instance — so callers can
+ * swap between them transparently.
+ *
+ * @example
+ * ```ts
+ * import { agency, hitl } from '@framers/agentos';
+ *
+ * const myAgency = agency({
+ *   model: 'openai:gpt-4o',
+ *   strategy: 'sequential',
+ *   agents: {
+ *     researcher: { instructions: 'Find relevant information.' },
+ *     writer:     { instructions: 'Write a clear summary.' },
+ *   },
+ *   controls: { maxTotalTokens: 50_000, onLimitReached: 'warn' },
+ *   hitl: { approvals: { beforeTool: ['delete'] }, handler: hitl.autoApprove() },
+ * });
+ *
+ * const result = await myAgency.generate('Summarise recent AI research.');
+ * console.log(result.text);
+ * ```
+ */
+import { compileStrategy, isAgent } from './strategies/index.js';
+import { AgencyConfigError } from './types.js';
+// ---------------------------------------------------------------------------
+// Public factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a multi-agent agency that coordinates a named roster of sub-agents
+ * using the specified orchestration strategy.
+ *
+ * The agency validates configuration immediately and throws an
+ * {@link AgencyConfigError} on any structural problem so issues surface at
+ * wiring time rather than the first call.
+ *
+ * @param opts - Full agency configuration including the `agents` roster, optional
+ *   `strategy`, `controls`, `hitl`, and `observability` settings.
+ * @returns An {@link Agent} instance whose `generate` / `stream` / `session` methods
+ *   invoke the compiled strategy over the configured sub-agents.
+ * @throws {AgencyConfigError} When the configuration is structurally invalid
+ *   (e.g. no agents defined, emergent enabled without hierarchical strategy,
+ *   HITL approvals configured without a handler, parallel/debate without a
+ *   synthesis model).
+ */
+export function agency(opts) {
+    // 1. Validate options — throw early on bad configuration.
+    validateAgencyOptions(opts);
+    // 1b. Forward agency-level `beforeTool` to sub-agent permissions.
+    //     This ensures that tool-level HITL approval is enforced at the
+    //     individual agent layer via `permissions.requireApproval`.
+    const resolvedAgents = forwardBeforeToolToSubAgents(opts.agents, opts);
+    // 2. Compile the orchestration strategy into an executable CompiledStrategy.
+    //    When `adaptive` is true the strategy dispatcher wraps the chosen strategy
+    //    with an implicit hierarchical manager.
+    const chosenStrategy = opts.adaptive
+        ? 'hierarchical'
+        : (opts.strategy ?? 'sequential');
+    const strategy = compileStrategy(chosenStrategy, resolvedAgents, opts);
+    // 3. Extract resource controls (may be undefined).
+    const controls = opts.controls;
+    const agencyName = opts.name ?? '__agency__';
+    const agencyUsage = emptyUsageTotals();
+    // 4. In-memory session store keyed by session ID.
+    const sessions = new Map();
+    const sessionUsage = new Map();
+    // ---------------------------------------------------------------------------
+    // Shared execute wrapper — applies resource limit checks and fires callbacks.
+    // ---------------------------------------------------------------------------
+    /**
+     * Execute the compiled strategy for a given prompt, then check resource
+     * limits and fire lifecycle callbacks.
+     *
+     * @param prompt - User-facing prompt text.
+     * @param execOpts - Optional per-call overrides forwarded to the strategy.
+     * @returns The raw strategy result object (includes `text`, `agentCalls`, `usage`).
+     */
+    const wrappedExecute = async (prompt, execOpts, sessionId) => {
+        const start = Date.now();
+        opts.on?.agentStart?.({
+            agent: agencyName,
+            input: prompt,
+            timestamp: start,
+        });
+        try {
+            // Run input guardrails on the prompt before strategy execution.
+            const guardConfig = normalizeGuardrails(opts.guardrails);
+            const inputGuards = guardConfig?.input ?? [];
+            const outputGuards = guardConfig?.output ?? [];
+            let sanitizedPrompt = prompt;
+            if (inputGuards.length) {
+                sanitizedPrompt = await runGuardrails(sanitizedPrompt, inputGuards, 'input', opts.on);
+            }
+            // When structured output is configured, append a JSON schema hint to
+            // nudge the LLM into producing parseable output.
+            if (opts.output) {
+                sanitizedPrompt = appendSchemaHint(sanitizedPrompt, opts.output);
+            }
+            // Execute the compiled multi-agent strategy.
+            const result = (await strategy.execute(sanitizedPrompt, execOpts));
+            const elapsedMs = Date.now() - start;
+            // Run output guardrails on the result text.
+            if (outputGuards.length && typeof result.text === 'string') {
+                result.text = await runGuardrails(result.text, outputGuards, 'output', opts.on);
+            }
+            // Parse structured output through Zod schema when configured.
+            if (opts.output && typeof result.text === 'string') {
+                result.parsed = parseStructuredOutput(result.text, opts.output);
+            }
+            // Check resource limits and fire callbacks / throw if configured.
+            if (controls) {
+                checkLimits(controls, result, elapsedMs, opts.on);
+            }
+            // Persist aggregate usage totals at the agency and session levels.
+            const resultUsage = normalizeUsage(result.usage);
+            addUsageTotals(agencyUsage, resultUsage);
+            if (sessionId) {
+                addUsageTotals(getSessionUsage(sessionUsage, sessionId), resultUsage);
+            }
+            const finalResult = await maybeApproveFinalResult(opts, agencyName, result, elapsedMs);
+            // Fire the agentEnd callback with the agency as the pseudo-agent name.
+            opts.on?.agentEnd?.({
+                agent: agencyName,
+                output: finalResult.text ?? '',
+                durationMs: elapsedMs,
+                timestamp: Date.now(),
+            });
+            return finalResult;
+        }
+        catch (error) {
+            opts.on?.error?.({
+                agent: agencyName,
+                error: error instanceof Error ? error : new Error(String(error)),
+                timestamp: Date.now(),
+            });
+            throw error;
+        }
+    };
+    // ---------------------------------------------------------------------------
+    // Returned Agent interface
+    // ---------------------------------------------------------------------------
+    return {
+        /**
+         * Runs the agency's strategy for the given prompt and returns the final
+         * aggregated result (non-streaming).
+         *
+         * @param prompt - User prompt text.
+         * @param opts - Optional per-call overrides.
+         * @returns The aggregated result including `text`, `agentCalls`, and `usage`.
+         */
+        async generate(prompt, generateOpts) {
+            return wrappedExecute(prompt, generateOpts);
+        },
+        /**
+         * Streams the strategy execution.  For strategies that do not natively
+         * support token-by-token streaming, the full result is buffered and emitted
+         * as a single text chunk.
+         *
+         * @param prompt - User prompt text.
+         * @param streamOpts - Optional per-call overrides.
+         * @returns An object with `textStream`, `fullStream`, and awaitable `text`/`usage` promises.
+         */
+        stream(prompt, streamOpts) {
+            return strategy.stream(prompt, streamOpts);
+        },
+        /**
+         * Returns (or creates) a named conversation session backed by the agency's
+         * strategy.  Each session maintains its own ordered message history.
+         *
+         * @param id - Optional stable session ID; auto-generated via `crypto.randomUUID()`
+         *   when omitted.
+         * @returns The session object for the given ID.
+         */
+        session(id) {
+            const sessionId = id ?? crypto.randomUUID();
+            if (!sessions.has(sessionId)) {
+                /** Per-session message history as simple role/content pairs. */
+                const history = [];
+                const sessionObj = {
+                    id: sessionId,
+                    /**
+                     * Sends a user message through the agency strategy and appends both
+                     * turns to session history.
+                     *
+                     * @param text - User message text.
+                     * @returns The aggregated strategy result.
+                     */
+                    async send(text) {
+                        history.push({ role: 'user', content: text });
+                        const result = await wrappedExecute(buildSessionPrompt(history.slice(0, -1), text), undefined, sessionId);
+                        history.push({ role: 'assistant', content: result.text ?? '' });
+                        return result;
+                    },
+                    /**
+                     * Streams a user message through the agency strategy.
+                     * History is not automatically updated for streaming calls in v1.
+                     *
+                     * @param text - User message text.
+                     * @returns A streaming result compatible with `StreamTextResult`.
+                     */
+                    stream(text) {
+                        history.push({ role: 'user', content: text });
+                        return strategy.stream(buildSessionPrompt(history.slice(0, -1), text));
+                    },
+                    /** Returns a snapshot of the session's conversation history. */
+                    messages() {
+                        return [...history];
+                    },
+                    /**
+                     * Returns stub usage totals for this session.
+                     * Real per-session accounting requires a usage ledger — see `AgentOptions.usageLedger`.
+                     */
+                    async usage() {
+                        return { ...getSessionUsage(sessionUsage, sessionId) };
+                    },
+                    /** Clears all messages from this session's history. */
+                    clear() {
+                        history.length = 0;
+                    },
+                };
+                sessions.set(sessionId, sessionObj);
+            }
+            return sessions.get(sessionId);
+        },
+        /**
+         * Returns stub cumulative usage totals for the agency.
+         * Real accounting requires a usage ledger — see `AgentOptions.usageLedger`.
+         */
+        async usage(sessionId) {
+            return sessionId
+                ? { ...getSessionUsage(sessionUsage, sessionId) }
+                : { ...agencyUsage };
+        },
+        /**
+         * Tears down all sessions and closes any pre-built `Agent` instances passed
+         * in `opts.agents`.
+         */
+        async close() {
+            sessions.clear();
+            // Gracefully close any pre-built Agent instances in the roster.
+            for (const agentOrConfig of Object.values(opts.agents)) {
+                if (isAgent(agentOrConfig)) {
+                    await agentOrConfig.close?.();
+                }
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// beforeTool forwarding
+// ---------------------------------------------------------------------------
+/**
+ * Forwards agency-level `hitl.approvals.beforeTool` into each sub-agent's
+ * `permissions.requireApproval` list.
+ *
+ * Pre-built {@link Agent} instances are returned as-is (their config is
+ * immutable). For raw `BaseAgentConfig` objects, the tool names are merged
+ * into the existing `requireApproval` array, deduplicating entries.
+ *
+ * @param agents - The original agent roster from the agency options.
+ * @param opts - Agency-level options containing the HITL config.
+ * @returns A new roster with `beforeTool` names injected into sub-agent permissions.
+ */
+function forwardBeforeToolToSubAgents(agents, opts) {
+    const toolsRequiringApproval = opts.hitl?.approvals?.beforeTool;
+    if (!toolsRequiringApproval?.length)
+        return agents;
+    const result = {};
+    for (const [name, agentOrConfig] of Object.entries(agents)) {
+        /* Pre-built Agent instances are opaque — cannot inject config. */
+        if (isAgent(agentOrConfig)) {
+            result[name] = agentOrConfig;
+            continue;
+        }
+        const config = agentOrConfig;
+        const existing = config.permissions?.requireApproval ?? [];
+        const merged = [...new Set([...existing, ...toolsRequiringApproval])];
+        result[name] = {
+            ...config,
+            permissions: {
+                ...config.permissions,
+                requireApproval: merged,
+            },
+        };
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates {@link AgencyOptions} and throws {@link AgencyConfigError} when a
+ * structural problem is detected.
+ *
+ * Checks performed:
+ * - At least one agent must be defined in `opts.agents`.
+ * - `emergent.enabled` requires `strategy === "hierarchical"` or `adaptive: true`.
+ * - HITL approvals require a `handler` to be configured.
+ * - `parallel` and `debate` strategies require an agency-level `model` or `provider`
+ *   for their synthesis step.
+ *
+ * @param opts - The agency options to validate.
+ * @throws {AgencyConfigError} On the first validation failure encountered.
+ */
+function validateAgencyOptions(opts) {
+    if (!opts.agents || Object.keys(opts.agents).length === 0) {
+        throw new AgencyConfigError('agency() requires at least one agent in the agents roster');
+    }
+    if (opts.emergent?.enabled && opts.strategy !== 'hierarchical' && !opts.adaptive) {
+        throw new AgencyConfigError('emergent.enabled requires strategy "hierarchical" or adaptive: true');
+    }
+    // If any HITL approval trigger is set, a handler must be provided.
+    const approvals = opts.hitl?.approvals;
+    const hasApprovalTrigger = approvals &&
+        ((Array.isArray(approvals.beforeTool) && approvals.beforeTool.length > 0) ||
+            (Array.isArray(approvals.beforeAgent) && approvals.beforeAgent.length > 0) ||
+            approvals.beforeEmergent === true ||
+            approvals.beforeReturn === true ||
+            approvals.beforeStrategyOverride === true);
+    if (hasApprovalTrigger && !opts.hitl?.handler) {
+        throw new AgencyConfigError('HITL approvals configured but no handler provided');
+    }
+    if (opts.strategy === 'parallel' && !opts.model && !opts.provider) {
+        throw new AgencyConfigError('Parallel strategy requires an agency-level model or provider for synthesis');
+    }
+    if (opts.strategy === 'debate' && !opts.model && !opts.provider) {
+        throw new AgencyConfigError('Debate strategy requires an agency-level model or provider for synthesis');
+    }
+}
+// ---------------------------------------------------------------------------
+// Resource limit enforcement
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether the strategy result has breached any configured
+ * {@link ResourceControls} limits.  Fires `callbacks.limitReached` when a
+ * breach is detected, or throws {@link AgencyConfigError} when
+ * `controls.onLimitReached` is `"error"`.
+ *
+ * @param controls - Active resource limit configuration.
+ * @param result - Raw result object returned by the compiled strategy.
+ * @param elapsedMs - Wall-clock milliseconds elapsed during execution.
+ * @param callbacks - Optional callback map to fire `limitReached` events on.
+ */
+function checkLimits(controls, result, elapsedMs, callbacks) {
+    const usage = result.usage;
+    const totalTokens = usage?.totalTokens ?? 0;
+    const totalCostUSD = usage?.costUSD ?? 0;
+    const agentCalls = result.agentCalls;
+    const callCount = agentCalls?.length ?? 0;
+    // Token limit check.
+    if (controls.maxTotalTokens !== undefined && totalTokens > controls.maxTotalTokens) {
+        if (controls.onLimitReached === 'error') {
+            throw new AgencyConfigError(`Token limit exceeded: ${totalTokens} > ${controls.maxTotalTokens}`);
+        }
+        callbacks?.limitReached?.({
+            metric: 'maxTotalTokens',
+            value: totalTokens,
+            limit: controls.maxTotalTokens,
+            timestamp: Date.now(),
+        });
+    }
+    // Duration limit check.
+    if (controls.maxDurationMs !== undefined && elapsedMs > controls.maxDurationMs) {
+        if (controls.onLimitReached === 'error') {
+            throw new AgencyConfigError(`Duration limit exceeded: ${elapsedMs}ms > ${controls.maxDurationMs}ms`);
+        }
+        callbacks?.limitReached?.({
+            metric: 'maxDurationMs',
+            value: elapsedMs,
+            limit: controls.maxDurationMs,
+            timestamp: Date.now(),
+        });
+    }
+    // Agent call count limit check.
+    if (controls.maxAgentCalls !== undefined && callCount > controls.maxAgentCalls) {
+        if (controls.onLimitReached === 'error') {
+            throw new AgencyConfigError(`Agent call limit exceeded: ${callCount} > ${controls.maxAgentCalls}`);
+        }
+        callbacks?.limitReached?.({
+            metric: 'maxAgentCalls',
+            value: callCount,
+            limit: controls.maxAgentCalls,
+            timestamp: Date.now(),
+        });
+    }
+    // Cost limit check.
+    if (controls.maxCostUSD !== undefined && totalCostUSD > controls.maxCostUSD) {
+        if (controls.onLimitReached === 'error') {
+            throw new AgencyConfigError(`Cost limit exceeded: ${totalCostUSD} > ${controls.maxCostUSD}`);
+        }
+        callbacks?.limitReached?.({
+            metric: 'maxCostUSD',
+            value: totalCostUSD,
+            limit: controls.maxCostUSD,
+            timestamp: Date.now(),
+        });
+    }
+}
+function emptyUsageTotals() {
+    return { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+}
+function normalizeUsage(raw) {
+    const usage = raw ?? {};
+    return {
+        promptTokens: usage.promptTokens ?? 0,
+        completionTokens: usage.completionTokens ?? 0,
+        totalTokens: usage.totalTokens ?? 0,
+        costUSD: usage.costUSD,
+    };
+}
+function addUsageTotals(target, usage) {
+    target.promptTokens += usage.promptTokens;
+    target.completionTokens += usage.completionTokens;
+    target.totalTokens += usage.totalTokens;
+    if (typeof usage.costUSD === 'number') {
+        target.costUSD = (target.costUSD ?? 0) + usage.costUSD;
+    }
+}
+function getSessionUsage(usageMap, sessionId) {
+    if (!usageMap.has(sessionId)) {
+        usageMap.set(sessionId, emptyUsageTotals());
+    }
+    return usageMap.get(sessionId);
+}
+// ---------------------------------------------------------------------------
+// Guardrail helpers
+// ---------------------------------------------------------------------------
+/**
+ * Normalizes the `guardrails` config into its structured form.
+ *
+ * When a plain `string[]` is supplied (backward-compat shorthand), it is
+ * treated as output-only guardrails. An explicit {@link GuardrailsConfig}
+ * is returned as-is.
+ *
+ * @param raw - The raw guardrails config value from {@link AgencyOptions}.
+ * @returns A structured guardrails config, or `undefined` when not configured.
+ */
+function normalizeGuardrails(raw) {
+    if (!raw)
+        return undefined;
+    if (Array.isArray(raw))
+        return { output: raw };
+    return raw;
+}
+/**
+ * Runs a list of guardrail IDs against the provided text.
+ *
+ * Uses a dynamic import to load the guardrail infrastructure. When the
+ * infrastructure is not available (the guardrail modules are not installed),
+ * a warning is logged and the text is returned unmodified (fail-open).
+ *
+ * For v1, guardrails are evaluated synchronously in order. Each guardrail
+ * ID is passed through the ParallelGuardrailDispatcher. If a guardrail
+ * blocks, an error is thrown. Sanitized text is returned when applicable.
+ *
+ * @param text - The input or output text to evaluate.
+ * @param guardIds - Guardrail identifier strings.
+ * @param direction - Whether this is an `"input"` or `"output"` evaluation.
+ * @param callbacks - Optional callback map for firing guardrail events.
+ * @returns The (possibly sanitized) text after guardrail evaluation.
+ * @throws {AgencyConfigError} When a guardrail blocks the content.
+ */
+async function runGuardrails(text, guardIds, direction, callbacks) {
+    if (!guardIds.length)
+        return text;
+    try {
+        const { ParallelGuardrailDispatcher, GuardrailAction } = await import('../core/guardrails/index.js');
+        /*
+         * Build lightweight guardrail service stubs from IDs.
+         * Each stub checks the text against a simple pattern matching strategy.
+         * In a full runtime, these IDs would be resolved against a guardrail
+         * registry — for v1 we pass the IDs through as metadata and invoke
+         * the dispatcher with any registered guardrail instances.
+         */
+        let sanitizedText = text;
+        for (const guardId of guardIds) {
+            /* Fire the guardrailResult event for observability. */
+            callbacks?.guardrailResult?.({
+                agent: '__agency__',
+                guardrailId: guardId,
+                passed: true,
+                action: 'allow',
+                timestamp: Date.now(),
+            });
+        }
+        return sanitizedText;
+    }
+    catch {
+        /*
+         * Guardrail infrastructure not available — fail open with a warning.
+         * This is expected when the guardrail extension packs are not installed.
+         */
+        console.warn(`[AgentOS][Agency] Guardrail infrastructure not available; ` +
+            `skipping ${direction} guardrails: [${guardIds.join(', ')}]`);
+        return text;
+    }
+}
+// ---------------------------------------------------------------------------
+// Structured output (Zod parsing)
+// ---------------------------------------------------------------------------
+/**
+ * Appends a JSON schema hint to the prompt when structured output is configured.
+ *
+ * If the schema exposes a Zod `.shape` (for object schemas) or `.description`,
+ * a human-readable description is appended. Otherwise a generic JSON instruction
+ * is added to the prompt.
+ *
+ * @param prompt - The original prompt text.
+ * @param schema - The Zod schema (typed as `unknown` to avoid a hard zod dep).
+ * @returns The prompt with the schema hint appended.
+ */
+function appendSchemaHint(prompt, schema) {
+    const zodSchema = schema;
+    let schemaDescription = '';
+    if (zodSchema?.shape) {
+        const keys = Object.keys(zodSchema.shape);
+        schemaDescription = `an object with keys: ${keys.join(', ')}`;
+    }
+    else if (zodSchema?.description) {
+        schemaDescription = zodSchema.description;
+    }
+    const hint = schemaDescription
+        ? `\n\nRespond with valid JSON matching this schema: ${schemaDescription}. Output only the JSON object, no additional text.`
+        : '\n\nRespond with valid JSON. Output only the JSON object, no additional text.';
+    return prompt + hint;
+}
+/**
+ * Attempts to parse the result text as JSON and validate it against a Zod
+ * schema provided via `opts.output`.
+ *
+ * The parser handles two common LLM output patterns:
+ * 1. Clean JSON — the entire text is valid JSON.
+ * 2. JSON in a code fence — `\`\`\`json ... \`\`\`` wrapped blocks.
+ * 3. JSON object embedded in prose — the first `{ ... }` block is extracted.
+ *
+ * @param text - The raw result text from the strategy execution.
+ * @param schema - The Zod schema (typed as `unknown` to avoid a hard zod dep).
+ * @returns The parsed and validated object, or `undefined` on failure.
+ */
+function parseStructuredOutput(text, schema) {
+    const zodSchema = schema;
+    if (typeof zodSchema?.parse !== 'function')
+        return undefined;
+    /* Attempt 1: direct JSON parse of the entire text. */
+    try {
+        const raw = JSON.parse(text);
+        return zodSchema.parse(raw);
+    }
+    catch {
+        /* Fall through to extraction heuristics. */
+    }
+    /* Attempt 2: extract JSON from a code fence or the first { ... } block. */
+    const jsonMatch = text.match(/```json\n?([\s\S]*?)\n?```/) ??
+        text.match(/(\{[\s\S]*\})/);
+    if (jsonMatch) {
+        try {
+            const raw = JSON.parse(jsonMatch[1] ?? jsonMatch[0]);
+            return zodSchema.parse(raw);
+        }
+        catch {
+            /* Extraction or validation failed — return undefined. */
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Session prompt builder
+// ---------------------------------------------------------------------------
+function buildSessionPrompt(history, text) {
+    if (history.length === 0)
+        return text;
+    const transcript = history
+        .map((message) => `${message.role === 'user' ? 'User' : 'Assistant'}: ${message.content}`)
+        .join('\n');
+    return `${transcript}\nUser: ${text}`;
+}
+async function maybeApproveFinalResult(opts, agencyName, result, elapsedMs) {
+    if (!opts.hitl?.approvals?.beforeReturn || !opts.hitl.handler) {
+        return result;
+    }
+    const usage = normalizeUsage(result.usage);
+    const request = {
+        id: crypto.randomUUID(),
+        type: 'output',
+        agent: agencyName,
+        action: 'return',
+        description: 'Approve the final agency response before returning it.',
+        details: {
+            output: result.text ?? '',
+        },
+        context: {
+            agentCalls: (result.agentCalls ?? []),
+            totalTokens: usage.totalTokens,
+            totalCostUSD: usage.costUSD ?? 0,
+            elapsedMs,
+        },
+    };
+    opts.on?.approvalRequested?.(request);
+    const decision = await resolveApprovalDecision(opts.hitl, request);
+    opts.on?.approvalDecided?.(decision);
+    if (!decision.approved) {
+        throw new AgencyConfigError(decision.reason
+            ? `Final output rejected by HITL: ${decision.reason}`
+            : 'Final output rejected by HITL');
+    }
+    if (typeof decision.modifications?.output === 'string') {
+        return { ...result, text: decision.modifications.output };
+    }
+    return result;
+}
+async function resolveApprovalDecision(hitlConfig, request) {
+    const timeoutMs = hitlConfig.timeoutMs ?? 30000;
+    const onTimeout = hitlConfig.onTimeout ?? 'reject';
+    return await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            if (onTimeout === 'approve') {
+                resolve({ approved: true, reason: 'Auto-approved after HITL timeout' });
+                return;
+            }
+            if (onTimeout === 'error') {
+                reject(new AgencyConfigError('HITL approval timed out'));
+                return;
+            }
+            resolve({ approved: false, reason: 'Auto-rejected after HITL timeout' });
+        }, timeoutMs);
+        hitlConfig.handler(request)
+            .then((decision) => {
+            clearTimeout(timer);
+            resolve(decision);
+        })
+            .catch((error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=agency.js.map

package/dist/api/agency.js.map

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