@executioncontrolprotocol/types 0.10.0

package/README.md

@@ -0,0 +1,16 @@
+# @executioncontrolprotocol/types
+
+Protocol types, constants, and generated JSON Schema (`npm run generate:schema` from repo root).
+
+Shared by all `@executioncontrolprotocol/*` packages. No runtime or host dependencies.
+
+`@executioncontrolprotocol/types` is the primary dependency for anyone who wants to **build on ECP**:
+extensions, runtimes, harnesses, CLIs, UIs, and external tooling should import
+the canonical types from here instead of re-defining protocol shapes.
+
+Guidelines:
+
+- Prefer `@executioncontrolprotocol/types` schema constants/unions (e.g. `@executioncontrolprotocol.workflow`, `@executioncontrolprotocol.patch`)
+  over repeating string literals.
+- Keep this package dependency-light so it can be installed broadly.
+- Treat types as the “public contract” for third-party extension authors.

package/dist/capabilities.d.ts

@@ -0,0 +1,31 @@
+import type { ValidationIssue } from "./validation.js";
+/** Minimum model generate capability input. @category Capabilities */
+export interface GenerateCapabilityInput {
+    prompt: string;
+    system?: string;
+    context?: unknown;
+    options?: Record<string, unknown>;
+}
+/** Minimum model generate capability output. @category Capabilities */
+export interface GenerateCapabilityOutput {
+    text: string;
+    raw?: unknown;
+    usage?: unknown;
+    diagnostics?: ValidationIssue[];
+}
+/** Minimum evaluate capability input. @category Capabilities */
+export interface EvaluateCapabilityInput {
+    subject: unknown;
+    criteria?: unknown;
+    rubric?: unknown;
+    options?: Record<string, unknown>;
+}
+/** Minimum evaluate capability output. @category Capabilities */
+export interface EvaluateCapabilityOutput {
+    passed?: boolean;
+    score?: number;
+    result?: unknown;
+    rationale?: string;
+    diagnostics?: ValidationIssue[];
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;CAChC;AAED,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;CAChC"}

package/dist/capabilities.js

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

package/dist/capabilities.js.map

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

package/dist/encoding.d.ts

@@ -0,0 +1,99 @@
+import type { EcpSchema } from "./schema.js";
+import type { EcpVersion } from "./version.js";
+import type { ValidationIssue } from "./validation.js";
+import type { ValidationResult } from "./validation.js";
+/** Reserved capability names for format extensions. @category Encoding */
+export declare const ECP_FORMAT_CAPABILITY_NAMES: {
+    readonly ENCODE: "encode";
+    readonly DECODE: "decode";
+};
+/** Known format identifiers. @category Encoding */
+export declare const ECP_FORMATS: {
+    readonly JSON: "json";
+    readonly TOON: "toon";
+    readonly FLUENT: "fluent";
+    readonly EQL: "eql";
+};
+/** Encoding error codes. @category Encoding */
+export declare const ECP_ENCODING_ERROR_CODES: {
+    readonly FORMAT_EXTENSION_NOT_FOUND: "FORMAT_EXTENSION_NOT_FOUND";
+    readonly FORMAT_ENCODER_NOT_FOUND: "FORMAT_ENCODER_NOT_FOUND";
+    readonly FORMAT_DECODER_NOT_FOUND: "FORMAT_DECODER_NOT_FOUND";
+    readonly FORMAT_ENCODER_INVALID_CONTRACT: "FORMAT_ENCODER_INVALID_CONTRACT";
+    readonly FORMAT_DECODER_INVALID_CONTRACT: "FORMAT_DECODER_INVALID_CONTRACT";
+    readonly FORMAT_ENCODE_FAILED: "FORMAT_ENCODE_FAILED";
+    readonly FORMAT_DECODE_FAILED: "FORMAT_DECODE_FAILED";
+    readonly FORMAT_UNSUPPORTED_SOURCE_SCHEMA: "FORMAT_UNSUPPORTED_SOURCE_SCHEMA";
+    readonly FORMAT_UNSUPPORTED_TARGET_SCHEMA: "FORMAT_UNSUPPORTED_TARGET_SCHEMA";
+};
+/** Encoding error code union. @category Encoding */
+export type EcpEncodingErrorCode = (typeof ECP_ENCODING_ERROR_CODES)[keyof typeof ECP_ENCODING_ERROR_CODES];
+/** Standard format encoder options. @category Encoding */
+export interface EcpFormatOptions extends Record<string, unknown> {
+    /** Include schema/version headers in encoded output. Default true. */
+    headers?: boolean;
+    /** Prefer compact output. Default false. */
+    compact?: boolean;
+    /** Return string content instead of object (JSON codec). */
+    as?: "object" | "string";
+    /** Fields to include when supported by the encoder. */
+    include?: string[];
+}
+/** Standard format decoder options. @category Encoding */
+export interface EcpDecodeOptions extends Record<string, unknown> {
+    /** Fail on invalid syntax or schema mismatch. */
+    strict?: boolean;
+    /** Header expectation. Default `"auto"`. */
+    headers?: boolean | "auto";
+    /** Match compact TOON encoding (`keyFolding: safe`). Default false. */
+    compact?: boolean;
+}
+/** Encode operation result. @category Encoding */
+export interface EncodeResult<T = unknown> {
+    schema: "@executioncontrolprotocol.encode.result";
+    version: EcpVersion;
+    success: boolean;
+    format: string;
+    sourceSchema?: EcpSchema;
+    sourceVersion?: EcpVersion;
+    mediaType?: string;
+    result?: T;
+    validation?: ValidationResult;
+    diagnostics: ValidationIssue[];
+}
+/** Decode operation result. @category Encoding */
+export interface DecodeResult<T = unknown> {
+    schema: "@executioncontrolprotocol.decode.result";
+    version: EcpVersion;
+    success: boolean;
+    targetSchema?: EcpSchema;
+    targetVersion?: EcpVersion;
+    result?: T;
+    validation?: ValidationResult;
+    diagnostics: ValidationIssue[];
+}
+/** Concrete encode result for schema generation. @category Encoding */
+export type EncodeResultDocument = EncodeResult<unknown>;
+/** Concrete decode result for schema generation. @category Encoding */
+export type DecodeResultDocument = DecodeResult<unknown>;
+/** Minimum encode capability contract. Extensions intersect `TOptions`. @category Encoding */
+export interface EncodeCapabilityInput<TValue = unknown, TOptions extends Record<string, unknown> = EcpFormatOptions> {
+    source: TValue;
+    sourceSchema?: EcpSchema;
+    sourceVersion?: EcpVersion;
+    format?: string;
+    options?: TOptions;
+}
+/** Minimum decode capability contract. @category Encoding */
+export interface DecodeCapabilityInput<TOptions extends Record<string, unknown> = EcpDecodeOptions> {
+    input: unknown;
+    format?: string;
+    targetSchema?: EcpSchema;
+    targetVersion?: EcpVersion;
+    options?: TOptions;
+}
+/** Input to `{extensionId}.encode` capabilities. @category Encoding */
+export type EcpEncodeInput = EncodeCapabilityInput;
+/** Input to `{extensionId}.decode` capabilities. @category Encoding */
+export type EcpDecodeInput = DecodeCapabilityInput;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

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

package/dist/encoding.js

@@ -0,0 +1,25 @@
+/** Reserved capability names for format extensions. @category Encoding */
+export const ECP_FORMAT_CAPABILITY_NAMES = {
+    ENCODE: "encode",
+    DECODE: "decode",
+};
+/** Known format identifiers. @category Encoding */
+export const ECP_FORMATS = {
+    JSON: "json",
+    TOON: "toon",
+    FLUENT: "fluent",
+    EQL: "eql",
+};
+/** Encoding error codes. @category Encoding */
+export const ECP_ENCODING_ERROR_CODES = {
+    FORMAT_EXTENSION_NOT_FOUND: "FORMAT_EXTENSION_NOT_FOUND",
+    FORMAT_ENCODER_NOT_FOUND: "FORMAT_ENCODER_NOT_FOUND",
+    FORMAT_DECODER_NOT_FOUND: "FORMAT_DECODER_NOT_FOUND",
+    FORMAT_ENCODER_INVALID_CONTRACT: "FORMAT_ENCODER_INVALID_CONTRACT",
+    FORMAT_DECODER_INVALID_CONTRACT: "FORMAT_DECODER_INVALID_CONTRACT",
+    FORMAT_ENCODE_FAILED: "FORMAT_ENCODE_FAILED",
+    FORMAT_DECODE_FAILED: "FORMAT_DECODE_FAILED",
+    FORMAT_UNSUPPORTED_SOURCE_SCHEMA: "FORMAT_UNSUPPORTED_SOURCE_SCHEMA",
+    FORMAT_UNSUPPORTED_TARGET_SCHEMA: "FORMAT_UNSUPPORTED_TARGET_SCHEMA",
+};
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAKA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAA;AAEV,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACF,CAAA;AAEV,+CAA+C;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,0BAA0B,EAAE,4BAA4B;IACxD,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IACpD,+BAA+B,EAAE,iCAAiC;IAClE,+BAA+B,EAAE,iCAAiC;IAClE,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,gCAAgC,EAAE,kCAAkC;IACpE,gCAAgC,EAAE,kCAAkC;CAC5D,CAAA"}

package/dist/environment.d.ts

@@ -0,0 +1,132 @@
+import type { NamespacedId } from "./schema.js";
+import type { EcpVersion } from "./version.js";
+/** Environment manifest (bindings only). @category Environment */
+export interface EnvironmentManifest {
+    schema: "@executioncontrolprotocol.environment";
+    version: EcpVersion;
+    environment: {
+        id: string;
+        label?: string;
+    };
+    runtime?: RuntimeBindingManifest;
+    extensions?: ExtensionBindingManifest[];
+    policies?: PolicyBindingManifest[];
+}
+/** Runtime binding in environment manifest. @category Environment */
+export interface RuntimeBindingManifest {
+    id: NamespacedId | string;
+    label?: string;
+    config?: Record<string, unknown>;
+}
+/** Extension binding in environment manifest. @category Environment */
+export interface ExtensionBindingManifest {
+    id: NamespacedId | string;
+    label?: string;
+    order: number;
+    config?: Record<string, unknown>;
+}
+/** Policy binding in environment manifest. @category Environment */
+export interface PolicyBindingManifest {
+    id: NamespacedId | string;
+    label?: string;
+    order: number;
+    config?: Record<string, unknown>;
+}
+/** Runtime feature flags for validation. @category Environment */
+export interface RuntimeFeatures {
+    durableExecution?: boolean;
+    loops?: boolean;
+    parallel?: boolean;
+    branches?: boolean;
+    pauses?: boolean;
+    cancellation?: boolean;
+    longRunningWorkflows?: boolean;
+}
+/** Environment descriptor for discovery. @category Environment */
+export interface EnvironmentDescriptor {
+    schema: "@executioncontrolprotocol.environment.describe";
+    version: EcpVersion;
+    environment: {
+        id: string;
+        label?: string;
+    };
+    runtime: RuntimeDescription;
+    extensions: ExtensionDescription[];
+    capabilities: CapabilityDescription[];
+    policies: PolicyDescription[];
+}
+/** Runtime section of descriptor. @category Environment */
+export interface RuntimeDescription {
+    id: string;
+    label?: string;
+    features: RuntimeFeatures;
+}
+/** Extension section of descriptor. @category Environment */
+export interface ExtensionDescription {
+    id: string;
+    label?: string;
+    order: number;
+    configSchema?: unknown;
+    capabilities: string[];
+    /** Runtimes this extension supports when restricted; omitted when universal. */
+    supportedRuntimes?: string[];
+}
+/** Capability metadata in descriptor. @category Environment */
+export interface CapabilityDescription {
+    id: string;
+    label?: string;
+    extension: string;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    examples?: unknown[];
+}
+/** Policy metadata in descriptor. @category Environment */
+export interface PolicyDescription {
+    id: string;
+    label?: string;
+    summary?: string;
+    config?: Record<string, unknown>;
+    configSchema?: unknown;
+}
+/** Describe query selection. @category Environment */
+export interface DescribeSelection {
+    id?: string;
+    namespace?: string;
+    match?: string;
+    mode?: "exact" | "partial" | "fuzzy" | "semantic";
+    include?: string[];
+    limit?: number;
+}
+/** Describe query object. @category Environment */
+export interface DescribeQuery {
+    runtime?: DescribeSelection;
+    extensions?: DescribeSelection;
+    capabilities?: DescribeSelection;
+    policies?: DescribeSelection;
+    features?: DescribeSelection;
+}
+/** Search options. @category Environment */
+export interface SearchOptions {
+    types?: Array<"capability" | "extension" | "policy">;
+    include?: string[];
+    limit?: number;
+}
+/** Search result item. @category Environment */
+export interface SearchResultItem {
+    type: string;
+    id: string;
+    label?: string;
+    score: number;
+    reason?: string;
+    /** Present when requested via {@link SearchOptions.include}. */
+    inputSchema?: unknown;
+    /** Present when requested via {@link SearchOptions.include}. */
+    outputSchema?: unknown;
+}
+/** Search response. @category Environment */
+export interface SearchResult {
+    schema: "@executioncontrolprotocol.environment.search";
+    version: EcpVersion;
+    results: SearchResultItem[];
+}
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

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

package/dist/environment.js

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

package/dist/environment.js.map

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

package/dist/harness-feedback.d.ts

@@ -0,0 +1,43 @@
+import type { AppliedPatchEntry } from "./patch.js";
+import type { EcpSchema } from "./schema.js";
+import type { ValidationIssue } from "./validation.js";
+/**
+ * Stage of a harness model-evaluation operation (decode, patch, validate, or raw output guard).
+ * @category Harness
+ */
+export type HarnessOperationStage = "decode" | "patch-apply" | "validate" | "model-output";
+/**
+ * Structured feedback from core decode, patch, or validate operations for harness repair decisions.
+ * @category Harness
+ */
+export interface HarnessOperationFeedback {
+    /** Operation stage that produced this feedback. */
+    stage: HarnessOperationStage;
+    /** Whether the operation succeeded at this stage. */
+    success: boolean;
+    /** Target schema when known (e.g. `@executioncontrolprotocol.workflow`, `@executioncontrolprotocol.patch`). */
+    targetSchema?: EcpSchema | string;
+    /** Validation and diagnostic issues with paths and codes. */
+    issues: ValidationIssue[];
+    /** Per-entry patch apply results when stage is patch-apply. */
+    applied?: AppliedPatchEntry[];
+    /** Raw model text associated with this attempt when relevant. */
+    rawOutput?: string;
+}
+/**
+ * One model call attempt during a harness repair loop.
+ * @category Harness
+ */
+export interface HarnessRepairAttempt {
+    /** Zero-based attempt index. */
+    attempt: number;
+    /** Structured feedback collected for this attempt. */
+    feedback: HarnessOperationFeedback[];
+    /** Raw model output for this attempt. */
+    rawOutput?: string;
+    /** Wall-clock ms in model generate for this attempt (when timing debug enabled). */
+    generateMs?: number;
+    /** Wall-clock ms in harness evaluate (compile/decode/validate) for this attempt. */
+    evaluateMs?: number;
+}
+//# sourceMappingURL=harness-feedback.d.ts.map

package/dist/harness-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-feedback.d.ts","sourceRoot":"","sources":["../src/harness-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAA;AAE1F;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,KAAK,EAAE,qBAAqB,CAAA;IAC5B,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAA;IAChB,+GAA+G;IAC/G,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,6DAA6D;IAC7D,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC7B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,QAAQ,EAAE,wBAAwB,EAAE,CAAA;IACpC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/harness-feedback.js

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

package/dist/harness-feedback.js.map

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

package/dist/harness-reply.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+/** Harness reply document schema id. @category Harness */
+export declare const ECP_HARNESS_REPLY_SCHEMA: "@executioncontrolprotocol.harness.reply";
+/** Citation kind in harness assistant replies. @category Harness */
+export declare const ECP_HARNESS_REPLY_CITATION_KINDS: {
+    readonly STEP: "step";
+    readonly RUN: "run";
+    readonly EXTENSION: "extension";
+    readonly ERROR: "error";
+};
+/** Harness reply citation. @category Harness */
+export declare const harnessReplyCitationSchema: z.ZodObject<{
+    kind: z.ZodEnum<["step", "run", "extension", "error"]>;
+    id: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "error" | "extension" | "step" | "run";
+    id?: string | undefined;
+    detail?: string | undefined;
+}, {
+    kind: "error" | "extension" | "step" | "run";
+    id?: string | undefined;
+    detail?: string | undefined;
+}>;
+/** Structured harness assistant reply. @category Harness */
+export declare const harnessReplySchema: z.ZodObject<{
+    schema: z.ZodLiteral<"@executioncontrolprotocol.harness.reply">;
+    /** Natural-language answer. */
+    answer: z.ZodString;
+    /** Optional structured citations. */
+    citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["step", "run", "extension", "error"]>;
+        id: z.ZodOptional<z.ZodString>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "error" | "extension" | "step" | "run";
+        id?: string | undefined;
+        detail?: string | undefined;
+    }, {
+        kind: "error" | "extension" | "step" | "run";
+        id?: string | undefined;
+        detail?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    schema: "@executioncontrolprotocol.harness.reply";
+    answer: string;
+    citations?: {
+        kind: "error" | "extension" | "step" | "run";
+        id?: string | undefined;
+        detail?: string | undefined;
+    }[] | undefined;
+}, {
+    schema: "@executioncontrolprotocol.harness.reply";
+    answer: string;
+    citations?: {
+        kind: "error" | "extension" | "step" | "run";
+        id?: string | undefined;
+        detail?: string | undefined;
+    }[] | undefined;
+}>;
+/** Structured harness assistant reply type. @category Harness */
+export type HarnessReply = z.infer<typeof harnessReplySchema>;
+//# sourceMappingURL=harness-reply.d.ts.map

package/dist/harness-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-reply.d.ts","sourceRoot":"","sources":["../src/harness-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,EAAG,yCAAkD,CAAA;AAE1F,oEAAoE;AACpE,eAAO,MAAM,gCAAgC;;;;;CAKnC,CAAA;AAEV,gDAAgD;AAChD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EASrC,CAAA;AAEF,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;IAE7B,+BAA+B;;IAE/B,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErC,CAAA;AAEF,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/harness-reply.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+/** Harness reply document schema id. @category Harness */
+export const ECP_HARNESS_REPLY_SCHEMA = "@executioncontrolprotocol.harness.reply";
+/** Citation kind in harness assistant replies. @category Harness */
+export const ECP_HARNESS_REPLY_CITATION_KINDS = {
+    STEP: "step",
+    RUN: "run",
+    EXTENSION: "extension",
+    ERROR: "error",
+};
+/** Harness reply citation. @category Harness */
+export const harnessReplyCitationSchema = z.object({
+    kind: z.enum([
+        ECP_HARNESS_REPLY_CITATION_KINDS.STEP,
+        ECP_HARNESS_REPLY_CITATION_KINDS.RUN,
+        ECP_HARNESS_REPLY_CITATION_KINDS.EXTENSION,
+        ECP_HARNESS_REPLY_CITATION_KINDS.ERROR,
+    ]),
+    id: z.string().optional(),
+    detail: z.string().optional(),
+});
+/** Structured harness assistant reply. @category Harness */
+export const harnessReplySchema = z.object({
+    schema: z.literal(ECP_HARNESS_REPLY_SCHEMA),
+    /** Natural-language answer. */
+    answer: z.string(),
+    /** Optional structured citations. */
+    citations: z.array(harnessReplyCitationSchema).optional(),
+});
+//# sourceMappingURL=harness-reply.js.map

package/dist/harness-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-reply.js","sourceRoot":"","sources":["../src/harness-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,yCAAkD,CAAA;AAE1F,oEAAoE;AACpE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;CACN,CAAA;AAEV,gDAAgD;AAChD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,gCAAgC,CAAC,IAAI;QACrC,gCAAgC,CAAC,GAAG;QACpC,gCAAgC,CAAC,SAAS;QAC1C,gCAAgC,CAAC,KAAK;KACvC,CAAC;IACF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAA;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAC3C,+BAA+B;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,qCAAqC;IACrC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,QAAQ,EAAE;CAC1D,CAAC,CAAA"}