oh-my-super-agent 0.1.0

package/dist/src/domain/records.js

@@ -0,0 +1,138 @@
+import { join } from "node:path";
+import { findPackageRoot } from "../package-root.js";
+import { isRecord } from "../utils/fs.js";
+import { loadJsonSchema } from "../runtime/schema.js";
+const OPAQUE_ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/;
+export const MAX_TRANSITION_OUTCOMES = 64;
+export function assertOpaqueId(value, label = "opaque id") {
+    if (typeof value !== "string" || !OPAQUE_ID_PATTERN.test(value)) {
+        throw new Error(`invalid ${label}`);
+    }
+    return value;
+}
+export function assertRecordId(value, label = "record id") {
+    return assertOpaqueId(value, label);
+}
+export function assertLockId(value, label = "lock id") {
+    return assertOpaqueId(value, label);
+}
+export function assertActorId(value, label = "actor id") {
+    return assertOpaqueId(value, label);
+}
+export function assertLeaseToken(value, label = "lease token") {
+    return assertOpaqueId(value, label);
+}
+export function assertTransitionNonce(value, label = "transition nonce") {
+    return assertOpaqueId(value, label);
+}
+export function runtimeRecordSchemaPath(root = findPackageRoot()) {
+    return join(root, "schemas", "runtime-record.schema.json");
+}
+export function loadRuntimeRecordSchema(root = findPackageRoot()) {
+    return loadJsonSchema(runtimeRecordSchemaPath(root));
+}
+export function recordFileName(recordId) {
+    return `${recordId}.json`;
+}
+export function recordLockId(recordId) {
+    return assertLockId(`record-${recordId}`);
+}
+export function parseRuntimeRecord(value) {
+    if (!isRecord(value))
+        throw new Error("runtime record must be an object");
+    if (value.schema_version !== 1)
+        throw new Error("runtime record schema_version must be 1");
+    const version = parseCount(value.version, "version");
+    const state = parseState(value.state);
+    const attempt = parsePositiveCount(value.attempt, "attempt");
+    const maxAttempts = parsePositiveCount(value.max_attempts, "max_attempts");
+    if (attempt > maxAttempts)
+        throw new Error("runtime record attempt exceeds max_attempts");
+    if (!isRecord(value.payload))
+        throw new Error("runtime record payload must be an object");
+    if (!Array.isArray(value.transition_outcomes) || value.transition_outcomes.length === 0) {
+        throw new Error("runtime record transition_outcomes must be a non-empty array");
+    }
+    if (value.transition_outcomes.length > MAX_TRANSITION_OUTCOMES) {
+        throw new Error(`runtime record transition_outcomes exceeds ${MAX_TRANSITION_OUTCOMES}`);
+    }
+    const leaseToken = value.lease_token === null ? null : assertLeaseToken(value.lease_token);
+    const actor = assertActorId(value.actor);
+    const transitionNonce = assertTransitionNonce(value.transition_nonce);
+    const outcomes = value.transition_outcomes.map(parseTransitionOutcome);
+    const seenNonces = new Set();
+    for (let index = 0; index < outcomes.length; index += 1) {
+        const outcome = outcomes[index];
+        if (!outcome)
+            throw new Error("runtime record transition outcome is missing");
+        if (seenNonces.has(outcome.nonce))
+            throw new Error("runtime record transition nonces must be unique");
+        seenNonces.add(outcome.nonce);
+        if (outcome.attempt > maxAttempts)
+            throw new Error("runtime record transition outcome exceeds max_attempts");
+        const previous = outcomes[index - 1];
+        if (!previous && outcome.version !== 0) {
+            throw new Error("runtime record transition outcome history must start at version 0");
+        }
+        if (previous && outcome.version !== previous.version + 1) {
+            throw new Error("runtime record transition outcome versions must be contiguous");
+        }
+        if (previous && (outcome.attempt < previous.attempt || outcome.attempt > previous.attempt + 1)) {
+            throw new Error("runtime record transition outcome attempts must be monotonic");
+        }
+    }
+    const lastOutcome = outcomes.at(-1);
+    if (!lastOutcome)
+        throw new Error("runtime record transition_outcomes must be a non-empty array");
+    if (lastOutcome.nonce !== transitionNonce
+        || lastOutcome.version !== version
+        || lastOutcome.state !== state
+        || lastOutcome.attempt !== attempt
+        || lastOutcome.actor !== actor
+        || lastOutcome.lease_token !== leaseToken) {
+        throw new Error("runtime record latest transition outcome does not match current state");
+    }
+    return {
+        schema_version: 1,
+        record_id: assertRecordId(value.record_id),
+        record_kind: assertOpaqueId(value.record_kind, "record kind"),
+        version,
+        state,
+        attempt,
+        max_attempts: maxAttempts,
+        actor,
+        lease_token: leaseToken,
+        transition_nonce: transitionNonce,
+        payload: value.payload,
+        transition_outcomes: outcomes,
+    };
+}
+function parseCount(value, label) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        throw new Error(`runtime record ${label} must be a non-negative integer`);
+    return value;
+}
+function parsePositiveCount(value, label) {
+    const count = parseCount(value, label);
+    if (count === 0)
+        throw new Error(`runtime record ${label} must be a positive integer`);
+    return count;
+}
+function parseState(value) {
+    if (typeof value !== "string")
+        throw new Error("runtime record state must be a string");
+    return value;
+}
+function parseTransitionOutcome(value) {
+    if (!isRecord(value))
+        throw new Error("runtime record transition outcome must be an object");
+    return {
+        nonce: assertTransitionNonce(value.nonce),
+        version: parseCount(value.version, "transition outcome version"),
+        state: parseState(value.state),
+        attempt: parsePositiveCount(value.attempt, "transition outcome attempt"),
+        actor: assertActorId(value.actor),
+        lease_token: value.lease_token === null ? null : assertLeaseToken(value.lease_token),
+    };
+}
+//# sourceMappingURL=records.js.map

package/dist/src/domain/records.js.map

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

package/dist/src/domain/role-policy.d.ts

@@ -0,0 +1,67 @@
+export declare const ROLE_IDS: readonly ["oms.conductor", "oms.exec-advisor", "oms.ticket-executor", "oms.goal-long-executor", "oms.grader.codex", "oms.grader.claude", "oms.bounded-dreamer"];
+export declare const ENGINES: readonly ["claude", "codex"];
+export declare const AUTH_MODES: readonly ["claude_subscription", "chatgpt_subscription", "api_key", "enterprise_access_token", "cloud_provider"];
+export declare const BILLING_CLASSES: readonly ["subscription", "api", "enterprise", "credit_billed"];
+export declare const TRANSPORTS: readonly ["claude_interactive", "codex_exec", "codex_goal"];
+export declare const SESSION_POLICIES: readonly ["operator_originated_oms_managed_interactive", "fresh", "persistent"];
+export declare const FRESHNESS_POLICIES: readonly ["fresh_required", "resumable", "persistent"];
+export declare const SANDBOXES: readonly ["read-only", "ticket-worktree-write"];
+export declare const EVIDENCE_SCHEMAS: readonly ["conductor-decision.v1", "advisor-output.v1", "executor-result.v1", "goal-executor-result.v1", "grader-output.v1", "reflection.v1"];
+export type RoleId = (typeof ROLE_IDS)[number];
+export type Engine = (typeof ENGINES)[number];
+export type AuthMode = (typeof AUTH_MODES)[number];
+export type BillingClass = (typeof BILLING_CLASSES)[number];
+export type Transport = (typeof TRANSPORTS)[number];
+export type SessionPolicy = (typeof SESSION_POLICIES)[number];
+export type FreshnessPolicy = (typeof FRESHNESS_POLICIES)[number];
+export type Sandbox = (typeof SANDBOXES)[number];
+export type EvidenceSchema = (typeof EVIDENCE_SCHEMAS)[number];
+export interface ModelDefinition {
+    engine: Engine;
+    id: string;
+}
+export interface RolePolicyRow {
+    role_id: RoleId;
+    engine: Engine;
+    model_id: string;
+    billing_class: BillingClass;
+    allow_api_billing: boolean;
+    allow_overage_credits: boolean;
+    auth_mode: AuthMode;
+    unattended_eligible: boolean;
+    sandbox: Sandbox;
+    transport: Transport;
+    session_policy: SessionPolicy;
+    freshness_policy: FreshnessPolicy;
+    evidence_schema: EvidenceSchema;
+}
+export interface RolePolicyConfig {
+    version: 2;
+    credit_billed_allowed: boolean;
+    models: Record<string, ModelDefinition>;
+    roles: Record<RoleId, RolePolicyRow>;
+}
+export interface TrackedRolePolicyGate {
+    readonly version: 2;
+    readonly digest: string;
+}
+export interface LegacyOmsConfigV1 {
+    version: 1;
+    unattended: {
+        enabled: boolean;
+        codex_auth: string;
+        claude_auth: string;
+    };
+}
+export declare const DEFAULT_ROLE_POLICY_CONFIG: RolePolicyConfig;
+export declare function cloneRolePolicyConfig(config: RolePolicyConfig): RolePolicyConfig;
+export declare function readRolePolicyConfig(value: unknown, path: string): RolePolicyConfig;
+export declare function loadTrackedRolePolicyGate(packageRoot?: string): TrackedRolePolicyGate;
+export declare function assertTrackedRolePolicyGate(value: unknown, packageRoot?: string): asserts value is TrackedRolePolicyGate;
+export declare function digestRolePolicyConfig(policy: RolePolicyConfig): string;
+export declare function readLegacyOmsConfigV1(value: unknown, path: string): LegacyOmsConfigV1;
+export declare function migrateLegacyOmsConfig(_legacy: LegacyOmsConfigV1): RolePolicyConfig;
+export declare function validateRolePolicyConfig(config: RolePolicyConfig): string[];
+export declare function getUnattendedRoles(config: RolePolicyConfig): RoleId[];
+export declare function resolveRoleModel(config: RolePolicyConfig, roleId: RoleId): ModelDefinition;
+export declare function selectCrossEngineGrader(config: RolePolicyConfig, executorRoleId: RoleId): RoleId;