@onesi/genesis 0.1.13 → 0.2.0

package/dist/auto.d.ts

@@ -0,0 +1,1010 @@
+import type { GenesisClient } from './client.js';
+import type { OperationInput as In } from './types.js';
+/** Auto, your organization's operating structure: orgs, mandates, spend actions, approvals, the org structure (units, positions with
+ * delegated authority, occupants, goals and scorecards), how the org operates (budgets, policies, cadences,
+ * succession and acting appointments), verifiable authority (the authority check with its signed receipt,
+ * AuthorityCredentials, token verification) and the decision ledger. Auto never runs or controls an agent.
+ * Updates, archives, appointments, vacancies, succession and acting changes take the `version` you read
+ * (sent as If-Match); a stale one is a 409. */
+export declare function autoModule(client: GenesisClient): {
+    whoami: () => Promise<{
+        org: string;
+        principal: string;
+        kind: "api_key" | "m2m_token" | "bridge_session";
+        scopes: string[];
+    }>;
+    orgs: {
+        list: (includeArchived?: boolean) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Org"][];
+        }>;
+        get: (org: string) => Promise<{
+            id: string;
+            name: string;
+            owner: string;
+            charter: import("./index.js").components["schemas"]["Auto.Charter"];
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        create: (body: In<"auto_createOrg">["body"]) => Promise<{
+            id: string;
+            name: string;
+            owner: string;
+            charter: import("./index.js").components["schemas"]["Auto.Charter"];
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        update: (org: string, version: number | string, body: In<"auto_updateOrg">["body"]) => Promise<{
+            id: string;
+            name: string;
+            owner: string;
+            charter: import("./index.js").components["schemas"]["Auto.Charter"];
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (org: string, version: number | string) => Promise<{
+            id: string;
+            name: string;
+            owner: string;
+            charter: import("./index.js").components["schemas"]["Auto.Charter"];
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        mandates: (org: string) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Mandate"][];
+        }>;
+        createMandate: (org: string, body: In<"auto_createMandate">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            outcome: string;
+            budget: import("./index.js").components["schemas"]["Auto.Budget"];
+            decision_limits: import("./index.js").components["schemas"]["Auto.DecisionLimits"];
+            escalation: import("./index.js").components["schemas"]["Auto.Escalation"];
+            kpis: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            status: "draft" | "active" | "paused" | "completed" | "archived";
+            position_id: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        recordDecision: (org: string, body: In<"auto_recordDecision">["body"]) => Promise<{
+            seq: number;
+            id: string;
+            org_id: string;
+            mandate_id: string | null;
+            kind: "org.created" | "org.updated" | "org.archived" | "mandate.created" | "mandate.updated" | "mandate.archived" | "decision" | "approval.requested" | "approval.approved" | "approval.denied" | "approval.expired" | "unit.created" | "unit.updated" | "unit.archived" | "position.created" | "position.updated" | "position.archived" | "position.filled" | "position.vacated" | "goal.created" | "goal.updated" | "goal.measured" | "authority.check" | "authority.release" | "budget.created" | "budget.updated" | "budget.archived" | "policy.created" | "policy.updated" | "policy.archived" | "cadence.created" | "cadence.updated" | "cadence.held" | "cadence.skipped" | "position.succession" | "position.acting" | "position.acting_ended" | "credential.issued" | "credential.revoked";
+            actor: string;
+            actor_kind: string;
+            summary: string;
+            reasoning: string;
+            inputs: unknown;
+            cost: import("./index.js").components["schemas"]["Auto.LedgerCost"] | null;
+            request_id: string;
+            created_at: string;
+            prev_hash: string;
+            hash: string;
+        }>;
+        ledger: (org: string, page?: {
+            after?: number;
+            limit?: number;
+        }) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.LedgerEntry"][];
+            next_after: number | null;
+        }>;
+        verifyLedger: (org: string) => Promise<{
+            ok: boolean;
+            entries: number;
+            head?: string;
+            broken_at?: number;
+        }>;
+        approvals: (org: string, status?: "pending" | "approved" | "denied" | "expired") => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Approval"][];
+        }>;
+        units: (org: string, includeArchived?: boolean) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Unit"][];
+        }>;
+        createUnit: (org: string, body: In<"auto_createUnit">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            parent_id: string | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        positions: (org: string, filter?: {
+            unit_id?: string;
+            include_archived?: boolean;
+        }) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Position"][];
+        }>;
+        createPosition: (org: string, body: In<"auto_createPosition">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        chart: (org: string) => Promise<{
+            org: {
+                id: string;
+                name: string;
+                owner: string;
+            };
+            units: import("./index.js").components["schemas"]["Auto.ChartUnit"][];
+            positions: import("./index.js").components["schemas"]["Auto.ChartPosition"][];
+            counts: {
+                units: number;
+                positions: number;
+                filled: number;
+                agents: number;
+            };
+        }>;
+        goals: (org: string, positionId?: string) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Goal"][];
+        }>;
+        createGoal: (org: string, body: In<"auto_createGoal">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            position_id: string;
+            mandate_id: string | null;
+            title: string;
+            description: string | null;
+            metrics: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            due_on: string | null;
+            status: "active" | "achieved" | "missed" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        scorecard: (org: string) => Promise<{
+            org_id: string;
+            as_of: string;
+            attainment: number | null;
+            positions: import("./index.js").components["schemas"]["Auto.PositionScoreRow"][];
+        }>;
+        budgets: (org: string, filter?: {
+            unit_id?: string;
+            include_archived?: boolean;
+        }) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.OrgBudget"][];
+        }>;
+        createBudget: (org: string, body: In<"auto_createBudget">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            name: string;
+            description: string | null;
+            amount: import("./index.js").components["schemas"]["Auto.Money"];
+            period: "once" | "month" | "quarter" | "year";
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+            spent_in_period: number;
+            remaining: number;
+        }>;
+        policies: (org: string, includeArchived?: boolean) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Policy"][];
+        }>;
+        createPolicy: (org: string, body: In<"auto_createPolicy">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            rules: import("./index.js").components["schemas"]["Auto.PolicyRule"][];
+            status: "active" | "paused" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        cadences: (org: string, filter?: {
+            position_id?: string;
+            include_archived?: boolean;
+        }) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.Cadence"][];
+        }>;
+        createCadence: (org: string, body: In<"auto_createCadence">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            kind: "meeting" | "review" | "report" | "check_in" | "planning" | "retro";
+            owner_position_id: string;
+            participant_position_ids: string[];
+            schedule: import("./index.js").components["schemas"]["Auto.CadenceSchedule"];
+            agenda: string[];
+            goal_ids: string[];
+            description: string | null;
+            status: "active" | "paused" | "archived";
+            next_due_at: string;
+            last_held_at: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        /** Active cadences due within `withinHours` (default 24, at most 744), overdue first, with who runs each. */
+        dueCadences: (org: string, withinHours?: number) => Promise<{
+            org_id: string;
+            as_of: string;
+            within_hours: number;
+            data: (import("./index.js").components["schemas"]["Auto.Cadence"] & {
+                overdue: boolean;
+                owner: {
+                    position_id: string;
+                    title: string;
+                    occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+                    acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+                };
+            })[];
+        }>;
+        /** Vacancies, successors and single points of spend. */
+        continuity: (org: string) => Promise<{
+            org_id: string;
+            as_of: string;
+            positions: {
+                position_id: string;
+                title: string;
+                reports_to: string | null;
+                occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+                acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+                successors: {
+                    position_id: string;
+                    title: string | null;
+                    filled: boolean;
+                    active: boolean;
+                }[];
+                risks: ("vacant" | "no_successor" | "no_filled_successor" | "single_point_of_spend")[];
+                ok: boolean;
+            }[];
+            counts: {
+                positions: number;
+                ok: number;
+                vacant: number;
+                acting: number;
+                no_successor: number;
+            };
+        }>;
+        credentials: (org: string, positionId?: string) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.AuthorityCredential"][];
+        }>;
+    };
+    units: {
+        get: (unit: string) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            parent_id: string | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        update: (unit: string, version: number | string, body: In<"auto_updateUnit">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            parent_id: string | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (unit: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            parent_id: string | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+    };
+    /** Positions hold delegated authority; it only flows down the reporting line. */
+    positions: {
+        get: (position: string) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        } & {
+            chain: {
+                id: string;
+                title: string;
+                occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            }[];
+        }>;
+        update: (position: string, version: number | string, body: In<"auto_updatePosition">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (position: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        /** Fill the position or swap its occupant (a person, or a Henry, Fleets or Flocks agent that Auto only references). */
+        appoint: (position: string, version: number | string, body: In<"auto_appointOccupant">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        vacate: (position: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        terms: (position: string) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.PositionTerm"][];
+        }>;
+        scorecard: (position: string) => Promise<{
+            position_id: string;
+            title: string;
+            unit_id: string | null;
+            reports_to: string | null;
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            goals?: import("./index.js").components["schemas"]["Auto.ScoredGoal"][];
+            goal_count: number;
+            attainment: number | null;
+        } & {
+            reports: import("./index.js").components["schemas"]["Auto.PositionScoreRow"][];
+        }>;
+        /** Replace the ordered successor list (up to 5 positions; empty clears it). */
+        setSuccession: (position: string, version: number | string, body: In<"auto_setPositionSuccession">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        /** Someone (the occupant of `from_position_id`, or the first filled successor) acts for the position. */
+        startActing: (position: string, version: number | string, body: In<"auto_startActing">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        endActing: (position: string, version: number | string, reason?: string) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            title: string;
+            description: string | null;
+            reports_to: string | null;
+            authority: {
+                spend: import("./index.js").components["schemas"]["Auto.SpendGrant"] | null;
+                sign: {
+                    per_document: import("./index.js").components["schemas"]["Auto.Money"];
+                } | null;
+                hire: boolean;
+                external_mail: {
+                    recipient_domains: string[];
+                } | null;
+                actions: string[];
+            };
+            occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+            filled_at: string | null;
+            succession: string[];
+            acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        /** A signed AuthorityCredential (JWT) for the position's holder; the `token` is returned only here. */
+        issueCredential: (position: string, body?: In<"auto_issuePositionCredential">["body"]) => Promise<{
+            credential: import("./index.js").components["schemas"]["Auto.AuthorityCredential"];
+            token: string;
+        }>;
+    };
+    /** "May this principal, in this position, do this?" Ledgered, never metered; `auto:read` alone gets a dry run. */
+    authority: {
+        /** With an idempotency key, a repeat returns the first answer (`idempotent_replay: true`) instead of counting spend twice. */
+        check: (body: In<"auto_checkAuthority">["body"], options?: {
+            idempotencyKey?: string;
+        }) => Promise<{
+            check_id: string;
+            outcome: "allow" | "deny";
+            action: string;
+            principal: string;
+            org_id: string;
+            position: {
+                id: string;
+                title: string;
+            } | null;
+            acting: {
+                for_position_id: string;
+                from_position_id: string;
+            } | null;
+            reasons: import("./index.js").components["schemas"]["Auto.AuthorityDenyReason"][];
+            policy: import("./index.js").components["schemas"]["Auto.AuthorityDenyReason"][];
+            escalation: {
+                position_id: string;
+                title: string;
+                occupant: import("./index.js").components["schemas"]["Auto.Occupant"] | null;
+                acting: import("./index.js").components["schemas"]["Auto.Acting"] | null;
+                vacant: boolean;
+                allows: boolean;
+            }[];
+            escalate_to: {
+                kind: "position";
+                position_id: string;
+                title: string;
+                occupant: import("./index.js").components["schemas"]["Auto.Occupant"];
+            } | {
+                kind: "org_owner";
+                principal: string;
+            } | null;
+            dry_run: boolean;
+            metered: false;
+            ledger_entry: {
+                id: string;
+                seq: number;
+                hash: string;
+            };
+            receipt: string | null;
+            idempotent_replay?: boolean;
+        }>;
+        getCheck: (check: string) => Promise<{
+            check_id: string;
+            org_id: string;
+            outcome: "allow" | "deny";
+            action: string;
+            principal: string;
+            caller: string;
+            position_id: string | null;
+            amount: import("./index.js").components["schemas"]["Auto.Money"] | null;
+            recipients: string[];
+            reasons: import("./index.js").components["schemas"]["Auto.AuthorityDenyReason"][];
+            escalate_to: unknown;
+            acting: {
+                for_position_id: string;
+                from_position_id: string;
+            } | null;
+            dry_run: boolean;
+            committed: import("./index.js").components["schemas"]["Auto.Money"] | null;
+            created_at: string;
+            ledger_entry: import("./index.js").components["schemas"]["Auto.LedgerRef"];
+            released: {
+                at: string;
+                by: string;
+                reason: string;
+                ledger_entry: import("./index.js").components["schemas"]["Auto.LedgerRef"];
+            } | null;
+        }>;
+        /** Spend that was allowed but did not happen stops counting against limits and budgets. Once per check. */
+        release: (check: string, reason?: string) => Promise<{
+            check_id: string;
+            released: import("./index.js").components["schemas"]["Auto.Money"];
+            ledger_entry: import("./index.js").components["schemas"]["Auto.LedgerRef"];
+        }>;
+        /** Check a receipt or an AuthorityCredential: Auto's signature, expiry and revocation. */
+        verify: (token: string) => Promise<{
+            valid: boolean;
+            type?: "receipt" | "credential";
+            issuer?: string;
+            kid?: string;
+            status?: "active" | "revoked" | "expired" | null;
+            released?: boolean | null;
+            claims?: {
+                [key: string]: unknown;
+            };
+            reasons: ("signature" | "type" | "unknown" | "revoked" | "expired")[];
+        }>;
+    };
+    goals: {
+        get: (goal: string) => Promise<{
+            id: string;
+            org_id: string;
+            position_id: string;
+            mandate_id: string | null;
+            title: string;
+            description: string | null;
+            metrics: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            due_on: string | null;
+            status: "active" | "achieved" | "missed" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        update: (goal: string, version: number | string, body: In<"auto_updateGoal">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            position_id: string;
+            mandate_id: string | null;
+            title: string;
+            description: string | null;
+            metrics: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            due_on: string | null;
+            status: "active" | "achieved" | "missed" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (goal: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            position_id: string;
+            mandate_id: string | null;
+            title: string;
+            description: string | null;
+            metrics: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            due_on: string | null;
+            status: "active" | "achieved" | "missed" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        measure: (goal: string, body: In<"auto_recordGoalMeasurement">["body"]) => Promise<{
+            id: string;
+            goal_id: string;
+            key: string;
+            value: number;
+            note: string | null;
+            recorded_by: string;
+            measured_at: string;
+            attainment: number;
+        }>;
+    };
+    /** Spend caps for a unit (and every unit below it) or the whole org, enforced by the authority check. */
+    budgets: {
+        get: (budget: string) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            name: string;
+            description: string | null;
+            amount: import("./index.js").components["schemas"]["Auto.Money"];
+            period: "once" | "month" | "quarter" | "year";
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+            spent_in_period: number;
+            remaining: number;
+        }>;
+        update: (budget: string, version: number | string, body: In<"auto_updateBudget">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            name: string;
+            description: string | null;
+            amount: import("./index.js").components["schemas"]["Auto.Money"];
+            period: "once" | "month" | "quarter" | "year";
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+            spent_in_period: number;
+            remaining: number;
+        }>;
+        archive: (budget: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            unit_id: string | null;
+            name: string;
+            description: string | null;
+            amount: import("./index.js").components["schemas"]["Auto.Money"];
+            period: "once" | "month" | "quarter" | "year";
+            status: "active" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+            spent_in_period: number;
+            remaining: number;
+        }>;
+    };
+    /** Rules that tighten every authority check (deny, or escalate to a named position). */
+    policies: {
+        get: (policy: string) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            rules: import("./index.js").components["schemas"]["Auto.PolicyRule"][];
+            status: "active" | "paused" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        update: (policy: string, version: number | string, body: In<"auto_updatePolicy">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            rules: import("./index.js").components["schemas"]["Auto.PolicyRule"][];
+            status: "active" | "paused" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (policy: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            description: string | null;
+            rules: import("./index.js").components["schemas"]["Auto.PolicyRule"][];
+            status: "active" | "paused" | "archived";
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+    };
+    /** The meetings, reviews and reports the org keeps. Auto keeps the schedule and the record; it never holds the meeting. */
+    cadences: {
+        get: (cadence: string) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            kind: "meeting" | "review" | "report" | "check_in" | "planning" | "retro";
+            owner_position_id: string;
+            participant_position_ids: string[];
+            schedule: import("./index.js").components["schemas"]["Auto.CadenceSchedule"];
+            agenda: string[];
+            goal_ids: string[];
+            description: string | null;
+            status: "active" | "paused" | "archived";
+            next_due_at: string;
+            last_held_at: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        } & {
+            recent: import("./index.js").components["schemas"]["Auto.CadenceOccurrence"][];
+        }>;
+        update: (cadence: string, version: number | string, body: In<"auto_updateCadence">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            kind: "meeting" | "review" | "report" | "check_in" | "planning" | "retro";
+            owner_position_id: string;
+            participant_position_ids: string[];
+            schedule: import("./index.js").components["schemas"]["Auto.CadenceSchedule"];
+            agenda: string[];
+            goal_ids: string[];
+            description: string | null;
+            status: "active" | "paused" | "archived";
+            next_due_at: string;
+            last_held_at: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (cadence: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            name: string;
+            kind: "meeting" | "review" | "report" | "check_in" | "planning" | "retro";
+            owner_position_id: string;
+            participant_position_ids: string[];
+            schedule: import("./index.js").components["schemas"]["Auto.CadenceSchedule"];
+            agenda: string[];
+            goal_ids: string[];
+            description: string | null;
+            status: "active" | "paused" | "archived";
+            next_due_at: string;
+            last_held_at: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        occurrences: (cadence: string, limit?: number) => Promise<{
+            data: import("./index.js").components["schemas"]["Auto.CadenceOccurrence"][];
+        }>;
+        /** Record that the occurrence was held or skipped; the cadence moves to its next slot. */
+        record: (cadence: string, body: In<"auto_recordCadenceOccurrence">["body"]) => Promise<{
+            occurrence: import("./index.js").components["schemas"]["Auto.CadenceOccurrence"];
+            next_due_at: string;
+        }>;
+    };
+    credentials: {
+        get: (credential: string) => Promise<{
+            id: string;
+            org_id: string;
+            position_id: string;
+            principal: string;
+            subject: string;
+            acting: boolean;
+            issued_by: string;
+            issued_at: string;
+            expires_at: string;
+            revoked_at: string | null;
+            revoke_reason: string | null;
+            status: "active" | "revoked" | "expired";
+        } & {
+            claims: {
+                [key: string]: unknown;
+            };
+        }>;
+        /** Public (no credential sent): the status any verifier reads from a credential's `credentialStatus` URL. */
+        status: (credential: string) => Promise<{
+            id: string;
+            issuer: string | null;
+            status: "active" | "revoked" | "expired";
+            expires_at: string;
+            revoked_at: string | null;
+        }>;
+        revoke: (credential: string, reason?: string) => Promise<{
+            id: string;
+            org_id: string;
+            position_id: string;
+            principal: string;
+            subject: string;
+            acting: boolean;
+            issued_by: string;
+            issued_at: string;
+            expires_at: string;
+            revoked_at: string | null;
+            revoke_reason: string | null;
+            status: "active" | "revoked" | "expired";
+        }>;
+    };
+    /** Public (no credential sent): Auto's signing keys and DID document, to verify receipts and credentials offline. */
+    keys: {
+        jwks: () => Promise<{
+            keys: {
+                [key: string]: unknown;
+            }[];
+        }>;
+        did: () => Promise<{
+            [key: string]: unknown;
+        }>;
+    };
+    mandates: {
+        get: (mandate: string) => Promise<{
+            id: string;
+            org_id: string;
+            outcome: string;
+            budget: import("./index.js").components["schemas"]["Auto.Budget"];
+            decision_limits: import("./index.js").components["schemas"]["Auto.DecisionLimits"];
+            escalation: import("./index.js").components["schemas"]["Auto.Escalation"];
+            kpis: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            status: "draft" | "active" | "paused" | "completed" | "archived";
+            position_id: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        update: (mandate: string, version: number | string, body: In<"auto_updateMandate">["body"]) => Promise<{
+            id: string;
+            org_id: string;
+            outcome: string;
+            budget: import("./index.js").components["schemas"]["Auto.Budget"];
+            decision_limits: import("./index.js").components["schemas"]["Auto.DecisionLimits"];
+            escalation: import("./index.js").components["schemas"]["Auto.Escalation"];
+            kpis: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            status: "draft" | "active" | "paused" | "completed" | "archived";
+            position_id: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        archive: (mandate: string, version: number | string) => Promise<{
+            id: string;
+            org_id: string;
+            outcome: string;
+            budget: import("./index.js").components["schemas"]["Auto.Budget"];
+            decision_limits: import("./index.js").components["schemas"]["Auto.DecisionLimits"];
+            escalation: import("./index.js").components["schemas"]["Auto.Escalation"];
+            kpis: import("./index.js").components["schemas"]["Auto.Kpi"][];
+            status: "draft" | "active" | "paused" | "completed" | "archived";
+            position_id: string | null;
+            version: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        propose: (mandate: string, body: In<"auto_proposeAction">["body"]) => Promise<{
+            outcome: "approved";
+            decision: import("./index.js").components["schemas"]["Auto.LedgerEntry"];
+        }>;
+    };
+    approvals: {
+        get: (approval: string) => Promise<{
+            id: string;
+            org_id: string;
+            mandate_id: string;
+            summary: string;
+            reasoning: string;
+            inputs: {
+                [key: string]: unknown;
+            };
+            amount: import("./index.js").components["schemas"]["Auto.Money"];
+            reasons: import("./index.js").components["schemas"]["Auto.LimitReason"][];
+            approver: string;
+            status: "pending" | "approved" | "denied" | "expired";
+            requested_by: string;
+            decided_by: string | null;
+            note: string | null;
+            expires_at: string;
+            decided_at: string | null;
+            created_at: string;
+        }>;
+        decide: (approval: string, body: In<"auto_decideApproval">["body"]) => Promise<{
+            approval: import("./index.js").components["schemas"]["Auto.Approval"];
+            decision: import("./index.js").components["schemas"]["Auto.LedgerEntry"] | null;
+        }>;
+    };
+};