@executioncontrolprotocol/core 0.10.0

package/dist/harness/call-model.d.ts

@@ -0,0 +1,15 @@
+import { type CapabilityId, type ModelGenerateInput } from "@executioncontrolprotocol/types";
+import type { CapabilityContext } from "../runtime/context.js";
+/** Default provider options for small-model harness calls (format adherence). */
+export declare const HARNESS_MODEL_GENERATE_OPTIONS: {
+    readonly temperature: 0.1;
+    readonly top_p: 0.9;
+};
+/**
+ * Call a harness-compatible model provider with normalized input/output.
+ * @category Harness
+ */
+export declare function callModelGenerate(providerCapabilityId: CapabilityId, input: ModelGenerateInput, ctx: CapabilityContext, outputFormat?: string): Promise<{
+    text: string;
+}>;
+//# sourceMappingURL=call-model.d.ts.map

package/dist/harness/call-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-model.d.ts","sourceRoot":"","sources":["../../src/harness/call-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,iFAAiF;AACjF,eAAO,MAAM,8BAA8B;;;CAGjC,CAAA;AAiBV;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,oBAAoB,EAAE,YAAY,EAClC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,iBAAiB,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkC3B"}

package/dist/harness/call-model.js

@@ -0,0 +1,59 @@
+import { ECP_MODEL_CAPABILITY_NAME, modelGenerateInputSchema, modelGenerateOutputSchema, } from "@executioncontrolprotocol/types";
+import { inferResponseFormatFromFormatter } from "./format-resolve.js";
+/** Default provider options for small-model harness calls (format adherence). */
+export const HARNESS_MODEL_GENERATE_OPTIONS = {
+    temperature: 0.1,
+    top_p: 0.9,
+};
+function extractText(output) {
+    if (typeof output === "string")
+        return output;
+    if (output !== null && typeof output === "object") {
+        if ("text" in output) {
+            const text = output.text;
+            if (typeof text === "string")
+                return text;
+        }
+        if ("content" in output) {
+            const content = output.content;
+            if (typeof content === "string")
+                return content;
+        }
+    }
+    throw new Error("Model provider returned an unsupported generate output shape");
+}
+/**
+ * Call a harness-compatible model provider with normalized input/output.
+ * @category Harness
+ */
+export async function callModelGenerate(providerCapabilityId, input, ctx, outputFormat) {
+    const capName = providerCapabilityId.split(".").pop();
+    if (capName !== ECP_MODEL_CAPABILITY_NAME) {
+        throw new Error(`Provider ${providerCapabilityId} must use capability name "${ECP_MODEL_CAPABILITY_NAME}"`);
+    }
+    const responseFormat = input.responseFormat ??
+        (outputFormat ? inferResponseFormatFromFormatter(outputFormat) : undefined);
+    let prompt = input.prompt;
+    if (responseFormat === "json" && !prompt.includes("JSON")) {
+        prompt = `${prompt}\n\nReply with JSON only. No markdown fences.`;
+    }
+    else if (responseFormat === "toon" && !prompt.toLowerCase().includes("toon")) {
+        prompt = `${prompt}\n\nReply with compact TOON only. No markdown fences.`;
+    }
+    else if (responseFormat === "eql" && !prompt.toUpperCase().includes("EQL")) {
+        prompt = `${prompt}\n\nReply with EQL only. No markdown fences. No ECP header line.`;
+    }
+    const payload = modelGenerateInputSchema.parse({
+        ...input,
+        prompt,
+        responseFormat,
+        options: {
+            ...HARNESS_MODEL_GENERATE_OPTIONS,
+            ...(input.options ?? {}),
+        },
+    });
+    const raw = await ctx.capabilities.call(providerCapabilityId, payload);
+    const text = extractText(raw);
+    return modelGenerateOutputSchema.parse({ text });
+}
+//# sourceMappingURL=call-model.js.map

package/dist/harness/call-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-model.js","sourceRoot":"","sources":["../../src/harness/call-model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAG1B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AAEtE,iFAAiF;AACjF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,WAAW,EAAE,GAAG;IAChB,KAAK,EAAE,GAAG;CACF,CAAA;AAEV,SAAS,WAAW,CAAC,MAAe;IAClC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,GAAI,MAA4B,CAAC,IAAI,CAAA;YAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;QAC3C,CAAC;QACD,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,OAAO,GAAI,MAA+B,CAAC,OAAO,CAAA;YACxD,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAA;QACjD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,oBAAkC,EAClC,KAAyB,EACzB,GAAsB,EACtB,YAAqB;IAErB,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;IACrD,IAAI,OAAO,KAAK,yBAAyB,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,YAAY,oBAAoB,8BAA8B,yBAAyB,GAAG,CAC3F,CAAA;IACH,CAAC;IAED,MAAM,cAAc,GAClB,KAAK,CAAC,cAAc;QACpB,CAAC,YAAY,CAAC,CAAC,CAAC,gCAAgC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAE7E,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;IACzB,IAAI,cAAc,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,+CAA+C,CAAA;IACnE,CAAC;SAAM,IAAI,cAAc,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,MAAM,GAAG,GAAG,MAAM,uDAAuD,CAAA;IAC3E,CAAC;SAAM,IAAI,cAAc,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7E,MAAM,GAAG,GAAG,MAAM,kEAAkE,CAAA;IACtF,CAAC;IAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC;QAC7C,GAAG,KAAK;QACR,MAAM;QACN,cAAc;QACd,OAAO,EAAE;YACP,GAAG,8BAA8B;YACjC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SACzB;KACF,CAAC,CAAA;IAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAA;IACtE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAC7B,OAAO,yBAAyB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC"}

package/dist/harness/context.d.ts

@@ -0,0 +1,28 @@
+import type { CapabilityId, HarnessId } from "@executioncontrolprotocol/types";
+import type { z } from "zod";
+import type { Environment } from "../environment/environment.js";
+import type { Ecp } from "../environment/ecp.js";
+import type { CapabilityContext } from "../runtime/context.js";
+/** Context passed to harness handlers during evaluate. @category Harness */
+export interface HarnessCapabilityContext<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /** Harness id. */
+    harnessId: HarnessId;
+    /** Resolved provider capability id. */
+    uses: CapabilityId;
+    /** Merged harness config from environment binding (parsed when configSchema is set). */
+    config: TConfig;
+    /** Underlying capability context for nested calls. */
+    capabilityContext: CapabilityContext;
+    /** Environment host. */
+    environment: Environment;
+    /** Operational ECP facade. */
+    ecp: Ecp;
+    /** Call another capability. */
+    call: CapabilityContext["capabilities"]["call"];
+}
+/**
+ * Build harness context for evaluate invocation.
+ * @category Harness
+ */
+export declare function createHarnessCapabilityContext<TConfig extends Record<string, unknown> = Record<string, unknown>>(harnessId: HarnessId, uses: CapabilityId, config: Record<string, unknown>, env: Environment, ecp: Ecp, capabilityContext: CapabilityContext, configSchema?: z.ZodType<TConfig>): HarnessCapabilityContext<TConfig>;
+//# sourceMappingURL=context.d.ts.map

package/dist/harness/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/harness/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,4EAA4E;AAC5E,MAAM,WAAW,wBAAwB,CACvC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,kBAAkB;IAClB,SAAS,EAAE,SAAS,CAAA;IACpB,uCAAuC;IACvC,IAAI,EAAE,YAAY,CAAA;IAClB,wFAAwF;IACxF,MAAM,EAAE,OAAO,CAAA;IACf,sDAAsD;IACtD,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,wBAAwB;IACxB,WAAW,EAAE,WAAW,CAAA;IACxB,8BAA8B;IAC9B,GAAG,EAAE,GAAG,CAAA;IACR,+BAA+B;IAC/B,IAAI,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;CAChD;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjE,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,GAAG,EACR,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAChC,wBAAwB,CAAC,OAAO,CAAC,CAcnC"}

package/dist/harness/context.js

@@ -0,0 +1,19 @@
+/**
+ * Build harness context for evaluate invocation.
+ * @category Harness
+ */
+export function createHarnessCapabilityContext(harnessId, uses, config, env, ecp, capabilityContext, configSchema) {
+    const resolvedConfig = configSchema
+        ? configSchema.parse(config)
+        : config;
+    return {
+        harnessId,
+        uses,
+        config: resolvedConfig,
+        capabilityContext,
+        environment: env,
+        ecp,
+        call: capabilityContext.capabilities.call.bind(capabilityContext.capabilities),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/harness/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/harness/context.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAG5C,SAAoB,EACpB,IAAkB,EAClB,MAA+B,EAC/B,GAAgB,EAChB,GAAQ,EACR,iBAAoC,EACpC,YAAiC;IAEjC,MAAM,cAAc,GAAG,YAAY;QACjC,CAAC,CAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAa;QACzC,CAAC,CAAE,MAAkB,CAAA;IAEvB,OAAO;QACL,SAAS;QACT,IAAI;QACJ,MAAM,EAAE,cAAc;QACtB,iBAAiB;QACjB,WAAW,EAAE,GAAG;QAChB,GAAG;QACH,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC;KAC/E,CAAA;AACH,CAAC"}

package/dist/harness/define-harness.d.ts

@@ -0,0 +1,37 @@
+import type { NamespacedId } from "@executioncontrolprotocol/types";
+import { ECP_MODEL_GENERATE_INTERFACE } from "@executioncontrolprotocol/types";
+import type { z } from "zod";
+import type { HarnessDefinition, HarnessHandler } from "./types.js";
+/** Fluent harness definition builder with Zod-inferred handler types. @category Harness */
+export declare class HarnessDefinitionBuilder<TConfig extends Record<string, unknown> = Record<string, unknown>, TInput = unknown, TOutput = unknown> {
+    private readonly namespace;
+    private readonly name;
+    private configSchema?;
+    private inputSchema?;
+    private outputSchema?;
+    private providerInterface;
+    private handler?;
+    constructor(namespace: string, name: string);
+    /** Environment binding config schema. */
+    withConfig<S extends z.ZodType>(schema: S): HarnessDefinitionBuilder<z.infer<S> & Record<string, unknown>, TInput, TOutput>;
+    /** Invoke input schema. */
+    withInput<S extends z.ZodType>(schema: S): HarnessDefinitionBuilder<TConfig, z.infer<S>, TOutput>;
+    /** Invoke output schema. */
+    withOutput<S extends z.ZodType>(schema: S): HarnessDefinitionBuilder<TConfig, TInput, z.infer<S>>;
+    /** Required provider interface tag. */
+    usesProviderInterface(iface: typeof ECP_MODEL_GENERATE_INTERFACE): this;
+    /** Harness evaluate handler (input and config types inferred from Zod schemas). */
+    withHandler(handler: HarnessHandler<TInput, TOutput, TConfig>): this;
+    /** Build harness definition. */
+    build(): HarnessDefinition;
+}
+/**
+ * Define a catalog harness.
+ * @category Harness
+ */
+export declare function defineHarness(namespace: string, name: string): HarnessDefinitionBuilder;
+/** Type guard for inline harness definition. @category Harness */
+export declare function isHarnessDefinition(ref: unknown): ref is HarnessDefinition;
+/** Resolve harness ref to definition. @category Harness */
+export declare function resolveHarnessRef(ref: NamespacedId | HarnessDefinition | string): HarnessDefinition | undefined;
+//# sourceMappingURL=define-harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-harness.d.ts","sourceRoot":"","sources":["../../src/harness/define-harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAwB,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAOzF,2FAA2F;AAC3F,qBAAa,wBAAwB,CACnC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,MAAM,GAAG,OAAO,EAChB,OAAO,GAAG,OAAO;IASf,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IARvB,OAAO,CAAC,YAAY,CAAC,CAAW;IAChC,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAW;IAChC,OAAO,CAAC,iBAAiB,CAAoE;IAC7F,OAAO,CAAC,OAAO,CAAC,CAA0C;gBAGvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM;IAG/B,yCAAyC;IACzC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5B,MAAM,EAAE,CAAC,GACR,wBAAwB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC;IAUlF,2BAA2B;IAC3B,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC3B,MAAM,EAAE,CAAC,GACR,wBAAwB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IAMzD,4BAA4B;IAC5B,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5B,MAAM,EAAE,CAAC,GACR,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAMxD,uCAAuC;IACvC,qBAAqB,CAAC,KAAK,EAAE,OAAO,4BAA4B,GAAG,IAAI;IAKvE,mFAAmF;IACnF,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI;IAKpE,gCAAgC;IAChC,KAAK,IAAI,iBAAiB;CAiB3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAEvF;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAQ1E;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,GAAG,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAG/G"}

package/dist/harness/define-harness.js

@@ -0,0 +1,88 @@
+import { ECP_MODEL_GENERATE_INTERFACE } from "@executioncontrolprotocol/types";
+import { getCatalogedHarness } from "./harness-catalog.js";
+function toHarnessId(namespace, name) {
+    const ns = namespace.startsWith("@") ? namespace : `@${namespace}`;
+    return `${ns}/${name}`;
+}
+/** Fluent harness definition builder with Zod-inferred handler types. @category Harness */
+export class HarnessDefinitionBuilder {
+    namespace;
+    name;
+    configSchema;
+    inputSchema;
+    outputSchema;
+    providerInterface = ECP_MODEL_GENERATE_INTERFACE;
+    handler;
+    constructor(namespace, name) {
+        this.namespace = namespace;
+        this.name = name;
+    }
+    /** Environment binding config schema. */
+    withConfig(schema) {
+        const next = this;
+        next.configSchema = schema;
+        return next;
+    }
+    /** Invoke input schema. */
+    withInput(schema) {
+        const next = this;
+        next.inputSchema = schema;
+        return next;
+    }
+    /** Invoke output schema. */
+    withOutput(schema) {
+        const next = this;
+        next.outputSchema = schema;
+        return next;
+    }
+    /** Required provider interface tag. */
+    usesProviderInterface(iface) {
+        this.providerInterface = iface;
+        return this;
+    }
+    /** Harness evaluate handler (input and config types inferred from Zod schemas). */
+    withHandler(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /** Build harness definition. */
+    build() {
+        if (!this.handler) {
+            throw new Error(`Harness ${toHarnessId(this.namespace, this.name)} requires .withHandler()`);
+        }
+        const id = toHarnessId(this.namespace, this.name);
+        const erasedHandler = this.handler;
+        return {
+            id,
+            namespace: this.namespace,
+            name: this.name,
+            configSchema: this.configSchema,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
+            providerInterface: this.providerInterface,
+            handler: erasedHandler,
+        };
+    }
+}
+/**
+ * Define a catalog harness.
+ * @category Harness
+ */
+export function defineHarness(namespace, name) {
+    return new HarnessDefinitionBuilder(namespace, name);
+}
+/** Type guard for inline harness definition. @category Harness */
+export function isHarnessDefinition(ref) {
+    return (typeof ref === "object" &&
+        ref !== null &&
+        "id" in ref &&
+        "handler" in ref &&
+        typeof ref.handler === "function");
+}
+/** Resolve harness ref to definition. @category Harness */
+export function resolveHarnessRef(ref) {
+    if (isHarnessDefinition(ref))
+        return ref;
+    return getCatalogedHarness(ref);
+}
+//# sourceMappingURL=define-harness.js.map

package/dist/harness/define-harness.js.map

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

package/dist/harness/definitions/test-minimal-harness.d.ts

@@ -0,0 +1,13 @@
+import { type HarnessId } from "@executioncontrolprotocol/types";
+/** Fixture harness id for core unit tests. @category Harness */
+export declare const TEST_MINIMAL_HARNESS_ID: HarnessId;
+/**
+ * Minimal harness for framework tests (no product logic).
+ * @category Harness
+ */
+export declare const testMinimalHarness: import("../types.js").HarnessDefinition;
+/** Register test minimal harness. @category Harness */
+export declare function registerTestMinimalHarness(): void;
+/** Reset test minimal harness registration (unit tests). @internal */
+export declare function resetTestMinimalHarnessRegistrationForTests(): void;
+//# sourceMappingURL=test-minimal-harness.d.ts.map

package/dist/harness/definitions/test-minimal-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-minimal-harness.d.ts","sourceRoot":"","sources":["../../../src/harness/definitions/test-minimal-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,iCAAiC,CAAA;AAKxC,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,EAAuD,SAAS,CAAA;AAUpG;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yCAiBrB,CAAA;AAIV,uDAAuD;AACvD,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AAED,sEAAsE;AACtE,wBAAgB,2CAA2C,IAAI,IAAI,CAElE"}

package/dist/harness/definitions/test-minimal-harness.js

@@ -0,0 +1,45 @@
+import { ECP_MODEL_GENERATE_INTERFACE, harnessEvaluateOutputSchema, } from "@executioncontrolprotocol/types";
+import { z } from "zod";
+import { defineHarness } from "../define-harness.js";
+import { catalogHarness } from "../harness-catalog.js";
+/** Fixture harness id for core unit tests. @category Harness */
+export const TEST_MINIMAL_HARNESS_ID = "@executioncontrolprotocol/test-minimal-harness";
+const configSchema = z.object({
+    echoPrefix: z.string().default("ok"),
+});
+const inputSchema = z.object({
+    value: z.string(),
+});
+/**
+ * Minimal harness for framework tests (no product logic).
+ * @category Harness
+ */
+export const testMinimalHarness = defineHarness("@executioncontrolprotocol", "test-minimal-harness")
+    .withConfig(configSchema)
+    .withInput(inputSchema)
+    .withOutput(harnessEvaluateOutputSchema.extend({
+    artifact: z.string(),
+}))
+    .usesProviderInterface(ECP_MODEL_GENERATE_INTERFACE)
+    .withHandler(async (input, ctx) => {
+    const raw = input.value ?? "minimal";
+    return {
+        artifact: `${ctx.config.echoPrefix}:${raw}`,
+        raw,
+        trace: { harness: TEST_MINIMAL_HARNESS_ID, provider: ctx.uses },
+    };
+})
+    .build();
+let registered = false;
+/** Register test minimal harness. @category Harness */
+export function registerTestMinimalHarness() {
+    if (registered)
+        return;
+    catalogHarness(testMinimalHarness);
+    registered = true;
+}
+/** Reset test minimal harness registration (unit tests). @internal */
+export function resetTestMinimalHarnessRegistrationForTests() {
+    registered = false;
+}
+//# sourceMappingURL=test-minimal-harness.js.map

package/dist/harness/definitions/test-minimal-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-minimal-harness.js","sourceRoot":"","sources":["../../../src/harness/definitions/test-minimal-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAE5B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,gDAA6D,CAAA;AAEpG,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrC,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC,2BAA2B,EAAE,sBAAsB,CAAC;KACjG,UAAU,CAAC,YAAY,CAAC;KACxB,SAAS,CAAC,WAAW,CAAC;KACtB,UAAU,CACT,2BAA2B,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CACH;KACA,qBAAqB,CAAC,4BAA4B,CAAC;KACnD,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAA;IACpC,OAAO;QACL,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,GAAG,EAAE;QAC3C,GAAG;QACH,KAAK,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE;KAChE,CAAA;AACH,CAAC,CAAC;KACD,KAAK,EAAE,CAAA;AAEV,IAAI,UAAU,GAAG,KAAK,CAAA;AAEtB,uDAAuD;AACvD,MAAM,UAAU,0BAA0B;IACxC,IAAI,UAAU;QAAE,OAAM;IACtB,cAAc,CAAC,kBAAkB,CAAC,CAAA;IAClC,UAAU,GAAG,IAAI,CAAA;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,2CAA2C;IACzD,UAAU,GAAG,KAAK,CAAA;AACpB,CAAC"}

package/dist/harness/execute-harness.d.ts

@@ -0,0 +1,9 @@
+import { type CapabilityId, type HarnessCapabilityId, type InvokeResult } from "@executioncontrolprotocol/types";
+import type { Environment } from "../environment/environment.js";
+/**
+ * Execute a harness evaluate capability.
+ * @category Harness
+ * @internal
+ */
+export declare function executeHarnessInvoke(env: Environment, capabilityId: HarnessCapabilityId, input: unknown, providerOverride?: CapabilityId): Promise<InvokeResult>;
+//# sourceMappingURL=execute-harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute-harness.d.ts","sourceRoot":"","sources":["../../src/harness/execute-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAkChE;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,OAAO,EACd,gBAAgB,CAAC,EAAE,YAAY,GAC9B,OAAO,CAAC,YAAY,CAAC,CA+JvB"}

package/dist/harness/execute-harness.js

@@ -0,0 +1,138 @@
+import { ECP_HARNESS_ERROR_CODES, ECP_INVOKE_ERROR_CODES, LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { createUtilityCapabilityContext } from "../encoding/utility-context.js";
+import { evaluatePolicies } from "../runtime/policy-engine.js";
+import { createUsageLedger } from "../runtime/context.js";
+import { emptyValidationResult } from "../validate/workflow-schema.js";
+import { zodIssuesToValidationIssues } from "../validate/zod-mapper.js";
+import { getCatalogedHarness, harnessIdFromCapabilityId } from "./harness-catalog.js";
+import { createHarnessCapabilityContext } from "./context.js";
+import { findHarnessBinding } from "./resolve-harness-binding.js";
+import { EcpImpl } from "../environment/ecp.js";
+const INVOKE_STUB_WORKFLOW = {
+    schema: "@executioncontrolprotocol.workflow",
+    version: LATEST_ECP_VERSION,
+    workflow: { id: "invoke-stub" },
+    steps: [],
+};
+function invokeFailure(capabilityId, code, message, validation) {
+    return {
+        schema: "@executioncontrolprotocol.invoke.result",
+        version: LATEST_ECP_VERSION,
+        success: false,
+        capabilityId,
+        validation,
+        diagnostics: [{ severity: "error", code, message }],
+    };
+}
+/**
+ * Execute a harness evaluate capability.
+ * @category Harness
+ * @internal
+ */
+export async function executeHarnessInvoke(env, capabilityId, input, providerOverride) {
+    const harnessId = harnessIdFromCapabilityId(capabilityId);
+    if (!harnessId) {
+        return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.CAPABILITY_NOT_FOUND, `Not a harness capability: ${capabilityId}`);
+    }
+    const def = getCatalogedHarness(harnessId);
+    if (!def) {
+        return invokeFailure(capabilityId, ECP_HARNESS_ERROR_CODES.UNKNOWN_HARNESS, `Harness ${harnessId} is not registered.`);
+    }
+    const binding = findHarnessBinding(env, harnessId);
+    if (!binding) {
+        return invokeFailure(capabilityId, ECP_HARNESS_ERROR_CODES.HARNESS_NOT_BOUND, `Harness ${harnessId} is not bound in this environment.`);
+    }
+    const uses = providerOverride ?? binding.uses;
+    if (!uses) {
+        return invokeFailure(capabilityId, ECP_HARNESS_ERROR_CODES.UNKNOWN_HARNESS_PROVIDER, `Harness ${harnessId} has no provider (.uses(...)).`);
+    }
+    let parsedInput = input;
+    if (def.inputSchema) {
+        const parsed = def.inputSchema.safeParse(input);
+        if (!parsed.success) {
+            const validation = emptyValidationResult(false);
+            validation.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+            return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_INPUT_INVALID, "Harness input validation failed", validation);
+        }
+        parsedInput = parsed.data;
+    }
+    const bindings = env.ecpResolveBindings();
+    const policyCtx = {
+        workflow: INVOKE_STUB_WORKFLOW,
+        run: { id: env.getEnvId(), input: {} },
+        step: { id: "invoke", capabilityId },
+        state: {},
+        input: (parsedInput ?? {}),
+        usage: createUsageLedger(),
+        scope: "invoke",
+        operation: "invoke",
+        capabilityId,
+    };
+    const preDecision = await evaluatePolicies("policy:pre", bindings.policyHooks, policyCtx);
+    if (preDecision.type === "deny" || preDecision.type === "pause") {
+        return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_DENIED, preDecision.reason ?? "Harness invocation denied by policy");
+    }
+    const registry = env.getRegistry();
+    const utilityCtx = createUtilityCapabilityContext(env.getEnvId(), env.getEnvLabel(), registry);
+    const extPrefix = uses.replace(/\.[^.]+$/, "");
+    const extBinding = bindings.extensions.find((e) => e.id === extPrefix);
+    const capCtx = {
+        store: utilityCtx.store,
+        state: {},
+        run: { id: env.getEnvId(), input: {} },
+        step: { id: "invoke", capabilityId },
+        logger: utilityCtx.logger,
+        usage: policyCtx.usage,
+        extensionConfig: extBinding?.config,
+        capabilities: {
+            call: async (id, nestedInput) => {
+                const nested = registry.getCapability(id);
+                if (!nested)
+                    throw new Error(`Unknown capability: ${id}`);
+                const nestedExt = bindings.extensions.find((e) => e.id === id.replace(/\.[^.]+$/, ""));
+                const nestedCtx = {
+                    ...capCtx,
+                    extensionConfig: nestedExt?.config,
+                };
+                return nested.handler(nestedInput, nestedCtx);
+            },
+        },
+    };
+    const ecp = new EcpImpl(env);
+    const harnessCtx = createHarnessCapabilityContext(harnessId, uses, binding.config, env, ecp, capCtx, def.configSchema);
+    let output;
+    try {
+        output = await def.handler(parsedInput, harnessCtx);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return invokeFailure(capabilityId, ECP_HARNESS_ERROR_CODES.HARNESS_EVALUATE_FAILED, message);
+    }
+    if (def.outputSchema) {
+        const parsed = def.outputSchema.safeParse(output);
+        if (!parsed.success) {
+            const validation = emptyValidationResult(false);
+            validation.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+            return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_OUTPUT_INVALID, "Harness output validation failed", validation);
+        }
+        output = parsed.data;
+    }
+    return {
+        schema: "@executioncontrolprotocol.invoke.result",
+        version: LATEST_ECP_VERSION,
+        success: true,
+        capabilityId,
+        result: output,
+        validation: emptyValidationResult(true),
+        diagnostics: [],
+        usage: policyCtx.usage.modelCalls > 0
+            ? {
+                modelCalls: policyCtx.usage.modelCalls,
+                costUsd: policyCtx.usage.costUsd,
+                tokens: policyCtx.usage.tokens,
+                retries: policyCtx.usage.retries,
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=execute-harness.js.map

package/dist/harness/execute-harness.js.map

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

package/dist/harness/format-resolve.d.ts

@@ -0,0 +1,26 @@
+import { type NamespacedId } from "@executioncontrolprotocol/types";
+/** Core formatter ids that do not require environment binding. @category Harness */
+export declare const CORE_FORMATTER_IDS: Set<string>;
+/**
+ * Whether a formatter id is core-cataloged (always available).
+ * @category Harness
+ */
+export declare function isCoreFormatterId(formatId: string): boolean;
+/**
+ * Normalize harness config format field to extension id.
+ * @category Harness
+ */
+export declare function normalizeFormatId(format: string): NamespacedId;
+/**
+ * Whether formatter is registered in catalog or core set.
+ * @category Harness
+ */
+export declare function isFormatterRegistered(formatId: string): boolean;
+/**
+ * Infer model response format hint from formatter id.
+ * @category Harness
+ */
+/** Logical harness output format for TypeScript source (not an extension id). @category Harness */
+export declare const HARNESS_OUTPUT_FORMAT_TYPESCRIPT: "typescript";
+export declare function inferResponseFormatFromFormatter(formatId: string): "text" | "json" | "toon" | "eql" | undefined;
+//# sourceMappingURL=format-resolve.d.ts.map

package/dist/harness/format-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-resolve.d.ts","sourceRoot":"","sources":["../../src/harness/format-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAG3F,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,aAG7B,CAAA;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED;;;GAGG;AACH,mGAAmG;AACnG,eAAO,MAAM,gCAAgC,EAAG,YAAqB,CAAA;AAErE,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAO9C"}

package/dist/harness/format-resolve.js

@@ -0,0 +1,50 @@
+import { ECP_CORE_FORMATTER_IDS } from "@executioncontrolprotocol/types";
+import { getCatalogedExtension, normalizeExtensionId } from "../registry/extension-catalog.js";
+/** Core formatter ids that do not require environment binding. @category Harness */
+export const CORE_FORMATTER_IDS = new Set([
+    ECP_CORE_FORMATTER_IDS.JSON,
+    ECP_CORE_FORMATTER_IDS.FLUENT,
+]);
+/**
+ * Whether a formatter id is core-cataloged (always available).
+ * @category Harness
+ */
+export function isCoreFormatterId(formatId) {
+    return CORE_FORMATTER_IDS.has(normalizeExtensionId(formatId));
+}
+/**
+ * Normalize harness config format field to extension id.
+ * @category Harness
+ */
+export function normalizeFormatId(format) {
+    return normalizeExtensionId(format);
+}
+/**
+ * Whether formatter is registered in catalog or core set.
+ * @category Harness
+ */
+export function isFormatterRegistered(formatId) {
+    const normalized = normalizeFormatId(formatId);
+    if (isCoreFormatterId(normalized))
+        return true;
+    return getCatalogedExtension(normalized) !== undefined;
+}
+/**
+ * Infer model response format hint from formatter id.
+ * @category Harness
+ */
+/** Logical harness output format for TypeScript source (not an extension id). @category Harness */
+export const HARNESS_OUTPUT_FORMAT_TYPESCRIPT = "typescript";
+export function inferResponseFormatFromFormatter(formatId) {
+    if (formatId === HARNESS_OUTPUT_FORMAT_TYPESCRIPT)
+        return "text";
+    const id = normalizeFormatId(formatId);
+    if (id === ECP_CORE_FORMATTER_IDS.JSON)
+        return "json";
+    if (id === "@executioncontrolprotocol/format-toon")
+        return "toon";
+    if (id === "@executioncontrolprotocol/format-eql")
+        return "eql";
+    return "text";
+}
+//# sourceMappingURL=format-resolve.js.map

package/dist/harness/format-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-resolve.js","sourceRoot":"","sources":["../../src/harness/format-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAqB,MAAM,iCAAiC,CAAA;AAC3F,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAE9F,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS;IAChD,sBAAsB,CAAC,IAAI;IAC3B,sBAAsB,CAAC,MAAM;CAC9B,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,kBAAkB,CAAC,GAAG,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAC9C,IAAI,iBAAiB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,qBAAqB,CAAC,UAAU,CAAC,KAAK,SAAS,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,mGAAmG;AACnG,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAqB,CAAA;AAErE,MAAM,UAAU,gCAAgC,CAC9C,QAAgB;IAEhB,IAAI,QAAQ,KAAK,gCAAgC;QAAE,OAAO,MAAM,CAAA;IAChE,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,EAAE,KAAK,sBAAsB,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IACrD,IAAI,EAAE,KAAK,uCAAuC;QAAE,OAAO,MAAM,CAAA;IACjE,IAAI,EAAE,KAAK,sCAAsC;QAAE,OAAO,KAAK,CAAA;IAC/D,OAAO,MAAM,CAAA;AACf,CAAC"}