agent-hitch 0.1.1 → 0.2.1

package/dist/src/runs/request.js

@@ -0,0 +1,169 @@
+import { stat } from "node:fs/promises";
+import { getAdapter, normalizeRequest } from "../adapters/index.js";
+import { SCHEMA_VERSION, invalidInput } from "../foundation/index.js";
+import { parseHarnessReference } from "../revisions/index.js";
+import { WORKSPACE_MODES } from "../workspaces/index.js";
+import { asBoolean, asOptionalString, asRecord, asSha256, asString, validateEvalRunParent, validateRunContext } from "../domain/index.js";
+import { sha256JSON } from "../foundation/index.js";
+import { defaultModelIdentity } from "./identity.js";
+export async function validateRunRequest(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw invalidInput("run request must be a JSON object");
+    }
+    const allowedFields = new Set([
+        "schema_version", "harness_ref", "agent", "model", "cwd", "workspace_mode", "prompt", "timeout_ms", "agent_args",
+        "context", "parent", "model_identity", "protocol_identity", "defer_benchmark_observation",
+    ]);
+    const unexpectedField = Object.keys(input).find((field) => !allowedFields.has(field));
+    if (unexpectedField)
+        throw invalidInput(`unknown run request field: ${unexpectedField}`);
+    if (input.schema_version !== undefined && input.schema_version !== SCHEMA_VERSION) {
+        throw invalidInput(`unsupported schema_version: ${input.schema_version}`);
+    }
+    if (input.harness_ref !== undefined && input.agent !== undefined) {
+        throw invalidInput("use only one of harness_ref and the legacy agent field");
+    }
+    if (typeof input.agent === "string" && input.agent.includes("@")) {
+        throw invalidInput("the legacy agent field accepts only a harness name; use harness_ref for revision selection");
+    }
+    const referenceValue = input.harness_ref ?? input.agent;
+    if (typeof referenceValue !== "string" || !referenceValue.trim()) {
+        throw invalidInput("harness_ref must be a non-empty string");
+    }
+    if (typeof input.prompt !== "string" || !input.prompt.trim())
+        throw invalidInput("prompt must be a non-empty string");
+    if (input.cwd !== undefined && (typeof input.cwd !== "string" || !input.cwd.trim())) {
+        throw invalidInput("cwd must be a non-empty string");
+    }
+    if (input.workspace_mode !== undefined && !WORKSPACE_MODES.has(input.workspace_mode)) {
+        throw invalidInput(`workspace_mode must be one of: ${[...WORKSPACE_MODES].join(", ")}`);
+    }
+    if (input.model !== undefined && typeof input.model !== "string")
+        throw invalidInput("model must be a string");
+    if (input.timeout_ms !== undefined && (typeof input.timeout_ms !== "number" || !Number.isFinite(input.timeout_ms) || input.timeout_ms < 0)) {
+        throw invalidInput("timeout_ms must be a non-negative number");
+    }
+    if (input.agent_args !== undefined && (!Array.isArray(input.agent_args) || input.agent_args.some((arg) => typeof arg !== "string"))) {
+        throw invalidInput("agent_args must be an array of strings");
+    }
+    const request = normalizeRequest(input);
+    const reference = parseHarnessReference(request.harness_ref);
+    getAdapter(reference.harness_id);
+    let workspace;
+    try {
+        workspace = await stat(request.cwd);
+    }
+    catch (error) {
+        throw invalidInput(`workspace does not exist: ${request.cwd}`, { cause: error });
+    }
+    if (!workspace.isDirectory())
+        throw invalidInput(`workspace is not a directory: ${request.cwd}`);
+    let parent;
+    try {
+        if (input.parent !== undefined)
+            parent = validateEvalRunParent(input.parent);
+    }
+    catch (error) {
+        throw invalidInput(error.message, { cause: error });
+    }
+    let context;
+    try {
+        context = validateRunContext(input.context ?? { kind: "ad_hoc" });
+    }
+    catch (error) {
+        throw invalidInput(error.message, { cause: error });
+    }
+    if (parent && context.kind !== "benchmark_task")
+        throw invalidInput("eval parent requires a benchmark_task context");
+    let deferObservation = false;
+    try {
+        if (input.defer_benchmark_observation !== undefined) {
+            deferObservation = asBoolean(input.defer_benchmark_observation, "defer_benchmark_observation");
+        }
+    }
+    catch (error) {
+        throw invalidInput(error.message, { cause: error });
+    }
+    if (deferObservation && (!parent || context.kind !== "benchmark_task")) {
+        throw invalidInput("defer_benchmark_observation is only valid for eval benchmark runs");
+    }
+    let modelIdentity;
+    let protocolIdentity = {};
+    try {
+        modelIdentity = validateModelIdentity(input.model_identity, request.model, reference.harness_id, request.agent_args);
+        protocolIdentity = validateProtocolIdentityInput(input.protocol_identity);
+    }
+    catch (error) {
+        throw invalidInput(error.message, { cause: error });
+    }
+    return {
+        ...request,
+        context,
+        ...(parent ? { parent } : {}),
+        model_identity: modelIdentity,
+        protocol_identity: protocolIdentity,
+        defer_benchmark_observation: deferObservation,
+    };
+}
+function validateModelIdentity(value, requestedId, harnessId, agentArgs) {
+    const derivedParameters = modelParameterDigest(agentArgs);
+    if (value === undefined)
+        return defaultModelIdentity(requestedId, harnessId, {
+            ...(derivedParameters ? { parametersSha256: derivedParameters } : {}),
+        });
+    const record = asRecord(value, "model_identity");
+    const allowed = new Set(["provider", "requested_id", "effective_id", "parameters_sha256", "identity_resolved"]);
+    const unexpected = Object.keys(record).find((field) => !allowed.has(field));
+    if (unexpected)
+        throw new TypeError(`model_identity has unknown field: ${unexpected}`);
+    const declaredRequested = asString(record.requested_id ?? requestedId, "model_identity.requested_id");
+    if (declaredRequested !== requestedId)
+        throw new TypeError("model_identity.requested_id must match model");
+    const effective = asString(record.effective_id ?? requestedId, "model_identity.effective_id");
+    const resolved = record.identity_resolved === undefined ? undefined : asBoolean(record.identity_resolved, "model_identity.identity_resolved");
+    const provider = asOptionalString(record.provider, "model_identity.provider");
+    const parameters = record.parameters_sha256 === undefined
+        ? derivedParameters
+        : asSha256(record.parameters_sha256, "model_identity.parameters_sha256");
+    return defaultModelIdentity(requestedId, harnessId, {
+        ...(provider ? { provider } : {}),
+        effectiveId: effective,
+        ...(parameters ? { parametersSha256: parameters } : {}),
+        ...(resolved !== undefined ? { resolved } : {}),
+    });
+}
+function modelParameterDigest(agentArgs) {
+    const safeFlags = new Set([
+        "--temperature", "--top-p", "--max-tokens", "--max-output-tokens", "--reasoning-effort",
+    ]);
+    const parameters = {};
+    for (let index = 0; index < agentArgs.length; index += 1) {
+        const argument = agentArgs[index];
+        const [flag, inline] = argument.split("=", 2);
+        if (!flag || !safeFlags.has(flag))
+            continue;
+        const value = inline ?? agentArgs[index + 1];
+        if (value === undefined || (!inline && value.startsWith("--")))
+            continue;
+        parameters[flag] = value;
+        if (inline === undefined)
+            index += 1;
+    }
+    return Object.keys(parameters).length ? sha256JSON(parameters) : undefined;
+}
+function validateProtocolIdentityInput(value) {
+    if (value === undefined)
+        return {};
+    const record = asRecord(value, "protocol_identity");
+    const allowed = new Set(["environment_identity", "tool_policy_sha256"]);
+    const unexpected = Object.keys(record).find((field) => !allowed.has(field));
+    if (unexpected)
+        throw new TypeError(`protocol_identity has unknown field: ${unexpected}`);
+    const result = {};
+    if (record.environment_identity !== undefined)
+        result.environment_identity = asSha256(record.environment_identity, "environment_identity");
+    if (record.tool_policy_sha256 !== undefined)
+        result.tool_policy_sha256 = asSha256(record.tool_policy_sha256, "tool_policy_sha256");
+    return result;
+}
+//# sourceMappingURL=request.js.map

package/dist/src/runs/request.js.map

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

package/dist/src/trajectories/contract.js

@@ -0,0 +1,17 @@
+/**
+ * Pinned DSH trajectory compatibility contract (spec §5.3). The contract is
+ * pinned to an exact reviewed commit, never inferred from DSH `master`.
+ *
+ * An implementation PR must re-check the DSH baseline and replace
+ * CONTRACT_COMMIT if a different exact revision is selected.
+ */
+export const SESSION_FORMAT_VERSION = 0;
+export const CONTRACT_COMMIT = "141eb6fef83422698aef7a981029e843e8161534";
+export const TRAJECTORY_FORMAT = {
+    family: "dsh-session",
+    version: 0,
+    contract_commit: CONTRACT_COMMIT,
+    compression: "none",
+    pack_chunks: false,
+};
+//# sourceMappingURL=contract.js.map

package/dist/src/trajectories/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/trajectories/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,0CAA0C,CAAC;AAU1E,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,eAAe;IAChC,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,KAAK;CACnB,CAAC"}

package/dist/src/trajectories/format.js

@@ -0,0 +1,127 @@
+/**
+ * DSH-compatible on-disk format helpers for the canonical trajectory store:
+ * session-id path encoding and project-key normalization, mirroring
+ * `@deepseek-ai/dsh-session-persistence-jsonl` at the pinned contract commit
+ * (spec §5.2, §5.3). V1 writes only raw JSONL (`compression: none`,
+ * `packChunks: false`).
+ */
+import { join } from "node:path";
+import { SESSION_FORMAT_VERSION, CONTRACT_COMMIT } from "./contract.js";
+import { validateSessionEvent, validateSessionHeaderLine } from "../domain/index.js";
+export function logSuffix(_compression) {
+    return ".jsonl";
+}
+/**
+ * Encode an arbitrary string as a single safe path segment, injectively over
+ * all JS (UTF-16) strings. Mirrors DSH `encodeSegment`.
+ */
+export function encodeSegment(raw) {
+    if (raw.length === 0)
+        throw new Error("cannot encode an empty path segment");
+    if (raw === ".")
+        return "~002E";
+    if (raw === "..")
+        return "~002E~002E";
+    let out = "";
+    for (let i = 0; i < raw.length; i++) {
+        const code = raw.charCodeAt(i);
+        const ch = String.fromCharCode(code);
+        if (ch !== "~" && /^[A-Za-z0-9._-]$/.test(ch)) {
+            out += ch;
+        }
+        else {
+            out += `~${code.toString(16).toUpperCase().padStart(4, "0")}`;
+        }
+    }
+    return out;
+}
+/** Decode a segment produced by {@link encodeSegment} back to the raw string. */
+export function decodeSegment(encoded) {
+    let out = "";
+    let i = 0;
+    while (i < encoded.length) {
+        const ch = encoded[i];
+        if (ch === "~" && i + 5 <= encoded.length) {
+            const hex = encoded.slice(i + 1, i + 5);
+            const code = Number.parseInt(hex, 16);
+            if (Number.isNaN(code)) {
+                out += ch;
+                i += 1;
+            }
+            else {
+                out += String.fromCharCode(code);
+                i += 5;
+            }
+        }
+        else {
+            out += ch;
+            i += 1;
+        }
+    }
+    return out;
+}
+/**
+ * Build the readable directory key for a project path, mirroring DSH
+ * `projectKey`: separators become `-`, unsafe code units use `~XXXX`, bounded
+ * to 251 chars, wrapped in `--`.
+ */
+export function projectKey(cwd) {
+    if (cwd.length === 0)
+        throw new Error("cannot encode an empty project path");
+    let readable = "";
+    let separatorRun = false;
+    for (let i = 0; i < cwd.length; i++) {
+        const code = cwd.charCodeAt(i);
+        const ch = String.fromCharCode(code);
+        if (ch === "/" || ch === "\\" || ch === ":") {
+            if (!separatorRun)
+                readable += "-";
+            separatorRun = true;
+        }
+        else if (ch !== "~" && /^[A-Za-z0-9._-]$/.test(ch)) {
+            readable += ch;
+            separatorRun = false;
+        }
+        else {
+            readable += `~${code.toString(16).toUpperCase().padStart(4, "0")}`;
+            separatorRun = false;
+        }
+    }
+    const slug = readable.replace(/^-+/, "") || "root";
+    return `--${slug.slice(0, 251)}--`;
+}
+export function projectDir(root, cwd) {
+    if (cwd === undefined)
+        return join(root, "_no-cwd");
+    return join(root, projectKey(cwd));
+}
+export function sessionDir(root, cwd, id) {
+    return join(projectDir(root, cwd), encodeSegment(id));
+}
+export function logPath(root, cwd, id) {
+    return join(sessionDir(root, cwd, id), `session${logSuffix("none")}`);
+}
+/**
+ * Serialize the session header line (the immutable first logical line).
+ */
+export function headerLine(header) {
+    return `${JSON.stringify(header)}\n`;
+}
+/**
+ * Serialize one session event as a JSONL line.
+ */
+export function eventLine(event) {
+    return `${JSON.stringify(event)}\n`;
+}
+export function parseHeaderLine(value) {
+    const header = validateSessionHeaderLine(value);
+    if (header.version !== SESSION_FORMAT_VERSION) {
+        throw new Error(`unsupported session format version ${header.version}; expected ${SESSION_FORMAT_VERSION} at contract ${CONTRACT_COMMIT}`);
+    }
+    return header;
+}
+export function parseEventLine(value) {
+    return validateSessionEvent(value);
+}
+export { SESSION_FORMAT_VERSION, CONTRACT_COMMIT };
+//# sourceMappingURL=format.js.map

package/dist/src/trajectories/format.js.map

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

package/dist/src/trajectories/index.js

@@ -0,0 +1,7 @@
+export { CONTRACT_COMMIT, SESSION_FORMAT_VERSION, TRAJECTORY_FORMAT } from "./contract.js";
+export { decodeSegment, encodeSegment, eventLine, headerLine, logPath, logSuffix, parseEventLine, parseHeaderLine, projectDir, projectKey, sessionDir } from "./format.js";
+export { EVENT_TYPE_KEYS, TrajectoryProjector } from "./projector.js";
+export { ProviderCaptureWriter, redactProviderJSON, redactProviderText } from "./provider-capture.js";
+export { TrajectoryWriter, canonicalTrajectoryFileRef, finalizeInterruptedTrajectory, listTrajectorySessions, loadTrajectoryRef, readTrajectory, removeTrajectory, trajectoryFileSha256, trajectoryLogPath, trajectoryRef, trajectoryRefPath, trajectoryRefV2, validateTrajectoryInvariants } from "./store.js";
+export { importDeepseekNativeSession } from "./providers/deepseek.js";
+//# sourceMappingURL=index.js.map

package/dist/src/trajectories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/trajectories/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3K,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEtG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAEhT,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC"}