oh-my-super-agent 0.1.0

package/dist/src/dispatch/advice-source.js

@@ -0,0 +1,198 @@
+import { createHash } from "node:crypto";
+import { readLiveContact, readLiveDeliveryAuthorization, readPreDispatchAdviceAuthorization, } from "../live/contact-journal.js";
+import { codexStructuredResultIdentity, } from "../providers/codex-exec.js";
+import { createStableId } from "../runtime/stable-id.js";
+import { isRecord } from "../utils/fs.js";
+import { adviceIdForIntent } from "./advice-store.js";
+import { captureCanonicalDispatchIntent, } from "./intent.js";
+const PROTECTED_ADVISOR_PROVENANCE = Symbol("OMS protected advisor provenance");
+const PROTECTED_ADVISOR_PROVENANCES = new WeakMap();
+export function captureProtectedAdvisorSource(source) {
+    const identity = codexStructuredResultIdentity(source);
+    if (!identity.certifying || identity.role_id !== "oms.exec-advisor" || !isRecord(source.value)) {
+        throw new Error("protected advisor source is not a certifying fresh Codex advisor result");
+    }
+    return Object.freeze({
+        role_id: "oms.exec-advisor",
+        request_id: identity.request_id,
+        fresh_session_id: identity.fresh_session_id,
+        output: source.value,
+    });
+}
+export function createAdvisorProviderRequest(options) {
+    const intent = captureCanonicalDispatchIntent(options.intent.canonical);
+    if (intent.dispatch_intent_sha256 !== options.intent.dispatch_intent_sha256) {
+        throw new Error("advisor request intent changed after capture");
+    }
+    const expectedRequestId = expectedAdvisorRequestId(intent);
+    if (options.requestId !== expectedRequestId)
+        throw new Error("advisor request id is not canonical for its intent");
+    return deepFreeze({
+        schema_version: 1,
+        request_id: expectedRequestId,
+        role_id: "oms.exec-advisor",
+        evidence_schema: "advisor-output.v1",
+        dispatch_intent_sha256: intent.dispatch_intent_sha256,
+        canonical_intent: structuredClone(intent.canonical),
+        advice_authorization_id: options.adviceAuthorizationId,
+    });
+}
+export function captureProtectedAdvisorProvenance(options) {
+    const source = captureProtectedAdvisorSource(options.source);
+    const intent = captureCanonicalDispatchIntent(options.request.canonical_intent);
+    const request = createAdvisorProviderRequest({
+        requestId: options.request.request_id,
+        intent,
+        adviceAuthorizationId: options.request.advice_authorization_id,
+    });
+    const current = readCurrentAdviceAuthority(options.stateRoot);
+    if (source.request_id !== request.request_id
+        || source.fresh_session_id !== request.request_id
+        || source.output.dispatch_intent_sha256 !== request.dispatch_intent_sha256
+        || request.advice_authorization_id !== current.advice.authorization_id)
+        throw new Error("fresh advisor result does not match its durable advisor authority");
+    const contact = readLiveContact(options.stateRoot, options.contactReference);
+    assertContactBinding(contact, current, request);
+    const provenance = Object.freeze({
+        [PROTECTED_ADVISOR_PROVENANCE]: true,
+    });
+    PROTECTED_ADVISOR_PROVENANCES.set(provenance, Object.freeze({
+        ...source,
+        evidence_id: expectedAdvisorEvidenceId(intent),
+        ticket_id: intent.canonical.ticket_id,
+        dispatch_intent_sha256: intent.dispatch_intent_sha256,
+        contact_reference: deepFreeze(structuredClone(options.contactReference)),
+        advice_authorization_id: current.advice.authorization_id,
+    }));
+    return provenance;
+}
+export function protectedAdvisorProvenanceIdentity(value) {
+    if (typeof value !== "object" || value === null || !Object.isFrozen(value)) {
+        throw new Error("advisor evidence requires durable advisor provenance");
+    }
+    const identity = PROTECTED_ADVISOR_PROVENANCES.get(value);
+    if (!identity)
+        throw new Error("advisor evidence requires durable advisor provenance");
+    return identity;
+}
+export function assertDurableAdvisorEvidenceProvenance(options) {
+    const intent = captureCanonicalDispatchIntent(options.intent.canonical);
+    if (intent.dispatch_intent_sha256 !== options.intent.dispatch_intent_sha256) {
+        throw new Error("durable advisor provenance intent changed after capture");
+    }
+    const payload = options.evidence.payload;
+    const requestId = requiredString(payload.provider_request_id, "advisor provider request id");
+    const freshSessionId = requiredString(payload.fresh_session_id, "advisor fresh session id");
+    const adviceAuthorizationId = requiredString(payload.advice_authorization_id, "advisor authorization id");
+    const contactReference = parseContactReference(payload.contact_reference);
+    const current = readCurrentAdviceAuthority(options.stateRoot);
+    const request = createAdvisorProviderRequest({
+        requestId,
+        intent,
+        adviceAuthorizationId,
+    });
+    const contact = readLiveContact(options.stateRoot, contactReference);
+    if (options.evidence.evidence_id !== expectedAdvisorEvidenceId(intent)
+        || options.evidence.evidence_kind !== "advisor-output"
+        || options.evidence.ticket_id !== intent.canonical.ticket_id
+        || options.evidence.producer_role !== "oms.exec-advisor"
+        || payload.dispatch_intent_sha256 !== intent.dispatch_intent_sha256
+        || freshSessionId !== requestId
+        || adviceAuthorizationId !== current.advice.authorization_id)
+        throw new Error("advisor evidence does not match its durable provenance");
+    assertContactBinding(contact, current, request);
+}
+export function assertStoredAdvisorEvidenceProvenance(options) {
+    const intent = captureCanonicalDispatchIntent(options.intent.canonical);
+    if (intent.dispatch_intent_sha256 !== options.intent.dispatch_intent_sha256) {
+        throw new Error("stored advisor provenance intent changed after capture");
+    }
+    const payload = options.evidence.payload;
+    const requestId = requiredString(payload.provider_request_id, "advisor provider request id");
+    const freshSessionId = requiredString(payload.fresh_session_id, "advisor fresh session id");
+    const adviceAuthorizationId = requiredString(payload.advice_authorization_id, "advisor authorization id");
+    const contactReference = parseContactReference(payload.contact_reference);
+    const request = createAdvisorProviderRequest({ requestId, intent, adviceAuthorizationId });
+    const contact = readLiveContact(options.stateRoot, contactReference);
+    if (options.evidence.evidence_id !== expectedAdvisorEvidenceId(intent)
+        || options.evidence.evidence_kind !== "advisor-output"
+        || options.evidence.ticket_id !== intent.canonical.ticket_id
+        || options.evidence.producer_role !== "oms.exec-advisor"
+        || payload.dispatch_intent_sha256 !== intent.dispatch_intent_sha256
+        || freshSessionId !== requestId
+        || createStableId("advice-auth", contact.authorization_id) !== adviceAuthorizationId
+        || contact.operation !== "pre-dispatch-advice"
+        || contact.contact_surface !== "codex-exec"
+        || contact.subject_id !== request.request_id
+        || contact.request_sha256 !== sha256(canonicalJson(request))
+        || contact.expected_spend !== "subscription")
+        throw new Error("stored advisor evidence does not match its immutable contact provenance");
+}
+function expectedAdvisorRequestId(intent) {
+    return createStableId("adv-request", adviceIdForIntent(intent));
+}
+function expectedAdvisorEvidenceId(intent) {
+    return createStableId("adv-evidence", adviceIdForIntent(intent));
+}
+function readCurrentAdviceAuthority(stateRoot) {
+    const authorization = readLiveDeliveryAuthorization(stateRoot);
+    const advice = readPreDispatchAdviceAuthorization(stateRoot);
+    if (!authorization || !advice)
+        throw new Error("advisor evidence lacks current human-confirmed advice authority");
+    if (advice.live_delivery_authorization_id !== authorization.authorization_id
+        || advice.conductor_session_id !== authorization.conductor_session_id
+        || advice.repository !== authorization.repository)
+        throw new Error("current advisor sidecar does not match live delivery authority");
+    return Object.freeze({ authorization, advice });
+}
+function assertContactBinding(contact, current, request) {
+    if (contact.authorization_id !== current.authorization.authorization_id
+        || contact.conductor_session_id !== current.authorization.conductor_session_id
+        || contact.repository !== current.authorization.repository
+        || contact.operation !== "pre-dispatch-advice"
+        || contact.contact_surface !== "codex-exec"
+        || contact.subject_id !== request.request_id
+        || contact.request_sha256 !== sha256(canonicalJson(request))
+        || contact.expected_spend !== "subscription")
+        throw new Error("advisor contact disclosure does not match its exact durable request");
+}
+function parseContactReference(value) {
+    if (!isRecord(value)
+        || typeof value.contact_id !== "string"
+        || typeof value.sha256 !== "string"
+        || typeof value.file_name !== "string")
+        throw new Error("advisor evidence lacks an exact contact reference");
+    return {
+        contact_id: value.contact_id,
+        sha256: value.sha256,
+        file_name: value.file_name,
+    };
+}
+function requiredString(value, label) {
+    if (typeof value !== "string" || value.length === 0)
+        throw new Error(`${label} is missing`);
+    return value;
+}
+function sha256(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+function canonicalJson(value) {
+    if (value === null || typeof value !== "object") {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new Error("advisor request contains a non-JSON value");
+        return encoded;
+    }
+    if (Array.isArray(value))
+        return `[${value.map((item) => canonicalJson(item)).join(",")}]`;
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=advice-source.js.map

package/dist/src/dispatch/advice-source.js.map

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

package/dist/src/dispatch/advice-store.d.ts

@@ -0,0 +1,41 @@
+import { type RuntimeRecord } from "../domain/records.js";
+import type { EvidenceReference } from "../evidence/store.js";
+import type { LiveContactReference } from "../live/contact-journal.js";
+import type { LinuxProcessIdentity } from "../runtime/process-identity.js";
+import { type CanonicalDispatchIntent, type CapturedDispatchIntent } from "./intent.js";
+export type DispatchAdviceState = "prepared" | "contacting" | "completed" | "blocked";
+export type AdvisorVerdict = "approve" | "revise" | "veto";
+export type DispatchAdvicePayload = Record<string, unknown> & {
+    advice_id: string;
+    request_id: string;
+    expected_evidence_id: string;
+    dispatch_intent_sha256: string;
+    canonical_intent: CanonicalDispatchIntent;
+    created_at: string;
+    updated_at: string;
+    contact_reference: LiveContactReference | null;
+    contact_owner_process: LinuxProcessIdentity | null;
+    provider_started_at: string | null;
+    advisor_evidence: EvidenceReference | null;
+    verdict: AdvisorVerdict | null;
+    blocked_reason: string | null;
+};
+export type DispatchAdviceRecord = RuntimeRecord<DispatchAdviceState, DispatchAdvicePayload>;
+export interface DispatchAdviceStore {
+    create(intent: CapturedDispatchIntent, at: string): DispatchAdviceRecord;
+    read(adviceId: string): DispatchAdviceRecord;
+    readIfExists(adviceId: string): DispatchAdviceRecord | undefined;
+    transition(options: {
+        record: DispatchAdviceRecord;
+        step: string;
+        toState: DispatchAdviceState;
+        at: string;
+        update: (payload: DispatchAdvicePayload) => DispatchAdvicePayload;
+    }): DispatchAdviceRecord;
+    list(): readonly DispatchAdviceRecord[];
+}
+export declare function adviceIdForIntent(intent: CapturedDispatchIntent): string;
+export declare function createDispatchAdviceStore(options: {
+    packageRoot: string;
+    stateRoot: string;
+}): DispatchAdviceStore;

package/dist/src/dispatch/advice-store.js

@@ -0,0 +1,201 @@
+import { join } from "node:path";
+import { assertActorId, assertLeaseToken, assertOpaqueId, assertRecordId, assertTransitionNonce, } from "../domain/records.js";
+import { canonicalTimestamp } from "../queue/model.js";
+import { createRecordStore } from "../runtime/record-store.js";
+import { assertSchema, loadJsonSchema } from "../runtime/schema.js";
+import { createStableId } from "../runtime/stable-id.js";
+import { validateExistingDirectory } from "../utils/fs.js";
+import { captureCanonicalDispatchIntent, } from "./intent.js";
+const LEGAL_EDGES = Object.freeze({
+    prepared: ["contacting", "blocked"],
+    contacting: ["completed", "blocked"],
+    completed: [],
+    blocked: [],
+});
+export function adviceIdForIntent(intent) {
+    return createStableId("advice", intent.canonical.ticket_id, String(intent.canonical.attempt), intent.canonical.lease_token, intent.dispatch_intent_sha256);
+}
+export function createDispatchAdviceStore(options) {
+    const packageRoot = validateExistingDirectory(options.packageRoot, "dispatch advice package root");
+    const stateRoot = validateExistingDirectory(options.stateRoot, "dispatch advice state root");
+    const payloadSchema = loadJsonSchema(join(packageRoot, "schemas", "dispatch-advice-payload.schema.json"));
+    const actor = assertActorId("oms-system");
+    const store = createRecordStore({
+        recordsRoot: join(stateRoot, "dispatch-advice"),
+        locksRoot: join(stateRoot, "locks"),
+        recordValidator(raw) {
+            if (raw.record_kind !== "dispatch-advice" || !isDispatchAdviceState(raw.state)) {
+                throw new Error("invalid dispatch advice runtime record");
+            }
+            assertSchema(raw.payload, payloadSchema, "dispatch advice payload");
+            validateRecord(raw);
+        },
+        createValidator(raw) {
+            if (raw.version !== 0 || raw.state !== "prepared" || raw.actor !== actor) {
+                throw new Error("dispatch advice must begin prepared under OMS system authority");
+            }
+        },
+        transitionValidator(current, next) {
+            const before = current;
+            const after = next;
+            if (!LEGAL_EDGES[before.state].includes(after.state)) {
+                throw new Error(`illegal dispatch advice transition: ${before.state} -> ${after.state}`);
+            }
+            for (const field of [
+                "advice_id",
+                "request_id",
+                "expected_evidence_id",
+                "dispatch_intent_sha256",
+                "canonical_intent",
+                "created_at",
+            ]) {
+                if (JSON.stringify(before.payload[field]) !== JSON.stringify(after.payload[field])) {
+                    throw new Error(`dispatch advice changed immutable ${field}`);
+                }
+            }
+            if (Date.parse(after.payload.updated_at) <= Date.parse(before.payload.updated_at)) {
+                throw new Error("dispatch advice update time must advance");
+            }
+            if (before.payload.contact_reference !== null
+                && JSON.stringify(before.payload.contact_reference) !== JSON.stringify(after.payload.contact_reference)) {
+                throw new Error("dispatch advice contact reference is immutable");
+            }
+            if (before.payload.contact_owner_process !== null
+                && JSON.stringify(before.payload.contact_owner_process) !== JSON.stringify(after.payload.contact_owner_process)) {
+                throw new Error("dispatch advice contact owner process is immutable");
+            }
+            if (before.payload.provider_started_at !== null
+                && before.payload.provider_started_at !== after.payload.provider_started_at) {
+                throw new Error("dispatch advice provider start is immutable");
+            }
+            if (before.payload.advisor_evidence !== null
+                && JSON.stringify(before.payload.advisor_evidence) !== JSON.stringify(after.payload.advisor_evidence)) {
+                throw new Error("dispatch advice evidence is immutable");
+            }
+        },
+    });
+    const result = {
+        create(intent, at) {
+            const capturedAt = canonicalTimestamp(at, "dispatch advice creation timestamp");
+            const adviceId = assertRecordId(adviceIdForIntent(intent), "dispatch advice id");
+            const canonical = structuredClone(intent.canonical);
+            const record = {
+                schema_version: 1,
+                record_id: adviceId,
+                record_kind: assertOpaqueId("dispatch-advice"),
+                version: 0,
+                state: "prepared",
+                attempt: canonical.attempt,
+                max_attempts: canonical.attempt + canonical.budget_snapshot.remaining_attempts - 1,
+                actor,
+                lease_token: assertLeaseToken(canonical.lease_token),
+                transition_nonce: assertTransitionNonce(createStableId("advice-create", adviceId)),
+                payload: {
+                    advice_id: adviceId,
+                    request_id: createStableId("adv-request", adviceId),
+                    expected_evidence_id: createStableId("adv-evidence", adviceId),
+                    dispatch_intent_sha256: intent.dispatch_intent_sha256,
+                    canonical_intent: canonical,
+                    created_at: capturedAt,
+                    updated_at: capturedAt,
+                    contact_reference: null,
+                    contact_owner_process: null,
+                    provider_started_at: null,
+                    advisor_evidence: null,
+                    verdict: null,
+                    blocked_reason: null,
+                },
+                transition_outcomes: [],
+            };
+            record.transition_outcomes.push({
+                nonce: record.transition_nonce,
+                version: 0,
+                state: "prepared",
+                attempt: record.attempt,
+                actor,
+                lease_token: record.lease_token,
+            });
+            return store.create(record);
+        },
+        read(adviceId) {
+            return store.read(assertRecordId(adviceId, "dispatch advice id"));
+        },
+        readIfExists(adviceId) {
+            return store.readIfExists(assertRecordId(adviceId, "dispatch advice id"));
+        },
+        transition({ record, step, toState, at, update }) {
+            return store.transition({
+                recordId: record.record_id,
+                ownerId: actor,
+                expectedVersion: record.version,
+                expectedActor: record.actor,
+                expectedAttempt: record.attempt,
+                expectedLeaseToken: record.lease_token,
+                nonce: createStableId("advice-step", record.record_id, step),
+                fromStates: [record.state],
+                toState,
+                updatePayload: (current) => ({
+                    ...update(current.payload),
+                    updated_at: canonicalTimestamp(at, "dispatch advice update timestamp"),
+                }),
+            }).record;
+        },
+        list() {
+            return store.list();
+        },
+    };
+    return Object.freeze(result);
+}
+function validateRecord(record) {
+    const payload = record.payload;
+    const captured = captureCanonicalDispatchIntent(payload.canonical_intent);
+    if (payload.advice_id !== record.record_id
+        || adviceIdForIntent(captured) !== record.record_id
+        || payload.dispatch_intent_sha256 !== captured.dispatch_intent_sha256
+        || payload.request_id !== createStableId("adv-request", record.record_id)
+        || payload.expected_evidence_id !== createStableId("adv-evidence", record.record_id)
+        || payload.canonical_intent.attempt !== record.attempt
+        || record.lease_token === null
+        || payload.canonical_intent.lease_token !== String(record.lease_token)
+        || record.actor !== "oms-system")
+        throw new Error("dispatch advice record identity mismatch");
+    const createdAt = canonicalTimestamp(payload.created_at, "dispatch advice created_at");
+    const updatedAt = canonicalTimestamp(payload.updated_at, "dispatch advice updated_at");
+    if (Date.parse(updatedAt) < Date.parse(createdAt))
+        throw new Error("dispatch advice update predates creation");
+    const hasContact = payload.contact_reference !== null;
+    if (hasContact !== (payload.contact_owner_process !== null)
+        || hasContact !== (payload.provider_started_at !== null))
+        throw new Error("dispatch advice contact metadata must be committed together");
+    if (record.state === "prepared" && (payload.contact_reference !== null
+        || payload.contact_owner_process !== null
+        || payload.provider_started_at !== null
+        || payload.advisor_evidence !== null
+        || payload.verdict !== null
+        || payload.blocked_reason !== null))
+        throw new Error("prepared dispatch advice has later-phase data");
+    if (record.state === "contacting" && (payload.contact_reference === null
+        || payload.contact_owner_process === null
+        || payload.provider_started_at === null
+        || payload.advisor_evidence !== null
+        || payload.verdict !== null
+        || payload.blocked_reason !== null))
+        throw new Error("contacting dispatch advice has invalid phase data");
+    if (record.state === "completed" && (payload.contact_reference === null
+        || payload.contact_owner_process === null
+        || payload.provider_started_at === null
+        || payload.advisor_evidence === null
+        || payload.verdict === null
+        || payload.blocked_reason !== null))
+        throw new Error("completed dispatch advice has invalid phase data");
+    if (record.state === "blocked" && payload.blocked_reason === null) {
+        throw new Error("blocked dispatch advice requires a reason");
+    }
+    if (!record.transition_outcomes.every((outcome) => outcome.actor === record.actor && outcome.lease_token === record.lease_token)) {
+        throw new Error("dispatch advice authority changed");
+    }
+}
+function isDispatchAdviceState(value) {
+    return Object.prototype.hasOwnProperty.call(LEGAL_EDGES, value);
+}
+//# sourceMappingURL=advice-store.js.map

package/dist/src/dispatch/advice-store.js.map

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

package/dist/src/dispatch/advice.d.ts

@@ -0,0 +1,34 @@
+import { type EvidenceReference } from "../evidence/store.js";
+import { runCodexStructured } from "../providers/codex-exec.js";
+import { type LinuxProcessIdentity } from "../runtime/process-identity.js";
+import { createRuntimeDispatchAuthorities } from "./runtime-authority.js";
+import { type DispatchIntent } from "./intent.js";
+type RuntimeAuthorities = ReturnType<typeof createRuntimeDispatchAuthorities>;
+type CodexStructuredRunner = typeof runCodexStructured;
+export interface DispatchAdviceProgress {
+    readonly status: "approved" | "revision-required" | "vetoed" | "blocked";
+    readonly advice_id: string;
+    readonly dispatch_intent_sha256: string;
+    readonly advisor_evidence: EvidenceReference | null;
+    readonly summary: string | null;
+    readonly recommendations: readonly string[];
+    readonly risks: readonly string[];
+    readonly reason: string | null;
+}
+export interface DispatchAdviceService {
+    advise(input: DispatchIntent): DispatchAdviceProgress;
+}
+export declare function createDispatchAdviceService(options: {
+    packageRoot: string;
+    configRoot?: string;
+    workspaceRoot: string;
+    stateRoot: string;
+    env?: NodeJS.ProcessEnv;
+    clock?: () => string;
+    runtime?: RuntimeAuthorities;
+    codexStructured?: CodexStructuredRunner;
+    processIdentity?: () => LinuxProcessIdentity;
+    processIsLive?: (identity: LinuxProcessIdentity) => boolean;
+}): DispatchAdviceService;
+export declare function assertDispatchAdviceService(value: unknown): asserts value is DispatchAdviceService;
+export {};