@noetic-tools/types 3.2.0 → 3.2.2

package/dist/types/sub-harness.js

@@ -1,106 +0,0 @@
-/**
- * Coding-agent harness contract.
- *
- * A "harness" here is a pluggable backend that drives an external agentic
- * coding tool — Claude Code, Codex, opencode, pi — as a Noetic step. It is the
- * direct analogue of the `ContextLayer` contract: defined in the dependency-free
- * `@noetic-tools/types` foundation so both `@noetic-tools/core` (which executes
- * harness steps) and the per-tool `@noetic-tools/sub-harness-*` packages (which
- * implement them) can depend on it without forming a cycle.
- *
- * Modelled on Vercel's `HarnessV1` spec: a tagged spec version, a small set of
- * descriptive fields, and a single `doStart` entry point that yields a session.
- * Optional capabilities are signalled by the presence of optional methods, not
- * a static capabilities object — an adapter that cannot satisfy a request
- * throws {@link SubHarnessCapabilityError} from the relevant method.
- */
-import { z } from 'zod';
-//#region Step-kind discriminator
-/**
- * The set of harness step kinds. Each value is a distinct `Step.kind`, so a
- * `step.claudeCode(...)` and a `step.codex(...)` are separate, individually
- * typed step variants — while the interpreter routes all of them through a
- * single shared `executeSubHarness` handler.
- * @public
- */
-export const SubHarnessKind = {
-    ClaudeCode: 'claude-code',
-    Codex: 'codex',
-    Opencode: 'opencode',
-    Pi: 'pi',
-};
-/** @public Ordered list of every harness kind — the single source of truth consumed by the JSON schema and the interpreter. */
-export const SUB_HARNESS_KINDS = [
-    SubHarnessKind.ClaudeCode,
-    SubHarnessKind.Codex,
-    SubHarnessKind.Opencode,
-    SubHarnessKind.Pi,
-];
-const HarnessFinishReasonSchema = z.enum([
-    'stop',
-    'length',
-    'aborted',
-    'error',
-    'tool-calls',
-]);
-const TokenUsageSchema = z.object({
-    input: z.number(),
-    output: z.number(),
-    total: z.number().optional(),
-    cached: z.number().optional(),
-});
-/**
- * Runtime validation schema for {@link SubHarnessStreamPart}. Adapters that move
- * events across a process or transport boundary (e.g. a sandbox bridge)
- * validate with this before forwarding.
- * @public
- */
-export const SubHarnessStreamPartSchema = z.discriminatedUnion('type', [
-    z.object({
-        type: z.literal('stream-start'),
-    }),
-    z.object({
-        type: z.literal('text-delta'),
-        delta: z.string(),
-    }),
-    z.object({
-        type: z.literal('reasoning-delta'),
-        delta: z.string(),
-    }),
-    z.object({
-        type: z.literal('tool-call'),
-        toolCallId: z.string(),
-        toolName: z.string(),
-        input: z.unknown(),
-        /** True when the underlying agent executed the tool itself (vs. host dispatch). */
-        providerExecuted: z.boolean().optional(),
-    }),
-    z.object({
-        type: z.literal('tool-result'),
-        toolCallId: z.string(),
-        toolName: z.string(),
-        output: z.unknown(),
-        isError: z.boolean().optional(),
-    }),
-    z.object({
-        type: z.literal('file-change'),
-        path: z.string().optional(),
-        summary: z.string().optional(),
-    }),
-    z.object({
-        type: z.literal('finish'),
-        finishReason: HarnessFinishReasonSchema,
-        usage: TokenUsageSchema.optional(),
-        cost: z.number().optional(),
-    }),
-    z.object({
-        type: z.literal('error'),
-        error: z.string(),
-    }),
-    /** Adapter-specific passthrough for events with no canonical mapping. */
-    z.object({
-        type: z.literal('raw'),
-        value: z.unknown(),
-    }),
-]);
-//#endregion