@polpo-ai/core 0.15.36 → 0.15.38

package/dist/runtime-plan/planner.js

@@ -0,0 +1,322 @@
+import { nanoid } from "nanoid";
+import { normalizeModelPolicy } from "../model-policy.js";
+import { RUNTIME_DECISION_SOURCES, RUNTIME_EXECUTION_MODES, RUNTIME_GUARDRAIL_ACTIONS, RUNTIME_GUARDRAIL_PHASES, RUNTIME_GUARDRAIL_RISKS, RUNTIME_INVOCATION_SOURCES, RUNTIME_PLAN_DEFAULTS, RUNTIME_SURFACES, RUNTIME_TOOL_EXPOSURES, } from "./settings.js";
+function assertMember(value, allowed, label) {
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        throw new Error(`${label} must be one of: ${allowed.join(", ")}`);
+    }
+}
+function requiredString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function optionalString(value, label) {
+    if (value === undefined)
+        return undefined;
+    return requiredString(value, label);
+}
+function requiredValue(value, label) {
+    if (value === undefined)
+        throw new Error(`${label} is required`);
+    return value;
+}
+function uniqueStrings(value, label) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        throw new Error(`${label} must be an array of strings`);
+    const seen = new Set();
+    const output = [];
+    for (const item of value) {
+        if (typeof item !== "string")
+            throw new Error(`${label} must contain only strings`);
+        const normalized = item.trim();
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        output.push(normalized);
+    }
+    return output;
+}
+function normalizeLatencyMap(value) {
+    if (value === undefined)
+        return undefined;
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("Runtime plan audit latencyMs must be an object");
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw new Error("Runtime plan audit latencyMs must be a plain object");
+    }
+    const output = {};
+    for (const [rawKey, rawLatency] of Object.entries(value)) {
+        const key = requiredString(rawKey, "Runtime plan audit latencyMs key");
+        if (key === "__proto__" ||
+            key === "constructor" ||
+            key === "prototype" ||
+            key.length > 64) {
+            throw new Error("Runtime plan audit latencyMs contains an invalid key");
+        }
+        if (typeof rawLatency !== "number" ||
+            !Number.isFinite(rawLatency) ||
+            rawLatency < 0) {
+            throw new Error("Runtime plan audit latencyMs values must be non-negative finite numbers");
+        }
+        output[key] = rawLatency;
+    }
+    return output;
+}
+function normalizedModelSelection(selection) {
+    const policy = normalizeModelPolicy(selection);
+    if (policy.fallbacks.length === 0)
+        return policy.primary;
+    return {
+        primary: policy.primary,
+        fallbacks: policy.fallbacks,
+    };
+}
+function cloneJson(value, path, ancestors) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`${path} must be JSON-serializable`);
+        }
+        return value;
+    }
+    if (typeof value !== "object") {
+        throw new Error(`${path} must be JSON-serializable`);
+    }
+    if (ancestors.has(value)) {
+        throw new Error(`${path} must be JSON-serializable (cyclic value)`);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((item, index) => cloneJson(item, `${path}[${index}]`, ancestors));
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new Error(`${path} must be JSON-serializable`);
+        }
+        const output = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (key === "__proto__" || key === "constructor" || key === "prototype") {
+                throw new Error(`${path}.${key} is not allowed`);
+            }
+            output[key] = cloneJson(item, `${path}.${key}`, ancestors);
+        }
+        return output;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function normalizeGuardrailDecision(decision, index) {
+    const label = `Runtime plan guardrails[${index}]`;
+    const id = requiredString(decision?.id, `${label}.id`);
+    const policyId = requiredString(decision?.policyId, `${label}.policyId`);
+    const policyVersion = optionalString(decision?.policyVersion, `${label}.policyVersion`);
+    assertMember(decision?.phase, RUNTIME_GUARDRAIL_PHASES, `${label}.phase`);
+    assertMember(decision?.action, RUNTIME_GUARDRAIL_ACTIONS, `${label}.action`);
+    assertMember(decision?.risk, RUNTIME_GUARDRAIL_RISKS, `${label}.risk`);
+    const reason = requiredString(decision?.reason, `${label}.reason`);
+    if (decision.latencyMs !== undefined &&
+        (!Number.isFinite(decision.latencyMs) || decision.latencyMs < 0)) {
+        throw new Error(`${label}.latencyMs must be a non-negative finite number`);
+    }
+    if (decision.fallbackUsed !== undefined &&
+        typeof decision.fallbackUsed !== "boolean") {
+        throw new Error(`${label}.fallbackUsed must be a boolean`);
+    }
+    return {
+        id,
+        policyId,
+        ...(policyVersion ? { policyVersion } : {}),
+        phase: decision.phase,
+        action: decision.action,
+        risk: decision.risk,
+        reason,
+        ...(decision.latencyMs !== undefined ? { latencyMs: decision.latencyMs } : {}),
+        ...(decision.fallbackUsed !== undefined
+            ? { fallbackUsed: decision.fallbackUsed }
+            : {}),
+    };
+}
+function resolvedAt(factory) {
+    const value = factory.now?.() ?? new Date();
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new Error("Runtime plan clock must return a valid date");
+    }
+    return date.toISOString();
+}
+export function freezeRuntimePlan(value) {
+    if (!value || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    for (const nested of Object.values(value)) {
+        freezeRuntimePlan(nested);
+    }
+    return Object.freeze(value);
+}
+export function createRuntimePlan(input, factory = {}) {
+    assertMember(input?.surface, RUNTIME_SURFACES, "Runtime plan surface");
+    assertMember(input?.source, RUNTIME_INVOCATION_SOURCES, "Runtime plan source");
+    const id = requiredString(input.id ?? factory.createId?.() ?? `plan-${nanoid(16)}`, "Runtime plan id");
+    const executionMode = input.execution?.mode ?? RUNTIME_PLAN_DEFAULTS.executionMode;
+    assertMember(executionMode, RUNTIME_EXECUTION_MODES, "Runtime plan execution mode");
+    const executionSource = input.execution?.source ?? RUNTIME_PLAN_DEFAULTS.executionSource;
+    assertMember(executionSource, RUNTIME_DECISION_SOURCES, "Runtime plan execution source");
+    const loop = optionalString(input.execution?.loop, "Runtime plan loop name");
+    if (executionMode === "loop" && !loop) {
+        throw new Error("Runtime plan loop mode requires a loop name");
+    }
+    if (executionMode === "direct" && loop) {
+        throw new Error("Direct runtime plans cannot carry a loop name");
+    }
+    const modelSource = input.model?.source ?? RUNTIME_PLAN_DEFAULTS.modelSource;
+    assertMember(modelSource, RUNTIME_DECISION_SOURCES, "Runtime plan model source");
+    const modelSelection = normalizedModelSelection(input.model?.selection);
+    const profile = optionalString(input.model?.profile, "Runtime plan model profile");
+    const sandboxIsolation = input.sandbox?.isolation ?? RUNTIME_PLAN_DEFAULTS.sandboxIsolation;
+    if (sandboxIsolation !== "reuse" && sandboxIsolation !== "fresh") {
+        throw new Error("Runtime plan sandbox isolation must be one of: reuse, fresh");
+    }
+    const sandboxSource = input.sandbox?.source ?? RUNTIME_PLAN_DEFAULTS.sandboxSource;
+    if (sandboxSource !== "request" &&
+        sandboxSource !== "agent" &&
+        sandboxSource !== "default") {
+        throw new Error("Runtime plan sandbox source must be one of: request, agent, default");
+    }
+    const toolExposure = input.tools?.exposure ?? RUNTIME_PLAN_DEFAULTS.toolExposure;
+    assertMember(toolExposure, RUNTIME_TOOL_EXPOSURES, "Runtime plan tool exposure");
+    const confidence = input.audit?.confidence;
+    if (confidence !== undefined &&
+        (!Number.isFinite(confidence) || confidence < 0 || confidence > 1)) {
+        throw new Error("Runtime plan confidence must be between 0 and 1");
+    }
+    if (input.audit?.fallbackUsed !== undefined &&
+        typeof input.audit.fallbackUsed !== "boolean") {
+        throw new Error("Runtime plan fallbackUsed must be a boolean");
+    }
+    const auditLatencyMs = normalizeLatencyMap(input.audit?.latencyMs);
+    const context = input.context === undefined
+        ? {}
+        : cloneJson(input.context, "Runtime plan context", new Set());
+    const plan = {
+        id,
+        surface: input.surface,
+        source: input.source,
+        execution: {
+            mode: executionMode,
+            ...(loop ? { loop } : {}),
+            source: executionSource,
+        },
+        model: {
+            selection: modelSelection,
+            ...(profile ? { profile } : {}),
+            source: modelSource,
+        },
+        sandbox: {
+            isolation: sandboxIsolation,
+            source: sandboxSource,
+        },
+        tools: {
+            exposure: toolExposure,
+            allowed: uniqueStrings(input.tools?.allowed, "Runtime plan allowed tools"),
+        },
+        guardrails: (input.guardrails ?? []).map(normalizeGuardrailDecision),
+        context,
+        audit: {
+            resolvedAt: resolvedAt(factory),
+            planner: optionalString(input.audit?.planner, "Runtime plan planner")
+                ?? RUNTIME_PLAN_DEFAULTS.planner,
+            reasons: uniqueStrings(input.audit?.reasons, "Runtime plan audit reasons"),
+            warnings: uniqueStrings(input.audit?.warnings, "Runtime plan audit warnings"),
+            policyIds: uniqueStrings(input.audit?.policyIds, "Runtime plan audit policy ids"),
+            ...(confidence !== undefined ? { confidence } : {}),
+            ...(auditLatencyMs !== undefined ? { latencyMs: auditLatencyMs } : {}),
+            fallbackUsed: input.audit?.fallbackUsed ?? false,
+        },
+    };
+    return freezeRuntimePlan(plan);
+}
+function record(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return value;
+}
+/**
+ * Rebuild a plan crossing a host boundary from the public allowlisted shape.
+ * This strips unknown fields and re-applies every invariant even when a
+ * JavaScript host bypasses the TypeScript contract.
+ */
+export function normalizeRuntimePlan(value) {
+    const plan = record(value, "Runtime plan");
+    const execution = record(plan.execution, "Runtime plan execution");
+    const model = record(plan.model, "Runtime plan model");
+    const sandbox = record(plan.sandbox, "Runtime plan sandbox");
+    const tools = record(plan.tools, "Runtime plan tools");
+    const audit = record(plan.audit, "Runtime plan audit");
+    if (!Array.isArray(plan.guardrails)) {
+        throw new Error("Runtime plan guardrails must be an array");
+    }
+    const context = record(plan.context, "Runtime plan context");
+    if (!Array.isArray(tools.allowed)) {
+        throw new Error("Runtime plan allowed tools must be an array");
+    }
+    if (!Array.isArray(audit.reasons)) {
+        throw new Error("Runtime plan audit reasons must be an array");
+    }
+    if (!Array.isArray(audit.warnings)) {
+        throw new Error("Runtime plan audit warnings must be an array");
+    }
+    if (!Array.isArray(audit.policyIds)) {
+        throw new Error("Runtime plan audit policy ids must be an array");
+    }
+    const resolvedAtValue = requiredString(audit.resolvedAt, "Runtime plan audit resolvedAt");
+    return createRuntimePlan({
+        id: plan.id,
+        surface: plan.surface,
+        source: plan.source,
+        execution: {
+            mode: requiredValue(execution.mode, "Runtime plan execution mode"),
+            ...(execution.loop !== undefined ? { loop: execution.loop } : {}),
+            source: requiredValue(execution.source, "Runtime plan execution source"),
+        },
+        model: {
+            selection: requiredValue(model.selection, "Runtime plan model selection"),
+            ...(model.profile !== undefined ? { profile: model.profile } : {}),
+            source: requiredValue(model.source, "Runtime plan model source"),
+        },
+        sandbox: {
+            isolation: requiredValue(sandbox.isolation, "Runtime plan sandbox isolation"),
+            source: requiredValue(sandbox.source, "Runtime plan sandbox source"),
+        },
+        tools: {
+            exposure: requiredValue(tools.exposure, "Runtime plan tool exposure"),
+            allowed: tools.allowed,
+        },
+        guardrails: plan.guardrails,
+        context,
+        audit: {
+            planner: requiredValue(audit.planner, "Runtime plan planner"),
+            reasons: audit.reasons,
+            warnings: audit.warnings,
+            policyIds: audit.policyIds,
+            ...(audit.confidence !== undefined ? { confidence: audit.confidence } : {}),
+            ...(audit.latencyMs !== undefined ? { latencyMs: audit.latencyMs } : {}),
+            fallbackUsed: requiredValue(audit.fallbackUsed, "Runtime plan fallbackUsed"),
+        },
+    }, {
+        createId: () => requiredString(plan.id, "Runtime plan id"),
+        now: () => resolvedAtValue,
+    });
+}
+//# sourceMappingURL=planner.js.map

package/dist/runtime-plan/planner.js.map

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

package/dist/runtime-plan/settings.d.ts

@@ -0,0 +1,18 @@
+export declare const RUNTIME_SURFACES: readonly ["agent", "task", "channel", "webhook"];
+export declare const RUNTIME_INVOCATION_SOURCES: readonly ["request", "channel", "task", "schedule", "loop-step", "internal"];
+export declare const RUNTIME_DECISION_SOURCES: readonly ["request", "agent", "project", "router", "default"];
+export declare const RUNTIME_EXECUTION_MODES: readonly ["direct", "loop"];
+export declare const RUNTIME_TOOL_EXPOSURES: readonly ["direct", "router"];
+export declare const RUNTIME_GUARDRAIL_PHASES: readonly ["input", "context", "model.preflight", "tool.before", "tool.after", "output"];
+export declare const RUNTIME_GUARDRAIL_ACTIONS: readonly ["allow", "audit", "taint", "redact", "rewrite", "block", "approval"];
+export declare const RUNTIME_GUARDRAIL_RISKS: readonly ["none", "low", "medium", "high", "critical"];
+export declare const RUNTIME_PLAN_DEFAULTS: Readonly<{
+    readonly executionMode: "direct";
+    readonly executionSource: "default";
+    readonly modelSource: "default";
+    readonly sandboxIsolation: "reuse";
+    readonly sandboxSource: "default";
+    readonly toolExposure: "direct";
+    readonly planner: "runtime-default";
+}>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/runtime-plan/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/runtime-plan/settings.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,kDAKiB,CAAC;AAE/C,eAAO,MAAM,0BAA0B,8EAOgB,CAAC;AAExD,eAAO,MAAM,wBAAwB,+DAMgB,CAAC;AAEtD,eAAO,MAAM,uBAAuB,6BAGgB,CAAC;AAErD,eAAO,MAAM,sBAAsB,+BAGgB,CAAC;AAEpD,eAAO,MAAM,wBAAwB,yFAOgB,CAAC;AAEtD,eAAO,MAAM,yBAAyB,gFAQgB,CAAC;AAEvD,eAAO,MAAM,uBAAuB,wDAMgB,CAAC;AAErD,eAAO,MAAM,qBAAqB;;;;;;;;EAQvB,CAAC"}

package/dist/runtime-plan/settings.js

@@ -0,0 +1,63 @@
+export const RUNTIME_SURFACES = [
+    "agent",
+    "task",
+    "channel",
+    "webhook",
+];
+export const RUNTIME_INVOCATION_SOURCES = [
+    "request",
+    "channel",
+    "task",
+    "schedule",
+    "loop-step",
+    "internal",
+];
+export const RUNTIME_DECISION_SOURCES = [
+    "request",
+    "agent",
+    "project",
+    "router",
+    "default",
+];
+export const RUNTIME_EXECUTION_MODES = [
+    "direct",
+    "loop",
+];
+export const RUNTIME_TOOL_EXPOSURES = [
+    "direct",
+    "router",
+];
+export const RUNTIME_GUARDRAIL_PHASES = [
+    "input",
+    "context",
+    "model.preflight",
+    "tool.before",
+    "tool.after",
+    "output",
+];
+export const RUNTIME_GUARDRAIL_ACTIONS = [
+    "allow",
+    "audit",
+    "taint",
+    "redact",
+    "rewrite",
+    "block",
+    "approval",
+];
+export const RUNTIME_GUARDRAIL_RISKS = [
+    "none",
+    "low",
+    "medium",
+    "high",
+    "critical",
+];
+export const RUNTIME_PLAN_DEFAULTS = Object.freeze({
+    executionMode: "direct",
+    executionSource: "default",
+    modelSource: "default",
+    sandboxIsolation: "reuse",
+    sandboxSource: "default",
+    toolExposure: "direct",
+    planner: "runtime-default",
+});
+//# sourceMappingURL=settings.js.map

package/dist/runtime-plan/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/runtime-plan/settings.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO;IACP,MAAM;IACN,SAAS;IACT,SAAS;CACmC,CAAC;AAE/C,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS;IACT,SAAS;IACT,MAAM;IACN,UAAU;IACV,WAAW;IACX,UAAU;CAC2C,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS;IACT,OAAO;IACP,SAAS;IACT,QAAQ;IACR,SAAS;CAC0C,CAAC;AAEtD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ;IACR,MAAM;CAC4C,CAAC;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ;IACR,QAAQ;CACyC,CAAC;AAEpD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,QAAQ;CAC2C,CAAC;AAEtD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;IACP,UAAU;CAC0C,CAAC;AAEvD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;IACN,UAAU;CACwC,CAAC;AAErD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,aAAa,EAAE,QAAQ;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,OAAO;IACzB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,QAAQ;IACtB,OAAO,EAAE,iBAAiB;CAClB,CAAC,CAAC"}

package/dist/runtime-plan/types.d.ts

@@ -0,0 +1,112 @@
+import type { ModelSelection } from "../model-policy.js";
+import type { SandboxIsolation } from "../runtime-sandbox.js";
+export type RuntimeSurface = "agent" | "task" | "channel" | "webhook";
+export type RuntimeInvocationSource = "request" | "channel" | "task" | "schedule" | "loop-step" | "internal";
+export type RuntimeDecisionSource = "request" | "agent" | "project" | "router" | "default";
+export type RuntimeExecutionMode = "direct" | "loop";
+export type RuntimeToolExposure = "direct" | "router";
+export type RuntimeGuardrailPhase = "input" | "context" | "model.preflight" | "tool.before" | "tool.after" | "output";
+export type RuntimeGuardrailAction = "allow" | "audit" | "taint" | "redact" | "rewrite" | "block" | "approval";
+export type RuntimeGuardrailRisk = "none" | "low" | "medium" | "high" | "critical";
+export interface RuntimeGuardrailDecision {
+    readonly id: string;
+    readonly policyId: string;
+    readonly policyVersion?: string;
+    readonly phase: RuntimeGuardrailPhase;
+    readonly action: RuntimeGuardrailAction;
+    readonly risk: RuntimeGuardrailRisk;
+    readonly reason: string;
+    readonly latencyMs?: number;
+    readonly fallbackUsed?: boolean;
+}
+/** Compatibility alias while the dedicated guardrail package lands in O-R3. */
+export type RuntimePlanGuardrailDecision = RuntimeGuardrailDecision;
+export type RuntimePlanJsonPrimitive = string | number | boolean | null;
+export type RuntimePlanJsonValue = RuntimePlanJsonPrimitive | readonly RuntimePlanJsonValue[] | {
+    readonly [key: string]: RuntimePlanJsonValue;
+};
+/**
+ * Host-neutral context policy references only. Raw context, prompts, retrieved
+ * documents, and messages never belong in a Runtime Plan.
+ */
+export type RuntimeContextPolicy = Readonly<Record<string, RuntimePlanJsonValue>>;
+export interface RuntimeDecisionAudit {
+    readonly resolvedAt: string;
+    readonly planner: string;
+    readonly reasons: readonly string[];
+    readonly warnings: readonly string[];
+    readonly policyIds: readonly string[];
+    readonly confidence?: number;
+    /** Named planning-stage latency measurements in milliseconds. */
+    readonly latencyMs?: Readonly<Record<string, number>>;
+    readonly fallbackUsed: boolean;
+}
+export interface RuntimePlan {
+    readonly id: string;
+    readonly surface: RuntimeSurface;
+    readonly source: RuntimeInvocationSource;
+    readonly execution: Readonly<{
+        mode: RuntimeExecutionMode;
+        loop?: string;
+        source: RuntimeDecisionSource;
+    }>;
+    readonly model: Readonly<{
+        selection: ModelSelection;
+        profile?: string;
+        source: RuntimeDecisionSource;
+    }>;
+    readonly sandbox: Readonly<{
+        isolation: SandboxIsolation;
+        source: Extract<RuntimeDecisionSource, "request" | "agent" | "default">;
+    }>;
+    readonly tools: Readonly<{
+        exposure: RuntimeToolExposure;
+        allowed: readonly string[];
+    }>;
+    readonly guardrails: readonly RuntimeGuardrailDecision[];
+    readonly context: RuntimeContextPolicy;
+    readonly audit: RuntimeDecisionAudit;
+}
+export interface CreateRuntimePlanInput {
+    readonly id?: string;
+    readonly surface: RuntimeSurface;
+    readonly source: RuntimeInvocationSource;
+    readonly execution?: Readonly<{
+        mode?: RuntimeExecutionMode;
+        loop?: string;
+        source?: RuntimeDecisionSource;
+    }>;
+    readonly model: Readonly<{
+        selection: ModelSelection;
+        profile?: string;
+        source?: RuntimeDecisionSource;
+    }>;
+    readonly sandbox?: Readonly<{
+        isolation?: SandboxIsolation;
+        source?: Extract<RuntimeDecisionSource, "request" | "agent" | "default">;
+    }>;
+    readonly tools?: Readonly<{
+        exposure?: RuntimeToolExposure;
+        allowed?: readonly string[];
+    }>;
+    readonly guardrails?: readonly RuntimeGuardrailDecision[];
+    readonly context?: RuntimeContextPolicy;
+    readonly audit?: Readonly<{
+        planner?: string;
+        reasons?: readonly string[];
+        warnings?: readonly string[];
+        policyIds?: readonly string[];
+        confidence?: number;
+        latencyMs?: Readonly<Record<string, number>>;
+        fallbackUsed?: boolean;
+    }>;
+}
+export interface RuntimePlanFactoryOptions {
+    readonly createId?: () => string;
+    readonly now?: () => Date | string;
+}
+export interface RuntimePlanResolvedEvent {
+    readonly type: "runtime.plan.resolved";
+    readonly plan: RuntimePlan;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime-plan/types.d.ts.map

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

package/dist/runtime-plan/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime-plan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime-plan/types.ts"],"names":[],"mappings":""}