@osstack/protocol 0.10.0

package/dist/approval.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export declare const Actor: z.ZodObject<{
+    readonly type: z.ZodEnum<["human", "agent"]>;
+    readonly id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "human" | "agent";
+    id: string;
+}, {
+    type: "human" | "agent";
+    id: string;
+}>;
+export type Actor = z.infer<typeof Actor>;
+/** Consumer-lenient Actor (A-007 deep leniency) — same shape, unknown fields ignored. */
+export declare const ActorLenient: z.ZodObject<{
+    readonly type: z.ZodEnum<["human", "agent"]>;
+    readonly id: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    readonly type: z.ZodEnum<["human", "agent"]>;
+    readonly id: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    readonly type: z.ZodEnum<["human", "agent"]>;
+    readonly id: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+/** Risk band of an action requiring approval. */
+export declare const Risk: z.ZodEnum<["low", "medium", "high"]>;
+export type Risk = z.infer<typeof Risk>;
+export declare const ApprovalRequest: z.ZodObject<{
+    readonly approval_id: z.ZodString;
+    readonly run_id: z.ZodOptional<z.ZodString>;
+    readonly action: z.ZodString;
+    readonly risk: z.ZodEnum<["low", "medium", "high"]>;
+    readonly requested_at: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    approval_id: string;
+    action: string;
+    risk: "low" | "medium" | "high";
+    requested_at: string;
+    run_id?: string | undefined;
+}, {
+    approval_id: string;
+    action: string;
+    risk: "low" | "medium" | "high";
+    requested_at: string;
+    run_id?: string | undefined;
+}>;
+export type ApprovalRequest = z.infer<typeof ApprovalRequest>;
+/** Consumer-lenient ApprovalRequest (A-007 deep leniency). */
+export declare const ApprovalRequestLenient: z.ZodObject<{
+    readonly approval_id: z.ZodString;
+    readonly run_id: z.ZodOptional<z.ZodString>;
+    readonly action: z.ZodString;
+    readonly risk: z.ZodEnum<["low", "medium", "high"]>;
+    readonly requested_at: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    readonly approval_id: z.ZodString;
+    readonly run_id: z.ZodOptional<z.ZodString>;
+    readonly action: z.ZodString;
+    readonly risk: z.ZodEnum<["low", "medium", "high"]>;
+    readonly requested_at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    readonly approval_id: z.ZodString;
+    readonly run_id: z.ZodOptional<z.ZodString>;
+    readonly action: z.ZodString;
+    readonly risk: z.ZodEnum<["low", "medium", "high"]>;
+    readonly requested_at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const ApprovalDecision: z.ZodObject<{
+    approval_id: z.ZodString;
+    approved: z.ZodBoolean;
+    decided_by: z.ZodObject<{
+        readonly type: z.ZodEnum<["human", "agent"]>;
+        readonly id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "human" | "agent";
+        id: string;
+    }, {
+        type: "human" | "agent";
+        id: string;
+    }>;
+    decided_at: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    approval_id: string;
+    approved: boolean;
+    decided_by: {
+        type: "human" | "agent";
+        id: string;
+    };
+    decided_at: string;
+    reason?: string | undefined;
+}, {
+    approval_id: string;
+    approved: boolean;
+    decided_by: {
+        type: "human" | "agent";
+        id: string;
+    };
+    decided_at: string;
+    reason?: string | undefined;
+}>;
+export type ApprovalDecision = z.infer<typeof ApprovalDecision>;
+//# sourceMappingURL=approval.d.ts.map

package/dist/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,KAAK;;;;;;;;;EAAgC,CAAC;AACnD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,yFAAyF;AACzF,eAAO,MAAM,YAAY;;;;;;;;;gCAAqC,CAAC;AAE/D,iDAAiD;AACjD,eAAO,MAAM,IAAI,sCAAoC,CAAC;AACtD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAUxC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAA0C,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;gCAA+C,CAAC;AAEnF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQlB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/approval.js

@@ -0,0 +1,52 @@
+// Approval shapes + the shared Actor identity.
+//
+// Extraction (architecture §1 / AGENT_COMMAND_PROTOCOL_V1 A-005): a minimal
+// subset of core's ApprovalRow.
+//   ApprovalRequest:  { approval_id, run_id?, action, risk, requested_at }
+//   ApprovalDecision: { approval_id, approved, decided_by, decided_at, reason? }
+//
+// Actor lives here (used by both ApprovalDecision.decided_by and the command
+// envelope's `actor`) so the dependency stays one-way (envelope -> approval),
+// avoiding a schema-init cycle.
+//
+// A-007 deep leniency: consumer-side parsers must ignore unknown fields at
+// EVERY level, not just the envelope top level — a v1.1 producer may add an
+// optional field inside a nested object (e.g. actor.display_name). Each nested
+// shape used by the lenient envelope parsers therefore also exports an explicit
+// `.passthrough()` variant; the producer schemas stay deep-strict.
+import { z } from "zod";
+/**
+ * A-005: `decided_by` is the FULL actor shape (type + id), never a bare id
+ * string, so the A-004 human-actor rule is structurally checkable — a decision
+ * whose `decided_by.type` is `agent` can be rejected at the policy layer unless
+ * the profile delegates that category (`allowed_auto_changes`).
+ */
+const actorShape = {
+    type: z.enum(["human", "agent"]),
+    id: z.string().min(1),
+};
+export const Actor = z.object(actorShape).strict();
+/** Consumer-lenient Actor (A-007 deep leniency) — same shape, unknown fields ignored. */
+export const ActorLenient = z.object(actorShape).passthrough();
+/** Risk band of an action requiring approval. */
+export const Risk = z.enum(["low", "medium", "high"]);
+const approvalRequestShape = {
+    approval_id: z.string().min(1),
+    run_id: z.string().min(1).optional(),
+    action: z.string().min(1),
+    risk: Risk,
+    requested_at: z.string().datetime(),
+};
+export const ApprovalRequest = z.object(approvalRequestShape).strict();
+/** Consumer-lenient ApprovalRequest (A-007 deep leniency). */
+export const ApprovalRequestLenient = z.object(approvalRequestShape).passthrough();
+export const ApprovalDecision = z
+    .object({
+    approval_id: z.string().min(1),
+    approved: z.boolean(),
+    decided_by: Actor,
+    decided_at: z.string().datetime(),
+    reason: z.string().optional(),
+})
+    .strict();
+//# sourceMappingURL=approval.js.map

package/dist/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,4EAA4E;AAC5E,gCAAgC;AAChC,2EAA2E;AAC3E,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,gFAAgF;AAChF,mEAAmE;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,UAAU,GAAG;IACjB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;AAGnD,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;AAE/D,iDAAiD;AACjD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAGtD,MAAM,oBAAoB,GAAG;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,IAAI;IACV,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGvE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAC;AAEnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC"}