oh-my-super-agent 0.1.0

package/dist/src/providers/claude-structured-completion.js

@@ -0,0 +1,229 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { createConductorNotificationStore } from "../conductor/notifications.js";
+import { assertOpaqueId } from "../domain/records.js";
+import { createRuntimeEventBus } from "../events/bus.js";
+import { createOutboxStore } from "../outbox/store.js";
+import { canonicalTimestamp } from "../queue/model.js";
+import { acquireDirectoryLock, LockBusyError, recoverDirectoryLock, } from "../runtime/lock.js";
+import { processIsAlive } from "../runtime/process-identity.js";
+import { createStableId } from "../runtime/stable-id.js";
+import { systemBootId } from "../runtime/system-clock.js";
+import { validateExistingDirectory } from "../utils/fs.js";
+import { createResultGateStore, } from "../verification/result-gate-store.js";
+import { createClaudeStructuredRoleStore, } from "./claude-structured-store.js";
+export const CLAUDE_STRUCTURED_COMPLETION_PROJECTOR = "structured-result-projector";
+export function projectClaudeStructuredRoleCompletion(options) {
+    const authorities = completionAuthorities(options);
+    return projectWithLock(authorities, assertOpaqueId(options.requestId, "structured completion request id"));
+}
+export function recoverClaudeStructuredRoleCompletions(options) {
+    const authorities = completionAuthorities(options);
+    const requestIds = authorities.gates.list()
+        .flatMap((gate) => {
+        const request = waitingClaudeRequest(gate);
+        return request && authorities.structuredRoles.readResultIfExists(request.request_id)
+            ? [request.request_id]
+            : [];
+    })
+        .filter((requestId, index, values) => values.indexOf(requestId) === index)
+        .sort((left, right) => left.localeCompare(right));
+    const projections = [];
+    const failedRequestIds = [];
+    for (const requestId of requestIds) {
+        try {
+            projections.push(projectWithLock(authorities, requestId));
+        }
+        catch {
+            failedRequestIds.push(requestId);
+        }
+    }
+    return Object.freeze({
+        projections: Object.freeze(projections),
+        failed_request_ids: Object.freeze(failedRequestIds),
+    });
+}
+function completionAuthorities(options) {
+    const packageRoot = validateExistingDirectory(options.packageRoot, "structured completion package root");
+    const stateRoot = validateExistingDirectory(options.stateRoot, "structured completion state root");
+    const outbox = createOutboxStore({
+        eventsRoot: join(stateRoot, "outbox", "events"),
+        receiptsRoot: join(stateRoot, "outbox", "receipts"),
+        locksRoot: join(stateRoot, "locks"),
+    });
+    return Object.freeze({
+        locksRoot: join(stateRoot, "locks"),
+        outbox,
+        bus: createRuntimeEventBus({ outbox, packageRoot }),
+        notifications: createConductorNotificationStore({
+            recordsRoot: join(stateRoot, "conductor-notifications"),
+            assignmentsRoot: join(stateRoot, "conductor-notification-assignments"),
+            locksRoot: join(stateRoot, "locks"),
+            packageRoot,
+            outbox,
+        }),
+        structuredRoles: createClaudeStructuredRoleStore({ packageRoot, stateRoot }),
+        gates: createResultGateStore({ packageRoot, stateRoot }),
+    });
+}
+function projectWithLock(authorities, requestId) {
+    const lock = acquireProjectionLock(authorities.locksRoot, requestId);
+    try {
+        return projectStoredResult(authorities, requestId);
+    }
+    finally {
+        lock.release();
+    }
+}
+function acquireProjectionLock(locksRoot, requestId) {
+    const lockId = createStableId("role-project", requestId);
+    const acquire = () => acquireDirectoryLock({
+        locksRoot,
+        lockId,
+        ownerId: CLAUDE_STRUCTURED_COMPLETION_PROJECTOR,
+        note: requestId,
+    });
+    try {
+        return acquire();
+    }
+    catch (error) {
+        if (!(error instanceof LockBusyError) || !error.owner)
+            throw error;
+        if (error.owner.boot_id === systemBootId() && processIsAlive(error.owner.process_id))
+            throw error;
+        recoverDirectoryLock({
+            locksRoot,
+            lockId,
+            recoveredBy: CLAUDE_STRUCTURED_COMPLETION_PROJECTOR,
+            reason: `dead structured completion projector for ${requestId}`,
+            expectedGenerationId: error.owner.created_nonce,
+        });
+        return acquire();
+    }
+}
+function projectStoredResult(authorities, requestId) {
+    const result = authorities.structuredRoles.readResultIfExists(requestId);
+    if (!result)
+        throw new Error(`structured-role result is not available: ${requestId}`);
+    const matches = authorities.gates.list().flatMap((gate) => {
+        const request = result.role_id === "oms.grader.claude"
+            ? gate.payload.grade_request
+            : gate.payload.reflection_request;
+        return requestMatchesResult(request, result) ? [{ gate, request }] : [];
+    });
+    if (matches.length !== 1) {
+        throw new Error(`structured-role result must match exactly one result gate: ${requestId}`);
+    }
+    const binding = matches[0];
+    const submittedAt = canonicalTimestamp(result.submitted_at, "structured completion timestamp");
+    const resultSha256 = sha256(canonicalJson(result));
+    const identity = {
+        sourceId: result.request_id,
+        sourceVersion: result.schema_version,
+        dedupeKey: createStableId("role-result", result.request_id),
+        occurredAt: submittedAt,
+    };
+    const payload = {
+        schema_version: 1,
+        request_id: result.request_id,
+        role_id: result.role_id,
+        result_gate_id: binding.gate.record_id,
+        dispatch_id: binding.gate.payload.subject.dispatch_id,
+        ticket_id: binding.gate.payload.subject.ticket_id,
+        claude_session_id: result.claude_session_id,
+        submitted_at: submittedAt,
+        result_sha256: resultSha256,
+        terminal_authority: false,
+    };
+    const expectedReceiptResult = Object.freeze({
+        action: "structured-role-completion-projected",
+        ...payload,
+    });
+    const existingEvent = authorities.bus.find("structured-role-completed", identity);
+    const existingReceipt = existingEvent && authorities.outbox.readReceipt(existingEvent.event_id, CLAUDE_STRUCTURED_COMPLETION_PROJECTOR);
+    const expectedState = result.role_id === "oms.grader.claude" ? "grading" : "reflecting";
+    if (binding.gate.state !== expectedState && (!existingEvent || !existingReceipt)) {
+        throw new Error(`structured-role result gate is not waiting in ${expectedState}: ${binding.gate.record_id}`);
+    }
+    if (existingReceipt)
+        assertCompletionReceipt(existingReceipt, submittedAt, expectedReceiptResult);
+    const published = authorities.bus.publish("structured-role-completed", identity, payload);
+    const committed = existingReceipt
+        ? { status: "replayed", receipt: existingReceipt }
+        : authorities.outbox.commitReceipt({
+            eventId: published.event.event_id,
+            consumerId: CLAUDE_STRUCTURED_COMPLETION_PROJECTOR,
+            processedAt: submittedAt,
+            result: expectedReceiptResult,
+        });
+    assertCompletionReceipt(committed.receipt, submittedAt, expectedReceiptResult);
+    const notification = authorities.notifications.assignProjected({
+        eventIds: [published.event.event_id],
+        projectorId: CLAUDE_STRUCTURED_COMPLETION_PROJECTOR,
+        createdAt: submittedAt,
+    });
+    if (!notification.record || notification.status === "empty") {
+        throw new Error("structured completion notification assignment disappeared");
+    }
+    return Object.freeze({
+        request_id: result.request_id,
+        event_id: published.event.event_id,
+        event_status: published.status,
+        receipt_id: committed.receipt.receipt_id,
+        receipt_status: committed.status,
+        notification_id: notification.record.record_id,
+        notification_status: notification.status,
+    });
+}
+function assertCompletionReceipt(receipt, submittedAt, expectedResult) {
+    if (receipt.consumer_id !== CLAUDE_STRUCTURED_COMPLETION_PROJECTOR
+        || receipt.processed_at !== submittedAt
+        || canonicalJson(receipt.result) !== canonicalJson(expectedResult))
+        throw new Error("structured completion projector receipt conflicts with the immutable result");
+}
+function sha256(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+function waitingClaudeRequest(gate) {
+    if (gate.state === "grading"
+        && gate.payload.grade_request?.role_id === "oms.grader.claude"
+        && gate.payload.grade_request.engine === "claude"
+        && gate.payload.grade_request.evidence_schema === "grader-output.v1"
+        && gate.payload.grade_request.started_at !== null
+        && gate.payload.grade_request.session_id !== null)
+        return gate.payload.grade_request;
+    if (gate.state === "reflecting"
+        && gate.payload.reflection_request?.role_id === "oms.bounded-dreamer"
+        && gate.payload.reflection_request.engine === "claude"
+        && gate.payload.reflection_request.evidence_schema === "reflection.v1"
+        && gate.payload.reflection_request.started_at !== null
+        && gate.payload.reflection_request.session_id !== null)
+        return gate.payload.reflection_request;
+    return undefined;
+}
+function requestMatchesResult(request, result) {
+    return request !== null
+        && request.engine === "claude"
+        && request.request_id === result.request_id
+        && request.role_id === result.role_id
+        && request.evidence_schema === result.evidence_schema
+        && request.started_at !== null
+        && request.session_id !== null
+        && request.session_id === result.claude_session_id;
+}
+function canonicalJson(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return JSON.stringify(value);
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new Error("structured completion contains a non-finite number");
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    if (typeof value !== "object")
+        throw new Error("structured completion contains non-JSON data");
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
+}
+//# sourceMappingURL=claude-structured-completion.js.map

package/dist/src/providers/claude-structured-completion.js.map

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

package/dist/src/providers/claude-structured-pane.d.ts

@@ -0,0 +1,23 @@
+import { type ProcessRunner } from "./process.js";
+export interface ClaudeStructuredPaneLaunch {
+    readonly requestId: string;
+    readonly command: "claude";
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+}
+export interface ClaudeStructuredPaneObservation {
+    readonly pane_id: string;
+    readonly process_id: number;
+    readonly dead: boolean;
+}
+export interface ClaudeStructuredPaneAdapter {
+    create(launch: ClaudeStructuredPaneLaunch): ClaudeStructuredPaneObservation;
+    observe(requestId: string): ClaudeStructuredPaneObservation | undefined;
+}
+export declare function createClaudeStructuredPaneAdapter(options?: {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly runner?: ProcessRunner;
+    readonly wait?: (milliseconds: number) => void;
+}): ClaudeStructuredPaneAdapter;
+export declare function structuredRoleWindowName(requestId: string): string;

package/dist/src/providers/claude-structured-pane.js

@@ -0,0 +1,156 @@
+import { createHash } from "node:crypto";
+import { assertOpaqueId } from "../domain/records.js";
+import { validateExistingDirectory } from "../utils/fs.js";
+import { runProcess } from "./process.js";
+const TMUX_SESSION = "oms";
+const SUPPORTED_TMUX_VERSION = "3.6";
+const PROCESS_TIMEOUT_MS = 10_000;
+const PROCESS_OUTPUT_LIMIT = 64 * 1024;
+const PROVIDER_READY_MS = 750;
+export function createClaudeStructuredPaneAdapter(options = {}) {
+    const controlEnv = tmuxControlEnvironment(options.env ?? process.env);
+    const runner = options.runner ?? runProcess;
+    const wait = options.wait ?? waitSynchronously;
+    function inspect(requestId) {
+        const windowName = structuredRoleWindowName(requestId);
+        const result = runner(request("tmux", [
+            "list-panes",
+            "-a",
+            "-F",
+            "#{session_name}\t#{window_name}\t#{pane_id}\t#{pane_pid}\t#{pane_dead}",
+        ], process.cwd(), controlEnv));
+        requireSuccess(result, "tmux structured-role pane list");
+        const matches = result.stdout.trim().split(/\r?\n/u).filter(Boolean).filter((line) => (line.startsWith(`${TMUX_SESSION}\t${windowName}\t`)));
+        if (matches.length > 1)
+            throw new Error(`duplicate OMS structured-role pane: ${requestId}`);
+        if (matches.length === 0)
+            return undefined;
+        const [, , paneId, pidText, deadText, ...extra] = matches[0].split("\t");
+        const processId = Number(pidText);
+        if (extra.length > 0
+            || !paneId
+            || !/^%[0-9]{1,10}$/u.test(paneId)
+            || !Number.isSafeInteger(processId)
+            || processId < 1
+            || (deadText !== "0" && deadText !== "1"))
+            throw new Error("invalid OMS structured-role pane observation");
+        return Object.freeze({ pane_id: paneId, process_id: processId, dead: deadText === "1" });
+    }
+    const adapter = {
+        create(rawLaunch) {
+            const launch = normalizeLaunch(rawLaunch);
+            probeTmux(launch.cwd, controlEnv, runner);
+            if (inspect(launch.requestId))
+                throw new Error(`OMS structured-role pane already exists: ${launch.requestId}`);
+            const environment = Object.entries(launch.env)
+                .filter((entry) => typeof entry[1] === "string")
+                .sort(([left], [right]) => left.localeCompare(right))
+                .map(([key, value]) => `${key}=${value}`);
+            const created = runner(request("tmux", [
+                "new-window",
+                "-d",
+                "-P",
+                "-F",
+                "#{pane_id}\t#{pane_pid}",
+                "-t",
+                `${TMUX_SESSION}:`,
+                "-n",
+                structuredRoleWindowName(launch.requestId),
+                "-c",
+                launch.cwd,
+                "env",
+                "-i",
+                ...environment,
+                launch.command,
+                ...launch.args,
+            ], launch.cwd, controlEnv));
+            requireSuccess(created, "tmux structured-role pane create");
+            const [paneId, pidText, ...extra] = created.stdout.trim().split("\t");
+            const processId = Number(pidText);
+            if (extra.length > 0
+                || !paneId
+                || !/^%[0-9]{1,10}$/u.test(paneId)
+                || !Number.isSafeInteger(processId)
+                || processId < 1)
+                throw new Error("tmux structured-role pane create returned invalid identity");
+            wait(PROVIDER_READY_MS);
+            sendSubmitKey(paneId, launch.cwd, controlEnv, runner, "tmux structured-role workspace trust confirmation");
+            wait(PROVIDER_READY_MS);
+            sendLiteralLine(paneId, `Process OMS structured request ${launch.requestId}. Read it once with mcp__oms_role__read_request, then submit exactly one schema result with mcp__oms_role__submit_schema_result.`, launch.cwd, controlEnv, runner);
+            return Object.freeze({ pane_id: paneId, process_id: processId, dead: false });
+        },
+        observe: inspect,
+    };
+    return Object.freeze(adapter);
+}
+export function structuredRoleWindowName(requestId) {
+    const id = assertOpaqueId(requestId, "structured request id");
+    return `role-${createHash("sha256").update(id).digest("hex").slice(0, 16)}`;
+}
+function normalizeLaunch(launch) {
+    const requestId = assertOpaqueId(launch.requestId, "structured request id");
+    const cwd = validateExistingDirectory(launch.cwd, "structured-role pane cwd");
+    if (launch.command !== "claude")
+        throw new Error("structured-role provider must be Claude");
+    const args = launch.args.map((argument) => {
+        if (typeof argument !== "string" || /[\0\r\n]/u.test(argument)) {
+            throw new Error("structured-role provider argument contains control characters");
+        }
+        return argument;
+    });
+    if (args.some((argument) => argument === "-p" || argument === "--print" || argument === "--resume" || argument === "--background" || argument === "--bg")) {
+        throw new Error("structured-role provider launch must be fresh and interactive");
+    }
+    if (args.filter((argument) => argument === "--session-id").length !== 1) {
+        throw new Error("structured-role provider launch requires one fresh native session id");
+    }
+    for (const [key, value] of Object.entries(launch.env)) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/u.test(key) || (value !== undefined && /[\0\r\n]/u.test(value))) {
+            throw new Error("structured-role provider environment is invalid");
+        }
+    }
+    return Object.freeze({
+        requestId,
+        command: "claude",
+        args: Object.freeze(args),
+        cwd,
+        env: { ...launch.env, TERM: "tmux-256color" },
+    });
+}
+function sendLiteralLine(paneId, line, cwd, env, runner) {
+    requireSuccess(runner(request("tmux", ["send-keys", "-l", "-t", paneId, line], cwd, env)), "tmux fixed structured-role input");
+    sendSubmitKey(paneId, cwd, env, runner, "tmux fixed structured-role input submit");
+}
+function sendSubmitKey(paneId, cwd, env, runner, label) {
+    requireSuccess(runner(request("tmux", ["send-keys", "-t", paneId, "Enter"], cwd, env)), label);
+}
+function probeTmux(cwd, env, runner) {
+    const version = runner(request("tmux", ["-V"], cwd, env));
+    requireSuccess(version, "tmux version probe");
+    const match = /^tmux ([0-9]+\.[0-9]+)\s*$/u.exec(version.stdout);
+    if (match?.[1] !== SUPPORTED_TMUX_VERSION)
+        throw new Error(`unsupported tmux version: ${match?.[1] ?? "unknown"}`);
+    requireSuccess(runner(request("tmux", ["has-session", "-t", TMUX_SESSION], cwd, env)), "OMS conductor tmux session probe");
+}
+function tmuxControlEnvironment(input) {
+    const env = {};
+    for (const key of ["PATH", "HOME", "USER", "LOGNAME", "SHELL", "TERM", "LANG", "TMPDIR", "TMUX", "TMUX_PANE"]) {
+        if (input[key] !== undefined)
+            env[key] = input[key];
+    }
+    for (const [key, value] of Object.entries(input))
+        if (key.startsWith("LC_") && value !== undefined)
+            env[key] = value;
+    return env;
+}
+function request(command, args, cwd, env) {
+    return { command, args, cwd, env, timeoutMs: PROCESS_TIMEOUT_MS, maxBufferBytes: PROCESS_OUTPUT_LIMIT };
+}
+function requireSuccess(result, label) {
+    if (result.error || result.status !== 0)
+        throw new Error(`${label} failed`);
+}
+function waitSynchronously(milliseconds) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, milliseconds);
+}
+//# sourceMappingURL=claude-structured-pane.js.map

package/dist/src/providers/claude-structured-pane.js.map

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

package/dist/src/providers/claude-structured-store.d.ts

@@ -0,0 +1,48 @@
+import type { EvidenceSchema } from "../domain/role-policy.js";
+export type ClaudeStructuredRoleId = "oms.grader.claude" | "oms.bounded-dreamer";
+export type ClaudeStructuredEvidenceSchema = Extract<EvidenceSchema, "grader-output.v1" | "reflection.v1">;
+export interface ClaudeStructuredRequest {
+    readonly schema_version: 1;
+    readonly request_id: string;
+    readonly role_id: ClaudeStructuredRoleId;
+    readonly evidence_schema: ClaudeStructuredEvidenceSchema;
+    readonly model_id: string;
+    readonly policy_digest: string;
+    readonly claude_session_id: string;
+    readonly claude_version: string;
+    readonly created_at: string;
+    readonly input: Readonly<Record<string, unknown>>;
+}
+export interface ClaudeStructuredResult {
+    readonly schema_version: 1;
+    readonly request_id: string;
+    readonly role_id: ClaudeStructuredRoleId;
+    readonly evidence_schema: ClaudeStructuredEvidenceSchema;
+    readonly claude_session_id: string;
+    readonly submitted_at: string;
+    readonly result: Readonly<Record<string, unknown>>;
+}
+export interface ClaudeStructuredRoleStore {
+    writeRequest(request: ClaudeStructuredRequest): Readonly<{
+        status: "created" | "replayed";
+        request: ClaudeStructuredRequest;
+    }>;
+    readRequest(requestId: string): ClaudeStructuredRequest;
+    readRequestIfExists(requestId: string): ClaudeStructuredRequest | undefined;
+    submitResult(requestId: string, result: Record<string, unknown>, submittedAt: string): Readonly<{
+        status: "created" | "replayed";
+        record: ClaudeStructuredResult;
+    }>;
+    readResultIfExists(requestId: string): ClaudeStructuredResult | undefined;
+    outputSchema(requestId: string): Readonly<Record<string, unknown>>;
+}
+export declare function createClaudeStructuredRoleStore(options: {
+    readonly packageRoot: string;
+    readonly stateRoot: string;
+}): ClaudeStructuredRoleStore;
+export declare function sameStructuredRequestIntent(request: ClaudeStructuredRequest, expected: Readonly<{
+    requestId: string;
+    roleId: ClaudeStructuredRoleId;
+    evidenceSchema: ClaudeStructuredEvidenceSchema;
+    input: Readonly<Record<string, unknown>>;
+}>): boolean;