@osstack/protocol 0.15.0 → 0.22.0

package/dist/session-continuation.d.ts

@@ -0,0 +1,129 @@
+import { z } from "zod";
+export declare const SessionGateKind: z.ZodEnum<["phase_continue", "task_authorization", "risk_approval", "external_input"]>;
+export type SessionGateKind = z.infer<typeof SessionGateKind>;
+/** An agent-reported request, never a grant or proof that a gate passed. */
+export declare const SessionContinuationRequest: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    gate_kind: z.ZodEnum<["phase_continue", "task_authorization", "risk_approval", "external_input"]>;
+    phase: z.ZodString;
+    next_action: z.ZodString;
+    evidence_refs: z.ZodArray<z.ZodObject<{
+        evidence_id: z.ZodString;
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        evidence_id: string;
+        sha256: string;
+    }, {
+        evidence_id: string;
+        sha256: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    gate_kind: "phase_continue" | "task_authorization" | "risk_approval" | "external_input";
+    phase: string;
+    next_action: string;
+    evidence_refs: {
+        evidence_id: string;
+        sha256: string;
+    }[];
+}, {
+    version: 1;
+    gate_kind: "phase_continue" | "task_authorization" | "risk_approval" | "external_input";
+    phase: string;
+    next_action: string;
+    evidence_refs: {
+        evidence_id: string;
+        sha256: string;
+    }[];
+}>;
+export type SessionContinuationRequest = z.infer<typeof SessionContinuationRequest>;
+export declare const SessionDecision: z.ZodObject<{
+    decision_id: z.ZodString;
+    question: z.ZodString;
+    choices: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        choice_id: z.ZodString;
+        label: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        choice_id: string;
+        label: string;
+    }, {
+        choice_id: string;
+        label: string;
+    }>, "many">, {
+        choice_id: string;
+        label: string;
+    }[], {
+        choice_id: string;
+        label: string;
+    }[]>;
+    continuation: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        gate_kind: z.ZodEnum<["phase_continue", "task_authorization", "risk_approval", "external_input"]>;
+        phase: z.ZodString;
+        next_action: z.ZodString;
+        evidence_refs: z.ZodArray<z.ZodObject<{
+            evidence_id: z.ZodString;
+            sha256: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            evidence_id: string;
+            sha256: string;
+        }, {
+            evidence_id: string;
+            sha256: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        version: 1;
+        gate_kind: "phase_continue" | "task_authorization" | "risk_approval" | "external_input";
+        phase: string;
+        next_action: string;
+        evidence_refs: {
+            evidence_id: string;
+            sha256: string;
+        }[];
+    }, {
+        version: 1;
+        gate_kind: "phase_continue" | "task_authorization" | "risk_approval" | "external_input";
+        phase: string;
+        next_action: string;
+        evidence_refs: {
+            evidence_id: string;
+            sha256: string;
+        }[];
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    decision_id: string;
+    question: string;
+    choices: {
+        choice_id: string;
+        label: string;
+    }[];
+    continuation?: {
+        version: 1;
+        gate_kind: "phase_continue" | "task_authorization" | "risk_approval" | "external_input";
+        phase: string;
+        next_action: string;
+        evidence_refs: {
+            evidence_id: string;
+            sha256: string;
+        }[];
+    } | undefined;
+}, {
+    decision_id: string;
+    question: string;
+    choices: {
+        choice_id: string;
+        label: string;
+    }[];
+    continuation?: {
+        version: 1;
+        gate_kind: "phase_continue" | "task_authorization" | "risk_approval" | "external_input";
+        phase: string;
+        next_action: string;
+        evidence_refs: {
+            evidence_id: string;
+            sha256: string;
+        }[];
+    } | undefined;
+}>;
+export type SessionDecision = z.infer<typeof SessionDecision>;
+//# sourceMappingURL=session-continuation.d.ts.map

package/dist/session-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-continuation.d.ts","sourceRoot":"","sources":["../src/session-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe,wFAK1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYjB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/session-continuation.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+const Id = z.string().trim().min(1).max(256);
+export const SessionGateKind = z.enum([
+    "phase_continue",
+    "task_authorization",
+    "risk_approval",
+    "external_input",
+]);
+/** An agent-reported request, never a grant or proof that a gate passed. */
+export const SessionContinuationRequest = z.object({
+    version: z.literal(1),
+    gate_kind: SessionGateKind,
+    phase: Id,
+    next_action: z.string().trim().min(1).max(1_000),
+    evidence_refs: z.array(z.object({
+        evidence_id: Id,
+        sha256: z.string().regex(/^[a-f0-9]{64}$/),
+    }).strict()).max(32),
+}).strict();
+export const SessionDecision = z.object({
+    decision_id: Id,
+    question: z.string().trim().min(1).max(1_000),
+    // Empty choices remain valid for legacy adapters requesting free-form input.
+    choices: z.array(z.object({
+        choice_id: Id,
+        label: z.string().trim().min(1).max(160),
+    }).strict()).max(8).refine((choices) => new Set(choices.map((choice) => choice.choice_id)).size === choices.length, "choice IDs must be unique"),
+    continuation: SessionContinuationRequest.optional(),
+}).strict();
+//# sourceMappingURL=session-continuation.js.map

package/dist/session-continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-continuation.js","sourceRoot":"","sources":["../src/session-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,gBAAgB;IAChB,oBAAoB;IACpB,eAAe;IACf,gBAAgB;CACjB,CAAC,CAAC;AAGH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IAChD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9B,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;KAC3C,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACrB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IAC7C,6EAA6E;IAC7E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;KACzC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CACxB,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EACvF,2BAA2B,CAC5B;IACD,YAAY,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/task.d.ts

@@ -21,17 +21,17 @@ export declare const Task: z.ZodObject<{
     evaluation: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
 }, "strict", z.ZodTypeAny, {
     task_id: string;
+    source: "manual" | "git_diff" | "gh_issue" | "github_branch" | "ci_log" | "task_queue";
     capability: string;
     prompt: string;
-    source: "git_diff" | "gh_issue" | "github_branch" | "ci_log" | "task_queue" | "manual";
     priority: number;
     context?: Record<string, unknown> | undefined;
     evaluation?: unknown[] | undefined;
 }, {
     task_id: string;
+    source: "manual" | "git_diff" | "gh_issue" | "github_branch" | "ci_log" | "task_queue";
     capability: string;
     prompt: string;
-    source: "git_diff" | "gh_issue" | "github_branch" | "ci_log" | "task_queue" | "manual";
     priority?: number | undefined;
     context?: Record<string, unknown> | undefined;
     evaluation?: unknown[] | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osstack/protocol",
-  "version": "0.15.0",
+  "version": "0.22.0",
   "description": "Stable cross-product / cross-process / cross-agent kernel contracts for osstack (Task, Run, Event, Evidence, Approval, Policy, Agent command envelope) with JSON Schema artifacts and a versioned protocol.",
   "license": "MIT",
   "type": "module",
@@ -10,6 +10,14 @@
     "dist",
     "schemas"
   ],
+  "scripts": {
+    "build": "tsc -p .",
+    "prepack": "node ../../scripts/prepare-npm-package.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "generate:schemas": "node scripts/generate-schemas.mjs",
+    "check:schemas": "node scripts/generate-schemas.mjs --check"
+  },
   "dependencies": {
     "zod": "^3.25.76"
   },
@@ -22,17 +30,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/gilosbornhello/osstack.git",
+    "url": "https://github.com/osborn-studio/osstack.git",
     "directory": "packages/protocol"
   },
   "engines": {
     "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p .",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "generate:schemas": "node scripts/generate-schemas.mjs",
-    "check:schemas": "node scripts/generate-schemas.mjs --check"
   }
-}
+}

package/schemas/attention-inbox.schema.json

@@ -0,0 +1,271 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSStack Attention Inbox",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "scope_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "coverage": {
+      "type": "string",
+      "enum": [
+        "covered",
+        "degraded",
+        "uncovered",
+        "unknown"
+      ]
+    },
+    "execution_takeover": {
+      "type": "boolean",
+      "const": false
+    },
+    "counts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "state": {
+            "type": "string",
+            "maxLength": 80
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "state",
+          "total"
+        ],
+        "additionalProperties": false
+      },
+      "maxItems": 20
+    },
+    "next_after": {
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "item_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "scope_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "session_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "turn_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "decision_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "content_hash": {
+            "type": "string",
+            "minLength": 64,
+            "maxLength": 64
+          },
+          "decision": {
+            "type": "object",
+            "properties": {
+              "decision_id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "question": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 1000
+              },
+              "choices": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "choice_id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256
+                    },
+                    "label": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 160
+                    }
+                  },
+                  "required": [
+                    "choice_id",
+                    "label"
+                  ],
+                  "additionalProperties": false
+                },
+                "maxItems": 8
+              },
+              "continuation": {
+                "type": "object",
+                "properties": {
+                  "version": {
+                    "type": "number",
+                    "const": 1
+                  },
+                  "gate_kind": {
+                    "type": "string",
+                    "enum": [
+                      "phase_continue",
+                      "task_authorization",
+                      "risk_approval",
+                      "external_input"
+                    ]
+                  },
+                  "phase": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 256
+                  },
+                  "next_action": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 1000
+                  },
+                  "evidence_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "evidence_id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 256
+                        },
+                        "sha256": {
+                          "type": "string",
+                          "pattern": "^[a-f0-9]{64}$"
+                        }
+                      },
+                      "required": [
+                        "evidence_id",
+                        "sha256"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "maxItems": 32
+                  }
+                },
+                "required": [
+                  "version",
+                  "gate_kind",
+                  "phase",
+                  "next_action",
+                  "evidence_refs"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "decision_id",
+              "question",
+              "choices"
+            ],
+            "additionalProperties": false
+          },
+          "source_version": {
+            "type": "integer",
+            "exclusiveMinimum": 0
+          },
+          "revision": {
+            "type": "integer",
+            "exclusiveMinimum": 0
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "open",
+              "source_missing",
+              "source_closed",
+              "continued_externally",
+              "answer_reserved",
+              "answer_uncertain",
+              "answer_applied",
+              "answer_abandoned"
+            ]
+          },
+          "created_at": {
+            "type": "number"
+          },
+          "updated_at": {
+            "type": "number"
+          },
+          "external_message_id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 512
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "item_id",
+          "scope_id",
+          "session_id",
+          "turn_id",
+          "decision_id",
+          "content_hash",
+          "decision",
+          "source_version",
+          "revision",
+          "state",
+          "created_at",
+          "updated_at",
+          "external_message_id"
+        ],
+        "additionalProperties": false
+      },
+      "maxItems": 100
+    }
+  },
+  "required": [
+    "schema_version",
+    "scope_id",
+    "coverage",
+    "execution_takeover",
+    "counts",
+    "next_after",
+    "items"
+  ],
+  "additionalProperties": false
+}