oh-my-super-agent 0.1.0

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

@@ -0,0 +1,212 @@
+import { join } from "node:path";
+import { assertOpaqueId } from "../domain/records.js";
+import { ImmutableFileConflictError, assertFileInside, openStableDirectory, readImmutableFile, writeImmutableFile, } from "../evidence/immutable-file.js";
+import { assertSchema, loadJsonSchema } from "../runtime/schema.js";
+import { registeredSchema } from "../schemas/registry.js";
+import { isRecord, lstatIfExists, validateExistingDirectory } from "../utils/fs.js";
+const MAX_STRUCTURED_ROLE_BYTES = 256 * 1024;
+export function createClaudeStructuredRoleStore(options) {
+    const packageRoot = validateExistingDirectory(options.packageRoot, "structured-role package root");
+    const requestsRoot = validateExistingDirectory(join(options.stateRoot, "structured-role-requests"), "structured-role requests root");
+    const resultsRoot = validateExistingDirectory(join(options.stateRoot, "structured-role-results"), "structured-role results root");
+    const requestEnvelope = loadJsonSchema(join(packageRoot, "schemas", "structured-role-request.schema.json"));
+    const resultEnvelope = loadJsonSchema(join(packageRoot, "schemas", "structured-role-result.schema.json"));
+    function readRequest(requestId) {
+        const id = assertOpaqueId(requestId, "structured request id");
+        return withStableFile(requestsRoot, `${id}.json`, "structured-role requests root", (path) => (parseRequest(parseBytes(readImmutableFile(path, MAX_STRUCTURED_ROLE_BYTES)), requestEnvelope)));
+    }
+    function readRequestIfExists(requestId) {
+        const id = assertOpaqueId(requestId, "structured request id");
+        const path = join(requestsRoot, `${id}.json`);
+        const entry = lstatIfExists(path);
+        if (!entry)
+            return undefined;
+        if (entry.isSymbolicLink() || !entry.isFile())
+            throw new Error("structured-role request path is unsafe");
+        return readRequest(id);
+    }
+    function readResultIfExists(requestId) {
+        const id = assertOpaqueId(requestId, "structured request id");
+        const path = join(resultsRoot, `${id}.json`);
+        const entry = lstatIfExists(path);
+        if (!entry)
+            return undefined;
+        if (entry.isSymbolicLink() || !entry.isFile())
+            throw new Error("structured-role result path is unsafe");
+        return withStableFile(resultsRoot, `${id}.json`, "structured-role results root", (stablePath) => {
+            const result = parseResult(parseBytes(readImmutableFile(stablePath, MAX_STRUCTURED_ROLE_BYTES)), resultEnvelope);
+            if (result.request_id !== id)
+                throw new Error("structured-role result has the wrong request id");
+            const request = readRequest(id);
+            assertResultBinding(request, result);
+            assertSchema(result.result, registeredSchema(request.evidence_schema, packageRoot).schema, request.evidence_schema);
+            return result;
+        });
+    }
+    const store = {
+        writeRequest(rawRequest) {
+            const request = parseRequest(rawRequest, requestEnvelope);
+            assertRoleSchema(request.role_id, request.evidence_schema);
+            const path = join(requestsRoot, `${assertOpaqueId(request.request_id, "structured request id")}.json`);
+            const bytes = canonicalBytes(request);
+            if (bytes.byteLength > MAX_STRUCTURED_ROLE_BYTES) {
+                throw new Error(`structured-role request exceeds ${MAX_STRUCTURED_ROLE_BYTES} bytes`);
+            }
+            const status = withStableRoot(requestsRoot, "structured-role requests root", (root) => {
+                assertFileInside(root, path);
+                return writeImmutableFile(path, bytes);
+            });
+            return Object.freeze({ status, request: readRequest(request.request_id) });
+        },
+        readRequest,
+        readRequestIfExists,
+        submitResult(requestId, rawResult, submittedAt) {
+            const request = readRequest(requestId);
+            assertTimestamp(submittedAt, "structured result timestamp");
+            const result = cloneObject(rawResult, "structured result");
+            assertSchema(result, registeredSchema(request.evidence_schema, packageRoot).schema, request.evidence_schema);
+            const existing = readResultIfExists(request.request_id);
+            if (existing) {
+                if (canonicalJson(existing.result) !== canonicalJson(result)) {
+                    throw new Error("structured-role result conflict");
+                }
+                return Object.freeze({ status: "replayed", record: existing });
+            }
+            const record = parseResult({
+                schema_version: 1,
+                request_id: request.request_id,
+                role_id: request.role_id,
+                evidence_schema: request.evidence_schema,
+                claude_session_id: request.claude_session_id,
+                submitted_at: submittedAt,
+                result,
+            }, resultEnvelope);
+            const path = join(resultsRoot, `${request.request_id}.json`);
+            let writeStatus = "replayed";
+            try {
+                writeStatus = withStableRoot(resultsRoot, "structured-role results root", (root) => {
+                    assertFileInside(root, path);
+                    return writeImmutableFile(path, canonicalBytes(record));
+                });
+            }
+            catch (error) {
+                if (!(error instanceof ImmutableFileConflictError))
+                    throw error;
+            }
+            const stored = readResultIfExists(request.request_id);
+            if (!stored)
+                throw new Error("structured-role result disappeared after write");
+            if (canonicalJson(stored.result) !== canonicalJson(result)) {
+                throw new Error("structured-role result conflict");
+            }
+            return Object.freeze({ status: writeStatus, record: stored });
+        },
+        readResultIfExists,
+        outputSchema(requestId) {
+            const request = readRequest(requestId);
+            return deepFreeze(structuredClone(registeredSchema(request.evidence_schema, packageRoot).schema));
+        },
+    };
+    return Object.freeze(store);
+}
+export function sameStructuredRequestIntent(request, expected) {
+    return request.request_id === expected.requestId
+        && request.role_id === expected.roleId
+        && request.evidence_schema === expected.evidenceSchema
+        && canonicalJson(request.input) === canonicalJson(expected.input);
+}
+function parseRequest(value, schema) {
+    assertSchema(value, schema, "structured-role request");
+    if (!isRecord(value) || !isRecord(value.input))
+        throw new Error("structured-role request is invalid");
+    const request = value;
+    assertRoleSchema(request.role_id, request.evidence_schema);
+    assertTimestamp(request.created_at, "structured request timestamp");
+    return deepFreeze(structuredClone(request));
+}
+function parseResult(value, schema) {
+    assertSchema(value, schema, "structured-role result");
+    if (!isRecord(value) || !isRecord(value.result))
+        throw new Error("structured-role result is invalid");
+    const result = value;
+    assertRoleSchema(result.role_id, result.evidence_schema);
+    assertTimestamp(result.submitted_at, "structured result timestamp");
+    return deepFreeze(structuredClone(result));
+}
+function assertRoleSchema(roleId, schema) {
+    const expected = roleId === "oms.grader.claude" ? "grader-output.v1" : "reflection.v1";
+    if (schema !== expected)
+        throw new Error(`role ${roleId} requires ${expected}`);
+}
+function assertResultBinding(request, result) {
+    if (result.role_id !== request.role_id
+        || result.evidence_schema !== request.evidence_schema
+        || result.claude_session_id !== request.claude_session_id)
+        throw new Error("structured-role result binding changed");
+}
+function withStableRoot(path, label, action) {
+    const root = openStableDirectory(path, label);
+    try {
+        return action(root);
+    }
+    finally {
+        root.close();
+    }
+}
+function withStableFile(rootPath, fileName, label, action) {
+    return withStableRoot(rootPath, label, (root) => {
+        const path = join(root.path, fileName);
+        assertFileInside(root, path);
+        const result = action(path);
+        root.assertUnchanged();
+        return result;
+    });
+}
+function parseBytes(bytes) {
+    try {
+        return JSON.parse(bytes.toString("utf8"));
+    }
+    catch {
+        throw new Error("structured-role record contains malformed JSON");
+    }
+}
+function canonicalBytes(value) {
+    return Buffer.from(`${canonicalJson(value)}\n`, "utf8");
+}
+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-role data contains a non-finite number");
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    if (isRecord(value)) {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new Error("structured-role data contains an unsupported object prototype");
+        }
+        return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`).join(",")}}`;
+    }
+    throw new Error("structured-role data must contain only JSON values");
+}
+function cloneObject(value, label) {
+    if (!isRecord(value))
+        throw new Error(`${label} must be an object`);
+    return JSON.parse(canonicalJson(value));
+}
+function assertTimestamp(value, label) {
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed))
+        throw new Error(`${label} is invalid`);
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const nested of Object.values(value))
+        deepFreeze(nested);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=claude-structured-store.js.map

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

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

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

@@ -0,0 +1,56 @@
+import { type ClaudeStructuredPaneAdapter, type ClaudeStructuredPaneObservation } from "./claude-structured-pane.js";
+import { type ClaudeStructuredEvidenceSchema, type ClaudeStructuredRequest, type ClaudeStructuredResult, type ClaudeStructuredRoleId } from "./claude-structured-store.js";
+import { type ProcessRunner } from "./process.js";
+export interface PrepareClaudeStructuredRoleOptions {
+    readonly requestId: string;
+    readonly roleId: ClaudeStructuredRoleId;
+    readonly evidenceSchema: ClaudeStructuredEvidenceSchema;
+    readonly input: Readonly<Record<string, unknown>>;
+}
+export interface PreparedClaudeStructuredRole {
+    readonly status: "created" | "replayed";
+    readonly request: ClaudeStructuredRequest;
+}
+export type ClaudeStructuredRoleProgress = Readonly<{
+    status: "launched" | "waiting";
+    request: ClaudeStructuredRequest;
+    observation: ClaudeStructuredPaneObservation;
+    result?: never;
+    reason?: never;
+}> | Readonly<{
+    status: "complete";
+    request: ClaudeStructuredRequest;
+    result: ClaudeStructuredResult;
+    observation?: never;
+    reason?: never;
+}> | Readonly<{
+    status: "blocked";
+    request: ClaudeStructuredRequest;
+    reason: string;
+    observation?: ClaudeStructuredPaneObservation;
+    result?: never;
+}>;
+export interface ClaudeStructuredRoleTransport {
+    prepare(options: PrepareClaudeStructuredRoleOptions): PreparedClaudeStructuredRole;
+    advance(prepared: PreparedClaudeStructuredRole): ClaudeStructuredRoleProgress;
+    read(requestId: string): ClaudeStructuredRoleProgress;
+}
+export interface ClaudeStructuredResultIdentity {
+    readonly request_id: string;
+    readonly role_id: ClaudeStructuredRoleId;
+    readonly fresh_session_id: string;
+    readonly certifying: boolean;
+}
+export declare function createClaudeStructuredRoleTransport(options: {
+    readonly packageRoot: string;
+    readonly configRoot?: string;
+    readonly workspaceRoot: string;
+    readonly stateRoot: string;
+    readonly executablePath: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly runner?: ProcessRunner;
+    readonly panes?: ClaudeStructuredPaneAdapter;
+    readonly clock?: () => string;
+    readonly sessionIdFactory?: () => string;
+}): ClaudeStructuredRoleTransport;
+export declare function claudeStructuredResultIdentity(value: unknown): ClaudeStructuredResultIdentity;

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

@@ -0,0 +1,250 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, lstatSync, realpathSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { readOmsConfig } from "../config.js";
+import { digestRolePolicyConfig } from "../domain/role-policy.js";
+import { assertOpaqueId } from "../domain/records.js";
+import { ImmutableFileConflictError } from "../evidence/immutable-file.js";
+import { isRecord, validateExistingDirectory } from "../utils/fs.js";
+import { prepareClaudeInteractiveLaunch } from "./claude-interactive.js";
+import { createClaudeStructuredPaneAdapter, } from "./claude-structured-pane.js";
+import { createClaudeStructuredRoleStore, sameStructuredRequestIntent, } from "./claude-structured-store.js";
+import { probeClaudeCodeCompatibility, resolveConfiguredRole } from "./preflight.js";
+import { runProcess } from "./process.js";
+const PREPARED_METADATA = new WeakMap();
+const ADVANCED = new WeakSet();
+const CLAUDE_STRUCTURED_IDENTITIES = new WeakMap();
+export function createClaudeStructuredRoleTransport(options) {
+    const packageRoot = validateExistingDirectory(options.packageRoot, "structured-role package root");
+    const configRoot = validateExistingDirectory(options.configRoot ?? packageRoot, "structured-role configuration root");
+    const workspaceRoot = validateExistingDirectory(options.workspaceRoot, "structured-role workspace root");
+    const stateRoot = validateExistingDirectory(options.stateRoot, "structured-role state root");
+    const executablePath = validateExecutable(options.executablePath);
+    const env = options.env ?? process.env;
+    const runner = options.runner ?? runProcess;
+    const panes = options.panes ?? createClaudeStructuredPaneAdapter({ env, runner });
+    const clock = options.clock ?? (() => new Date().toISOString());
+    const sessionIdFactory = options.sessionIdFactory ?? randomUUID;
+    const store = createClaudeStructuredRoleStore({ packageRoot, stateRoot });
+    const transport = Symbol("OMS Claude structured-role transport");
+    const certifying = options.runner === undefined
+        && options.panes === undefined
+        && options.sessionIdFactory === undefined;
+    function prepare(raw) {
+        const intent = normalizeIntent(raw);
+        const existing = store.readRequestIfExists(intent.requestId);
+        if (existing)
+            return preparedResult("replayed", existing, intent);
+        const config = readOmsConfig(configRoot);
+        const configured = resolveConfiguredRole(config, intent.roleId);
+        if (configured.role.evidence_schema !== intent.evidenceSchema
+            || configured.role.engine !== "claude"
+            || configured.role.transport !== "claude_interactive"
+            || configured.role.sandbox !== "read-only"
+            || configured.role.session_policy !== "fresh"
+            || configured.role.freshness_policy !== "fresh_required")
+            throw new Error(`role ${intent.roleId} is not an eligible fresh interactive structured role`);
+        const compatibility = probeClaudeCodeCompatibility({ cwd: workspaceRoot, env, runner });
+        const sessionId = sessionIdFactory().toLowerCase();
+        const bridge = {
+            command: executablePath,
+            args: [
+                "structured-role",
+                "bridge",
+                "--request-id",
+                intent.requestId,
+                "--session-id",
+                sessionId,
+                "--state-root",
+                stateRoot,
+                "--workspace-root",
+                workspaceRoot,
+            ],
+        };
+        const launch = prepareClaudeInteractiveLaunch({
+            config,
+            roleId: intent.roleId,
+            cwd: workspaceRoot,
+            sessionName: intent.requestId,
+            env,
+            runner,
+            structuredRoleBridge: bridge,
+            structuredRoleInstructionsPath: join(packageRoot, ".agents", "agents", intent.roleId === "oms.grader.claude" ? "grader.md" : "dreamer.md"),
+            structuredRequestId: intent.requestId,
+            nativeSessionId: sessionId,
+        });
+        const request = {
+            schema_version: 1,
+            request_id: intent.requestId,
+            role_id: intent.roleId,
+            evidence_schema: intent.evidenceSchema,
+            model_id: configured.modelId,
+            policy_digest: digestRolePolicyConfig(config),
+            claude_session_id: sessionId,
+            claude_version: compatibility.version,
+            created_at: clock(),
+            input: intent.input,
+        };
+        let written;
+        try {
+            written = store.writeRequest(request);
+        }
+        catch (error) {
+            if (!(error instanceof ImmutableFileConflictError))
+                throw error;
+            const raced = store.readRequest(intent.requestId);
+            return preparedResult("replayed", raced, intent);
+        }
+        if (written.status === "replayed")
+            return preparedResult("replayed", written.request, intent);
+        const prepared = Object.freeze({ status: "created", request: written.request });
+        PREPARED_METADATA.set(prepared, {
+            transport,
+            launch: Object.freeze({
+                requestId: intent.requestId,
+                command: launch.command,
+                args: Object.freeze([...launch.args]),
+                cwd: launch.cwd,
+                env: Object.freeze({ ...launch.env }),
+            }),
+        });
+        return prepared;
+    }
+    function preparedResult(status, request, intent) {
+        if (!sameStructuredRequestIntent(request, intent))
+            throw new Error("structured-role request conflict");
+        const prepared = Object.freeze({ status, request });
+        PREPARED_METADATA.set(prepared, { transport });
+        return prepared;
+    }
+    function read(requestId) {
+        const request = store.readRequest(assertOpaqueId(requestId, "structured request id"));
+        const result = store.readResultIfExists(request.request_id);
+        if (result)
+            return completedProgress(request, result, certifying);
+        try {
+            const observation = panes.observe(request.request_id);
+            if (!observation) {
+                return Object.freeze({ status: "blocked", request, reason: "structured-role launch is ambiguous after its durable claim" });
+            }
+            if (observation.dead) {
+                return Object.freeze({ status: "blocked", request, observation, reason: "structured-role pane is dead" });
+            }
+            return Object.freeze({ status: "waiting", request, observation });
+        }
+        catch (error) {
+            return Object.freeze({ status: "blocked", request, reason: boundedReason(error) });
+        }
+    }
+    function advance(prepared) {
+        const metadata = PREPARED_METADATA.get(prepared);
+        if (!metadata || metadata.transport !== transport || !Object.isFrozen(prepared)) {
+            throw new Error("structured-role advance requires a prepared request from this transport");
+        }
+        const completed = store.readResultIfExists(prepared.request.request_id);
+        if (completed)
+            return completedProgress(prepared.request, completed, certifying);
+        if (!metadata.launch || ADVANCED.has(prepared))
+            return read(prepared.request.request_id);
+        ADVANCED.add(prepared);
+        try {
+            const observation = panes.create(metadata.launch);
+            return Object.freeze({ status: "launched", request: prepared.request, observation });
+        }
+        catch (error) {
+            return Object.freeze({ status: "blocked", request: prepared.request, reason: boundedReason(error) });
+        }
+    }
+    return Object.freeze({ prepare, advance, read });
+}
+export function claudeStructuredResultIdentity(value) {
+    if (typeof value !== "object" || value === null || !Object.isFrozen(value)) {
+        throw new Error("Claude grade source is not a completed structured invocation");
+    }
+    const identity = CLAUDE_STRUCTURED_IDENTITIES.get(value);
+    if (!identity)
+        throw new Error("Claude grade source is not a completed structured invocation");
+    return identity;
+}
+function completedProgress(request, result, certifying) {
+    if (result.request_id !== request.request_id
+        || result.role_id !== request.role_id
+        || result.evidence_schema !== request.evidence_schema
+        || result.claude_session_id !== request.claude_session_id)
+        throw new Error("Claude structured result changed its durable request or fresh session binding");
+    CLAUDE_STRUCTURED_IDENTITIES.set(result, Object.freeze({
+        request_id: request.request_id,
+        role_id: request.role_id,
+        fresh_session_id: request.claude_session_id,
+        certifying,
+    }));
+    return Object.freeze({ status: "complete", request, result });
+}
+function normalizeIntent(options) {
+    const requestId = assertOpaqueId(options.requestId, "structured request id");
+    if (options.roleId !== "oms.grader.claude" && options.roleId !== "oms.bounded-dreamer") {
+        throw new Error("unsupported Claude structured role");
+    }
+    const expectedSchema = options.roleId === "oms.grader.claude" ? "grader-output.v1" : "reflection.v1";
+    if (options.evidenceSchema !== expectedSchema)
+        throw new Error(`role ${options.roleId} requires ${expectedSchema}`);
+    if (!isRecord(options.input))
+        throw new Error("structured-role input must be an object");
+    try {
+        assertJsonValue(options.input, new Set());
+    }
+    catch {
+        throw new Error("structured-role input must contain only acyclic JSON data");
+    }
+    const input = structuredClone(options.input);
+    return Object.freeze({ requestId, roleId: options.roleId, evidenceSchema: options.evidenceSchema, input: deepFreeze(input) });
+}
+function validateExecutable(path) {
+    if (!isAbsolute(path) || !existsSync(path))
+        throw new Error("OMS executable path must be an existing absolute file");
+    const entry = lstatSync(path);
+    if (entry.isSymbolicLink() || !entry.isFile() || (entry.mode & 0o111) === 0) {
+        throw new Error("OMS executable path must be a non-symbolic executable file");
+    }
+    return realpathSync.native(path);
+}
+function boundedReason(error) {
+    const value = error instanceof Error ? error.message : String(error);
+    return (value.trim().replace(/[\0\r\n]+/gu, " ") || "structured-role transport blocked").slice(0, 512);
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const nested of Object.values(value))
+        deepFreeze(nested);
+    return Object.freeze(value);
+}
+function assertJsonValue(value, ancestors) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new Error("non-finite number");
+        return;
+    }
+    if (typeof value !== "object")
+        throw new Error("unsupported JSON value");
+    if (ancestors.has(value))
+        throw new Error("cyclic JSON value");
+    ancestors.add(value);
+    if (Array.isArray(value)) {
+        for (const child of value)
+            assertJsonValue(child, ancestors);
+    }
+    else {
+        if (!isRecord(value))
+            throw new Error("unsupported JSON object");
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            throw new Error("unsupported JSON object prototype");
+        for (const child of Object.values(value))
+            assertJsonValue(child, ancestors);
+    }
+    ancestors.delete(value);
+}
+//# sourceMappingURL=claude-structured.js.map

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

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

package/dist/src/providers/codex-exec.d.ts

@@ -0,0 +1,29 @@
+import type { RolePolicyConfig } from "../domain/role-policy.js";
+import { type ProcessResult, type ProcessRunner } from "./process.js";
+export interface CodexStructuredRequest {
+    config: RolePolicyConfig;
+    roleId: "oms.exec-advisor" | "oms.grader.codex";
+    prompt: string;
+    requestId: string;
+    cwd: string;
+    temporaryRoot: string;
+    packageRoot?: string;
+    timeoutMs?: number;
+    confirmBilledUse?: boolean;
+    beforeProviderContact?: () => void;
+    env?: NodeJS.ProcessEnv;
+    runner?: ProcessRunner;
+}
+export interface CodexStructuredResult<T = unknown> {
+    value: T;
+    outputPath: string;
+    process: Pick<ProcessResult, "status" | "signal" | "stdout" | "stderr">;
+}
+export interface CodexStructuredResultIdentity {
+    readonly request_id: string;
+    readonly role_id: CodexStructuredRequest["roleId"];
+    readonly fresh_session_id: string;
+    readonly certifying: boolean;
+}
+export declare function runCodexStructured<T = unknown>(request: CodexStructuredRequest): CodexStructuredResult<T>;
+export declare function codexStructuredResultIdentity(value: unknown): CodexStructuredResultIdentity;