@maiaos/protocol 0.1.0-canary.1

package/dist/approval/contract.d.ts

@@ -0,0 +1,176 @@
+import type { InferRuntimeSchema } from "../runtime-schema/index.js";
+/** Typed failures every approval client can branch on. */
+export declare const APPROVAL_ERROR_CODES: readonly ["approval_closed", "approval_expired", 
+/** A Session already has its limit of requests waiting for a person. */
+"approval_pending_limit", "approval_request_changed"];
+export type ApprovalErrorCode = (typeof APPROVAL_ERROR_CODES)[number];
+export declare const approvalSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly approvalId: string;
+    readonly createdAt: string;
+    readonly executor: "claude-code" | "codex-cli";
+    readonly expiresAt: string;
+    readonly forSessionOffered: boolean;
+    readonly kind: "command" | "file_change" | "question" | "tool";
+    readonly options?: readonly {
+        readonly label: string;
+        readonly optionId: string;
+    }[] | undefined;
+    readonly reason?: string | undefined;
+    readonly requestDigest: string;
+    readonly resolution?: {
+        readonly actorId: string;
+        readonly answer?: string | undefined;
+        readonly forSession?: true | undefined;
+        readonly reason?: string | undefined;
+        readonly resolvedAt: string;
+    } | undefined;
+    readonly revision: string;
+    readonly schemaVersion: "maia.approval/v1";
+    readonly sessionId: string;
+    readonly status: "answered" | "approved" | "cancelled" | "denied" | "expired" | "pending";
+    readonly summary: string;
+    readonly turnId: string;
+    readonly workspaceId: string;
+}>;
+export type Approval = InferRuntimeSchema<typeof approvalSchema>;
+export declare const approvalListParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly limit: number;
+    readonly pendingOnly?: boolean | undefined;
+    readonly sessionId?: string | undefined;
+}>;
+export type ApprovalListParameters = InferRuntimeSchema<typeof approvalListParametersSchema>;
+export declare const approvalShowParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly approvalId: string;
+}>;
+export type ApprovalShowParameters = InferRuntimeSchema<typeof approvalShowParametersSchema>;
+export declare const approvalRespondParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly answer?: string | undefined;
+    readonly approvalId: string;
+    readonly commandId: string;
+    readonly decision: "answer" | "approve" | "approve_for_session" | "deny";
+    readonly reason?: string | undefined;
+    readonly requestDigest: string;
+}>;
+export type ApprovalRespondParameters = InferRuntimeSchema<typeof approvalRespondParametersSchema>;
+export declare const approvalListResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly items: readonly {
+        readonly approvalId: string;
+        readonly createdAt: string;
+        readonly executor: "claude-code" | "codex-cli";
+        readonly expiresAt: string;
+        readonly forSessionOffered: boolean;
+        readonly kind: "command" | "file_change" | "question" | "tool";
+        readonly options?: readonly {
+            readonly label: string;
+            readonly optionId: string;
+        }[] | undefined;
+        readonly reason?: string | undefined;
+        readonly requestDigest: string;
+        readonly resolution?: {
+            readonly actorId: string;
+            readonly answer?: string | undefined;
+            readonly forSession?: true | undefined;
+            readonly reason?: string | undefined;
+            readonly resolvedAt: string;
+        } | undefined;
+        readonly revision: string;
+        readonly schemaVersion: "maia.approval/v1";
+        readonly sessionId: string;
+        readonly status: "answered" | "approved" | "cancelled" | "denied" | "expired" | "pending";
+        readonly summary: string;
+        readonly turnId: string;
+        readonly workspaceId: string;
+    }[];
+    readonly method: "approval.list";
+}>;
+export type ApprovalListResult = InferRuntimeSchema<typeof approvalListResultSchema>;
+export declare const approvalShowResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly approval: {
+        readonly approvalId: string;
+        readonly createdAt: string;
+        readonly executor: "claude-code" | "codex-cli";
+        readonly expiresAt: string;
+        readonly forSessionOffered: boolean;
+        readonly kind: "command" | "file_change" | "question" | "tool";
+        readonly options?: readonly {
+            readonly label: string;
+            readonly optionId: string;
+        }[] | undefined;
+        readonly reason?: string | undefined;
+        readonly requestDigest: string;
+        readonly resolution?: {
+            readonly actorId: string;
+            readonly answer?: string | undefined;
+            readonly forSession?: true | undefined;
+            readonly reason?: string | undefined;
+            readonly resolvedAt: string;
+        } | undefined;
+        readonly revision: string;
+        readonly schemaVersion: "maia.approval/v1";
+        readonly sessionId: string;
+        readonly status: "answered" | "approved" | "cancelled" | "denied" | "expired" | "pending";
+        readonly summary: string;
+        readonly turnId: string;
+        readonly workspaceId: string;
+    };
+    readonly method: "approval.show";
+}>;
+export type ApprovalShowResult = InferRuntimeSchema<typeof approvalShowResultSchema>;
+export declare const approvalRespondResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly approval: {
+        readonly approvalId: string;
+        readonly createdAt: string;
+        readonly executor: "claude-code" | "codex-cli";
+        readonly expiresAt: string;
+        readonly forSessionOffered: boolean;
+        readonly kind: "command" | "file_change" | "question" | "tool";
+        readonly options?: readonly {
+            readonly label: string;
+            readonly optionId: string;
+        }[] | undefined;
+        readonly reason?: string | undefined;
+        readonly requestDigest: string;
+        readonly resolution?: {
+            readonly actorId: string;
+            readonly answer?: string | undefined;
+            readonly forSession?: true | undefined;
+            readonly reason?: string | undefined;
+            readonly resolvedAt: string;
+        } | undefined;
+        readonly revision: string;
+        readonly schemaVersion: "maia.approval/v1";
+        readonly sessionId: string;
+        readonly status: "answered" | "approved" | "cancelled" | "denied" | "expired" | "pending";
+        readonly summary: string;
+        readonly turnId: string;
+        readonly workspaceId: string;
+    };
+    readonly commandId: string;
+    readonly delivery: "duplicate" | "new";
+    readonly method: "approval.respond";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+}>;
+export type ApprovalRespondResult = InferRuntimeSchema<typeof approvalRespondResultSchema>;
+export declare const APPROVAL_SCHEMA_VERSION: "maia.approval/v1";
+export declare const APPROVAL_AGGREGATE_TYPE: "approval";
+export declare const APPROVAL_TTL_MILLISECONDS: number;
+export declare const MAX_APPROVAL_PAGE_SIZE: number;
+export declare const MAX_APPROVAL_SUMMARY_BYTES: number;
+export declare const MAX_APPROVAL_REASON_BYTES: number;
+export declare const MAX_APPROVAL_ANSWER_BYTES: number;
+//# sourceMappingURL=contract.d.ts.map

package/dist/approval/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/approval/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAqBrE,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,YAC/B,iBAAiB,EACjB,kBAAkB;AAClB,wEAAwE;AACxE,wBAAwB,EACxB,0BAA0B,CAClB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgD,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,cAAc,CAAC,CAAC;AAEjE,eAAO,MAAM,4BAA4B;;;;EAExC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACrD,OAAO,4BAA4B,CACpC,CAAC;AACF,eAAO,MAAM,4BAA4B;;EAExC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACrD,OAAO,4BAA4B,CACpC,CAAC;AACF,eAAO,MAAM,+BAA+B;;;;;;;EAE3C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CACxD,OAAO,+BAA+B,CACvC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpC,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CACjD,OAAO,wBAAwB,CAChC,CAAC;AACF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpC,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CACjD,OAAO,wBAAwB,CAChC,CAAC;AACF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEvC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CACpD,OAAO,2BAA2B,CACnC,CAAC;AAGF,eAAO,MAAM,uBAAuB,EAAE,kBAAkC,CAAC;AACzE,eAAO,MAAM,uBAAuB,EAAE,UAA0B,CAAC;AACjE,eAAO,MAAM,yBAAyB,EAAE,MAAwB,CAAC;AACjE,eAAO,MAAM,sBAAsB,EAAE,MAAwB,CAAC;AAC9D,eAAO,MAAM,0BAA0B,EAAE,MAA4B,CAAC;AACtE,eAAO,MAAM,yBAAyB,EAAE,MAA2B,CAAC;AACpE,eAAO,MAAM,yBAAyB,EAAE,MAA2B,CAAC"}

package/dist/approval/contract.js

@@ -0,0 +1,27 @@
+import { makeEffectRuntimeSchema } from "../runtime-schema/effect-schema.js";
+import { APPROVAL_SCHEMA_VERSION as schemaVersion, APPROVAL_TTL_MILLISECONDS as ttlMilliseconds, approvalEffectSchema, approvalListParametersEffectSchema, approvalRespondParametersEffectSchema, approvalShowParametersEffectSchema, MAX_APPROVAL_ANSWER_BYTES as maximumAnswerBytes, MAX_APPROVAL_PAGE_SIZE as maximumPageSize, MAX_APPROVAL_REASON_BYTES as maximumReasonBytes, MAX_APPROVAL_SUMMARY_BYTES as maximumSummaryBytes, } from "./request-effect-schema.js";
+import { APPROVAL_AGGREGATE_TYPE as aggregateType, approvalListResultEffectSchema, approvalRespondResultEffectSchema, approvalShowResultEffectSchema, } from "./result-effect-schema.js";
+/** Typed failures every approval client can branch on. */
+export const APPROVAL_ERROR_CODES = [
+    "approval_closed",
+    "approval_expired",
+    /** A Session already has its limit of requests waiting for a person. */
+    "approval_pending_limit",
+    "approval_request_changed",
+];
+export const approvalSchema = makeEffectRuntimeSchema(approvalEffectSchema);
+export const approvalListParametersSchema = makeEffectRuntimeSchema(approvalListParametersEffectSchema);
+export const approvalShowParametersSchema = makeEffectRuntimeSchema(approvalShowParametersEffectSchema);
+export const approvalRespondParametersSchema = makeEffectRuntimeSchema(approvalRespondParametersEffectSchema);
+export const approvalListResultSchema = makeEffectRuntimeSchema(approvalListResultEffectSchema);
+export const approvalShowResultSchema = makeEffectRuntimeSchema(approvalShowResultEffectSchema);
+export const approvalRespondResultSchema = makeEffectRuntimeSchema(approvalRespondResultEffectSchema);
+// Keep public declarations independent of the private Effect schema module.
+export const APPROVAL_SCHEMA_VERSION = schemaVersion;
+export const APPROVAL_AGGREGATE_TYPE = aggregateType;
+export const APPROVAL_TTL_MILLISECONDS = ttlMilliseconds;
+export const MAX_APPROVAL_PAGE_SIZE = maximumPageSize;
+export const MAX_APPROVAL_SUMMARY_BYTES = maximumSummaryBytes;
+export const MAX_APPROVAL_REASON_BYTES = maximumReasonBytes;
+export const MAX_APPROVAL_ANSWER_BYTES = maximumAnswerBytes;
+//# sourceMappingURL=contract.js.map

package/dist/approval/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/approval/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,EACL,uBAAuB,IAAI,aAAa,EACxC,yBAAyB,IAAI,eAAe,EAC5C,oBAAoB,EACpB,kCAAkC,EAClC,qCAAqC,EACrC,kCAAkC,EAClC,yBAAyB,IAAI,kBAAkB,EAC/C,sBAAsB,IAAI,eAAe,EACzC,yBAAyB,IAAI,kBAAkB,EAC/C,0BAA0B,IAAI,mBAAmB,GAClD,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,IAAI,aAAa,EACxC,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB;IACjB,kBAAkB;IAClB,wEAAwE;IACxE,wBAAwB;IACxB,0BAA0B;CAClB,CAAC;AAGX,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;AAG5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,uBAAuB,CACjE,kCAAkC,CACnC,CAAC;AAIF,MAAM,CAAC,MAAM,4BAA4B,GAAG,uBAAuB,CACjE,kCAAkC,CACnC,CAAC;AAIF,MAAM,CAAC,MAAM,+BAA+B,GAAG,uBAAuB,CACpE,qCAAqC,CACtC,CAAC;AAKF,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAC7D,8BAA8B,CAC/B,CAAC;AAIF,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAC7D,8BAA8B,CAC/B,CAAC;AAIF,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAChE,iCAAiC,CAClC,CAAC;AAKF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAuB,aAAa,CAAC;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAe,aAAa,CAAC;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAW,eAAe,CAAC;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAW,eAAe,CAAC;AAC9D,MAAM,CAAC,MAAM,0BAA0B,GAAW,mBAAmB,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAW,kBAAkB,CAAC;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAW,kBAAkB,CAAC"}

package/dist/approval/effect-schema.d.ts

@@ -0,0 +1,3 @@
+export { approvalRequestEffectSchema } from "./request-effect-schema.js";
+export { approvalResultEffectSchema } from "./result-effect-schema.js";
+//# sourceMappingURL=effect-schema.d.ts.map

package/dist/approval/effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-schema.d.ts","sourceRoot":"","sources":["../../src/approval/effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/approval/effect-schema.js

@@ -0,0 +1,3 @@
+export { approvalRequestEffectSchema } from "./request-effect-schema.js";
+export { approvalResultEffectSchema } from "./result-effect-schema.js";
+//# sourceMappingURL=effect-schema.js.map

package/dist/approval/effect-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-schema.js","sourceRoot":"","sources":["../../src/approval/effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/approval/feature.d.ts

@@ -0,0 +1,88 @@
+import { type MaiaOperationsFeature } from "../feature/descriptor/index.js";
+/** What workers wait on a person for, and a person's decision. */
+export declare const APPROVAL_FEATURE_OPERATIONS: readonly [{
+    readonly method: "approval.list";
+    readonly nodeHandler: "approval";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "List what workers wait on a person for: command and patch approvals, tool calls outside their profile and questions, pending by default (pendingOnly false adds resolved ones), optionally for one Session. Only a person answers them, with maia session approval approve, deny or answer; tell the user what is waiting.";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "listApprovals";
+    };
+}, {
+    readonly method: "approval.show";
+    readonly nodeHandler: "approval";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Show one approval request: the exact command, patch summary, tool call or question, its Session, turn, expiry and how it was resolved.";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "showApproval";
+    };
+}, {
+    readonly method: "approval.respond";
+    readonly nodeHandler: "approval";
+    readonly policy: {
+        readonly confirmation: "trusted-client-required";
+        readonly effectClass: "native-idempotent";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "consequential";
+    };
+    readonly primitives: readonly ["confirmation", "receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: false;
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "respondToApproval";
+    };
+}];
+export declare const APPROVAL_FEATURE: MaiaOperationsFeature<"approval", typeof APPROVAL_FEATURE_OPERATIONS>;
+//# sourceMappingURL=feature.d.ts.map

package/dist/approval/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/approval/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AAExC,kEAAkE;AAClE,eAAO,MAAM,2BAA2B;qBAE5B,eAAe;0BACV,UAAU;;iBAErB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,MAAM;iBACnB,WAAW,EAAE,MAAM;iBACnB,UAAU;iBACV,OAAO,EAAE,MAAM;iBACf,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,MAAM;;;;iBAIZ,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,4TAA4T;qBAC9T,WAAW;qBACX,QAAQ;;iBAEV,OAAO,EAAE,8BAA8B;iBACvC,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,eAAe;;;qBAG/C,eAAe;0BACV,UAAU;;iBAErB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,MAAM;iBACnB,WAAW,EAAE,MAAM;iBACnB,UAAU;iBACV,OAAO,EAAE,MAAM;iBACf,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,MAAM;;;;iBAIZ,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,wIAAwI;qBAC1I,WAAW;qBACX,QAAQ;;iBAEV,OAAO,EAAE,8BAA8B;iBACvC,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,cAAc;;;qBAG9C,kBAAkB;0BACb,UAAU;;iBAErB,YAAY,EAAE,yBAAyB;iBACvC,WAAW,EAAE,mBAAmB;iBAChC,WAAW,EAAE,YAAY;iBACzB,UAAU;iBACV,OAAO,EAAE,UAAU;iBACnB,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,eAAe;;;;iBAIrB,GAAG;iBACH,WAAW;iBACX,OAAO,EAAE,8BAA8B;iBACvC,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,mBAAmB;;EAED,CAAC;AAE/D,eAAO,MAAM,gBAAgB,EAAE,qBAAqB,CAClD,UAAU,EACV,OAAO,2BAA2B,CAMlC,CAAC"}

package/dist/approval/feature.js

@@ -0,0 +1,88 @@
+import { defineMaiaFeature, } from "../feature/descriptor/index.js";
+/** What workers wait on a person for, and a person's decision. */
+export const APPROVAL_FEATURE_OPERATIONS = [
+    {
+        method: "approval.list",
+        nodeHandler: "approval",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "List what workers wait on a person for: command and patch approvals, tool calls outside their profile and questions, pending by default (pendingOnly false adds resolved ones), optionally for one Session. Only a person answers them, with maia session approval approve, deny or answer; tell the user what is waiting.",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "listApprovals" },
+    },
+    {
+        method: "approval.show",
+        nodeHandler: "approval",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "Show one approval request: the exact command, patch summary, tool call or question, its Session, turn, expiry and how it was resolved.",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "showApproval" },
+    },
+    {
+        method: "approval.respond",
+        nodeHandler: "approval",
+        policy: {
+            confirmation: "trusted-client-required",
+            effectClass: "native-idempotent",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "consequential",
+        },
+        primitives: ["confirmation", "receipt"],
+        projections: {
+            cli: true,
+            coordinator: false,
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "respondToApproval" },
+    },
+];
+export const APPROVAL_FEATURE = defineMaiaFeature({
+    contributions: { routines: [], rules: [], schedules: [], skills: [] },
+    id: "approval",
+    operations: APPROVAL_FEATURE_OPERATIONS,
+    schemaVersion: "maia.feature/approval/v1",
+});
+//# sourceMappingURL=feature.js.map

package/dist/approval/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../src/approval/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAGlB,MAAM,gCAAgC,CAAC;AAExC,kEAAkE;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC;QACE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE;YACN,YAAY,EAAE,MAAM;YACpB,WAAW,EAAE,MAAM;YACnB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,MAAM;YACf,gBAAgB,EAAE,KAAK;YACvB,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,MAAM;SACb;QACD,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE;YACX,GAAG,EAAE,IAAI;YACT,WAAW,EAAE;gBACX,WAAW,EACT,4TAA4T;gBAC9T,WAAW,EAAE,KAAK;gBAClB,QAAQ,EAAE,IAAI;aACf;YACD,OAAO,EAAE,8BAA8B;YACvC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;SACb;QACD,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE;KAC1D;IACD;QACE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE;YACN,YAAY,EAAE,MAAM;YACpB,WAAW,EAAE,MAAM;YACnB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,MAAM;YACf,gBAAgB,EAAE,KAAK;YACvB,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,MAAM;SACb;QACD,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE;YACX,GAAG,EAAE,IAAI;YACT,WAAW,EAAE;gBACX,WAAW,EACT,wIAAwI;gBAC1I,WAAW,EAAE,KAAK;gBAClB,QAAQ,EAAE,IAAI;aACf;YACD,OAAO,EAAE,8BAA8B;YACvC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;SACb;QACD,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE;KACzD;IACD;QACE,MAAM,EAAE,kBAAkB;QAC1B,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE;YACN,YAAY,EAAE,yBAAyB;YACvC,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,YAAY;YACzB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,UAAU;YACnB,gBAAgB,EAAE,KAAK;YACvB,aAAa,EAAE,IAAI;YACnB,IAAI,EAAE,eAAe;SACtB;QACD,UAAU,EAAE,CAAC,cAAc,EAAE,SAAS,CAAC;QACvC,WAAW,EAAE;YACX,GAAG,EAAE,IAAI;YACT,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,8BAA8B;YACvC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;SACb;QACD,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE;KAC9D;CAC2D,CAAC;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAGzB,iBAAiB,CAAC;IACpB,aAAa,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACrE,EAAE,EAAE,UAAU;IACd,UAAU,EAAE,2BAA2B;IACvC,aAAa,EAAE,0BAA0B;CAC1C,CAAC,CAAC"}

package/dist/approval/index.d.ts

@@ -0,0 +1,3 @@
+export { type Approval, APPROVAL_AGGREGATE_TYPE, APPROVAL_ERROR_CODES, APPROVAL_SCHEMA_VERSION, APPROVAL_TTL_MILLISECONDS, type ApprovalErrorCode, type ApprovalListParameters, approvalListParametersSchema, type ApprovalListResult, approvalListResultSchema, type ApprovalRespondParameters, approvalRespondParametersSchema, type ApprovalRespondResult, approvalRespondResultSchema, approvalSchema, type ApprovalShowParameters, approvalShowParametersSchema, type ApprovalShowResult, approvalShowResultSchema, MAX_APPROVAL_ANSWER_BYTES, MAX_APPROVAL_PAGE_SIZE, MAX_APPROVAL_REASON_BYTES, MAX_APPROVAL_SUMMARY_BYTES, } from "./contract.js";
+export { APPROVAL_FEATURE } from "./feature.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/approval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/approval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,cAAc,EACd,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/approval/index.js

@@ -0,0 +1,3 @@
+export { APPROVAL_AGGREGATE_TYPE, APPROVAL_ERROR_CODES, APPROVAL_SCHEMA_VERSION, APPROVAL_TTL_MILLISECONDS, approvalListParametersSchema, approvalListResultSchema, approvalRespondParametersSchema, approvalRespondResultSchema, approvalSchema, approvalShowParametersSchema, approvalShowResultSchema, MAX_APPROVAL_ANSWER_BYTES, MAX_APPROVAL_PAGE_SIZE, MAX_APPROVAL_REASON_BYTES, MAX_APPROVAL_SUMMARY_BYTES, } from "./contract.js";
+export { APPROVAL_FEATURE } from "./feature.js";
+//# sourceMappingURL=index.js.map

package/dist/approval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/approval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EAGzB,4BAA4B,EAE5B,wBAAwB,EAExB,+BAA+B,EAE/B,2BAA2B,EAC3B,cAAc,EAEd,4BAA4B,EAE5B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/approval/request-effect-schema.d.ts

@@ -0,0 +1,93 @@
+import * as Schema from "effect/Schema";
+export declare const APPROVAL_SCHEMA_VERSION = "maia.approval/v1";
+/** How long a worker waits for a person before the Node denies the request. */
+export declare const APPROVAL_TTL_MILLISECONDS: number;
+export declare const MAX_APPROVAL_PAGE_SIZE = 50;
+/** The exact command, patch summary, tool call or question a person reads. */
+export declare const MAX_APPROVAL_SUMMARY_BYTES = 8192;
+export declare const MAX_APPROVAL_REASON_BYTES = 1024;
+export declare const MAX_APPROVAL_ANSWER_BYTES = 4096;
+export declare const approvalDigestEffectSchema: Schema.String;
+export declare const approvalKindEffectSchema: Schema.Literals<readonly ["command", "file_change", "question", "tool"]>;
+export declare const approvalStatusEffectSchema: Schema.Literals<readonly ["approved", "answered", "cancelled", "denied", "expired", "pending"]>;
+export declare const approvalDecisionEffectSchema: Schema.Literals<readonly ["answer", "approve", "approve_for_session", "deny"]>;
+/**
+ * One request a running worker holds open for a person: a command or patch
+ * to approve, a tool call outside its profile, or a question. The digest
+ * binds a decision to the request a person read.
+ */
+export declare const approvalEffectSchema: Schema.Struct<{
+    readonly approvalId: Schema.String;
+    readonly createdAt: Schema.String;
+    readonly executor: Schema.Literals<readonly ["claude-code", "codex-cli"]>;
+    readonly expiresAt: Schema.String;
+    /** Whether the vendor can apply an approval to the rest of the Session. */
+    readonly forSessionOffered: Schema.Boolean;
+    readonly kind: Schema.Literals<readonly ["command", "file_change", "question", "tool"]>;
+    readonly options: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly label: Schema.String;
+        readonly optionId: Schema.String;
+    }>>>;
+    /** The worker's own explanation, when it gave one. */
+    readonly reason: Schema.optional<Schema.String>;
+    readonly requestDigest: Schema.String;
+    readonly resolution: Schema.optional<Schema.Struct<{
+        /** The person who decided, or `node` for an expiry or a stop. */
+        readonly actorId: Schema.String;
+        readonly answer: Schema.optional<Schema.String>;
+        readonly forSession: Schema.optional<Schema.Literal<true>>;
+        readonly reason: Schema.optional<Schema.String>;
+        readonly resolvedAt: Schema.String;
+    }>>;
+    readonly revision: Schema.String;
+    readonly schemaVersion: Schema.Literal<"maia.approval/v1">;
+    readonly sessionId: Schema.String;
+    readonly status: Schema.Literals<readonly ["approved", "answered", "cancelled", "denied", "expired", "pending"]>;
+    readonly summary: Schema.String;
+    readonly turnId: Schema.String;
+    readonly workspaceId: Schema.String;
+}>;
+export declare const approvalListParametersEffectSchema: Schema.Struct<{
+    readonly limit: Schema.Int;
+    /** `true` (the default) lists pending requests; `false` adds the latest resolved ones. */
+    readonly pendingOnly: Schema.optional<Schema.Boolean>;
+    readonly sessionId: Schema.optional<Schema.String>;
+}>;
+export declare const approvalShowParametersEffectSchema: Schema.Struct<{
+    readonly approvalId: Schema.String;
+}>;
+export declare const approvalRespondParametersEffectSchema: Schema.Struct<{
+    readonly answer: Schema.optional<Schema.String>;
+    readonly approvalId: Schema.String;
+    readonly commandId: Schema.String;
+    readonly decision: Schema.Literals<readonly ["answer", "approve", "approve_for_session", "deny"]>;
+    readonly reason: Schema.optional<Schema.String>;
+    /** The digest of the request the person read; the Node refuses any other. */
+    readonly requestDigest: Schema.String;
+}>;
+export declare const approvalRequestEffectSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly method: Schema.Literal<"approval.list">;
+    readonly parameters: Schema.Struct<{
+        readonly limit: Schema.Int;
+        /** `true` (the default) lists pending requests; `false` adds the latest resolved ones. */
+        readonly pendingOnly: Schema.optional<Schema.Boolean>;
+        readonly sessionId: Schema.optional<Schema.String>;
+    }>;
+}>, Schema.Struct<{
+    readonly method: Schema.Literal<"approval.respond">;
+    readonly parameters: Schema.Struct<{
+        readonly answer: Schema.optional<Schema.String>;
+        readonly approvalId: Schema.String;
+        readonly commandId: Schema.String;
+        readonly decision: Schema.Literals<readonly ["answer", "approve", "approve_for_session", "deny"]>;
+        readonly reason: Schema.optional<Schema.String>;
+        /** The digest of the request the person read; the Node refuses any other. */
+        readonly requestDigest: Schema.String;
+    }>;
+}>, Schema.Struct<{
+    readonly method: Schema.Literal<"approval.show">;
+    readonly parameters: Schema.Struct<{
+        readonly approvalId: Schema.String;
+    }>;
+}>]>;
+//# sourceMappingURL=request-effect-schema.d.ts.map

package/dist/approval/request-effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-effect-schema.d.ts","sourceRoot":"","sources":["../../src/approval/request-effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAQxC,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AACxD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAsC9C,eAAO,MAAM,0BAA0B,eAEtC,CAAC;AACF,eAAO,MAAM,wBAAwB,0EAKnC,CAAC;AACH,eAAO,MAAM,0BAA0B,iGAOrC,CAAC;AACH,eAAO,MAAM,4BAA4B,gFAKvC,CAAC;AA6CH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;IAK/B,2EAA2E;;;;;;;IAM3E,sDAAsD;;;;QAnDtD,iEAAiE;;;;;;;;;;;;;;EAsElE,CAAC;AAEF,eAAO,MAAM,kCAAkC;;IAI7C,0FAA0F;;;EAG1F,CAAC;AACH,eAAO,MAAM,kCAAkC;;EAE7C,CAAC;AACH,eAAO,MAAM,qCAAqC;;;;;;IAMhD,6EAA6E;;EAS9E,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;QAxBtC,0FAA0F;;;;;;;;;;;;QAa1F,6EAA6E;;;;;;;;IAwB7E,CAAC"}