@xemahq/kernel-contracts 0.21.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/dist/agent-session/index.d.ts +1 -0
  2. package/dist/agent-session/index.d.ts.map +1 -1
  3. package/dist/agent-session/index.js +1 -0
  4. package/dist/agent-session/index.js.map +1 -1
  5. package/dist/agent-session/lib/participant.d.ts +8 -0
  6. package/dist/agent-session/lib/participant.d.ts.map +1 -0
  7. package/dist/agent-session/lib/participant.js +12 -0
  8. package/dist/agent-session/lib/participant.js.map +1 -0
  9. package/dist/agent-workspace/awp-spec.json +1 -1
  10. package/dist/execution-context/lib/execution-context.d.ts +2 -0
  11. package/dist/execution-context/lib/execution-context.d.ts.map +1 -1
  12. package/dist/execution-context/lib/execution-context.js +2 -0
  13. package/dist/execution-context/lib/execution-context.js.map +1 -1
  14. package/package.json +1 -1
  15. package/src/agent-session/index.ts +1 -0
  16. package/src/agent-session/lib/participant.ts +31 -0
  17. package/src/execution-context/lib/execution-context.ts +15 -0
package/dist/agent-session/index.d.ts CHANGED
@@ -1,2 +1,3 @@
1
1
  export * from './lib/lifecycle';
2
+ export * from './lib/participant';
2
3
  //# sourceMappingURL=index.d.ts.map
package/dist/agent-session/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-session/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-session/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}
package/dist/agent-session/index.js CHANGED
@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./lib/lifecycle"), exports);
18
+ __exportStar(require("./lib/participant"), exports);
18
19
  //# sourceMappingURL=index.js.map
package/dist/agent-session/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-session/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-session/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,oDAAkC"}
package/dist/agent-session/lib/participant.d.ts ADDED
@@ -0,0 +1,8 @@
1
+ import { z } from 'zod';
2
+ export declare enum SessionParticipantRole {
3
+ Owner = "owner",
4
+ Editor = "editor",
5
+ Viewer = "viewer"
6
+ }
7
+ export declare const SessionParticipantRoleSchema: z.ZodEnum<typeof SessionParticipantRole>;
8
+ //# sourceMappingURL=participant.d.ts.map
package/dist/agent-session/lib/participant.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"participant.d.ts","sourceRoot":"","sources":["../../../src/agent-session/lib/participant.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oBAAY,sBAAsB;IAEhC,KAAK,UAAU;IAEf,MAAM,WAAW;IAEjB,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,4BAA4B,0CAAuC,CAAC"}
package/dist/agent-session/lib/participant.js ADDED
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SessionParticipantRoleSchema = exports.SessionParticipantRole = void 0;
4
+ const zod_1 = require("zod");
5
+ var SessionParticipantRole;
6
+ (function (SessionParticipantRole) {
7
+ SessionParticipantRole["Owner"] = "owner";
8
+ SessionParticipantRole["Editor"] = "editor";
9
+ SessionParticipantRole["Viewer"] = "viewer";
10
+ })(SessionParticipantRole || (exports.SessionParticipantRole = SessionParticipantRole = {}));
11
+ exports.SessionParticipantRoleSchema = zod_1.z.nativeEnum(SessionParticipantRole);
12
+ //# sourceMappingURL=participant.js.map
package/dist/agent-session/lib/participant.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"participant.js","sourceRoot":"","sources":["../../../src/agent-session/lib/participant.ts"],"names":[],"mappings":";;;AAeA,6BAAwB;AAMxB,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAEhC,yCAAe,CAAA;IAEf,2CAAiB,CAAA;IAEjB,2CAAiB,CAAA;AACnB,CAAC,EAPW,sBAAsB,sCAAtB,sBAAsB,QAOjC;AAEY,QAAA,4BAA4B,GAAG,OAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC"}
package/dist/agent-workspace/awp-spec.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://xema.dev/schemas/awp-spec.v1.json",
3
- "emittedAt": "2026-06-29T08:34:35.782Z",
3
+ "emittedAt": "2026-06-29T09:35:56.778Z",
4
4
  "spec": {
5
5
  "id": "awp/v1",
6
6
  "version": "1.2.0",
package/dist/execution-context/lib/execution-context.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { AgentReachTier } from '../../agent-composition';
3
+ import { SessionParticipantRole } from '../../agent-session';
3
4
  import { type CapabilityRef } from '../../capability';
4
5
  import { ExecutionEnvironmentKind } from '../../execution-environment';
5
6
  import { DataClassification, type SpaceRef } from '../../space';
@@ -57,6 +58,7 @@ export interface ExecutionContext {
57
58
  actorChain?: ActingForRef[];
58
59
  credentialBindingId?: string;
59
60
  reachTier?: AgentReachTier;
61
+ participantRole?: SessionParticipantRole;
60
62
  }
61
63
  export declare const ExecutionContextSchema: z.ZodType<ExecutionContext>;
62
64
  //# sourceMappingURL=execution-context.d.ts.map
package/dist/execution-context/lib/execution-context.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/execution-context/lib/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EAEzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAGlB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAWnB,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,oBAAoB,kCAA+B,CAAC;AAQjE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,2BAA2B,EAKlC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAavC,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,eAAO,MAAM,iCAAiC,EAGxC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAW7C,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,aAAa,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gCAAgC,EAGvC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAW5C,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,eAAO,MAAM,8BAA8B,EAGrC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAc1C,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,iCAAiC,EAMxC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAa7C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,2BAA2B,CAAC;IACzC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,0BAA0B,CAAC;IACvC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAO1C,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAO5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAQ7B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,eAAO,MAAM,sBAAsB,EAe7B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC"}
1
+ {"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/execution-context/lib/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EAEzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAGlB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAWnB,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,oBAAoB,kCAA+B,CAAC;AAQjE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,2BAA2B,EAKlC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAavC,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,eAAO,MAAM,iCAAiC,EAGxC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAW7C,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,aAAa,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gCAAgC,EAGvC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAW5C,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,eAAO,MAAM,8BAA8B,EAGrC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAc1C,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,iCAAiC,EAMxC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAa7C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,2BAA2B,CAAC;IACzC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,0BAA0B,CAAC;IACvC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAO1C,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAO5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAQ7B,SAAS,CAAC,EAAE,cAAc,CAAC;IAU3B,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED,eAAO,MAAM,sBAAsB,EAgB7B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC"}
package/dist/execution-context/lib/execution-context.js CHANGED
@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.ExecutionContextSchema = exports.ExecutionContextConstraintsSchema = exports.ExecutionContextResourceSchema = exports.ExecutionContextCapabilitySchema = exports.ExecutionContextEnvironmentSchema = exports.ExecutionContextBiomeSchema = exports.BiomeTrustTierSchema = exports.BiomeTrustTier = void 0;
4
4
  const zod_1 = require("zod");
5
5
  const agent_composition_1 = require("../../agent-composition");
6
+ const agent_session_1 = require("../../agent-session");
6
7
  const capability_1 = require("../../capability");
7
8
  const execution_environment_1 = require("../../execution-environment");
8
9
  const space_1 = require("../../space");
@@ -56,5 +57,6 @@ exports.ExecutionContextSchema = zod_1.z.object({
56
57
  actorChain: zod_1.z.array(subject_1.ActingForRefSchema).optional(),
57
58
  credentialBindingId: zod_1.z.string().min(1).optional(),
58
59
  reachTier: agent_composition_1.AgentReachTierSchema.optional(),
60
+ participantRole: agent_session_1.SessionParticipantRoleSchema.optional(),
59
61
  });
60
62
  //# sourceMappingURL=execution-context.js.map
package/dist/execution-context/lib/execution-context.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../../src/execution-context/lib/execution-context.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+DAGiC;AACjC,iDAG0B;AAC1B,uEAGqC;AACrC,uCAKqB;AACrB,qCAAqD;AACrD,uCAKmB;AAWnB,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,uCAAqB,CAAA;IACrB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;AACzB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB;AAEY,QAAA,oBAAoB,GAAG,OAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AAepD,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,4BAAoB;IAC/B,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE;CAC/B,CAAqC,CAAC;AAkB1B,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,sDAA8B;CACrC,CAA2C,CAAC;AAgBhC,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,GAAG,EAAE,gCAAmB;IACxB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAA0C,CAAC;AAgB/B,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,cAAc,EAAE,gCAAwB;CACzC,CAAwC,CAAC;AAsB7B,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/C,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC7D,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,mBAAmB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAA2C,CAAC;AAiDhC,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,0BAAgB;IACzB,MAAM,EAAE,qBAAY;IACpB,KAAK,EAAE,sBAAc;IACrB,WAAW,EAAE,yCAAiC;IAC9C,KAAK,EAAE,mCAA2B,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,wCAAgC;IAC5C,QAAQ,EAAE,sCAA8B,CAAC,QAAQ,EAAE;IACnD,WAAW,EAAE,yCAAiC,CAAC,QAAQ,EAAE;IACzD,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,4BAAkB,CAAC,CAAC,QAAQ,EAAE;IAClD,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjD,SAAS,EAAE,wCAAoB,CAAC,QAAQ,EAAE;CAC3C,CAAgC,CAAC"}
1
+ {"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../../src/execution-context/lib/execution-context.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xemahq/kernel-contracts",
3
- "version": "0.21.0",
3
+ "version": "0.22.0",
4
4
  "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the 32 kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
5
5
  "publishConfig": {
6
6
  "registry": "https://registry.npmjs.org/",
package/src/agent-session/index.ts CHANGED
@@ -1 +1,2 @@
1
1
  export * from './lib/lifecycle';
2
+ export * from './lib/participant';
package/src/agent-session/lib/participant.ts ADDED
@@ -0,0 +1,31 @@
1
+ // ═══════════════════════════════════════════════════════════════════════════
2
+ // ── Agent-session participant role — SINGLE SOURCE OF TRUTH ──
3
+ //
4
+ // The closed role a `SessionParticipant` holds within an agent session
5
+ // (Phase E multi-user sessions). This is the canonical Layer-0 contract that
6
+ // the persistence enum (agent-session-api Prisma `ParticipantRole`), the
7
+ // MCP bridge-token `participantRole` claim (`@xemahq/platform-common`), and
8
+ // the kernel `ExecutionContext.participantRole` PDP pass-through ALL derive
9
+ // from. Prisma cannot import a TS value, so its schema re-declares the same
10
+ // members; the values MUST stay member-identical.
11
+ //
12
+ // Precedence (`owner > editor > viewer`): `owner` is the session creator (one
13
+ // per session, full control), `editor` may post turns, `viewer` may only read.
14
+ // ═══════════════════════════════════════════════════════════════════════════
15
+
16
+ import { z } from 'zod';
17
+
18
+ /**
19
+ * Role of a session participant. Closed set — value-identical to the
20
+ * persisted `participant_role` Prisma enum in agent-session-api.
21
+ */
22
+ export enum SessionParticipantRole {
23
+ /** Session creator — one per session, full control. */
24
+ Owner = 'owner',
25
+ /** May post turns + mutate session state. */
26
+ Editor = 'editor',
27
+ /** Read-only access to the session transcript. */
28
+ Viewer = 'viewer',
29
+ }
30
+
31
+ export const SessionParticipantRoleSchema = z.nativeEnum(SessionParticipantRole);
package/src/execution-context/lib/execution-context.ts CHANGED
@@ -3,6 +3,10 @@ import {
3
3
  AgentReachTier,
4
4
  AgentReachTierSchema,
5
5
  } from '../../agent-composition';
6
+ import {
7
+ SessionParticipantRole,
8
+ SessionParticipantRoleSchema,
9
+ } from '../../agent-session';
6
10
  import {
7
11
  CapabilityRefSchema,
8
12
  type CapabilityRef,
@@ -195,6 +199,16 @@ export interface ExecutionContext {
195
199
  * amplify (see {@link AgentReachTier}).
196
200
  */
197
201
  reachTier?: AgentReachTier;
202
+ /**
203
+ * The session-participant role the acting subject holds in the originating
204
+ * agent session ({@link SessionParticipantRole}), stamped by the capability
205
+ * gateway from the verified MCP bridge-token claim (AUTH-B6.1). Carries the
206
+ * participant's role to the PDP so policy can attenuate the verdict by role
207
+ * (e.g. a `viewer` may discover but not invoke side-effecting capabilities).
208
+ * Absent for non-session invocations (workflow steps, service calls) ⇒ no
209
+ * role constraint, byte-identical to the pre-B6.1 verdict.
210
+ */
211
+ participantRole?: SessionParticipantRole;
198
212
  }
199
213
 
200
214
  export const ExecutionContextSchema = z.object({
@@ -212,4 +226,5 @@ export const ExecutionContextSchema = z.object({
212
226
  actorChain: z.array(ActingForRefSchema).optional(),
213
227
  credentialBindingId: z.string().min(1).optional(),
214
228
  reachTier: AgentReachTierSchema.optional(),
229
+ participantRole: SessionParticipantRoleSchema.optional(),
215
230
  }) as z.ZodType<ExecutionContext>;