humanish 0.0.1 → 0.15.0

package/dist/adapter-extension.js

@@ -0,0 +1,214 @@
+import path from "node:path";
+export async function applyBrowserAdapterHooks(args) {
+    const { hooks, context, bundle, sanitize, warnings, hookLabel } = args;
+    if (!hooks?.score && !hooks?.deriveFeedback && !hooks?.deriveArtifacts)
+        return;
+    const scrubValue = (value) => {
+        const encoded = JSON.stringify(value);
+        return encoded === undefined ? value : JSON.parse(sanitize(encoded));
+    };
+    if (hooks.score) {
+        try {
+            const score = await hooks.score(context);
+            const cleaned = scrubValue(score);
+            if (isAdapterScoreShape(cleaned)) {
+                bundle.adapterScore = cleaned;
+                applyAdapterScoreFailureToReview(bundle);
+            }
+            else {
+                warnings.push(`${hookLabel}.score returned a value that is not a well-formed humanish.adapter-score.v1 (non-empty namespace + status + numeric score + summary); dropped so the bundle stays verifiable.`);
+            }
+        }
+        catch (error) {
+            warnings.push(`${hookLabel}.score threw (${sanitize(error instanceof Error ? error.message : String(error))}); dropped so the bundle stays verifiable.`);
+        }
+    }
+    if (hooks.deriveFeedback) {
+        try {
+            const candidates = await hooks.deriveFeedback(context);
+            const accepted = [];
+            for (const candidate of Array.isArray(candidates) ? candidates : []) {
+                const cleaned = scrubValue(candidate);
+                if (isAdapterFeedbackCandidateShape(cleaned))
+                    accepted.push(cleaned);
+                else
+                    warnings.push(`${hookLabel}.deriveFeedback returned a candidate that is not a well-formed humanish.feedback-candidate.v1 (or its adapter block lacked a non-empty namespace + data record); dropped so the bundle stays verifiable.`);
+            }
+            if (accepted.length > 0) {
+                bundle.feedbackCandidates = [...bundle.feedbackCandidates, ...accepted];
+            }
+        }
+        catch (error) {
+            warnings.push(`${hookLabel}.deriveFeedback threw (${sanitize(error instanceof Error ? error.message : String(error))}); dropped so the bundle stays verifiable.`);
+        }
+    }
+    if (hooks.deriveArtifacts) {
+        try {
+            const artifacts = await hooks.deriveArtifacts(context);
+            const accepted = [];
+            for (const artifact of Array.isArray(artifacts) ? artifacts : []) {
+                const cleaned = scrubValue(artifact);
+                if (isAdapterArtifactShape(cleaned))
+                    accepted.push(cleaned);
+                else
+                    warnings.push(`${hookLabel}.deriveArtifacts returned an artifact that is not a well-formed humanish.adapter-artifact.v1 (non-empty namespace + label + local path + supported kind); dropped so the bundle stays verifiable.`);
+            }
+            if (accepted.length > 0) {
+                bundle.adapterArtifacts = [...(bundle.adapterArtifacts ?? []), ...accepted];
+            }
+        }
+        catch (error) {
+            warnings.push(`${hookLabel}.deriveArtifacts threw (${sanitize(error instanceof Error ? error.message : String(error))}); dropped so the bundle stays verifiable.`);
+        }
+    }
+}
+export function adapterScoreFailureMessage(bundle) {
+    return bundle.adapterScore?.status === "fail"
+        ? `Adapter scorer failed the run: ${bundle.adapterScore.summary}`
+        : undefined;
+}
+export function applyAdapterScoreFailureToReview(bundle) {
+    const message = adapterScoreFailureMessage(bundle);
+    if (message === undefined)
+        return undefined;
+    if (bundle.review.verdict === "pass" || bundle.review.verdict === "contract_proof_only") {
+        bundle.review.verdict = "fail";
+        bundle.review.summary = message;
+    }
+    if (!bundle.review.gaps.includes(message)) {
+        bundle.review.gaps = [...bundle.review.gaps, message];
+    }
+    return message;
+}
+function isAdapterScoreShape(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        && value.schema === "humanish.adapter-score.v1"
+        && typeof value.namespace === "string"
+        && value.namespace.trim().length > 0
+        && ["pass", "partial", "fail"].includes(value.status)
+        && typeof value.score === "number"
+        && Number.isFinite(value.score)
+        && typeof value.summary === "string"
+        && (value.data === undefined
+            || (typeof value.data === "object"
+                && value.data !== null
+                && !Array.isArray(value.data)));
+}
+function isAdapterFeedbackCandidateShape(value) {
+    if (!isRecord(value))
+        return false;
+    const candidate = value;
+    if (candidate.schema !== "humanish.feedback-candidate.v1"
+        || typeof candidate.id !== "string"
+        || typeof candidate.run_id !== "string"
+        || (candidate.stream_id !== undefined && typeof candidate.stream_id !== "string")
+        || typeof candidate.adapter_id !== "string"
+        || typeof candidate.scenario_id !== "string"
+        || typeof candidate.persona_id !== "string"
+        || !isFeedbackActor(candidate.actor)
+        || !isFeedbackSubstrate(candidate.substrate)
+        || !isFeedbackFailureOwner(candidate.failure_owner)
+        || typeof candidate.summary !== "string"
+        || candidate.summary.trim().length === 0
+        || typeof candidate.expected !== "string"
+        || typeof candidate.actual !== "string"
+        || !Array.isArray(candidate.evidence)
+        || !candidate.evidence.every(isFeedbackEvidence)
+        || !isRecord(candidate.redaction)
+        || candidate.redaction.status !== "passed"
+        || typeof candidate.redaction.notes !== "string"
+        || typeof candidate.idempotency_key !== "string"
+        || !isFeedbackNextState(candidate.proposed_next_state)
+        || !Array.isArray(candidate.acceptance_proof)
+        || !candidate.acceptance_proof.every((item) => typeof item === "string")) {
+        return false;
+    }
+    if (candidate.adapter !== undefined) {
+        const adapter = candidate.adapter;
+        if (!isRecord(adapter)
+            || typeof adapter.namespace !== "string" || adapter.namespace.trim().length === 0
+            || !isRecord(adapter.data)) {
+            return false;
+        }
+    }
+    return true;
+}
+function isAdapterArtifactShape(value) {
+    if (!isRecord(value))
+        return false;
+    const artifact = value;
+    return artifact.schema === "humanish.adapter-artifact.v1"
+        && typeof artifact.namespace === "string"
+        && artifact.namespace.trim().length > 0
+        && typeof artifact.label === "string"
+        && artifact.label.trim().length > 0
+        && typeof artifact.path === "string"
+        && isSafeRelativeArtifactPath(artifact.path)
+        && isAdapterArtifactKind(artifact.kind)
+        && typeof artifact.note === "string"
+        && artifact.note.trim().length > 0;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSafeRelativeArtifactPath(value) {
+    return value.trim().length > 0
+        && !path.isAbsolute(value)
+        && !value.includes("://")
+        && !value.split(/[\\/]/).some((part) => part === ".." || part === "." || part.length === 0);
+}
+function isAdapterArtifactKind(value) {
+    return value === "state"
+        || value === "review"
+        || value === "log"
+        || value === "trace"
+        || value === "screenshot"
+        || value === "filesystem"
+        || value === "summary";
+}
+function isFeedbackActor(value) {
+    return value === "codex-tui"
+        || value === "codex-exec"
+        || value === "codex-app-server"
+        || value === "synthetic-dry-run"
+        || value === "unknown";
+}
+function isFeedbackSubstrate(value) {
+    return value === "e2b-desktop"
+        || value === "e2b-terminal"
+        || value === "local-filesystem"
+        || value === "codex-app-server"
+        || value === "unknown";
+}
+function isFeedbackFailureOwner(value) {
+    return value === "harness"
+        || value === "target-app"
+        || value === "actor"
+        || value === "environment"
+        || value === "unknown";
+}
+function isFeedbackNextState(value) {
+    return value === "watch"
+        || value === "adapter-hardening"
+        || value === "target-app-setup"
+        || value === "actor-auth"
+        || value === "setup-quality-review"
+        || value === "study-quality-review";
+}
+function isFeedbackEvidence(value) {
+    if (!isRecord(value))
+        return false;
+    return typeof value.path === "string"
+        && value.path.length > 0
+        && !path.isAbsolute(value.path)
+        && !value.path.includes("://")
+        && !value.path.includes("..")
+        && (value.kind === "review"
+            || value.kind === "state"
+            || value.kind === "log"
+            || value.kind === "trace"
+            || value.kind === "screenshot"
+            || value.kind === "filesystem")
+        && typeof value.note === "string";
+}
+//# sourceMappingURL=adapter-extension.js.map

package/dist/adapter-extension.js.map

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

package/dist/argv.d.ts

@@ -0,0 +1 @@
+export declare function normalizeCliArgv(argv: string[]): string[];

package/dist/argv.js

@@ -0,0 +1,8 @@
+export function normalizeCliArgv(argv) {
+    const [runtime, entrypoint, separator, ...rest] = argv;
+    if (runtime && entrypoint && separator === "--") {
+        return [runtime, entrypoint, ...rest];
+    }
+    return argv;
+}
+//# sourceMappingURL=argv.js.map

package/dist/argv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.js","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvD,IAAI,OAAO,IAAI,UAAU,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/artifact-reference.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Decide whether to include a recorded artifact path in published evidence.
+ *
+ * Returns the path only when the producer confirms it actually wrote (or, for a
+ * surface that attempts the write inline, attempted to write) the artifact. When
+ * `wrote` is false the producer is declaring "I have no artifact here" and the
+ * reference is dropped so the bundle never claims evidence that does not exist.
+ *
+ * This is intentionally producer-driven, not status-driven: a successful step that
+ * failed to write its file should pass `wrote: true` (it believes it wrote one) so
+ * the strict verifier still catches the broken producer. Only a step whose recorded
+ * evidence IS the failure passes `wrote: false`.
+ */
+export declare function artifactReferenceIfWritten(path: string | undefined, wrote: boolean): string | undefined;
+/**
+ * True when a captured surface/step recorded a real screenshot artifact that the
+ * producer wrote. A blocked capture/step whose evidence is the failure itself wrote
+ * no screenshot, so it has no `screenshotPath` to reference.
+ */
+export declare function hasWrittenScreenshot(capture: {
+    screenshotPath?: string;
+}): boolean;

package/dist/artifact-reference.js

@@ -0,0 +1,47 @@
+// Artifact-reference discipline: "never reference an artifact you did not write."
+//
+// `verifyRun` fails closed when a run bundle references a local evidence artifact
+// (a screenshot path, an embed URL, a `ui.screenshotUrl`) that does not exist on
+// disk or is zero-byte. That fail-closed behavior is correct and must NOT be
+// weakened. The honest fix lives on the PRODUCER side: a step or capture that did
+// not write an artifact must not claim one.
+//
+// A blocked/failed step where the failure itself is the recorded evidence wrote no
+// screenshot — so it must omit the reference, keeping its blocked status + reason
+// (the failure is the evidence). A step that claims SUCCESS but failed to write its
+// screenshot must STILL carry the reference so verify can catch the broken producer:
+// this guard never blanket-omits by status, it only lets a producer decline to
+// reference a path it knows it never wrote.
+//
+// The browser lane (src/run.ts + src/scripted-browser-actor.ts) imports this; the
+// terminal-product lane (SLICE 2, src/e2b-terminal-lab.ts) inherits the same
+// discipline so neither path can reintroduce the missing-artifact verify failure.
+/**
+ * Decide whether to include a recorded artifact path in published evidence.
+ *
+ * Returns the path only when the producer confirms it actually wrote (or, for a
+ * surface that attempts the write inline, attempted to write) the artifact. When
+ * `wrote` is false the producer is declaring "I have no artifact here" and the
+ * reference is dropped so the bundle never claims evidence that does not exist.
+ *
+ * This is intentionally producer-driven, not status-driven: a successful step that
+ * failed to write its file should pass `wrote: true` (it believes it wrote one) so
+ * the strict verifier still catches the broken producer. Only a step whose recorded
+ * evidence IS the failure passes `wrote: false`.
+ */
+export function artifactReferenceIfWritten(path, wrote) {
+    if (!wrote) {
+        return undefined;
+    }
+    const trimmed = path?.trim();
+    return trimmed ? trimmed : undefined;
+}
+/**
+ * True when a captured surface/step recorded a real screenshot artifact that the
+ * producer wrote. A blocked capture/step whose evidence is the failure itself wrote
+ * no screenshot, so it has no `screenshotPath` to reference.
+ */
+export function hasWrittenScreenshot(capture) {
+    return Boolean(capture.screenshotPath?.trim());
+}
+//# sourceMappingURL=artifact-reference.js.map

package/dist/artifact-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-reference.js","sourceRoot":"","sources":["../src/artifact-reference.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,6EAA6E;AAC7E,kFAAkF;AAClF,4CAA4C;AAC5C,EAAE;AACF,mFAAmF;AACnF,kFAAkF;AAClF,oFAAoF;AACpF,qFAAqF;AACrF,+EAA+E;AAC/E,4CAA4C;AAC5C,EAAE;AACF,kFAAkF;AAClF,6EAA6E;AAC7E,kFAAkF;AAElF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAwB,EAAE,KAAc;IACjF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACvE,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/browser-evidence-hygiene.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Browser chrome that belongs to the host environment (update prompts, password
+ * save bubbles, first-run UI) pollutes product evidence. Keep these knobs in one
+ * place so browser-backed lanes can prefer product pixels over browser UI.
+ */
+export declare const CHROMIUM_EVIDENCE_HYGIENE_FLAGS: readonly ["--disable-background-networking", "--disable-component-update", "--disable-default-apps", "--disable-domain-reliability", "--disable-extensions", "--disable-sync", "--no-default-browser-check", "--no-first-run", "--password-store=basic", "--use-mock-keychain"];
+export declare function chromiumEvidenceProfilePreferencesJson(): string;

package/dist/browser-evidence-hygiene.js

@@ -0,0 +1,40 @@
+/**
+ * Browser chrome that belongs to the host environment (update prompts, password
+ * save bubbles, first-run UI) pollutes product evidence. Keep these knobs in one
+ * place so browser-backed lanes can prefer product pixels over browser UI.
+ */
+export const CHROMIUM_EVIDENCE_HYGIENE_FLAGS = [
+    "--disable-background-networking",
+    "--disable-component-update",
+    "--disable-default-apps",
+    "--disable-domain-reliability",
+    "--disable-extensions",
+    "--disable-sync",
+    "--no-default-browser-check",
+    "--no-first-run",
+    "--password-store=basic",
+    "--use-mock-keychain"
+];
+const CHROMIUM_EVIDENCE_PROFILE_PREFERENCES = {
+    autofill: {
+        credit_card_enabled: false,
+        profile_enabled: false
+    },
+    browser: {
+        check_default_browser: false
+    },
+    credentials_enable_service: false,
+    payments: {
+        can_make_payment_enabled: false
+    },
+    profile: {
+        default_content_setting_values: {
+            notifications: 2
+        },
+        password_manager_enabled: false
+    }
+};
+export function chromiumEvidenceProfilePreferencesJson() {
+    return JSON.stringify(CHROMIUM_EVIDENCE_PROFILE_PREFERENCES);
+}
+//# sourceMappingURL=browser-evidence-hygiene.js.map

package/dist/browser-evidence-hygiene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-evidence-hygiene.js","sourceRoot":"","sources":["../src/browser-evidence-hygiene.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,iCAAiC;IACjC,4BAA4B;IAC5B,wBAAwB;IACxB,8BAA8B;IAC9B,sBAAsB;IACtB,gBAAgB;IAChB,4BAA4B;IAC5B,gBAAgB;IAChB,wBAAwB;IACxB,qBAAqB;CACb,CAAC;AAEX,MAAM,qCAAqC,GAAG;IAC5C,QAAQ,EAAE;QACR,mBAAmB,EAAE,KAAK;QAC1B,eAAe,EAAE,KAAK;KACvB;IACD,OAAO,EAAE;QACP,qBAAqB,EAAE,KAAK;KAC7B;IACD,0BAA0B,EAAE,KAAK;IACjC,QAAQ,EAAE;QACR,wBAAwB,EAAE,KAAK;KAChC;IACD,OAAO,EAAE;QACP,8BAA8B,EAAE;YAC9B,aAAa,EAAE,CAAC;SACjB;QACD,wBAAwB,EAAE,KAAK;KAChC;CACO,CAAC;AAEX,MAAM,UAAU,sCAAsC;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/claude-agent-sdk.d.ts

@@ -0,0 +1,94 @@
+import { type ActorCompletionReason, type ActorPersonaRef, type ActorStatus, type ActorTrace } from "./actor-contract.js";
+export type ClaudeResultSubtype = "success" | "error_during_execution" | "error_max_turns" | "error_max_budget_usd" | "error_max_structured_output_retries";
+export type ClaudeContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "thinking";
+    thinking: string;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+} | {
+    type: "tool_result";
+    tool_use_id: string;
+    is_error?: boolean;
+};
+export type ClaudeMessage = {
+    type: "system";
+    subtype: string;
+    session_id?: string;
+    model?: string;
+} | {
+    type: "assistant";
+    message: {
+        content: ClaudeContentBlock[];
+    };
+} | {
+    type: "user";
+    message: {
+        content: ClaudeContentBlock[] | string;
+    };
+} | {
+    type: "result";
+    subtype: ClaudeResultSubtype;
+    is_error?: boolean;
+    duration_ms?: number;
+    num_turns?: number;
+    session_id?: string;
+    total_cost_usd?: number;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+    result?: string;
+};
+export interface ClaudeSessionResult {
+    messages: ClaudeMessage[];
+    startedAt: string;
+    completedAt: string;
+    providerVersion?: string;
+}
+export declare function claudeResultSubtypeToStatus(subtype: ClaudeResultSubtype): ActorStatus;
+export declare function claudeStatusToCompletionReason(status: ActorStatus): ActorCompletionReason;
+/**
+ * Map a Claude Agent SDK session into the provider-neutral ActorTrace. Pure and
+ * side-effect-free; mirrors codexResultToActorTrace / piSessionToActorTrace. The
+ * persona reference is supplied by the harness.
+ */
+export declare function claudeSessionToActorTrace(session: ClaudeSessionResult, persona: ActorPersonaRef): ActorTrace;
+export type ClaudeQueryFn = (args: {
+    prompt: string;
+    options: Record<string, unknown>;
+}) => AsyncIterable<unknown>;
+export interface ClaudeAgentSessionOptions {
+    cwd: string;
+    runRoot: string;
+    prompt: string;
+    persona: ActorPersonaRef;
+    timeoutMs: number;
+    model?: string;
+    maxTurns?: number;
+    systemPrompt?: string;
+    queryFn?: ClaudeQueryFn;
+    loadQueryFn?: () => Promise<ClaudeQueryFn>;
+}
+export interface ClaudeAgentSessionResult {
+    status: ActorStatus;
+    reason: string;
+    durationMs: number;
+    trace: ActorTrace;
+    session: ClaudeSessionResult;
+    transcriptPath: string;
+    tracePath: string;
+    eventsPath: string;
+    tail: string;
+}
+/**
+ * Drive a Claude Agent SDK session (or an injected fake) and write the three
+ * provider-neutral evidence artifacts, mirroring runCodexAppServerSession. The
+ * mapping is delegated to the pure claudeSessionToActorTrace. A load failure or
+ * timeout still produces a (failed/timed_out) bundle rather than throwing.
+ */
+export declare function runClaudeAgentSession(options: ClaudeAgentSessionOptions): Promise<ClaudeAgentSessionResult>;