@corbat-tech/coco 2.37.0 → 2.38.0

package/dist/blueprints-BWcCJfnN.d.ts

@@ -0,0 +1,99 @@
+import { ap as ProviderType, P as ProviderConfig, L as LLMProvider, E as EventLog, V as RuntimeTurnRunner, t as AgentRuntime, I as RuntimeSession, T as RuntimeTurnInput, U as RuntimeTurnResult } from './agent-runtime-DeLcB0Ie.js';
+import { T as ToolRegistry } from './registry-CEpl9Jq0.js';
+import { z } from 'zod';
+
+type GuardrailSeverity = "info" | "warning" | "blocked";
+type GuardrailStage = "input" | "output" | "tool";
+interface GuardrailFinding {
+    id: string;
+    stage: GuardrailStage;
+    severity: GuardrailSeverity;
+    message: string;
+    redacted?: boolean;
+}
+interface GuardrailResult {
+    allowed: boolean;
+    content: string;
+    findings: GuardrailFinding[];
+}
+interface SecretRedactionConfig {
+    enabled: boolean;
+    replacement?: string;
+}
+interface TopicBoundaryConfig {
+    allowedTopics?: string[];
+    blockedTopics?: string[];
+}
+interface GuardrailConfig {
+    maxInputChars?: number;
+    maxOutputChars?: number;
+    secretRedaction?: SecretRedactionConfig;
+    promptInjectionDetection?: boolean;
+    topicBoundary?: TopicBoundaryConfig;
+}
+declare const defaultPublicGuardrails: GuardrailConfig;
+declare function redactSecrets(content: string, config?: SecretRedactionConfig): {
+    content: string;
+    findings: GuardrailFinding[];
+};
+declare function runGuardrails(stage: GuardrailStage, content: string, config?: GuardrailConfig): GuardrailResult;
+declare function validateStructuredOutput(output: unknown, schema: z.ZodTypeAny | undefined): GuardrailFinding[];
+
+type AgentDeploymentSurface = "cli" | "web" | "whatsapp" | "slack" | "api" | "internal";
+type AgentActionMode = "ask" | "draft" | "act" | "review";
+type AgentMaturity = "experimental" | "beta" | "stable";
+interface MemoryConfig {
+    enabled: boolean;
+    retention?: "session" | "short-term" | "long-term";
+}
+interface ApprovalPolicy {
+    requireHumanForExternalActions: boolean;
+    requireHumanForSensitiveData?: boolean;
+}
+interface ObservabilityConfig {
+    logEvents: boolean;
+    redactSensitiveData: boolean;
+    estimateCost?: boolean;
+}
+interface AgentBlueprint {
+    id: string;
+    name: string;
+    description: string;
+    surface: AgentDeploymentSurface;
+    defaultMode: AgentActionMode;
+    maturity: AgentMaturity;
+    instructions: string;
+    allowedTools: string[];
+    guardrails: GuardrailConfig;
+    memory: MemoryConfig;
+    approval: ApprovalPolicy;
+    observability: ObservabilityConfig;
+    outputSchema?: unknown;
+}
+interface AgentRuntimeFactoryOptions {
+    providerType: ProviderType;
+    model?: string;
+    providerConfig?: ProviderConfig;
+    provider?: LLMProvider;
+    toolRegistry?: ToolRegistry;
+    eventLog?: EventLog;
+    turnRunner?: RuntimeTurnRunner;
+}
+interface AgentPreset<TConfig = unknown> {
+    id: string;
+    name: string;
+    createBlueprint(config: TConfig): AgentBlueprint;
+    createRuntime(config: TConfig & AgentRuntimeFactoryOptions): Promise<AgentRuntime>;
+}
+interface BlueprintAgent {
+    blueprint: AgentBlueprint;
+    runtime: AgentRuntime;
+    createSession(metadata?: Record<string, unknown>): RuntimeSession;
+    runTurn(input: RuntimeTurnInput): Promise<RuntimeTurnResult>;
+}
+declare function mapActionModeToRuntimeMode(mode: AgentActionMode): "ask" | "build" | "review";
+declare function createSafeToolRegistry(allowedTools: string[], source?: ToolRegistry): ToolRegistry;
+declare function createAgentFromBlueprint(blueprint: AgentBlueprint, options: AgentRuntimeFactoryOptions): Promise<BlueprintAgent>;
+declare function createBaseBlueprint(input: Omit<AgentBlueprint, "guardrails" | "memory" | "approval" | "observability"> & Partial<Pick<AgentBlueprint, "guardrails" | "memory" | "approval" | "observability">>): AgentBlueprint;
+
+export { type AgentActionMode as A, type BlueprintAgent as B, type GuardrailConfig as G, type MemoryConfig as M, type ObservabilityConfig as O, type SecretRedactionConfig as S, type TopicBoundaryConfig as T, type AgentBlueprint as a, type AgentDeploymentSurface as b, type AgentMaturity as c, type AgentPreset as d, type AgentRuntimeFactoryOptions as e, type ApprovalPolicy as f, type GuardrailFinding as g, type GuardrailResult as h, type GuardrailSeverity as i, type GuardrailStage as j, createAgentFromBlueprint as k, createBaseBlueprint as l, createSafeToolRegistry as m, defaultPublicGuardrails as n, mapActionModeToRuntimeMode as o, runGuardrails as p, redactSecrets as r, validateStructuredOutput as v };