@amodalai/core 0.1.0

package/dist/src/runtime/context-compiler.js

@@ -0,0 +1,183 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Compiles system prompts from repo configuration and session state.
+ *
+ * Builds ordered, prioritized context sections and delegates to TokenAllocator
+ * for budget trimming.
+ */
+export class ContextCompiler {
+    repo;
+    allocator;
+    constructor(config) {
+        this.repo = config.repo;
+        this.allocator = config.allocator;
+    }
+    /**
+     * Compile the full primary-agent system prompt.
+     */
+    compile(session) {
+        const sections = [];
+        // 1. base_prompt (priority 10)
+        const description = this.repo.config.description ?? '';
+        const descLine = description ? `\n${description}\n` : '\n';
+        sections.push(this.section('base_prompt', `You are an AI assistant for ${this.repo.config.name}.${descLine}\nYou help users by querying connected systems, analyzing data, and taking actions when authorized.\nAlways use the request tool to interact with external systems. Never fabricate data.`, 10));
+        // 2. agent_override (priority 9)
+        if (this.repo.agents.main) {
+            sections.push(this.section('agent_override', this.repo.agents.main, 9));
+        }
+        // 3. connections (priority 8)
+        const connectionsContent = this.buildConnectionsContent();
+        if (connectionsContent) {
+            sections.push(this.section('connections', connectionsContent, 8));
+        }
+        // 4. skills (priority 7)
+        const skillsContent = this.buildSkillsContent();
+        if (skillsContent) {
+            sections.push(this.section('skills', skillsContent, 7));
+        }
+        // 5. knowledge (priority 6)
+        const knowledgeContent = this.buildKnowledgeContent();
+        if (knowledgeContent) {
+            sections.push(this.section('knowledge', knowledgeContent, 6));
+        }
+        // 6. field_guidance (priority 5)
+        if (session.fieldGuidance) {
+            sections.push(this.section('field_guidance', `## Field Access Restrictions\n${session.fieldGuidance}`, 5));
+        }
+        // 7. scope_descriptions (priority 4)
+        const scopeEntries = Object.entries(session.scopeLabels);
+        if (scopeEntries.length > 0) {
+            const lines = scopeEntries.map(([entity, label]) => `- ${entity}: ${label}`);
+            sections.push(this.section('scope_descriptions', `## Data Scope\n${lines.join('\n')}`, 4));
+        }
+        // 8. alternative_lookups (priority 3)
+        if (session.alternativeLookupGuidance) {
+            sections.push(this.section('alternative_lookups', session.alternativeLookupGuidance, 3));
+        }
+        // 9. plan_mode (priority 10, never trimmed)
+        if (session.planMode) {
+            let planContent = '## Planning Mode Active\nYou are currently in planning mode. Present your plan to the user before executing write operations.\nRead operations and explore are allowed freely.';
+            if (session.approvedPlan) {
+                planContent += `\n\n## Approved Plan\nExecute the following approved plan:\n${session.approvedPlan}`;
+            }
+            sections.push(this.section('plan_mode', planContent, 10));
+        }
+        return this.buildResult(sections);
+    }
+    /**
+     * Compile the explore sub-agent system prompt (subset of main).
+     */
+    compileExplore(session) {
+        const sections = [];
+        // 1. base_prompt (priority 10) — explore-specific
+        sections.push(this.section('base_prompt', 'You are a data-gathering sub-agent. Your job is to query connected systems and return a concise summary of findings.\nFocus on the specific query. Do not take actions or propose changes. Return a structured summary of 200-500 tokens.', 10));
+        // 2. agent_override (priority 9) — simple agent override
+        if (this.repo.agents.simple) {
+            sections.push(this.section('agent_override', this.repo.agents.simple, 9));
+        }
+        // 3. connections (priority 8)
+        const connectionsContent = this.buildConnectionsContent();
+        if (connectionsContent) {
+            sections.push(this.section('connections', connectionsContent, 8));
+        }
+        // 4. knowledge (priority 6)
+        const knowledgeContent = this.buildKnowledgeContent();
+        if (knowledgeContent) {
+            sections.push(this.section('knowledge', knowledgeContent, 6));
+        }
+        // 5. field_guidance (priority 5)
+        if (session.fieldGuidance) {
+            sections.push(this.section('field_guidance', `## Field Access Restrictions\n${session.fieldGuidance}`, 5));
+        }
+        // 6. scope_descriptions (priority 4)
+        const scopeEntries = Object.entries(session.scopeLabels);
+        if (scopeEntries.length > 0) {
+            const lines = scopeEntries.map(([entity, label]) => `- ${entity}: ${label}`);
+            sections.push(this.section('scope_descriptions', `## Data Scope\n${lines.join('\n')}`, 4));
+        }
+        return this.buildResult(sections);
+    }
+    section(name, content, priority) {
+        return {
+            name,
+            content,
+            tokens: 0, // TokenAllocator will compute
+            priority,
+            trimmed: false,
+        };
+    }
+    buildConnectionsContent() {
+        if (this.repo.connections.size === 0) {
+            return '';
+        }
+        const parts = [];
+        for (const [, conn] of this.repo.connections) {
+            const lines = [`## Connection: ${conn.name}`];
+            // Surface endpoints
+            const includedEndpoints = conn.surface.filter((ep) => ep.included);
+            if (includedEndpoints.length > 0) {
+                lines.push('', '### Available Endpoints');
+                for (const ep of includedEndpoints) {
+                    lines.push(`${ep.method} ${ep.path} — ${ep.description}`);
+                }
+            }
+            // Entities
+            if (conn.entities) {
+                lines.push('', '### Entities', conn.entities);
+            }
+            // Rules
+            if (conn.rules) {
+                lines.push('', '### Rules', conn.rules);
+            }
+            parts.push(lines.join('\n'));
+        }
+        return parts.join('\n\n');
+    }
+    buildSkillsContent() {
+        if (this.repo.skills.length === 0) {
+            return '';
+        }
+        const lines = ['## Available Skills', ''];
+        for (const skill of this.repo.skills) {
+            const trigger = skill.trigger ?? 'Manual activation';
+            lines.push(`- **${skill.name}**: ${skill.description}`);
+            lines.push(`  Trigger: ${trigger}`);
+        }
+        return lines.join('\n');
+    }
+    buildKnowledgeContent() {
+        if (this.repo.knowledge.length === 0) {
+            return '';
+        }
+        const lines = ['## Knowledge Base'];
+        for (const doc of this.repo.knowledge) {
+            lines.push('', `### ${doc.title}`, doc.body);
+        }
+        return lines.join('\n');
+    }
+    buildResult(sections) {
+        const { included, trimmed, totalTokens } = this.allocator.allocate(sections);
+        const allSections = [...included, ...trimmed];
+        const sectionBreakdown = {};
+        for (const s of allSections) {
+            sectionBreakdown[s.name] = s.tokens;
+        }
+        const total = this.allocator.budget;
+        const systemPrompt = included.map((s) => s.content).join('\n\n');
+        return {
+            systemPrompt,
+            tokenUsage: {
+                total,
+                used: totalTokens,
+                remaining: total - totalTokens,
+                sectionBreakdown,
+            },
+            sections: allSections,
+        };
+    }
+}
+//# sourceMappingURL=context-compiler.js.map

package/dist/src/runtime/context-compiler.js.map

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

package/dist/src/runtime/default-prompt.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Build the default Amodal system prompt.
+ *
+ * Used when the user has not set a custom `basePrompt` in amodal.json
+ * or on the application record. This replaces the upstream Gemini CLI
+ * system prompt with one tailored for the Amodal agent runtime.
+ */
+export declare function buildDefaultPrompt(opts: {
+    name: string;
+    description?: string;
+    agentContext?: string;
+    connectionNames?: string[];
+    skills?: Array<{
+        name: string;
+        description: string;
+        trigger?: string;
+        body?: string;
+    }>;
+    knowledge?: Array<{
+        name: string;
+        title?: string;
+    }>;
+}): string;

package/dist/src/runtime/default-prompt.js

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Build the default Amodal system prompt.
+ *
+ * Used when the user has not set a custom `basePrompt` in amodal.json
+ * or on the application record. This replaces the upstream Gemini CLI
+ * system prompt with one tailored for the Amodal agent runtime.
+ */
+export function buildDefaultPrompt(opts) {
+    const parts = [];
+    // Identity
+    parts.push(`You are ${opts.name}${opts.description ? ` — ${opts.description}` : ''}.`);
+    parts.push('');
+    // Agent context (if set by the deployment)
+    if (opts.agentContext) {
+        parts.push(opts.agentContext);
+        parts.push('');
+    }
+    // Core behavior
+    parts.push(`## How you work
+
+- Use the **request** tool to query connected systems. Always specify the connection name, HTTP method, endpoint, and intent (read or write).
+- Write operations require user confirmation unless the user has explicitly approved the action.
+- Never fabricate data. If a query returns no results, say so. If you're uncertain, ask.
+- When the user's question requires data from external systems, always query first — do not guess.
+- Keep responses concise and grounded in the data you retrieve.`);
+    parts.push('');
+    // Connections
+    if (opts.connectionNames && opts.connectionNames.length > 0) {
+        parts.push('## Connected systems');
+        parts.push('');
+        for (const name of opts.connectionNames) {
+            parts.push(`- **${name}**`);
+        }
+        parts.push('');
+        parts.push('Use `request` with the connection name to interact with these systems. Check the connection documentation for available endpoints.');
+        parts.push('');
+    }
+    // Skills
+    if (opts.skills && opts.skills.length > 0) {
+        parts.push('## Skills');
+        parts.push('');
+        for (const skill of opts.skills) {
+            parts.push(`### ${skill.name}`);
+            if (skill.trigger) {
+                parts.push(`**When to activate:** ${skill.trigger}`);
+            }
+            parts.push(skill.description);
+            if (skill.body) {
+                parts.push('');
+                parts.push(skill.body);
+            }
+            parts.push('');
+        }
+    }
+    // Knowledge
+    if (opts.knowledge && opts.knowledge.length > 0) {
+        parts.push('## Available knowledge');
+        parts.push('');
+        for (const doc of opts.knowledge) {
+            parts.push(`- ${doc.title ?? doc.name}`);
+        }
+        parts.push('');
+    }
+    return parts.join('\n').trim();
+}
+//# sourceMappingURL=default-prompt.js.map

package/dist/src/runtime/default-prompt.js.map

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

package/dist/src/runtime/explore-tool.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Configuration for an explore sub-agent invocation.
+ * The actual agent execution is handled by the runtime server (Phase 4).
+ * This module prepares the context, model selection, and constraints.
+ */
+import type { ModelConfig } from '../repo/config-schema.js';
+import type { ConnectionsMap } from '../templates/connections.js';
+import type { SessionRuntime } from './session-setup.js';
+export interface ExploreConfig {
+    systemPrompt: string;
+    model: ModelConfig;
+    /** All available model configs for override selection */
+    availableModels: {
+        main: ModelConfig;
+        simple?: ModelConfig;
+        advanced?: ModelConfig;
+    };
+    connectionsMap: ConnectionsMap;
+    readOnly: true;
+    maxTurns: number;
+    maxDepth: number;
+}
+export interface ExploreRequest {
+    query: string;
+    endpointHints?: string[];
+    parentDepth: number;
+}
+export interface ExploreResult {
+    summary: string;
+    tokensUsed: number;
+    endpointsQueried: string[];
+    truncated: boolean;
+}
+/**
+ * Prepares the configuration for an explore sub-agent.
+ */
+export declare function prepareExploreConfig(runtime: SessionRuntime, options?: {
+    maxTurns?: number;
+    maxDepth?: number;
+}): ExploreConfig;
+/**
+ * Resolves the effective model for an explore sub-agent call.
+ *
+ * If the LLM passes a `model` parameter, this resolves it against the
+ * available models:
+ * - "simple" → the explore/lightweight model
+ * - "default" → the default explore model (same as no override)
+ * - "advanced" → the main/primary model
+ * - "provider:model" → literal override (e.g., "openai:gpt-4o-mini")
+ *
+ * Otherwise returns the default explore model.
+ */
+export declare function resolveExploreModel(config: ExploreConfig, modelParam?: string): ModelConfig;
+/**
+ * Validates an explore request against the config constraints.
+ * Returns an error message if invalid, null if valid.
+ */
+export declare function validateExploreRequest(request: ExploreRequest, config: ExploreConfig): string | null;
+/**
+ * The explore tool name constant.
+ */
+export declare const EXPLORE_TOOL_NAME = "explore";
+/**
+ * The explore tool definition for LLM tool calling.
+ * This is the schema the LLM sees.
+ */
+export declare const EXPLORE_TOOL_SCHEMA: {
+    readonly name: "explore";
+    readonly description: "Delegate data gathering to a focused sub-agent that queries connected systems and returns a concise summary. Use this for broad investigation, parallel data collection, or when you need to gather information from multiple endpoints.";
+    readonly parameters: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "What to investigate. Be specific about what data you need.";
+            };
+            readonly endpoint_hints: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional: specific endpoint paths to prioritize (e.g., \"/api/contacts\", \"/api/deals\").";
+            };
+            readonly model: {
+                readonly type: "string";
+                readonly description: "Optional: model to use for this sub-agent. Use \"simple\" for the lightweight model, \"default\" for the standard explore model, \"advanced\" for the primary model, or \"provider:model\" for a specific model (e.g., \"openai:gpt-4o-mini\").";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+};

package/dist/src/runtime/explore-tool.js

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+const DEFAULT_MAX_TURNS = 10;
+const DEFAULT_MAX_DEPTH = 2;
+/**
+ * Prepares the configuration for an explore sub-agent.
+ */
+export function prepareExploreConfig(runtime, options) {
+    const models = runtime.repo.config.models;
+    const model = models['simple'] ?? models['main'];
+    return {
+        systemPrompt: runtime.exploreContext.systemPrompt,
+        model,
+        availableModels: models,
+        connectionsMap: runtime.connectionsMap,
+        readOnly: true,
+        maxTurns: options?.maxTurns ?? DEFAULT_MAX_TURNS,
+        maxDepth: options?.maxDepth ?? DEFAULT_MAX_DEPTH,
+    };
+}
+/**
+ * Resolves the effective model for an explore sub-agent call.
+ *
+ * If the LLM passes a `model` parameter, this resolves it against the
+ * available models:
+ * - "simple" → the explore/lightweight model
+ * - "default" → the default explore model (same as no override)
+ * - "advanced" → the main/primary model
+ * - "provider:model" → literal override (e.g., "openai:gpt-4o-mini")
+ *
+ * Otherwise returns the default explore model.
+ */
+export function resolveExploreModel(config, modelParam) {
+    if (!modelParam) {
+        return config.model;
+    }
+    const normalized = modelParam.trim().toLowerCase();
+    // Named aliases
+    if (normalized === 'simple') {
+        return config.availableModels.simple ?? config.model;
+    }
+    if (normalized === 'default') {
+        return config.model;
+    }
+    if (normalized === 'advanced') {
+        return config.availableModels.advanced ?? config.availableModels.main;
+    }
+    // Literal "provider:model" override (e.g., "openai:gpt-4o-mini")
+    if (modelParam.includes(':')) {
+        const colonIdx = modelParam.indexOf(':');
+        const provider = modelParam.slice(0, colonIdx).trim();
+        const model = modelParam.slice(colonIdx + 1).trim();
+        if (provider && model) {
+            return {
+                provider,
+                model,
+                // Inherit credentials from the default explore model so tenant creds flow through
+                credentials: config.model.credentials,
+            };
+        }
+    }
+    return config.model;
+}
+/**
+ * Validates an explore request against the config constraints.
+ * Returns an error message if invalid, null if valid.
+ */
+export function validateExploreRequest(request, config) {
+    if (!request.query || request.query.trim().length === 0) {
+        return 'Explore query must not be empty';
+    }
+    if (request.parentDepth >= config.maxDepth) {
+        return `Explore request exceeds max depth: parentDepth=${request.parentDepth}, maxDepth=${config.maxDepth}`;
+    }
+    return null;
+}
+/**
+ * The explore tool name constant.
+ */
+export const EXPLORE_TOOL_NAME = 'explore';
+/**
+ * The explore tool definition for LLM tool calling.
+ * This is the schema the LLM sees.
+ */
+export const EXPLORE_TOOL_SCHEMA = {
+    name: 'explore',
+    description: 'Delegate data gathering to a focused sub-agent that queries connected systems and returns a concise summary. Use this for broad investigation, parallel data collection, or when you need to gather information from multiple endpoints.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'What to investigate. Be specific about what data you need.',
+            },
+            endpoint_hints: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional: specific endpoint paths to prioritize (e.g., "/api/contacts", "/api/deals").',
+            },
+            model: {
+                type: 'string',
+                description: 'Optional: model to use for this sub-agent. Use "simple" for the lightweight model, "default" for the standard explore model, "advanced" for the primary model, or "provider:model" for a specific model (e.g., "openai:gpt-4o-mini").',
+            },
+        },
+        required: ['query'],
+    },
+};
+//# sourceMappingURL=explore-tool.js.map

package/dist/src/runtime/explore-tool.js.map

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

package/dist/src/runtime/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { buildAccessConfigs, buildConnectionsMap } from './connection-bridge.js';
+export { ContextCompiler } from './context-compiler.js';
+export type { CompiledContext, ContextSection, SessionConfig, TokenBudget, } from './runtime-types.js';
+export { setupSession } from './session-setup.js';
+export type { SessionRuntime, SessionSetupOptions } from './session-setup.js';
+export { getModelContextWindow, TokenAllocator } from './token-allocator.js';
+export { defaultUserContext, extractRoles, generateAlternativeLookupGuidance, generateFieldGuidance, resolveScopeLabels, } from './user-context.js';
+export type { UserContextResult } from './user-context.js';
+export { EXPLORE_TOOL_NAME, EXPLORE_TOOL_SCHEMA, prepareExploreConfig, resolveExploreModel, validateExploreRequest, } from './explore-tool.js';
+export type { ExploreConfig, ExploreRequest, ExploreResult, } from './explore-tool.js';
+export { createSecuredReadOnlyRequestTool, createSecuredRequestTool, } from './request-integration.js';
+export { PlanModeManager } from './plan-mode.js';
+export { OutputPipeline, StreamGuardProcessor } from './output-pipeline.js';
+export type { OutputPipelineConfig, PipelineResult } from './output-pipeline.js';
+export { RuntimeTelemetry } from './telemetry-hooks.js';
+export type { RuntimeTelemetryEvent, TelemetrySink, TelemetryEventType } from './telemetry-hooks.js';
+export { PlatformTelemetrySink } from './telemetry-client.js';
+export { PreferenceClient, formatPreferencesPrompt } from './preference-client.js';
+export type { UserPreference } from './preference-client.js';
+export { detectPreferences } from './preference-detector.js';
+export type { DetectedPreference } from './preference-detector.js';

package/dist/src/runtime/index.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { buildAccessConfigs, buildConnectionsMap } from './connection-bridge.js';
+export { ContextCompiler } from './context-compiler.js';
+export { setupSession } from './session-setup.js';
+export { getModelContextWindow, TokenAllocator } from './token-allocator.js';
+export { defaultUserContext, extractRoles, generateAlternativeLookupGuidance, generateFieldGuidance, resolveScopeLabels, } from './user-context.js';
+export { EXPLORE_TOOL_NAME, EXPLORE_TOOL_SCHEMA, prepareExploreConfig, resolveExploreModel, validateExploreRequest, } from './explore-tool.js';
+export { createSecuredReadOnlyRequestTool, createSecuredRequestTool, } from './request-integration.js';
+export { PlanModeManager } from './plan-mode.js';
+export { OutputPipeline, StreamGuardProcessor } from './output-pipeline.js';
+export { RuntimeTelemetry } from './telemetry-hooks.js';
+export { PlatformTelemetrySink } from './telemetry-client.js';
+export { PreferenceClient, formatPreferencesPrompt } from './preference-client.js';
+export { detectPreferences } from './preference-detector.js';
+//# sourceMappingURL=index.js.map

package/dist/src/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,kBAAkB,EAAE,mBAAmB,EAAC,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAOtD,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAC,qBAAqB,EAAE,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,iCAAiC,EACjC,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,cAAc,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAC,gBAAgB,EAAE,uBAAuB,EAAC,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC"}

package/dist/src/runtime/output-pipeline.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { OutputGuard } from '../security/output-guard.js';
+import type { GuardFinding, GuardResult } from '../security/security-types.js';
+/**
+ * Configuration for the output pipeline.
+ */
+export interface OutputPipelineConfig {
+    outputGuard: OutputGuard;
+    onGuardDecision?: (result: GuardResult) => void;
+}
+/**
+ * Result from processing agent output through the pipeline.
+ */
+export interface PipelineResult {
+    output: string;
+    modified: boolean;
+    blocked: boolean;
+    findings: GuardFinding[];
+}
+/**
+ * Wraps OutputGuard in a pipeline suitable for both synchronous
+ * and streaming use. Provides telemetry hooks and buffered stream
+ * processing.
+ */
+export declare class OutputPipeline {
+    private readonly outputGuard;
+    private readonly onGuardDecision?;
+    constructor(config: OutputPipelineConfig);
+    /**
+     * Process a complete agent response text through the guard.
+     */
+    process(text: string): PipelineResult;
+    /**
+     * Create a streaming processor that buffers tokens and guards on finalize.
+     */
+    createStreamProcessor(): StreamGuardProcessor;
+}
+/**
+ * Buffers streaming tokens and runs the output guard on finalize.
+ */
+export declare class StreamGuardProcessor {
+    private readonly pipeline;
+    private buffer;
+    constructor(pipeline: OutputPipeline);
+    /**
+     * Feed a token into the buffer. Tokens are accumulated
+     * for guard processing on finalize.
+     */
+    feed(token: string): void;
+    /**
+     * Get the current buffered text for intermediate streaming display.
+     */
+    getBuffer(): string;
+    /**
+     * Run the output guard on the full buffered text and return the result.
+     */
+    finalize(): PipelineResult;
+}