typekro 0.28.1 → 0.30.0

package/dist/core/planning/materialization.d.ts

@@ -0,0 +1,54 @@
+import { TypeKroError } from '../errors.js';
+import type { PlanValue } from './types.js';
+/** Explicit bindings supplied after pure planning and before artifact execution. */
+export interface PlanMaterializationBindings {
+    readonly spec?: unknown;
+    readonly sensitive?: Readonly<Record<string, unknown>>;
+    readonly externalInputs?: Readonly<Record<string, unknown>>;
+    readonly artifactOutputs?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+    /** Portable iterator variables available while expanding a direct artifact. */
+    readonly locals?: Readonly<Record<string, unknown>>;
+    /** Canonical schema `$item` paths bound by the current iteration coordinates. */
+    readonly iterationItems?: Readonly<Record<string, unknown>>;
+    /** Concrete producer ids selected for references from the current artifact instance. */
+    readonly resourceIds?: Readonly<Record<string, string>>;
+}
+/** Explicit policy and named values for plaintext static-YAML materialization. */
+export interface StaticYamlMaterializationOptions {
+    /** Acknowledges that returned YAML may contain plaintext sensitive values. */
+    readonly allowSensitiveMaterialization?: true;
+    /** Values for explicit `sensitiveValue(binding)` references. */
+    readonly sensitiveBindings?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Prepare the plaintext-only binding map used by static YAML. Canonical plans
+ * and artifact records remain binding-only; this helper is called only at the
+ * final serialization boundary.
+ */
+export declare function resolveStaticYamlSensitiveBindings(requiredBindings: readonly string[], capturedBindings: Readonly<Record<string, unknown>>, options: StaticYamlMaterializationOptions | undefined, context: string, containsSensitiveValue?: boolean): Readonly<Record<string, unknown>>;
+/**
+ * Extract ephemeral values for sensitive binding identities already present in
+ * a canonical value. The returned envelope is deliberately separate from the
+ * PlanValue and must never be encoded into a plan or artifact bundle.
+ */
+export declare function collectPlanValueSensitiveBindings(value: PlanValue, concrete: unknown, path?: string): Readonly<Record<string, unknown>>;
+/** Return the stable sensitive binding identities referenced by a PlanValue. */
+export declare function planValueSensitiveBindingNames(value: PlanValue): readonly string[];
+/** Whether a canonical value contains tainted data that can be resolved from ordinary bindings. */
+export declare function planValueContainsSensitiveValue(value: PlanValue): boolean;
+/** Rewrite binding identities without resolving or exposing their values. */
+export declare function mapPlanValueSensitiveBindings(value: PlanValue, mapBinding: (binding: string) => string): PlanValue;
+export declare class PlanMaterializationError extends TypeKroError {
+    constructor(message: string, path: string, details?: Record<string, unknown>);
+}
+/** Convert a canonical PlanValue into the runtime value consumed by existing executors. */
+export declare function materializePlanValue(value: PlanValue, bindings?: PlanMaterializationBindings, path?: string): unknown;
+/**
+ * Resolve an activation condition when all of its inputs are available before
+ * deployment. `undefined` means the condition depends on runtime resource
+ * state and must remain attached to the artifact.
+ */
+export declare function evaluatePlanActivation(value: PlanValue, bindings?: PlanMaterializationBindings, path?: string): boolean | undefined;
+/** Rehydrate symbolic PlanValue records for the established KRO serializer. */
+export declare function materializePlanValueForKro(value: PlanValue, path?: string): unknown;
+//# sourceMappingURL=materialization.d.ts.map

package/dist/core/planning/materialization.d.ts.map

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

package/dist/core/planning/materialization.js

@@ -0,0 +1,489 @@
+import { evaluate } from 'cel-js';
+import { CEL_EXPRESSION_BRAND, KUBERNETES_REF_BRAND } from '../constants/brands.js';
+import { TypeKroError } from '../errors.js';
+import { KRO_ARTIFACT_BINDINGS_SPEC_FIELD, kroArtifactOutputField, kroArtifactRequirementField, } from './values.js';
+/**
+ * Prepare the plaintext-only binding map used by static YAML. Canonical plans
+ * and artifact records remain binding-only; this helper is called only at the
+ * final serialization boundary.
+ */
+export function resolveStaticYamlSensitiveBindings(requiredBindings, capturedBindings, options, context, containsSensitiveValue = false) {
+    const required = [...new Set(requiredBindings)].sort();
+    if (required.length === 0 && !containsSensitiveValue)
+        return {};
+    if (options?.allowSensitiveMaterialization !== true) {
+        throw new TypeKroError(`${context} contains sensitive values and requires explicit plaintext materialization.`, 'SENSITIVE_YAML_MATERIALIZATION_REQUIRED', { bindings: required, containsSensitiveValue });
+    }
+    const resolved = { ...capturedBindings };
+    for (const [binding, value] of Object.entries(options.sensitiveBindings ?? {})) {
+        if (Object.hasOwn(resolved, binding) && !Object.is(resolved[binding], value)) {
+            throw new TypeKroError(`${context} received conflicting values for sensitive binding ${binding}.`, 'SENSITIVE_BINDING_CONFLICT', { binding });
+        }
+        resolved[binding] = value;
+    }
+    const missing = required.filter((binding) => !Object.hasOwn(resolved, binding));
+    if (missing.length > 0) {
+        throw new TypeKroError(`${context} is missing sensitive materialization bindings: ${missing.join(', ')}.`, 'SENSITIVE_BINDING_UNRESOLVED', { bindings: missing });
+    }
+    return Object.fromEntries(required.map((binding) => [binding, resolved[binding]]));
+}
+function isSensitiveBindingDescriptor(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Reflect.get(value, 'kind') === 'sensitive-binding' &&
+        typeof Reflect.get(value, 'binding') === 'string');
+}
+function collectSensitiveBindings(value, concrete, bindings, path) {
+    switch (value.kind) {
+        case 'sensitive-binding': {
+            // An explicit sensitiveValue(binding) has no materialized bytes in the
+            // concrete spec. It remains unresolved until a caller supplies that
+            // named binding through an operational resolver.
+            if (isSensitiveBindingDescriptor(concrete) && concrete.binding === value.binding) {
+                return;
+            }
+            if (Object.hasOwn(bindings, value.binding) && !Object.is(bindings[value.binding], concrete)) {
+                throw new PlanMaterializationError(`Sensitive binding ${value.binding} resolved to conflicting values.`, path, { binding: value.binding });
+            }
+            bindings[value.binding] = concrete;
+            return;
+        }
+        case 'sensitive-value':
+            collectSensitiveBindings(value.value, concrete, bindings, `${path}.value`);
+            return;
+        case 'array': {
+            const items = Array.isArray(concrete) ? concrete : [];
+            value.items.forEach((item, index) => collectSensitiveBindings(item, items[index], bindings, `${path}[${index}]`));
+            return;
+        }
+        case 'object': {
+            const record = concrete && typeof concrete === 'object' && !Array.isArray(concrete)
+                ? concrete
+                : {};
+            value.entries.forEach((entry) => collectSensitiveBindings(entry.value, record[entry.key], bindings, `${path}.${entry.key}`));
+            return;
+        }
+        default:
+            return;
+    }
+}
+/**
+ * Extract ephemeral values for sensitive binding identities already present in
+ * a canonical value. The returned envelope is deliberately separate from the
+ * PlanValue and must never be encoded into a plan or artifact bundle.
+ */
+export function collectPlanValueSensitiveBindings(value, concrete, path = '$') {
+    const bindings = {};
+    collectSensitiveBindings(value, concrete, bindings, path);
+    return bindings;
+}
+/** Return the stable sensitive binding identities referenced by a PlanValue. */
+export function planValueSensitiveBindingNames(value) {
+    const names = new Set();
+    const visit = (current) => {
+        switch (current.kind) {
+            case 'sensitive-binding':
+                names.add(current.binding);
+                return;
+            case 'sensitive-value':
+                visit(current.value);
+                return;
+            case 'array':
+                current.items.forEach(visit);
+                return;
+            case 'object':
+                current.entries.forEach((entry) => visit(entry.value));
+                return;
+            default:
+                return;
+        }
+    };
+    visit(value);
+    return [...names].sort();
+}
+/** Whether a canonical value contains tainted data that can be resolved from ordinary bindings. */
+export function planValueContainsSensitiveValue(value) {
+    switch (value.kind) {
+        case 'sensitive-value':
+            return true;
+        case 'array':
+            return value.items.some(planValueContainsSensitiveValue);
+        case 'object':
+            return value.entries.some((entry) => planValueContainsSensitiveValue(entry.value));
+        default:
+            return false;
+    }
+}
+/** Rewrite binding identities without resolving or exposing their values. */
+export function mapPlanValueSensitiveBindings(value, mapBinding) {
+    switch (value.kind) {
+        case 'sensitive-binding':
+            return { ...value, binding: mapBinding(value.binding) };
+        case 'sensitive-value':
+            return { ...value, value: mapPlanValueSensitiveBindings(value.value, mapBinding) };
+        case 'array':
+            return {
+                ...value,
+                items: value.items.map((item) => mapPlanValueSensitiveBindings(item, mapBinding)),
+            };
+        case 'object':
+            return {
+                ...value,
+                entries: value.entries.map((entry) => ({
+                    ...entry,
+                    value: mapPlanValueSensitiveBindings(entry.value, mapBinding),
+                })),
+            };
+        default:
+            return value;
+    }
+}
+export class PlanMaterializationError extends TypeKroError {
+    constructor(message, path, details = {}) {
+        super(message, 'PLAN_MATERIALIZATION_FAILED', { path, ...details });
+        this.name = 'PlanMaterializationError';
+    }
+}
+const OMIT = Symbol('typekro.plan.omit');
+function cloneEvaluationValue(value) {
+    if (Array.isArray(value))
+        return value.map(cloneEvaluationValue);
+    if (!value || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, child]) => [
+        key,
+        cloneEvaluationValue(child),
+    ]));
+}
+function ensureEvaluationPath(root, fieldPath) {
+    const parts = fieldPath.split('.').filter(Boolean);
+    const leaf = parts.pop();
+    if (!leaf)
+        return;
+    let current = root;
+    for (const part of parts) {
+        const child = current[part];
+        if (!child || typeof child !== 'object' || Array.isArray(child))
+            current[part] = {};
+        current = current[part];
+    }
+    if (!Object.hasOwn(current, leaf))
+        current[leaf] = null;
+}
+function evaluatePortableExpression(expression, bindings, path, references = []) {
+    try {
+        const missingPresencePaths = new Set();
+        let executable = expression.replace(/\bhas\(schema\.spec\.([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*)\)/g, (_match, fieldPath) => {
+            const missing = readPath(bindings.spec, fieldPath, path, true, bindings.iterationItems) === OMIT;
+            if (missing)
+                missingPresencePaths.add(fieldPath);
+            return missing ? 'false' : 'true';
+        });
+        const clonedSpec = cloneEvaluationValue(bindings.spec);
+        const specContext = clonedSpec && typeof clonedSpec === 'object' && !Array.isArray(clonedSpec)
+            ? clonedSpec
+            : {};
+        for (const reference of references) {
+            if (reference.source !== 'spec')
+                continue;
+            const guarded = [...missingPresencePaths].some((fieldPath) => reference.fieldPath === fieldPath || reference.fieldPath.startsWith(`${fieldPath}.`));
+            if (guarded)
+                ensureEvaluationPath(specContext, reference.fieldPath);
+        }
+        const context = {
+            schema: { spec: specContext },
+            ...(bindings.locals ?? {}),
+        };
+        Object.entries(bindings.iterationItems ?? {})
+            .sort(([left], [right]) => right.length - left.length)
+            .forEach(([itemPath, item], index) => {
+            const variable = `__typekro_item_${index}`;
+            executable = executable.split(`schema.spec.${itemPath}`).join(variable);
+            context[variable] = item;
+        });
+        return evaluate(executable, context, {
+            string: (value) => String(value),
+            int: (value) => Number.parseInt(String(value), 10),
+            double: (value) => Number.parseFloat(String(value)),
+            size: (value) => Array.isArray(value) || typeof value === 'string'
+                ? value.length
+                : value && typeof value === 'object'
+                    ? Object.keys(value).length
+                    : 0,
+            has: (value) => value !== undefined && value !== null,
+            concat: (...values) => values.join(''),
+        });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new PlanMaterializationError(`Portable expression could not be evaluated at ${path}: ${expression}`, path, {
+            expression,
+            error: reason,
+        });
+    }
+}
+function readPath(root, fieldPath, path, optional = false, iterationItems = {}) {
+    const normalizedPath = fieldPath
+        .split('.')
+        .filter((part) => part.length > 0)
+        .map((part) => (part.startsWith('?') ? part.slice(1) : part))
+        .join('.');
+    const itemBinding = Object.entries(iterationItems)
+        .filter(([itemPath]) => normalizedPath === itemPath || normalizedPath.startsWith(`${itemPath}.`))
+        .sort(([left], [right]) => right.length - left.length)[0];
+    const parts = itemBinding
+        ? normalizedPath.slice(itemBinding[0].length).replace(/^\./, '').split('.').filter(Boolean)
+        : normalizedPath.split('.').filter(Boolean);
+    if (itemBinding)
+        root = itemBinding[1];
+    let current = root;
+    for (const part of parts) {
+        if (!current || typeof current !== 'object' || !(part in current)) {
+            if (optional)
+                return OMIT;
+            throw new PlanMaterializationError(`Declared spec reference ${fieldPath} is not present in materialization input.`, path, { fieldPath });
+        }
+        current = Reflect.get(current, part);
+    }
+    return current;
+}
+function runtimeReference(resourceId, fieldPath, options = {}) {
+    const marker = `__KUBERNETES_REF_${resourceId}_${fieldPath}__`;
+    const reference = (() => marker);
+    Object.assign(reference, {
+        resourceId,
+        fieldPath,
+        ...(options.nestedComposition ? { __nestedComposition: true } : {}),
+    });
+    Object.defineProperties(reference, {
+        toString: { value: () => marker, enumerable: false },
+        valueOf: { value: () => marker, enumerable: false },
+        [Symbol.toPrimitive]: {
+            value: (hint) => (hint === 'number' ? Number.NaN : marker),
+            enumerable: false,
+        },
+    });
+    Object.defineProperty(reference, KUBERNETES_REF_BRAND, {
+        value: true,
+        enumerable: false,
+    });
+    return reference;
+}
+function runtimeExpression(expression, template = false) {
+    const value = { expression, ...(template ? { __isTemplate: true } : {}) };
+    Object.defineProperty(value, CEL_EXPRESSION_BRAND, { value: true, enumerable: false });
+    return value;
+}
+function markerString(source, resourceId, fieldPath) {
+    const id = source === 'spec' ? '__schema__' : resourceId;
+    if (!id)
+        throw new PlanMaterializationError(`Template resource reference has no producer id.`, '$');
+    const path = source === 'spec' && !fieldPath.startsWith('spec.') ? `spec.${fieldPath}` : fieldPath;
+    return `__KUBERNETES_REF_${id}_${path}__`;
+}
+function materialize(value, bindings, path) {
+    switch (value.kind) {
+        case 'literal':
+            return value.value;
+        case 'omitted':
+            return OMIT;
+        case 'array':
+            return value.items.map((item, index) => {
+                const child = materialize(item, bindings, `${path}[${index}]`);
+                return child === OMIT ? undefined : child;
+            });
+        case 'object': {
+            const result = {};
+            for (const entry of value.entries) {
+                const child = materialize(entry.value, bindings, `${path}.${entry.key}`);
+                if (child !== OMIT)
+                    result[entry.key] = child;
+            }
+            return result;
+        }
+        case 'reference':
+            if (value.source === 'spec') {
+                if (bindings.spec === undefined) {
+                    throw new PlanMaterializationError(`Spec binding is required to resolve ${value.fieldPath}.`, path, { fieldPath: value.fieldPath });
+                }
+                return readPath(bindings.spec, value.fieldPath, path, value.optional === true, bindings.iterationItems);
+            }
+            if (!value.resourceId) {
+                throw new PlanMaterializationError(`Resource reference has no producer id.`, path);
+            }
+            return runtimeReference(bindings.resourceIds?.[value.resourceId] ?? value.resourceId, value.fieldPath, {
+                ...(value.nestedComposition ? { nestedComposition: true } : {}),
+            });
+        case 'expression':
+            if (value.expression.language !== 'portable-cel') {
+                throw new PlanMaterializationError(`Raw CEL cannot be materialized for direct execution.`, path, { language: value.expression.language });
+            }
+            if (value.expression.references.some((reference) => reference.source === 'resource')) {
+                return runtimeExpression(value.expression.expression);
+            }
+            if (bindings.spec === undefined &&
+                value.expression.references.some((reference) => reference.source === 'spec')) {
+                throw new PlanMaterializationError(`Spec binding is required to evaluate ${value.expression.expression}.`, path, { expression: value.expression.expression });
+            }
+            return evaluatePortableExpression(value.expression.expression, bindings, path, value.expression.references);
+        case 'template': {
+            let hasRuntimeExpression = false;
+            const renderedSegments = [];
+            for (const segment of value.segments) {
+                if (segment.kind === 'literal') {
+                    renderedSegments.push(segment.value);
+                    continue;
+                }
+                if (segment.kind === 'expression') {
+                    const onlySpecReferences = segment.expression.references.every((reference) => reference.source === 'spec');
+                    if (bindings.spec !== undefined && onlySpecReferences) {
+                        renderedSegments.push(String(evaluatePortableExpression(segment.expression.expression, bindings, path, segment.expression.references)));
+                        continue;
+                    }
+                    hasRuntimeExpression = true;
+                    renderedSegments.push(`\${${segment.expression.expression}}`);
+                    continue;
+                }
+                if (segment.source === 'spec' && bindings.spec !== undefined) {
+                    const resolved = readPath(bindings.spec, segment.fieldPath, path, segment.optional === true, bindings.iterationItems);
+                    if (resolved === OMIT)
+                        return OMIT;
+                    renderedSegments.push(String(resolved));
+                    continue;
+                }
+                renderedSegments.push(markerString(segment.source, segment.resourceId
+                    ? (bindings.resourceIds?.[segment.resourceId] ?? segment.resourceId)
+                    : undefined, segment.fieldPath));
+            }
+            const rendered = renderedSegments.join('');
+            return hasRuntimeExpression ? runtimeExpression(rendered, true) : rendered;
+        }
+        case 'sensitive-binding': {
+            if (!Object.hasOwn(bindings.sensitive ?? {}, value.binding)) {
+                throw new PlanMaterializationError(`Sensitive binding ${value.binding} was not supplied.`, path, { binding: value.binding });
+            }
+            return bindings.sensitive?.[value.binding];
+        }
+        case 'sensitive-value':
+            return materialize(value.value, bindings, `${path}.value`);
+        case 'external-input': {
+            if (!Object.hasOwn(bindings.externalInputs ?? {}, value.name)) {
+                throw new PlanMaterializationError(`External input ${value.name} was not supplied.`, path, {
+                    input: value.name,
+                });
+            }
+            return bindings.externalInputs?.[value.name];
+        }
+        case 'artifact-output': {
+            const outputs = bindings.artifactOutputs?.[value.requirementId];
+            if (!outputs || !Object.hasOwn(outputs, value.output)) {
+                throw new PlanMaterializationError(`Artifact output ${value.requirementId}.${value.output} was not supplied.`, path, { requirementId: value.requirementId, output: value.output });
+            }
+            return outputs[value.output];
+        }
+    }
+}
+/** Convert a canonical PlanValue into the runtime value consumed by existing executors. */
+export function materializePlanValue(value, bindings = {}, path = '$') {
+    const result = materialize(value, bindings, path);
+    return result === OMIT ? undefined : result;
+}
+/**
+ * Resolve an activation condition when all of its inputs are available before
+ * deployment. `undefined` means the condition depends on runtime resource
+ * state and must remain attached to the artifact.
+ */
+export function evaluatePlanActivation(value, bindings = {}, path = '$') {
+    if (value.kind === 'expression') {
+        if (value.expression.language !== 'portable-cel') {
+            throw new PlanMaterializationError('Raw CEL activation cannot be evaluated for direct execution.', path, { language: value.expression.language });
+        }
+        if (value.expression.references.some((reference) => reference.source === 'resource')) {
+            return undefined;
+        }
+        if (bindings.spec === undefined && value.expression.references.length > 0) {
+            throw new PlanMaterializationError('Spec binding is required to evaluate activation.', path, {
+                expression: value.expression.expression,
+            });
+        }
+        const result = evaluatePortableExpression(value.expression.expression, bindings, path, value.expression.references);
+        if (typeof result !== 'boolean') {
+            throw new PlanMaterializationError('Activation expression did not evaluate to a boolean.', path, { expression: value.expression.expression, resultType: typeof result });
+        }
+        return result;
+    }
+    if ((value.kind === 'reference' && value.source === 'resource') || value.kind === 'template') {
+        return undefined;
+    }
+    const result = materialize(value, bindings, path);
+    if (result === OMIT || result === undefined || result === null)
+        return false;
+    if (typeof result !== 'boolean') {
+        throw new PlanMaterializationError('Activation value did not materialize to a boolean.', path, {
+            resultType: typeof result,
+        });
+    }
+    return result;
+}
+function materializeKro(value, path) {
+    switch (value.kind) {
+        case 'literal':
+            return value.value;
+        case 'omitted':
+            return OMIT;
+        case 'array':
+            return value.items.map((item, index) => {
+                const child = materializeKro(item, `${path}[${index}]`);
+                return child === OMIT ? undefined : child;
+            });
+        case 'object': {
+            const result = {};
+            for (const entry of value.entries) {
+                const child = materializeKro(entry.value, `${path}.${entry.key}`);
+                if (child !== OMIT)
+                    result[entry.key] = child;
+            }
+            return result;
+        }
+        case 'reference':
+            return value.source === 'spec'
+                ? runtimeReference('__schema__', `spec.${value.fieldPath}`)
+                : value.resourceId
+                    ? runtimeReference(value.resourceId, value.fieldPath, {
+                        ...(value.nestedComposition ? { nestedComposition: true } : {}),
+                    })
+                    : (() => {
+                        throw new PlanMaterializationError('KRO resource reference has no producer id.', path);
+                    })();
+        case 'expression':
+            return runtimeExpression(value.expression.expression);
+        case 'template': {
+            const rendered = value.segments
+                .map((segment) => {
+                if (segment.kind === 'literal')
+                    return segment.value;
+                if (segment.kind === 'expression')
+                    return `\${${segment.expression.expression}}`;
+                return markerString(segment.source, segment.resourceId, segment.fieldPath);
+            })
+                .join('');
+            return value.segments.some((segment) => segment.kind === 'expression')
+                ? runtimeExpression(rendered, true)
+                : rendered;
+        }
+        case 'sensitive-binding':
+            throw new PlanMaterializationError(`Sensitive binding ${value.binding} cannot be embedded in a shared KRO graph.`, path, { binding: value.binding });
+        case 'sensitive-value':
+            return materializeKro(value.value, `${path}.value`);
+        case 'external-input':
+            throw new PlanMaterializationError(`External input ${value.name} cannot be embedded in a shared KRO graph.`, path, { input: value.name });
+        case 'artifact-output':
+            return runtimeReference('__schema__', `spec.${KRO_ARTIFACT_BINDINGS_SPEC_FIELD}.${kroArtifactRequirementField(value.requirementId)}.${kroArtifactOutputField(value.output)}`);
+    }
+}
+/** Rehydrate symbolic PlanValue records for the established KRO serializer. */
+export function materializePlanValueForKro(value, path = '$') {
+    const result = materializeKro(value, path);
+    return result === OMIT ? undefined : result;
+}
+//# sourceMappingURL=materialization.js.map

package/dist/core/planning/materialization.js.map

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

package/dist/core/planning/plan-codec.d.ts

@@ -0,0 +1,11 @@
+import { TypeKroError } from '../errors.js';
+import { type DesiredStatePlan } from './types.js';
+/** Failure raised when a serialized semantic plan violates its versioned contract. */
+export declare class DesiredStatePlanDecodeError extends TypeKroError {
+    constructor(message: string, path: string);
+}
+/** Canonically encode a semantic desired-state plan. */
+export declare function encodeDesiredStatePlan(plan: DesiredStatePlan): string;
+/** Decode and validate a complete semantic desired-state plan. */
+export declare function decodeDesiredStatePlan(encoded: string): DesiredStatePlan;
+//# sourceMappingURL=plan-codec.d.ts.map

package/dist/core/planning/plan-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-codec.d.ts","sourceRoot":"","sources":["../../../src/core/planning/plan-codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAEL,KAAK,gBAAgB,EAKtB,MAAM,YAAY,CAAC;AAKpB,sFAAsF;AACtF,qBAAa,2BAA4B,SAAQ,YAAY;gBAC/C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AA6pBD,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAErE;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAaxE"}