@lssm/lib.contracts-spec 17.3.2

package/dist/node/migrations.js

@@ -0,0 +1,69 @@
+import{compareVersions as r}from"compare-versions";const a=(e,t)=>`${e}.v${t}`;export class MigrationRegistry{items=new Map;register(e){const t=a(e.meta.key,e.meta.version);if(this.items.has(t))throw Error(`Duplicate migration ${t}`);this.items.set(t,e);return this}list(){return[...this.items.values()].sort((e,t)=>{const i=e.meta.key.localeCompare(t.meta.key);return i!==0?i:r(e.meta.version,t.meta.version)})}get(e,t){if(t!=null)return this.items.get(a(e,t));let i;for(const n of this.items.values()){if(n.meta.key!==e)continue;if(!i||r(n.meta.version,i.meta.version)>0)i=n}return i}}export const tech_contracts_migrations_DocBlocks=[{id:"docs.tech.contracts.migrations",title:"MigrationSpec Overview",summary:"`MigrationSpec` provides a declarative plan for schema/data/validation steps so migrations can be generated, reviewed, and executed safely by tooling. Each spec captures ownership metadata, target dialect, generated artifact provenance, ordered up/down steps, and optional dependency information. Runtime tooling can consume the spec to run SQL/data scripts with pre/post checks and produce audit logs.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/migrations",tags:["tech","contracts","migrations"],body:`# MigrationSpec Overview
+
+## Purpose
+
+\`MigrationSpec\` provides a declarative plan for schema/data/validation steps so migrations can be generated, reviewed, and executed safely by tooling. Each spec captures ownership metadata, target dialect, generated artifact provenance, ordered up/down steps, and optional dependency information. Runtime tooling can consume the spec to run SQL/data scripts with pre/post checks and produce audit logs.
+
+## Location
+
+- Spec + registry: \`packages/libs/contracts/src/migrations.ts\`
+- Tests: \`packages/.../migrations.test.ts\`
+
+## Schema
+
+\`\`\`ts
+export interface MigrationSpec {
+  meta: MigrationMeta;   // ownership metadata + { name, version }
+  plan: {
+    up: MigrationStep[];   // required forward plan
+    down?: MigrationStep[];// optional rollback steps
+  };
+  dependencies?: string[]; // optional list of migration keys this depends on
+}
+\`\`\`
+
+- **MigrationStep**
+  - \`kind\`: \`'schema' | 'data' | 'validation'\`
+  - Shared fields: \`description?\`, \`timeoutMs?\`, \`retries?\`, \`preChecks?\`, \`postChecks?\`
+  - \`schema\`: \`sql\` string executed in transactional context
+  - \`data\`: arbitrary \`script\` (e.g., JS/TS snippet, path to file, instructions)
+  - \`validation\`: \`assertion\` expression verifying state (e.g., SQL returning boolean)
+- **MigrationCheck** (\`preChecks\`/\`postChecks\`)
+  - \`description\`: human context
+  - \`expression\`: expression or SQL snippet to evaluate before/after the step
+- **Dependencies**
+  - Array of migration keys (\`"boundedContext.namespace.timestamp_slug"\`) used to ensure the registry executes prerequisites first
+
+## Registry Usage
+
+\`\`\`ts
+import { MigrationRegistry } from '@lssm/lib.contracts-spec/migrations';
+import { AddUsersMigration } from './migrations/core.db.2025_01_add_users';
+
+const registry = new MigrationRegistry();
+registry.register(AddUsersMigration);
+
+const migration = registry.get('core.db.2025_01_add_users');
+const all = registry.list(); // sorted by name/version
+\`\`\`
+
+## Authoring Guidelines
+
+1. Name migrations with timestamped slugs (\`domain.db.YYYY_MM_description\`) for clarity.
+2. Capture ownership metadata (\`owners\`, \`tags\`, \`stability\`) so tooling can route approvals.
+3. Prefer small, reversible steps. Use \`plan.down\` when safe; otherwise document fallback.
+4. Use \`preChecks\`/\`postChecks\` for critical invariants (row counts, schema existence).
+5. Specify dependencies explicitly to avoid parallel execution hazards.
+6. For large data scripts, use \`script\` as a pointer (URL, file path) rather than embedding code directly.
+
+## Tooling Roadmap
+
+Upcoming CLI support (Phase 4 plan):
+
+- \`contractspec create --type migration\` (scaffolds spec skeleton)
+- \`contractspec build <migration>\` (generate executor harness)
+- \`contractspec migrate create/up/down/status\` orchestration commands
+
+The current implementation focuses on the spec/registry foundation so downstream tooling can be layered iteratively.
+
+`}];

package/dist/node/model-registry.js

@@ -0,0 +1 @@
+import{isSchemaModel as r}from"@lssm/lib.schema/SchemaModel";function i(e){if(r(e))return e.config.name;return"AnonymousSchema_"+Math.random().toString(36).substring(7)}export class ModelRegistry{items=new Map;constructor(e){if(e)e.forEach((t)=>this.register(t))}register(e){const t=i(e);if(this.items.has(t))throw Error(`Duplicate contract \`model\` ${t}`);this.items.set(t,e);return this}list(){return[...this.items.values()]}get(e){return this.items.get(e)}}

package/dist/node/navigation/index.js

@@ -0,0 +1 @@
+export{defineNavEdge,defineNavGraph,isNavEdgeSpec,isNavGraphSpec,validateNavGraph}from"./nav-graph.js";export{defineNavSurfaceItem,isNavSurfaceItemSpec}from"./nav-surface.js";export{NavRegistry}from"./registry.js";

package/dist/node/navigation/nav-graph.js

@@ -0,0 +1,69 @@
+import{isNavSurfaceItemSpec as d}from"./nav-surface.js";const l=["related","leads-to","escalates-to","parent-of"];export const defineNavGraph=(a)=>a,defineNavEdge=(a)=>a;function s(a){if(!a||typeof a!=="object")return!1;const e=a;return typeof e.web==="string"&&e.web.length>0}export function isNavEdgeSpec(a){if(!a||typeof a!=="object")return!1;const e=a;if(!s(e.from))return!1;if(!s(e.to))return!1;if(typeof e.kind!=="string")return!1;if(!l.includes(e.kind))return!1;if(e.weight!==void 0&&(typeof e.weight!=="number"||!Number.isFinite(e.weight)||e.weight<0))return!1;return!0}export function isNavGraphSpec(a){if(!a||typeof a!=="object")return!1;const e=a;if(!e.meta||typeof e.meta!=="object")return!1;if(typeof e.meta.key!=="string"||e.meta.key.length===0)return!1;if(typeof e.meta.version!=="string"||e.meta.version.length===0)return!1;if(!Array.isArray(e.nodes))return!1;if(!e.nodes.every(d))return!1;if(!Array.isArray(e.edges))return!1;if(!e.edges.every(isNavEdgeSpec))return!1;return!0}export function validateNavGraph(a){const e=[],o=new Set(a.nodes.map((r)=>r.route.web)),i=new Set;a.edges.forEach((r,p)=>{const t=`edges[${p}]`;if(r.from.web===r.to.web)e.push({level:"error",message:`Self-loop edge on ${r.from.web}`,path:t});if(!o.has(r.from.web))e.push({level:"error",message:`Edge.from references unknown node: ${r.from.web}`,path:`${t}.from`});if(!o.has(r.to.web))e.push({level:"error",message:`Edge.to references unknown node: ${r.to.web}`,path:`${t}.to`});const n=`${r.kind}:${r.from.web}->${r.to.web}`;if(i.has(n))e.push({level:"warning",message:`Duplicate edge ${n}`,path:t});i.add(n)});return{valid:!e.some((r)=>r.level==="error"),issues:e}}export const navGraphDocBlock={id:"nav-graph-spec",title:"NavGraphSpec",body:`Relationship graph over registered navigation surface items with hand-curated product knowledge edges.
+
+## Overview
+
+\`NavGraphSpec\` models the navigation surface as a directed graph where:
+- **Nodes** are \`NavSurfaceItemSpec\` entries (typically auto-derived from \`NavRegistry.list()\`)
+- **Edges** are hand-maintained product relationships describing how surfaces relate
+- **Optional Layout** hints how to render the graph in the Nav Map viewer
+
+## Edge Semantics
+
+Edges use semantic kinds to express relationship intent:
+
+| Kind | Meaning | Example |
+|------|---------|---------|
+| \`related\` | Surfaces are related but not ordered | inbox ↔ threads |
+| \`leads-to\` | Natural workflow progression | workflow → evidence |
+| \`escalates-to\` | Escalation path | support → escalation-queue |
+| \`parent-of\` | Hierarchical containment | analytics → analytics/usage |
+
+Each edge carries an optional \`weight\` (0..∞) indicating usage frequency or affinity.
+
+## Validation
+
+\`validateNavGraph\` ensures:
+- No self-loops
+- Both endpoints resolve to node routes
+- No duplicate (from, to, kind) triples
+
+## Integration with Design-System Graph Templates
+
+\`NavGraphSpec\` integrates with existing DS graph renderers:
+- \`ConversationGraphView\` — render conversation/discussion threads
+- \`WorkflowDagView\` — render workflow DAG
+- \`AgentTreeView\` — render agent hierarchy
+- \`EngineeringLoopView\` — render loop/feedback structures
+
+The Nav Map view at \`/companyos/nav-map\` renders the full \`NavGraphSpec\` to show power users the complete navigation topology.
+
+## Example
+
+\`\`\`typescript
+const navGraph = defineNavGraph({
+  meta: {
+    key: 'companyos-nav',
+    version: '1.0.0',
+    description: 'CompanyOS navigation graph',
+    goal: 'Enable power-user nav-map view and routing suggestions',
+    context: 'Global navigation topology for all personas',
+    owners: ['team-platform'],
+    tags: ['core', 'navigation'],
+  },
+  nodes: navRegistry.list(),
+  edges: [
+    defineNavEdge({
+      from: { web: '/companyos/workflow' },
+      to: { web: '/companyos/evidence' },
+      kind: 'leads-to',
+      weight: 2.5,
+    }),
+    defineNavEdge({
+      from: { web: '/companyos/inbox' },
+      to: { web: '/companyos/threads' },
+      kind: 'related',
+    }),
+  ],
+  layout: { type: 'force-directed', spacing: 200 },
+});
+\`\`\``,kind:"reference",route:"packages/libs/contracts-spec/src/navigation/nav-graph.ts",visibility:"public"};

package/dist/node/navigation/nav-surface.js

@@ -0,0 +1,70 @@
+export const defineNavSurfaceItem=(t)=>t;export function isNavSurfaceItemSpec(t){if(!t||typeof t!=="object")return!1;const e=t;if(!e.meta||typeof e.meta!=="object")return!1;if(typeof e.meta.key!=="string"||e.meta.key.length===0)return!1;if(typeof e.meta.version!=="string"||e.meta.version.length===0)return!1;if(!e.capability||typeof e.capability!=="object")return!1;if(typeof e.capability.key!=="string"||e.capability.key.length===0)return!1;if(!e.route||typeof e.route!=="object")return!1;if(typeof e.route.web!=="string"||e.route.web.length===0)return!1;if(e.route.api!==void 0&&typeof e.route.api!=="string")return!1;if(!Array.isArray(e.personaVisibility))return!1;if(e.personaVisibility.some((i)=>typeof i!=="string"))return!1;if(typeof e.groupKey!=="string"||e.groupKey.length===0)return!1;if(typeof e.iconKey!=="string"||e.iconKey.length===0)return!1;if(e.densityHint!==void 0&&e.densityHint!=="compact"&&e.densityHint!=="comfortable")return!1;if(e.tabBarIcon!==void 0&&typeof e.tabBarIcon!=="string")return!1;if(e.gestureHint!==void 0&&e.gestureHint!=="swipe-back"&&e.gestureHint!=="swipe-left"&&e.gestureHint!=="swipe-right"&&e.gestureHint!=="swipe-down"&&e.gestureHint!=="none")return!1;if(e.parentGroupKey!==void 0&&typeof e.parentGroupKey!=="string")return!1;return!0}export const navSurfaceDocBlock={id:"nav-surface-item-spec",title:"NavSurfaceItemSpec",body:`Single navigation entry contract that binds a capability to a web route with persona and grouping semantics. Includes optional mobile-extension fields for Expo Router native navigation (Phase D.0).
+
+## Overview
+
+\`NavSurfaceItemSpec\` mirrors the \`PresentationSpec.capability\` pattern and defines a hard binding between:
+- A registered **capability** that provides the navigation surface (validated against CapabilityRegistry)
+- A **route** (web path + optional API root)
+- **Persona visibility** (which personas can see this entry)
+- **Grouping** (sidebar/nav section)
+- **Icon** (logical key resolved at render time)
+
+## Key Semantics
+
+**Capability Binding**: Every nav item MUST reference a \`CapabilityRef\` so the host can validate at build time that every navigation surface is backed by a real capability registered with \`surface: 'navigation'\`.
+
+**Persona Visibility**: The \`personaVisibility\` array lists personas allowed to see the entry. An empty array means hidden from all personas.
+
+**Optional Policy**: The \`policy\` field adds an additional gate on top of persona visibility (e.g., require a feature flag or explicit permission).
+
+**Optional Density Hint**: The \`densityHint\` field suggests UI density ('compact' | 'comfortable') applied to the rendered entry.
+
+## Mobile Extension Fields (additive, Phase D.0)
+
+Three optional fields enable native Expo Router navigation without app-level hard-coding:
+
+**\`tabBarIcon?\`**: Logical icon key for native tab bar rendering, separate from the web sidebar \`iconKey\`. When absent the host may fall back to \`iconKey\` or a platform default. Only meaningful on tab-root items (\`parentGroupKey\` absent).
+
+**\`gestureHint?\`** (\`NativeGestureHint\`): Declares the primary gesture affordance for this screen. Use \`'none'\` to explicitly disable back/dismiss gestures (e.g. auditor audit-log where accidental swipe-dismiss would lose evidence context).
+
+**\`parentGroupKey?\`**: Expresses the tab-vs-stack hierarchy. Absent = item IS a tab-bar root. Present = item is a stack-child pushed onto the named tab's navigator and does NOT appear in the tab bar.
+
+Tab/stack hierarchy example:
+- \`cockpit\` → \`parentGroupKey: undefined\` → tab bar root
+- \`work-graph\` → \`parentGroupKey: 'cockpit'\` → stack child under cockpit tab
+- \`inbox\` → \`parentGroupKey: undefined\` → tab bar root
+- \`threads/[id]\` → \`parentGroupKey: 'inbox'\` → stack child under inbox tab
+
+Web shells ignore these fields (absent optional fields produce no effect).
+
+## Usage in NavRegistry
+
+The \`NavRegistry\` consumes \`NavSurfaceItemSpec\` entries and provides:
+- \`indexByPersona(persona)\`: Get all entries visible to a persona
+- \`indexByGroup(groupKey)\`: Get all entries in a nav group
+- \`resolveForRoleMorph(roleMorph, preferences)\`: Resolve visible entries for a role-morph projection (filtered by persona + hidden groups)
+
+## Example
+
+\`\`\`typescript
+const inboxNav = defineNavSurfaceItem({
+  meta: {
+    key: 'inbox',
+    version: '1.0.0',
+    description: 'Inbox navigation entry',
+    goal: 'Direct users to their messages and notifications',
+    context: 'Core workflow entry point for all personas',
+    owners: ['team-platform'],
+    tags: ['core', 'workflow'],
+  },
+  capability: { key: 'inbox.read' },
+  route: { web: '/companyos/inbox', api: '/api/companyos/inbox' },
+  personaVisibility: ['founder_approver', 'operations_manager', 'frontline_staff'],
+  groupKey: 'workflow',
+  iconKey: 'icon.inbox',
+  densityHint: 'comfortable',
+  // Mobile extension fields (optional — web shell ignores these)
+  tabBarIcon: 'tab.inbox',
+  gestureHint: 'swipe-back',
+});
+\`\`\``,kind:"reference",route:"packages/libs/contracts-spec/src/navigation/nav-surface.ts",visibility:"public"};

package/dist/node/navigation/registry.js

@@ -0,0 +1 @@
+const p=(e)=>`${e.meta.key}.v${e.meta.version}`;export class NavRegistry{items=new Map;personaIndexCache=null;groupIndexCache=null;capabilities;constructor(e={}){this.capabilities=e.capabilities}register(e){const i=p(e);if(this.items.has(i))throw Error(`Duplicate nav item ${i}`);if(this.capabilities){const r=this.capabilities.indexBySurface("navigation"),t=`navigation:${e.capability.key}`;if(!r.has(t))throw Error(`Nav item ${i} references capability ${e.capability.key} which is not registered with surface 'navigation'`)}this.items.set(i,e);this.personaIndexCache=null;this.groupIndexCache=null;return this}list(){return[...this.items.values()]}get(e,i){if(i!==void 0)return this.items.get(`${e}.v${i}`);let r;for(const t of this.items.values()){if(t.meta.key!==e)continue;if(!r||t.meta.version>r.meta.version)r=t}return r}indexByPersona(e){return this.buildPersonaIndex().get(e)??[]}indexByGroup(e){return this.buildGroupIndex().get(e)??[]}resolveForRoleMorph(e,i){const r=new Set(e.personas),t=new Set(i?.hiddenGroups??[]),s=new Set,n=[];for(const a of this.items.values()){if(s.has(a.meta.key))continue;if(t.has(a.groupKey))continue;if(!a.personaVisibility.some((o)=>r.has(o)))continue;s.add(a.meta.key);n.push(a)}return n}buildPersonaIndex(){if(this.personaIndexCache)return this.personaIndexCache;const e=new Map;for(const i of this.items.values())for(const r of i.personaVisibility){const t=e.get(r)??[];t.push(i);e.set(r,t)}this.personaIndexCache=e;return e}buildGroupIndex(){if(this.groupIndexCache)return this.groupIndexCache;const e=new Map;for(const i of this.items.values()){const r=e.get(i.groupKey)??[];r.push(i);e.set(i.groupKey,r)}this.groupIndexCache=e;return e}}export const navRegistryDocBlock={id:"nav-registry",title:"NavRegistry",body:"In-memory registry for navigation surface items with persona- and group-aware queries and capability binding validation.\n\n## Overview\n\n`NavRegistry` mirrors the `CapabilityRegistry` API and provides:\n- **Registration**: `register(spec)` with duplicate + capability validation\n- **Queries**: `get(key, version?)`, `list()`, `indexByPersona()`, `indexByGroup()`\n- **Role-aware resolution**: `resolveForRoleMorph(roleMorph, preferences)`\n\n## Registration Flow\n\n1. Create `NavSurfaceItemSpec` entries using `defineNavSurfaceItem()`\n2. Optionally pass a `CapabilityRegistry` to the `NavRegistry` constructor\n3. Call `register(spec)` for each entry\n   - Throws if `meta.key + version` is duplicate\n   - Throws if capability is not registered with `surface: 'navigation'` (when `CapabilityRegistry` is provided)\n4. Use queries to retrieve filtered nav items\n\n## resolveForRoleMorph Semantics\n\n`resolveForRoleMorph(roleMorph, preferences)` filters the registry to:\n1. **Persona intersection**: Keep entries where `personaVisibility` overlaps with `roleMorph.personas`\n2. **Group hiding**: Remove entries in `preferences.hiddenGroups`\n3. **De-duplication**: By `meta.key` (latest version wins)\n\nReturns a flat array of visible `NavSurfaceItemSpec` in insertion order.\n\n## CapabilityRegistry Binding Validation\n\nIf a `CapabilityRegistry` is provided at construction, `register()` validates that:\n- `spec.capability.key` is registered in capabilities with `surface: 'navigation'`\n- If not, throws: `\"Nav item {id} references capability {key} which is not registered with surface 'navigation'\"`\n\nThis ensures all nav items map to real capabilities at build time.\n\n## Index Caching\n\nBoth persona and group indexes are lazy-built and cached; they invalidate on `register()`.\n\n## Example Usage\n\n```typescript\nconst registry = new NavRegistry({ capabilities: capabilityRegistry });\n\nregistry.register(inboxNavSpec);\nregistry.register(workflowNavSpec);\nregistry.register(analyticsNavSpec);\n\n// Get entries visible to a persona\nconst founderNav = registry.indexByPersona('founder_approver');\n\n// Resolve for a role-morph with hidden groups\nconst visibleNav = registry.resolveForRoleMorph(\n  { personas: ['founder_approver', 'operations_manager'] },\n  { hiddenGroups: ['experimental'] }\n);\n\n// Build a NavGraphSpec from the registry\nconst graph = defineNavGraph({\n  meta: { /* ... */ },\n  nodes: registry.list(),\n  edges: [ /* hand-curated */ ],\n});\n```",kind:"how",route:"packages/libs/contracts-spec/src/navigation/registry.ts",visibility:"public"};

package/dist/node/notifications/contracts.js

@@ -0,0 +1 @@
+import{defineEnum as o,defineSchemaModel as e,ScalarTypeEnum as t}from"@lssm/lib.schema";import{defineCommand as n,defineQuery as a}from"../operations/index.js";const i=["platform.notifications"];export const NotificationStatusSchemaEnum=o("NotificationStatus",["PENDING","SENT","DELIVERED","READ","FAILED","CANCELLED"]),NotificationChannelSchemaEnum=o("NotificationChannel",["EMAIL","IN_APP","PUSH","WEBHOOK","SMS","TELEGRAM","WHATSAPP"]),NotificationFilterEnum=o("NotificationFilter",["unread","read","all"]),NotificationModel=e({name:"Notification",description:"A notification sent to a user",fields:{id:{type:t.String_unsecure(),isOptional:!1},userId:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},body:{type:t.String_unsecure(),isOptional:!1},type:{type:t.String_unsecure(),isOptional:!1},status:{type:NotificationStatusSchemaEnum,isOptional:!1},channels:{type:NotificationChannelSchemaEnum,isArray:!0,isOptional:!1},actionUrl:{type:t.URL(),isOptional:!0},readAt:{type:t.DateTime(),isOptional:!0},createdAt:{type:t.DateTime(),isOptional:!1}}}),NotificationPreferenceModel=e({name:"NotificationPreference",description:"User notification preferences",fields:{userId:{type:t.String_unsecure(),isOptional:!1},globalEnabled:{type:t.Boolean(),isOptional:!1},channelPreferences:{type:t.JSONObject(),isOptional:!1},typePreferences:{type:t.JSONObject(),isOptional:!1},quietHoursStart:{type:t.String_unsecure(),isOptional:!0},quietHoursEnd:{type:t.String_unsecure(),isOptional:!0},timezone:{type:t.String_unsecure(),isOptional:!1},digestEnabled:{type:t.Boolean(),isOptional:!1},digestFrequency:{type:t.String_unsecure(),isOptional:!0}}}),SendNotificationInputModel=e({name:"SendNotificationInput",description:"Input for sending a notification",fields:{userId:{type:t.String_unsecure(),isOptional:!1},templateId:{type:t.String_unsecure(),isOptional:!0},title:{type:t.String_unsecure(),isOptional:!0},body:{type:t.String_unsecure(),isOptional:!0},type:{type:t.String_unsecure(),isOptional:!1},channels:{type:NotificationChannelSchemaEnum,isArray:!0,isOptional:!0},actionUrl:{type:t.URL(),isOptional:!0},variables:{type:t.JSONObject(),isOptional:!0},metadata:{type:t.JSONObject(),isOptional:!0}}}),ListNotificationsInputModel=e({name:"ListNotificationsInput",description:"Input for listing notifications",fields:{status:{type:NotificationFilterEnum,isOptional:!0},type:{type:t.String_unsecure(),isOptional:!0},limit:{type:t.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:t.Int_unsecure(),isOptional:!0,defaultValue:0}}}),ListNotificationsOutputModel=e({name:"ListNotificationsOutput",description:"Output for listing notifications",fields:{notifications:{type:NotificationModel,isArray:!0,isOptional:!1},total:{type:t.Int_unsecure(),isOptional:!1},unreadCount:{type:t.Int_unsecure(),isOptional:!1}}}),MarkNotificationReadInputModel=e({name:"MarkNotificationReadInput",fields:{notificationId:{type:t.String_unsecure(),isOptional:!1}}}),MarkAllNotificationsReadOutputModel=e({name:"MarkAllNotificationsReadOutput",fields:{markedCount:{type:t.Int_unsecure(),isOptional:!1}}}),UpdatePreferencesInputModel=e({name:"UpdateNotificationPreferencesInput",description:"Input for updating notification preferences",fields:{globalEnabled:{type:t.Boolean(),isOptional:!0},channelPreferences:{type:t.JSONObject(),isOptional:!0},typePreferences:{type:t.JSONObject(),isOptional:!0},quietHoursStart:{type:t.String_unsecure(),isOptional:!0},quietHoursEnd:{type:t.String_unsecure(),isOptional:!0},timezone:{type:t.String_unsecure(),isOptional:!0},digestEnabled:{type:t.Boolean(),isOptional:!0},digestFrequency:{type:t.String_unsecure(),isOptional:!0}}}),DeleteNotificationInputModel=e({name:"DeleteNotificationInput",fields:{notificationId:{type:t.String_unsecure(),isOptional:!1}}}),DeleteNotificationOutputModel=e({name:"DeleteNotificationOutput",fields:{success:{type:t.Boolean(),isOptional:!1}}}),SendNotificationContract=n({meta:{key:"notifications.send",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","send"],description:"Send a notification to a user.",goal:"Deliver notifications across multiple channels.",context:"Called by services when events require user notification."},io:{input:SendNotificationInputModel,output:NotificationModel,errors:{USER_NOT_FOUND:{description:"Target user does not exist",http:404,gqlCode:"USER_NOT_FOUND",when:"User ID is invalid"},TEMPLATE_NOT_FOUND:{description:"Notification template does not exist",http:404,gqlCode:"TEMPLATE_NOT_FOUND",when:"Template ID is invalid"}}},policy:{auth:"user"},sideEffects:{emits:[{key:"notification.sent",version:"1.0.0",when:"Notification is sent",payload:NotificationModel}]}}),ListNotificationsContract=a({meta:{key:"notifications.list",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","list"],description:"List notifications for the current user.",goal:"Show user their notifications.",context:"Notification center UI."},io:{input:ListNotificationsInputModel,output:ListNotificationsOutputModel},policy:{auth:"user"}}),MarkNotificationReadContract=n({meta:{key:"notifications.markRead",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","read"],description:"Mark a notification as read.",goal:"Track which notifications user has seen.",context:"User clicks on a notification."},io:{input:MarkNotificationReadInputModel,output:NotificationModel},policy:{auth:"user"}}),MarkAllNotificationsReadContract=n({meta:{key:"notifications.markAllRead",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","read"],description:"Mark all notifications as read.",goal:"Clear notification badge.",context:'User clicks "mark all as read".'},io:{input:null,output:MarkAllNotificationsReadOutputModel},policy:{auth:"user"}}),GetNotificationPreferencesContract=a({meta:{key:"notifications.preferences.get",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","preferences","get"],description:"Get notification preferences for current user.",goal:"Show user their notification settings.",context:"Notification settings page."},io:{input:null,output:NotificationPreferenceModel},policy:{auth:"user"}}),UpdateNotificationPreferencesContract=n({meta:{key:"notifications.preferences.update",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","preferences","update"],description:"Update notification preferences.",goal:"Allow user to control notification delivery.",context:"Notification settings page."},io:{input:UpdatePreferencesInputModel,output:NotificationPreferenceModel},policy:{auth:"user"}}),DeleteNotificationContract=n({meta:{key:"notifications.delete",version:"1.0.0",stability:"stable",owners:[...i],tags:["notifications","delete"],description:"Delete a notification.",goal:"Allow user to remove unwanted notifications.",context:"User dismisses a notification."},io:{input:DeleteNotificationInputModel,output:DeleteNotificationOutputModel},policy:{auth:"user"}}),NotificationContracts=[SendNotificationContract,ListNotificationsContract,MarkNotificationReadContract,MarkAllNotificationsReadContract,GetNotificationPreferencesContract,UpdateNotificationPreferencesContract,DeleteNotificationContract],NotificationOperationRefs=NotificationContracts.map((s)=>({key:s.meta.key,version:s.meta.version}));

package/dist/node/notifications/index.js

@@ -0,0 +1 @@
+export*from"./contracts.js";export*from"./notifications.capability.js";export*from"./notifications.feature.js";

package/dist/node/notifications/notifications.capability.js

@@ -0,0 +1 @@
+import{defineCapability as t}from"../capabilities/index.js";import{StabilityEnum as o}from"../ownership.js";import{NotificationOperationRefs as a}from"./contracts.js";export const NotificationsCapability=t({meta:{key:"notifications",version:"1.0.0",title:"Notifications Capability",description:"Provides user notification contract operations.",domain:"platform",owners:["platform.notifications"],tags:["notifications"],kind:"api",stability:o.Stable},provides:a.map((i)=>({surface:"operation",key:i.key,version:i.version})),requires:[{key:"identity",version:"1.0.0"}]});

package/dist/node/notifications/notifications.feature.js

@@ -0,0 +1 @@
+import{defineFeature as i}from"../features/index.js";import{NotificationOperationRefs as t}from"./contracts.js";export const NotificationsFeature=i({meta:{key:"libs.notifications",version:"1.0.0",title:"Notifications",description:"Notification contract operations for user notification flows.",domain:"platform",owners:["platform.notifications"],tags:["notifications"],stability:"stable"},operations:[...t],events:[],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:"notifications",version:"1.0.0"}],requires:[{key:"identity",version:"1.0.0"}]}});

package/dist/node/observability/database-signals.js

@@ -0,0 +1 @@
+import{defineSignal as a}from"./signal-spec.js";const e=["tenant.ref","database.table","database.operation","database.dialect"];export const DATABASE_SIGNAL_DURATION_UNIT="ms",DatabaseQuerySignal=a({id:"database.query",kind:"metric",unit:DATABASE_SIGNAL_DURATION_UNIT,dimensions:[...e],description:"Governed database read duration (ms)."}),DatabaseMutationSignal=a({id:"database.mutation",kind:"metric",unit:DATABASE_SIGNAL_DURATION_UNIT,dimensions:[...e],description:"Governed database write duration (ms)."}),DATABASE_SIGNALS=[DatabaseQuerySignal,DatabaseMutationSignal],DatabaseSignalsDocBlock={id:"docs.tech.observability.database-signals",title:"Database observability signals",summary:"Canonical database.query / database.mutation duration signals (ms).",kind:"reference",visibility:"public",route:"/docs/tech/observability/database-signals",tags:["observability","signals","database","latency"],body:"# Database signals\n\nCanonical observability signals for governed database access.\n\n- `database.query` — governed read duration metric (`ms`).\n- `database.mutation` — governed write duration metric (`ms`).\n\nBoth ids are stable, locale-free machine strings and reference canonical\ndimension ids only (`tenant.ref`, `database.table`, `database.operation`,\n`database.dialect`). Construct/validate via `defineSignal`.\n"};

package/dist/node/observability/evidence-record.js

@@ -0,0 +1 @@
+import{FieldType as s,ScalarTypeEnum as t,SchemaModel as i}from"@lssm/lib.schema";import*as o from"zod";const a=new s({name:"NumericQuantities",zod:o.record(o.string(),o.number()),parseValue:(e)=>o.record(o.string(),o.number()).parse(e),serialize:(e)=>e??{},jsonSchema:{type:"object",additionalProperties:{type:"number"}}});export const SignalCostBreakdownModel=new i({name:"SignalCostBreakdown",description:"Per-category cost line mirroring the cost-tracking breakdown.",fields:{category:{type:t.NonEmptyString(),isOptional:!1},amount:{type:t.Float_unsecure(),isOptional:!1}}}),SignalCostEvidenceModel=new i({name:"SignalCostEvidence",description:"Canonical cost envelope attached to a cost/usage evidence record.",fields:{total:{type:t.Float_unsecure(),isOptional:!1},currency:{type:t.NonEmptyString(),isOptional:!1},costModelVersion:{type:t.NonEmptyString(),isOptional:!1},breakdown:{type:SignalCostBreakdownModel,isOptional:!0,isArray:!0},sampleCount:{type:t.Int_unsecure(),isOptional:!0}}}),EvidenceRecordModel=new i({name:"EvidenceRecord",description:"The persisted envelope for one observed signal.",fields:{tenantId:{type:t.NonEmptyString(),isOptional:!1},signalId:{type:t.NonEmptyString(),isOptional:!1},value:{type:t.Float_unsecure(),isOptional:!0},quantities:{type:a,isOptional:!0},costEvidence:{type:SignalCostEvidenceModel,isOptional:!0},traceId:{type:t.String_unsecure(),isOptional:!0},idempotencyKey:{type:t.NonEmptyString(),isOptional:!1},occurredAt:{type:t.NonEmptyString(),isOptional:!1},redactionRef:{type:t.String_unsecure(),isOptional:!0}}});const d=EvidenceRecordModel.getZod().superRefine((e,n)=>{if(Number.isNaN(Date.parse(e.occurredAt)))n.addIssue({code:"custom",path:["occurredAt"],message:`EvidenceRecord.occurredAt must be a valid ISO instant: ${e.occurredAt}`});if(e.value===void 0&&e.quantities===void 0)n.addIssue({code:"custom",path:["value"],message:"EvidenceRecord must carry a value or quantities payload"})}),c=(e)=>{const n=e.path[0];if(e.code==="custom")return e.message;switch(n){case"tenantId":return"EvidenceRecord.tenantId must be a non-empty raw string";case"signalId":return"EvidenceRecord.signalId must be a non-empty string";case"idempotencyKey":return"EvidenceRecord.idempotencyKey must be a non-empty string";case"occurredAt":return"EvidenceRecord.occurredAt must be an ISO-8601 string";default:return e.message}};export const validateEvidenceRecord=(e)=>{const n=d.safeParse(e);if(!n.success){const[r]=n.error.issues;throw Error(r?c(r):"EvidenceRecord failed validation")}return n.data},EvidenceRecordDocBlock={id:"docs.tech.observability.evidence-record",title:"EvidenceRecord — persisted signal evidence envelope",summary:"Type-only persisted envelope for observed signals; tenantId is the raw RLS key.",kind:"reference",visibility:"public",route:"/docs/tech/observability/evidence-record",tags:["observability","evidence","cost","usage","tenancy"],body:"# EvidenceRecord\n\nThe persisted envelope for a single observed signal — the shared spine consumed\nby observability and billing.\n\n- Declared as the `EvidenceRecordModel` `SchemaModel`; `EvidenceRecord` is its\n  Zod-inferred TS shape.\n- `tenantId` is stored **raw**, never hashed: it is the row-level-security key.\n- `idempotencyKey` and `occurredAt` are required (at-least-once dedupe + time).\n- `value` or `quantities` carries the payload; `cost`/`usage` signals attach\n  `SignalCostEvidence`.\n- `redactionRef` points at the redaction policy applied to payload values.\n\nThis module is type-only + a validator. Persistence/DB wiring lives in the app\nadapter, not here.\n"};

package/dist/node/observability/index.js

@@ -0,0 +1 @@
+export{DATABASE_SIGNAL_DURATION_UNIT,DATABASE_SIGNALS,DatabaseMutationSignal,DatabaseQuerySignal,DatabaseSignalsDocBlock}from"./database-signals.js";export{EvidenceRecordDocBlock,EvidenceRecordModel,SignalCostBreakdownModel,SignalCostEvidenceModel,validateEvidenceRecord}from"./evidence-record.js";export{defineSignal,SignalKindEnum,SignalSpecDocBlock,SignalSpecModel}from"./signal-spec.js";

package/dist/node/observability/signal-spec.js

@@ -0,0 +1 @@
+import{EnumType as t,ScalarTypeEnum as n,SchemaModel as o}from"@lssm/lib.schema";export const SignalKindEnum=new t("SignalKind",["metric","trace","cost","usage"]),SignalSpecModel=new o({name:"SignalSpec",description:"Canonical, locale-free declaration of a single observable signal.",fields:{id:{type:n.NonEmptyString(),isOptional:!1},kind:{type:SignalKindEnum,isOptional:!1},unit:{type:n.NonEmptyString(),isOptional:!1},dimensions:{type:n.NonEmptyString(),isOptional:!1,isArray:!0},description:{type:n.String_unsecure(),isOptional:!0},costModelVersion:{type:n.String_unsecure(),isOptional:!0},redactionPolicyRef:{type:n.String_unsecure(),isOptional:!0}}});const c=/^[a-z0-9]+(?:[._][a-z0-9]+)*$/,l=/[._-][a-z]{2}([_-][a-z]{2})?$/,s=(e)=>c.test(e)&&!l.test(e),r=SignalSpecModel.getZod().superRefine((e,i)=>{if(!s(e.id))i.addIssue({code:"custom",path:["id"],message:`SignalSpec.id must be a canonical, locale-free id: ${e.id}`});for(const a of e.dimensions)if(!s(a))i.addIssue({code:"custom",path:["dimensions"],message:`SignalSpec.dimensions must be canonical, locale-free ids: ${a}`})}),d=(e)=>{const i=e.path[0];if(e.code==="custom")return e.message;switch(i){case"id":return"SignalSpec.id must be a non-empty string";case"kind":return"SignalSpec.kind is invalid";case"unit":return"SignalSpec.unit must be a non-empty string";default:return e.message}};export const defineSignal=(e)=>{const i=r.safeParse(e);if(!i.success){const[a]=i.error.issues;throw Error(a?d(a):"SignalSpec failed validation")}return i.data},SignalSpecDocBlock={id:"docs.tech.observability.signal-spec",title:"SignalSpec — observability/cost/usage signal declarations",summary:"Canonical, locale-free declaration layer for metric/trace/cost/usage signals.",kind:"reference",visibility:"public",route:"/docs/tech/observability/signal-spec",tags:["observability","signals","cost","usage","i18n"],body:"# SignalSpec\n\nThe typed declaration layer for all observability/cost/usage signals. One spine,\ntwo consumers: observability (metric/trace) and billing (cost/usage).\n\n- Declared as the `SignalSpecModel` `SchemaModel`; `SignalSpec` is its\n  Zod-inferred TS shape.\n- `id` and `dimensions` are stable machine strings — never localized, never\n  locale-suffixed (enforced by `i18n/no-localized-machine-contracts` and by\n  `defineSignal` validation).\n- `dimensions` reuse canonical semantic dimension ids from the analytics layer.\n- `costModelVersion` and `redactionPolicyRef` are optional refs consumed by the\n  billing/evidence pipeline.\n\nUse `defineSignal(spec)` to construct a validated `SignalSpec`.\n"};

package/dist/node/onboarding-base.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t}from"@lssm/lib.schema/ScalarTypeEnum";import{SchemaModel as e}from"@lssm/lib.schema/SchemaModel";import{defineCommand as n,defineQuery as r}from"./operations/index.js";import{OwnersEnum as o,StabilityEnum as a}from"./ownership.js";export const SaveOnboardingDraftInput=new e({name:"SaveOnboardingDraftInput",description:"Input for saving onboarding draft",fields:{data:{type:t.JSON(),isOptional:!1}}}),SaveOnboardingDraftOutput=new e({name:"SaveOnboardingDraftOutput",description:"Output for saving onboarding draft",fields:{id:{type:t.ID(),isOptional:!1},organizationId:{type:t.ID(),isOptional:!1}}}),SaveOnboardingDraftBaseSpec=n({meta:{key:"base.onboarding.saveDraft",version:"1.0.0",stability:a.Beta,owners:[o.PlatformSigil],tags:["onboarding","draft"],description:"Save or update onboarding draft for active organization",goal:"Persist onboarding progress incrementally for resumption and safety",context:"Auto-saves every few seconds during onboarding; enables users to leave and resume"},io:{input:SaveOnboardingDraftInput,output:SaveOnboardingDraftOutput},policy:{auth:"user",escalate:null},transport:{gql:{field:"saveOnboardingDraft"},rest:{method:"POST"}}}),GetOnboardingDraftOutput=new e({name:"GetOnboardingDraftOutput",description:"Onboarding draft payload",fields:{id:{type:t.ID(),isOptional:!0},organizationId:{type:t.ID(),isOptional:!0},data:{type:t.JSON(),isOptional:!0},createdAt:{type:t.DateTime(),isOptional:!0},updatedAt:{type:t.DateTime(),isOptional:!0}}}),GetOnboardingDraftBaseSpec=r({meta:{key:"base.onboarding.getDraft",version:"1.0.0",stability:a.Beta,owners:[o.PlatformSigil],tags:["onboarding","draft"],description:"Get onboarding draft for active organization",goal:"Retrieve saved onboarding progress",context:"Called on mount to restore in-progress onboarding"},io:{input:null,output:GetOnboardingDraftOutput},policy:{auth:"user",escalate:null},transport:{gql:{field:"getOnboardingDraft"},rest:{method:"GET"}}}),DeleteOnboardingDraftOutput=new e({name:"DeleteOnboardingDraftOutput",description:"Result of delete operation",fields:{ok:{type:t.Boolean(),isOptional:!1}}}),DeleteOnboardingDraftBaseSpec=n({meta:{key:"base.onboarding.deleteDraft",version:"1.0.0",stability:a.Beta,owners:[o.PlatformSigil],tags:["onboarding","draft"],description:"Delete onboarding draft for active organization",goal:"Clear draft after completion or if user wants to restart",context:"Called after successful onboarding or explicit user reset"},io:{input:null,output:DeleteOnboardingDraftOutput},policy:{auth:"user",escalate:null},transport:{gql:{field:"deleteOnboardingDraft"},rest:{method:"POST"}}}),CompleteOnboardingBaseInput=new e({name:"CompleteOnboardingBaseInput",description:"Input for completing onboarding",fields:{data:{type:t.JSON(),isOptional:!1}}}),CompleteOnboardingBaseOutput=new e({name:"CompleteOnboardingBaseOutput",description:"Result of onboarding completion",fields:{success:{type:t.Boolean(),isOptional:!1},userId:{type:t.ID(),isOptional:!0},organizationId:{type:t.ID(),isOptional:!0}}}),CompleteOnboardingBaseSpec=n({meta:{key:"base.onboarding.complete",version:"1.0.0",stability:a.Beta,owners:[o.PlatformSigil],tags:["onboarding"],description:"Complete onboarding and finalize user/organization setup",goal:"Transition from draft to active profile",context:"Validates all required fields, creates/updates entities, marks onboarding complete"},io:{input:CompleteOnboardingBaseInput,output:CompleteOnboardingBaseOutput},policy:{auth:"user",escalate:null},transport:{gql:{field:"completeOnboarding"},rest:{method:"POST"}}});

package/dist/node/ontology/autonomous-work-order.fixture.js

@@ -0,0 +1 @@
+import{defineOntologyEdge as i}from"./defineOntologyEdge.js";import{defineOntologyNode as a}from"./defineOntologyNode.js";import{defineOntologyEvidenceReceipt as n}from"./evidence.js";import{defineOntologyGraph as s}from"./graph.js";import{buildOntologyRef as e}from"./ref.js";export const AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION="1.0.0",AUTONOMOUS_WORK_ORDER_FIXTURE_OCCURRED_AT="2026-05-17T00:00:00.000Z",AutonomousWorkOrderOntologyRefs={requestingHuman:e({namespace:"companyos",domain:"actor",kind:"requesting-human",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),planningAgent:e({namespace:"companyos",domain:"actor",kind:"planning-agent",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),workOrder:e({namespace:"companyos",domain:"work",kind:"autonomous-work-order",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),workPlan:e({namespace:"companyos",domain:"work",kind:"operation-plan",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),knowledgeSpec:e({namespace:"companyos",domain:"resource",kind:"knowledge-spec",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),workOrderPage:e({namespace:"companyos",domain:"surface",kind:"work-order-page",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),workOrderDataView:e({namespace:"companyos",domain:"surface",kind:"work-order-dataview",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),roleMorphDecision:e({namespace:"companyos",domain:"adaptation",kind:"rolemorph-decision",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),behaviorSignal:e({namespace:"companyos",domain:"adaptation",kind:"behavior-signal",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),policyDecision:e({namespace:"companyos",domain:"safety",kind:"policy-decision",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),humanApproval:e({namespace:"companyos",domain:"safety",kind:"human-approval",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),auditReceipt:e({namespace:"companyos",domain:"safety",kind:"audit-receipt",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),sanitizedTrainingTrace:e({namespace:"companyos",domain:"resource",kind:"sanitized-training-trace",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION})},AutonomousWorkOrderCommittedSafety={boundary:"high-impact-order",policyDecisionRef:AutonomousWorkOrderOntologyRefs.policyDecision,authorityScopeRef:"companyos:safety:authority-scope@1.0.0",approvalOrRefusalRef:AutonomousWorkOrderOntologyRefs.humanApproval,auditReceiptRef:AutonomousWorkOrderOntologyRefs.auditReceipt,redactionStatus:"applied",replayOrEvidenceRef:AutonomousWorkOrderOntologyRefs.auditReceipt,riskTier:"high",occurredAt:AUTONOMOUS_WORK_ORDER_FIXTURE_OCCURRED_AT},AutonomousWorkOrderEvidenceReceipt=n({id:"companyos:evidence:autonomous-work-order-receipt",ontologyRefIds:Object.values(AutonomousWorkOrderOntologyRefs),evidenceRefs:[{id:"companyos:evidence:policy-decision",kind:"policy-decision",sourcePackage:"@lssm/lib.contracts-spec"},{id:"companyos:evidence:operator-authority",kind:"authority-scope",sourcePackage:"@lssm/lib.contracts-spec"},{id:"companyos:evidence:human-approval",kind:"approval-or-refusal",sourcePackage:"@lssm/lib.contracts-spec"},{id:"companyos:evidence:audit-receipt",kind:"audit-receipt",sourcePackage:"@lssm/lib.contracts-spec"},{id:"companyos:evidence:redaction",kind:"redaction",sourcePackage:"@lssm/lib.contracts-spec"},{id:"companyos:evidence:replay",kind:"replay",sourcePackage:"@lssm/lib.contracts-spec"},{id:"companyos:evidence:sanitized-training",kind:"training-receipt",sourcePackage:"@lssm/lib.contracts-spec"}],safety:AutonomousWorkOrderCommittedSafety,sanitizedForTraining:!0,createdAt:AUTONOMOUS_WORK_ORDER_FIXTURE_OCCURRED_AT});const o=["companyos:evidence:autonomous-work-order-receipt"];export const AutonomousWorkOrderOntologyGraph=s({key:"companyos.autonomous-work-order.ontology-fixture",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION,createdAt:AUTONOMOUS_WORK_ORDER_FIXTURE_OCCURRED_AT,evidenceRefIds:AutonomousWorkOrderEvidenceReceipt.evidenceRefs.map((r)=>r.id),nodes:[a({ref:AutonomousWorkOrderOntologyRefs.requestingHuman,domain:"actor",kind:"human",label:"Requesting human",description:"Human operator requesting the work order.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.planningAgent,domain:"actor",kind:"agent",label:"Planning agent",description:"Agent that proposes the operation plan.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.workOrder,domain:"work",kind:"order",label:"Autonomous work order",description:"High-impact work order gated by policy and human approval.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),a({ref:AutonomousWorkOrderOntologyRefs.workPlan,domain:"work",kind:"workflow",label:"Operation plan",description:"Agent-proposed plan before execution.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.knowledgeSpec,domain:"resource",kind:"spec",label:"Knowledge spec",description:"Resource context used by the plan.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.workOrderPage,domain:"surface",kind:"page",label:"Work order page",description:"Surface page exposing the work order graph.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.workOrderDataView,domain:"surface",kind:"dataview",label:"Work order graph dataview",description:"Graph dataview rendering related work, resource, safety, and adaptation refs.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.roleMorphDecision,domain:"adaptation",kind:"rolemorph-decision",label:"RoleMorph decision",description:"Role-aware surface decision for operator/auditor/agent roles.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.behaviorSignal,domain:"adaptation",kind:"behavior-signal",label:"Behavior signal",description:"Safe adaptive signal tied to surface/work refs.",evidenceRefIds:o}),a({ref:AutonomousWorkOrderOntologyRefs.policyDecision,domain:"safety",kind:"policy-decision",label:"Policy decision",description:"Safety verdict for the high-impact order.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),a({ref:AutonomousWorkOrderOntologyRefs.humanApproval,domain:"safety",kind:"approval",label:"Human approval",description:"Human approval that gates execution.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),a({ref:AutonomousWorkOrderOntologyRefs.auditReceipt,domain:"safety",kind:"audit-receipt",label:"Audit receipt",description:"Replayable evidence receipt for execution and adaptation.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),a({ref:AutonomousWorkOrderOntologyRefs.sanitizedTrainingTrace,domain:"resource",kind:"evidence",label:"Sanitized training trace",description:"Policy-approved sanitized evidence for future tuning.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety})],edges:[i({ref:e({namespace:"companyos",domain:"work",kind:"human-initiates-work-order",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.requestingHuman,to:AutonomousWorkOrderOntologyRefs.workOrder,relation:"initiates",label:"initiates",description:"Human request creates the work order.",evidenceRefIds:o}),i({ref:e({namespace:"companyos",domain:"work",kind:"agent-produces-plan",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.planningAgent,to:AutonomousWorkOrderOntologyRefs.workPlan,relation:"produces",label:"produces plan",description:"Agent proposes an operation plan.",evidenceRefIds:o}),i({ref:e({namespace:"companyos",domain:"safety",kind:"work-order-requires-approval",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.workOrder,to:AutonomousWorkOrderOntologyRefs.policyDecision,relation:"requires-approval",label:"requires approval",description:"Work order requires a policy decision before execution.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),i({ref:e({namespace:"companyos",domain:"safety",kind:"human-approves-work-order",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.humanApproval,to:AutonomousWorkOrderOntologyRefs.workOrder,relation:"approved-by",label:"approved by",description:"Human approval gates the high-impact mutation/order.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),i({ref:e({namespace:"companyos",domain:"surface",kind:"page-renders-work-order",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.workOrderPage,to:AutonomousWorkOrderOntologyRefs.workOrder,relation:"renders",label:"renders",description:"Page renders work order state.",evidenceRefIds:o}),i({ref:e({namespace:"companyos",domain:"surface",kind:"dataview-renders-work-order",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.workOrderDataView,to:AutonomousWorkOrderOntologyRefs.workOrder,relation:"renders",label:"renders graph",description:"Graph dataview renders the ontology envelope.",evidenceRefIds:o}),i({ref:e({namespace:"companyos",domain:"adaptation",kind:"rolemorph-adapts-page",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.roleMorphDecision,to:AutonomousWorkOrderOntologyRefs.workOrderPage,relation:"adapts",label:"adapts page",description:"RoleMorph adapts the visible surface decisions.",evidenceRefIds:o}),i({ref:e({namespace:"companyos",domain:"adaptation",kind:"behavior-signal-personalizes-dataview",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.behaviorSignal,to:AutonomousWorkOrderOntologyRefs.workOrderDataView,relation:"personalizes",label:"personalizes dataview",description:"Safe behavior signal personalizes the graph surface.",evidenceRefIds:o}),i({ref:e({namespace:"companyos",domain:"safety",kind:"audit-evidences-work-order",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.auditReceipt,to:AutonomousWorkOrderOntologyRefs.workOrder,relation:"evidences",label:"evidences",description:"Audit receipt evidences execution, approval, rendering, and adaptation outcomes.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety}),i({ref:e({namespace:"companyos",domain:"resource",kind:"audit-trains-from-sanitized-trace",version:AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION}),from:AutonomousWorkOrderOntologyRefs.auditReceipt,to:AutonomousWorkOrderOntologyRefs.sanitizedTrainingTrace,relation:"trains-from",label:"trains from sanitized trace",description:"Future tuning consumes only sanitized policy-approved evidence.",evidenceRefIds:o,safety:AutonomousWorkOrderCommittedSafety})]});

package/dist/node/ontology/companyos.js

@@ -0,0 +1 @@
+import{buildOntologyRef as e}from"./ref.js";export const COMPANYOS_ONTOLOGY_VERSION="1.0.0",COMPANYOS_ONTOLOGY_KEY="companyos.ontology.spine",COMPANYOS_ONTOLOGY_REFS={autonomousWorkOrder:e({namespace:"companyos",domain:"work",kind:"autonomous-work-order",version:COMPANYOS_ONTOLOGY_VERSION}),requestingOperator:e({namespace:"companyos",domain:"actor",kind:"requesting-operator",version:COMPANYOS_ONTOLOGY_VERSION}),workOrderGraphSurface:e({namespace:"companyos",domain:"surface",kind:"work-order-graph",version:COMPANYOS_ONTOLOGY_VERSION}),approvalPolicyDecision:e({namespace:"companyos",domain:"safety",kind:"approval-policy-decision",version:COMPANYOS_ONTOLOGY_VERSION}),evidenceReceipt:e({namespace:"companyos",domain:"resource",kind:"evidence-receipt",version:COMPANYOS_ONTOLOGY_VERSION}),sanitizedTrainingReceipt:e({namespace:"companyos",domain:"ai-improvement",kind:"sanitized-training-receipt",version:COMPANYOS_ONTOLOGY_VERSION})},CompanyOsOntologySpine={meta:{key:COMPANYOS_ONTOLOGY_KEY,version:COMPANYOS_ONTOLOGY_VERSION,title:"CompanyOS Ontology Spine",description:"Canonical ontology refs for Managed CompanyOS graph projections, approval safety evidence, adaptive UI surfaces, and AI-improvement receipts.",domain:"managed-companyos",owners:["managed-companyos"],tags:["managed-companyos","companyos","ontology","graph"],stability:"experimental"},nodes:[{ref:COMPANYOS_ONTOLOGY_REFS.autonomousWorkOrder,domain:"work",kind:"work-item",label:"Autonomous Work Order",description:"Operator-requested work item that may be planned by an agent but remains policy and approval gated before dispatch.",evidenceRefIds:["companyos:evidence:work-order-request"],safety:{boundary:"high-impact-order",riskTier:"high"}},{ref:COMPANYOS_ONTOLOGY_REFS.requestingOperator,domain:"actor",kind:"actor",label:"Requesting Operator",description:"Human operator that requests, reviews, or approves work.",evidenceRefIds:["companyos:evidence:operator-intent"],safety:{boundary:"query",riskTier:"medium"}},{ref:COMPANYOS_ONTOLOGY_REFS.workOrderGraphSurface,domain:"surface",kind:"surface",label:"Work Order Graph Surface",description:"Adaptive UI graph surface that renders ontology-addressable work, actor, safety, and evidence refs.",evidenceRefIds:["companyos:evidence:surface-render"],safety:{boundary:"display-only",riskTier:"low"}},{ref:COMPANYOS_ONTOLOGY_REFS.approvalPolicyDecision,domain:"safety",kind:"policy-decision",label:"Approval Policy Decision",description:"Policy verdict, authority scope, and approval/refusal evidence required before high-impact execution.",evidenceRefIds:["companyos:evidence:policy-decision"],safety:{boundary:"order",riskTier:"high"}},{ref:COMPANYOS_ONTOLOGY_REFS.evidenceReceipt,domain:"resource",kind:"evidence-receipt",label:"Evidence Receipt",description:"Replayable audit receipt proving the decision, redaction, and execution trace behind a graph projection.",evidenceRefIds:["companyos:evidence:audit-receipt"],safety:{boundary:"query",riskTier:"medium"}},{ref:COMPANYOS_ONTOLOGY_REFS.sanitizedTrainingReceipt,domain:"ai-improvement",kind:"ai-improvement-trace",label:"Sanitized Training Receipt",description:"Receipt that a personalization or fine-tuning trace was redacted, replayable, and policy-approved before training use.",evidenceRefIds:["companyos:evidence:sanitized-training-receipt"],safety:{boundary:"mutation",riskTier:"high"}}],edges:[{ref:e({namespace:"companyos",domain:"work",kind:"requesting-operator-requests-autonomous-work-order",version:COMPANYOS_ONTOLOGY_VERSION}),from:COMPANYOS_ONTOLOGY_REFS.requestingOperator,to:COMPANYOS_ONTOLOGY_REFS.autonomousWorkOrder,relation:"requests",label:"requests",description:"The requesting operator initiates the autonomous work order.",evidenceRefIds:["companyos:evidence:operator-intent"]},{ref:e({namespace:"companyos",domain:"surface",kind:"work-order-graph-renders-autonomous-work-order",version:COMPANYOS_ONTOLOGY_VERSION}),from:COMPANYOS_ONTOLOGY_REFS.workOrderGraphSurface,to:COMPANYOS_ONTOLOGY_REFS.autonomousWorkOrder,relation:"renders",label:"renders",description:"The adaptive graph surface renders work-order state without authorizing dispatch.",evidenceRefIds:["companyos:evidence:surface-render"],safety:{boundary:"display-only",riskTier:"low"}},{ref:e({namespace:"companyos",domain:"safety",kind:"autonomous-work-order-requires-approval-policy-decision",version:COMPANYOS_ONTOLOGY_VERSION}),from:COMPANYOS_ONTOLOGY_REFS.autonomousWorkOrder,to:COMPANYOS_ONTOLOGY_REFS.approvalPolicyDecision,relation:"requires",label:"requires approval policy decision",description:"High-impact work orders require policy decision, authority, approval/refusal, audit, redaction, replay, and timestamp refs.",evidenceRefIds:["companyos:evidence:policy-decision"],safety:{boundary:"high-impact-order",riskTier:"high"}},{ref:e({namespace:"companyos",domain:"resource",kind:"approval-policy-decision-produces-evidence-receipt",version:COMPANYOS_ONTOLOGY_VERSION}),from:COMPANYOS_ONTOLOGY_REFS.approvalPolicyDecision,to:COMPANYOS_ONTOLOGY_REFS.evidenceReceipt,relation:"produces",label:"produces evidence receipt",description:"Approval decisions must be anchored to replayable evidence receipts.",evidenceRefIds:["companyos:evidence:audit-receipt"],safety:{boundary:"order",riskTier:"high"}},{ref:e({namespace:"companyos",domain:"ai-improvement",kind:"evidence-receipt-trains-from-sanitized-training-receipt",version:COMPANYOS_ONTOLOGY_VERSION}),from:COMPANYOS_ONTOLOGY_REFS.evidenceReceipt,to:COMPANYOS_ONTOLOGY_REFS.sanitizedTrainingReceipt,relation:"trains-from",label:"enables sanitized training receipt",description:"AI-improvement traces may reference evidence only through sanitized, policy-approved training receipts.",evidenceRefIds:["companyos:evidence:sanitized-training-receipt"],safety:{boundary:"mutation",riskTier:"high"}}]};

package/dist/node/ontology/defineOntologyEdge.js

@@ -0,0 +1 @@
+import{isOntologyRef as t,parseOntologyRef as n}from"./ref.js";import{getIncompleteOntologySafetyFields as f}from"./safety.js";export function defineOntologyEdge(o){for(const r of[o.ref,o.from,o.to])if(!t(r))throw Error(`Invalid ontology edge ref: ${r}`);if(n(o.ref)?.domain===void 0)throw Error(`Invalid ontology edge ref: ${o.ref}`);const e=o.safety?f(o.safety):[];if(e.length>0)throw Error(`Ontology edge ${o.ref} is missing high-impact safety refs: ${e.join(", ")}`);return o}

package/dist/node/ontology/defineOntologyNode.js

@@ -0,0 +1 @@
+import{isOntologyRef as e,parseOntologyRef as r}from"./ref.js";export function defineOntologyNode(o){if(!e(o.ref))throw Error(`Invalid ontology node ref: ${o.ref}`);const n=r(o.ref);if(n?.domain!==o.domain)throw Error(`Ontology node ref domain ${n?.domain??"unknown"} does not match node domain ${o.domain}`);return o}

package/dist/node/ontology/evidence.js

@@ -0,0 +1 @@
+export function defineOntologyEvidenceReceipt(e){if(e.evidenceRefs.length===0)throw Error(`Ontology evidence receipt ${e.id} has no evidence refs`);return e}

package/dist/node/ontology/graph.js

@@ -0,0 +1 @@
+import{OntologyRegistry as r}from"./registry.js";import{getIncompleteOntologySafetyFields as s}from"./safety.js";export function defineOntologyGraph(e){assertOntologyGraph(e);return e}export function ontologyGraphFromSpine(e,t=new Date(0).toISOString()){return defineOntologyGraph({key:e.meta.key,version:e.meta.version,nodes:e.nodes,edges:e.edges,evidenceRefIds:[...new Set([...e.nodes.flatMap((o)=>o.evidenceRefIds),...e.edges.flatMap((o)=>o.evidenceRefIds)])],createdAt:t})}export function validateOntologyGraph(e){const t=[];try{new r([{meta:i(e),nodes:e.nodes,edges:e.edges}]).assertResolvable()}catch(o){t.push({ref:e.key,severity:"error",message:o instanceof Error?o.message:String(o)})}for(const o of e.edges){const n=o.safety?s(o.safety):[];if(n.length>0)t.push({ref:o.ref,severity:"error",message:`High-impact ontology edge is missing safety refs: ${n.join(", ")}`,missingSafetyFields:n})}return t}export function assertOntologyGraph(e){const t=validateOntologyGraph(e);if(t.length>0)throw Error(`Invalid ontology graph ${e.key}: ${t.map((o)=>o.message).join("; ")}`)}function i(e){return{key:e.key,version:e.version,title:e.key,description:"Ontology graph validation envelope",domain:"ontology",owners:["contracts-spec"],tags:["ontology"],stability:"experimental"}}

package/dist/node/ontology/index.js

@@ -0,0 +1 @@
+export{AUTONOMOUS_WORK_ORDER_FIXTURE_OCCURRED_AT,AUTONOMOUS_WORK_ORDER_FIXTURE_VERSION,AutonomousWorkOrderCommittedSafety,AutonomousWorkOrderEvidenceReceipt,AutonomousWorkOrderOntologyGraph,AutonomousWorkOrderOntologyRefs}from"./autonomous-work-order.fixture.js";export{COMPANYOS_ONTOLOGY_KEY,COMPANYOS_ONTOLOGY_REFS,COMPANYOS_ONTOLOGY_VERSION,CompanyOsOntologySpine}from"./companyos.js";export{defineOntologyEdge}from"./defineOntologyEdge.js";export{defineOntologyNode}from"./defineOntologyNode.js";export{assertOntologyGraph,defineOntologyGraph,ontologyGraphFromSpine,validateOntologyGraph}from"./graph.js";export{isCanonicalOntologyDomain,isCanonicalOntologyEdgeRelation,isCanonicalOntologyNodeKind,OntologyDomains,OntologyEdgeRelations,OntologyNodeKinds}from"./kinds.js";export{assertOntologyRef,buildOntologyRef,isOntologyRef,ontologyRef,parseOntologyRef}from"./ref.js";export{OntologyRegistry}from"./registry.js";export{getIncompleteOntologySafetyFields,requiresCompleteOntologySafetyRefs}from"./safety.js";

package/dist/node/ontology/kinds.js

@@ -0,0 +1 @@
+export const OntologyDomains=["actor","work","resource","surface","adaptation","safety"],OntologyNodeKinds={actor:["human","agent","team","customer","role","permission","authority-scope"],work:["goal","order","workflow","command","query","mutation","decision","blocker","outcome"],resource:["spec","document","entity","record","file","page","memory","evidence","external-resource","evidence-receipt"],surface:["app","page","nav-item","menu","link","feature","panel","dataview","action","route"],adaptation:["preference","behavior-signal","rolemorph-decision","adaptive-hint","analytics-signal","explanation"],safety:["policy-decision","approval","rejection","audit-receipt","redaction","replay","risk","consent"]},OntologyEdgeRelations=["initiates","assigned-to","requires-approval","approved-by","denied-by","queries","mutates","orders","produces","blocks","depends-on","renders","navigates-to","contains","adapts","personalizes","explains","evidences","redacts","replays","trains-from","derived-from"];export function isCanonicalOntologyDomain(o){return OntologyDomains.includes(o)}export function isCanonicalOntologyNodeKind(o,e){if(!isCanonicalOntologyDomain(o))return!1;return OntologyNodeKinds[o].includes(e)}export function isCanonicalOntologyEdgeRelation(o){return OntologyEdgeRelations.includes(o)}

package/dist/node/ontology/ref.js

@@ -0,0 +1 @@
+const f=/^([^:@\s]+):([^:@\s]+):([^@\s]+)@([^@\s]+)$/;export function ontologyRef(o){assertOntologyRef(o);return o}export function buildOntologyRef(o){return ontologyRef(`${o.namespace}:${o.domain}:${o.kind}@${o.version}`)}export function parseOntologyRef(o){const e=f.exec(o);if(!e)return;const[,n,t,r,s]=e;if(!n||!t||!r||!s)return;return{namespace:n,domain:t,kind:r,version:s}}export function isOntologyRef(o){return parseOntologyRef(o)!==void 0}export function assertOntologyRef(o){if(!isOntologyRef(o))throw Error(`Invalid ontology ref: ${o}`)}

package/dist/node/ontology/registry.js

@@ -0,0 +1 @@
+export class OntologyRegistry{nodes=new Map;edges=new Map;constructor(e=[]){for(const o of e)this.registerSpine(o)}registerSpine(e){for(const o of e.nodes)this.registerNode(o);for(const o of e.edges)this.registerEdge(o);return this}registerNode(e){if(this.nodes.has(e.ref))throw Error(`Duplicate ontology node ref: ${e.ref}`);this.nodes.set(e.ref,e);return this}registerEdge(e){if(this.edges.has(e.ref))throw Error(`Duplicate ontology edge ref: ${e.ref}`);this.edges.set(e.ref,e);return this}getNode(e){return this.nodes.get(e)}getEdge(e){return this.edges.get(e)}listNodes(){return[...this.nodes.values()]}listEdges(){return[...this.edges.values()]}assertResolvable(){const e=new Set;for(const o of this.edges.values()){if(!this.nodes.has(o.from))e.add(o.from);if(!this.nodes.has(o.to))e.add(o.to)}if(e.size>0)throw Error(`Ontology edge endpoint refs are missing: ${[...e].join(", ")}`);return this}}

package/dist/node/ontology/safety.js

@@ -0,0 +1 @@
+const t=["policyDecisionRef","authorityScopeRef","approvalOrRefusalRef","auditReceiptRef","redactionStatus","replayOrEvidenceRef","riskTier","occurredAt"];export function requiresCompleteOntologySafetyRefs(e){return getIncompleteOntologySafetyFields(e).length>0}export function getIncompleteOntologySafetyFields(e){if(e.boundary!=="mutation"&&e.boundary!=="order"&&e.boundary!=="high-impact-order")return[];return t.filter((o)=>!e[o])}

package/dist/node/openapi.js

@@ -0,0 +1,38 @@
+import{compareVersions as O}from"compare-versions";import{defaultRestPath as g,jsonSchemaForSpec as l}from"./jsonschema.js";function m(r,t){return`${r.replace(/\./g,"_")}_v${t}`}function d(r,t,s){return`${r}_${m(t,s)}`}function S(r,t){return(t??(r==="query"?"GET":"POST")).toLowerCase()}function f(r){const t=r.transport?.rest?.path??g(r.meta.key,r.meta.version);return t.startsWith("/")?t:`/${t}`}export function openApiForRegistry(r,t={}){const s=r.list().filter((e)=>e.meta.kind==="command"||e.meta.kind==="query").slice().sort((e,n)=>{const p=e.meta.key.localeCompare(n.meta.key);return p!==0?p:O(e.meta.version,n.meta.version)}),i={openapi:"3.1.0",info:{title:t.title??"ContractSpec API",version:t.version??"0.0.0",...t.description?{description:t.description}:{}},...t.servers?{servers:t.servers}:{},paths:{},components:{schemas:{}}};for(const e of s){const n=l(e),p=S(e.meta.kind,e.transport?.rest?.method),u=f(e),h=m(e.meta.key,e.meta.version),y=i.paths[u]??={},a={operationId:h,summary:e.meta.description??e.meta.key,description:e.meta.description,tags:e.meta.tags??[],"x-contractspec":{name:e.meta.key,version:e.meta.version,kind:e.meta.kind},responses:{}};if(n.input){const o=d("Input",e.meta.key,e.meta.version);i.components.schemas[o]=n.input;a.requestBody={required:!0,content:{"application/json":{schema:{$ref:`#/components/schemas/${o}`}}}}}const c={};if(n.output){const o=d("Output",e.meta.key,e.meta.version);i.components.schemas[o]=n.output;c["200"]={description:"OK",content:{"application/json":{schema:{$ref:`#/components/schemas/${o}`}}}}}else c["200"]={description:"OK"};a.responses=c;y[p]=a}return i}export const tech_contracts_openapi_export_DocBlocks=[{id:"docs.tech.contracts.openapi-export",title:"OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry",summary:"Generate a deterministic OpenAPI document from a OperationSpecRegistry using jsonSchemaForSpec + REST transport metadata.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/openapi-export",tags:["contracts","openapi","rest"],body:`## OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry
+
+### Purpose
+
+ContractSpec specs can be exported into an **OpenAPI 3.1** document for tooling (SDK generation, docs, gateways).
+
+The export is **spec-first**:
+
+- Uses \`jsonSchemaForSpec(spec)\` for input/output JSON Schema (from SchemaModel → zod → JSON Schema)
+- Uses \`spec.transport.rest.method/path\` when present
+- Falls back to deterministic defaults:
+  - Method: \`POST\` for commands, \`GET\` for queries
+  - Path: \`defaultRestPath(name, version)\` → \`/<dot/name>/v<version>\`
+
+### Library API
+
+- Function: \`openApiForRegistry(registry, options?)\`
+- Location: \`@lssm/lib.contracts-spec/openapi\`
+
+### CLI
+
+Export OpenAPI from a registry module:
+
+\`\`\`bash
+contractspec openapi --registry ./src/registry.ts --out ./openapi.json
+\`\`\`
+
+The registry module must export one of:
+
+- \`registry: OperationSpecRegistry\`
+- \`default(): OperationSpecRegistry | Promise<OperationSpecRegistry>\`
+- \`createRegistry(): OperationSpecRegistry | Promise<OperationSpecRegistry>\`
+
+### Notes / limitations (current)
+
+- Responses are generated as a basic \`200\` response (plus schemas when available).
+- Query (GET) inputs are currently represented as a JSON request body when an input schema exists.
+- Errors are not yet expanded into OpenAPI responses; that will be added when we standardize error envelopes.`}];

package/dist/node/operations/agent/archive.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as i}from"../../ownership.js";import{IdempotencyKeyScalar as n}from"../../shared/index.js";import{defineCommand as r}from"../operation.js";import{AGENT_DOMAIN as a,AGENT_OWNERS as o,AGENT_TAGS as s,AgentDetail as l,AgentMutationErrors as p,AgentScopeFields as u}from"./shared-schemas.js";const c=new t({name:"AgentArchiveInput",fields:{...u,agentId:{type:e.String_unsecure(),isOptional:!1},expectedVersion:{type:e.Int_unsecure(),isOptional:!1},idempotencyKey:{type:n,isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1}}}),m=new t({name:"AgentArchiveOutput",fields:{agent:{type:l,isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentArchiveCommand=r({meta:{key:"agent.archive",title:"Agent Archive",version:"1.0.0",description:"Archive an agent (terminal). Must be in STOPPED. Emits regulatory-retention audit event with required reason.",goal:"Allow operators to retire agents while preserving the audit and run history immutably.",context:"Phase 0.4.A mutation. ARCHIVED is terminal in v1.0 (no unarchive — clone if needed). See DOMAIN_NOTES §1.6 and §2.3.",domain:a,owners:[...o],tags:[...s,"archive","lifecycle","terminal"],stability:i.Experimental},io:{input:c,output:m,errors:{...p}},policy:{auth:"user",permissions:["agent.fleet.deploy"],escalate:"human_review",pii:[]},sideEffects:{audit:["agent.archived"]}});

package/dist/node/operations/agent/assign-tool.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as n}from"../../ownership.js";import{IdempotencyKeyScalar as o}from"../../shared/index.js";import{defineCommand as i}from"../operation.js";import{AGENT_DOMAIN as a,AGENT_OWNERS as s,AGENT_TAGS as r,AgentDetail as l,AgentMutationErrors as p,AgentScopeFields as g,ToolBinding as u}from"./shared-schemas.js";const d=new t({name:"AgentAssignToolInput",fields:{...g,agentId:{type:e.String_unsecure(),isOptional:!1},expectedVersion:{type:e.Int_unsecure(),isOptional:!1},idempotencyKey:{type:o,isOptional:!1},toolId:{type:e.String_unsecure(),isOptional:!1},bindingMode:{type:e.String_unsecure(),isOptional:!1},scopes:{type:e.String_unsecure(),isOptional:!0,isArray:!0},reason:{type:e.String_unsecure(),isOptional:!1}}}),c=new t({name:"AgentAssignToolOutput",fields:{agent:{type:l,isOptional:!1},binding:{type:u,isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentAssignToolCommand=i({meta:{key:"agent.assign-tool",title:"Agent Assign Tool",version:"1.0.0",description:"Attach (or detach) a tool binding on an agent. Mode: attach | detach. Scopes default to the tool spec.",goal:"Wire an agent to a tool from the registry with optional scope narrowing and full audit trail.",context:"Phase 0.4.A mutation. PRIMARY tool-registry seam (SEAMS §3.1). Audit retention regulatory when tool.riskTier >= elevated. See DOMAIN_NOTES §1.10 and §6.1.",domain:a,owners:[...s],tags:[...r,"assign-tool","tool"],stability:n.Experimental},io:{input:d,output:c,errors:{...p}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.tool-assigned","agent.tool-detached"]}});

package/dist/node/operations/agent/clone.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as n}from"../../ownership.js";import{IdempotencyKeyScalar as o}from"../../shared/index.js";import{defineCommand as i}from"../operation.js";import{AGENT_DOMAIN as a,AGENT_OWNERS as s,AGENT_TAGS as l,AgentDetail as r,AgentMutationErrors as u,AgentScopeFields as p}from"./shared-schemas.js";const m=new t({name:"AgentCloneInput",fields:{...p,agentId:{type:e.String_unsecure(),isOptional:!1},idempotencyKey:{type:o,isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},includeRuns:{type:e.Boolean(),isOptional:!0},resetAutonomy:{type:e.Boolean(),isOptional:!0}}}),g=new t({name:"AgentCloneOutput",fields:{agent:{type:r,isOptional:!1},sourceAgentId:{type:e.String_unsecure(),isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentCloneCommand=i({meta:{key:"agent.clone",title:"Agent Clone",version:"1.0.0",description:"Clone an existing agent — copies configuration into a new DRAFT agent. Source must not be DRAFT or ARCHIVED.",goal:"Speed up onboarding new agents by templating from a known-good source.",context:"Phase 0.4.A mutation. Cloning does NOT advance the source agent. resetAutonomy defaults true — clone starts at minimum autonomy. See DOMAIN_NOTES §1.5.",domain:a,owners:[...s],tags:[...l,"clone","lifecycle"],stability:n.Experimental},io:{input:m,output:g,errors:{...u}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.cloned"]}});

package/dist/node/operations/agent/create.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as i}from"../../ownership.js";import{IdempotencyKeyScalar as n}from"../../shared/index.js";import{defineCommand as a}from"../operation.js";import{AGENT_DOMAIN as r,AGENT_OWNERS as s,AGENT_TAGS as o,AgentDetail as p,AgentMutationErrors as l,AgentScopeFields as u}from"./shared-schemas.js";const m=new t({name:"AgentCreateInput",fields:{...u,idempotencyKey:{type:n,isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},template:{type:e.String_unsecure(),isOptional:!0},initialAutonomy:{type:e.String_unsecure(),isOptional:!1},initialRiskTier:{type:e.String_unsecure(),isOptional:!1},ownerIds:{type:e.String_unsecure(),isOptional:!1,isArray:!0},tags:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}}),c=new t({name:"AgentCreateOutput",fields:{agent:{type:p,isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentCreateCommand=a({meta:{key:"agent.create",title:"Agent Create",version:"1.0.0",description:"Create a new agent — initialises lifecycle in DRAFT.",goal:"Allow operators to define a new agent with starting autonomy, risk tier, owners, and optional template.",context:"Phase 0.4.A mutation. Idempotency-required (SEAMS §1.4). Audit-emit on success. See DOMAIN_NOTES §1.3.",domain:r,owners:[...s],tags:[...o,"create","lifecycle"],stability:i.Experimental},io:{input:m,output:c,errors:{...l}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.created"]}});

package/dist/node/operations/agent/fleet-health.query.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as a}from"../../ownership.js";import{defineQuery as n}from"../operation.js";import{AGENT_DOMAIN as s,AGENT_OWNERS as i,AGENT_TAGS as l,AgentReadErrors as o,AgentScopeFields as r}from"./shared-schemas.js";const p=new t({name:"AgentFleetHealthInput",fields:{...r}}),u=new t({name:"AgentFleetHealthOutput",fields:{status:{type:e.String_unsecure(),isOptional:!1},symptoms:{type:e.String_unsecure(),isOptional:!1,isArray:!0},totalAgents:{type:e.Int_unsecure(),isOptional:!1},activeAgents:{type:e.Int_unsecure(),isOptional:!1},pausedByPolicy:{type:e.Int_unsecure(),isOptional:!1},stoppedAgents:{type:e.Int_unsecure(),isOptional:!1},readinessGateFailures:{type:e.Int_unsecure(),isOptional:!1},runtimeAvailable:{type:e.Boolean(),isOptional:!1},generatedAt:{type:e.String_unsecure(),isOptional:!1}}});export const AgentFleetHealthQuery=n({meta:{key:"agent.fleet.health",title:"Agent Fleet Health",version:"1.0.0",description:"Agent-domain health rollup (status + symptoms + counts) consumed by fleet.health.snapshot.",goal:"Surface the operational health of the agent fleet for the operating-cockpit health card.",context:"Phase 0.4.A read contract (SEAMS Q-05 add). Composes runtime + lifecycle aggregates over lib.ai-agent. See DOMAIN_NOTES §6.5 (auto-paused-by-policy counts) + SEAMS §3.10.",domain:s,owners:[...i],tags:[...l,"health","read"],stability:a.Experimental},capability:{key:"fleet.metrics.read",version:"1.0.0"},io:{input:p,output:u,errors:{...o}},policy:{auth:"user",permissions:["agent.fleet.read","fleet.metrics.read"],pii:[]}});

package/dist/node/operations/agent/get.query.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as n}from"../../ownership.js";import{defineQuery as i}from"../operation.js";import{AGENT_DOMAIN as r,AGENT_OWNERS as a,AGENT_TAGS as o,AgentDetail as s,AgentReadErrors as l,AgentRunSummary as u,AgentScopeFields as p,ToolBinding as c}from"./shared-schemas.js";const g=new t({name:"AgentGetInput",fields:{...p,agentId:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!0},includeTools:{type:e.Boolean(),isOptional:!0},includeRecentRuns:{type:e.Int_unsecure(),isOptional:!0}}}),d=new t({name:"AgentGetOutput",fields:{agent:{type:s,isOptional:!1},tools:{type:c,isOptional:!0,isArray:!0},recentRuns:{type:u,isOptional:!0,isArray:!0}}});export const AgentGetQuery=i({meta:{key:"agent.get",title:"Agent Get",version:"1.0.0",description:"Read a single agent — detail surface for AgentDetailScreen, drawer, and audit screens.",goal:"Resolve a full AgentDetail with optional tool bindings and recent run summaries.",context:"Phase 0.4.A read contract. Returns AgentDetail; full run telemetry via @lssm/module.execution-console. See DOMAIN_NOTES §1.2.",domain:r,owners:[...a],tags:[...o,"detail","read"],stability:n.Experimental},io:{input:g,output:d,errors:{...l}},policy:{auth:"user",permissions:["agent.fleet.read"],pii:[]}});

package/dist/node/operations/agent/import-memory.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as o}from"@lssm/lib.schema";import{StabilityEnum as r}from"../../ownership.js";import{IdempotencyKeyScalar as i}from"../../shared/index.js";import{defineCommand as n}from"../operation.js";import{AGENT_DOMAIN as m,AGENT_OWNERS as a,AGENT_TAGS as s,AgentMutationErrors as p}from"./shared-schemas.js";const e={type:t.String_unsecure(),isOptional:!1};export const AgentImportMemoryInput=new o({name:"AgentImportMemoryInput",fields:{tenantId:e,workspaceId:e,environmentId:e,applicationRef:e,proposalRef:e,proposalDigest:e,archiveRef:e,archiveDigest:e,runtimeWorkOrderRef:e,idempotencyKey:{type:i,isOptional:!1}}}),AgentImportMemoryOutput=new o({name:"AgentImportMemoryOutput",fields:{proposalRef:e,proposalDigest:e,status:e,runtimeOperationRef:e,artifactRevision:{type:t.Int_unsecure(),isOptional:!0}}}),AgentImportMemoryCommand=n({meta:{key:"agent.memory.import.submit",title:"Submit imported memory for owner review",version:"1.0.0",description:"Submit a digest-bound external memory proposal for owner review through Runtime Node authority.",goal:"Let a member migrate selected memory without activating imported instructions or bypassing owner consent.",context:"PersonalOS and CompanyOS retain promotion, retention, sharing and deletion authority. This operation stores a review candidate only.",domain:m,owners:[...a],tags:[...s,"migration","memory"],stability:r.Experimental},io:{input:AgentImportMemoryInput,output:AgentImportMemoryOutput,errors:{...p}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.memory-import.submission"]}});

package/dist/node/operations/agent/list.query.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as n}from"@lssm/lib.schema";import{StabilityEnum as u}from"../../ownership.js";import{createQueryResultEnvelope as l}from"../../query/index.js";import{defineQuery as p}from"../operation.js";import{AGENT_DOMAIN as c,AGENT_OWNERS as g,AGENT_TAGS as y,AgentReadErrors as d,AgentScopeFields as m,AgentSummary as A}from"./shared-schemas.js";const f=new n({name:"AgentListFilter",fields:{state:{type:t.String_unsecure(),isOptional:!0,isArray:!0},autonomyLevel:{type:t.String_unsecure(),isOptional:!0,isArray:!0},riskTier:{type:t.String_unsecure(),isOptional:!0,isArray:!0},ownerId:{type:t.String_unsecure(),isOptional:!0},capability:{type:t.String_unsecure(),isOptional:!0,isArray:!0},tags:{type:t.String_unsecure(),isOptional:!0,isArray:!0},search:{type:t.String_unsecure(),isOptional:!0}}}),O=new n({name:"AgentListInput",fields:{...m,filter:{type:f,isOptional:!0},sort:{type:t.String_unsecure(),isOptional:!0},cursor:{type:t.String_unsecure(),isOptional:!0},limit:{type:t.Int_unsecure(),isOptional:!0}}}),S=new n({name:"AgentListOutput",fields:{items:{type:A,isOptional:!1,isArray:!0},nextCursor:{type:t.String_unsecure(),isOptional:!0},approxTotal:{type:t.Int_unsecure(),isOptional:!0}}});export const AgentListQuery=p({meta:{key:"agent.list",title:"Agent List",version:"1.0.0",description:"Paginated agent listing — primary read for the AgentFleet table and AgentTree screens.",goal:"Power the fleet table, tree hierarchy, and dashboard with one cursor-paginated read.",context:"Phase 0.4.A read contract. Returns AgentSummary rows; full detail via agent.get. See DOMAIN_NOTES §1.1.",domain:c,owners:[...g],tags:[...y,"list","read"],stability:u.Experimental},io:{input:O,output:S,errors:{...d}},policy:{auth:"user",permissions:["agent.fleet.read"],pii:[]}});export function createAgentListCanonicalQuery(e){const s=Object.entries(e.filter??{}).flatMap(([i,r])=>{if(i==="search"||r===void 0)return[];return[{field:i,operator:Array.isArray(r)?"in":"eq",value:r}]}),[a="updatedAt",o="desc"]=(e.sort??"updatedAt:desc").split(":");return{operation:{key:"agent.list",version:"1.0.0"},search:e.filter?.search?.trim()||void 0,filters:s,sort:[{field:a,direction:o==="asc"?"asc":"desc"}],pagination:{mode:"cursor",cursor:e.cursor,limit:e.limit??50},cache:{keyParts:["agent.list",e.filter??{},e.sort??"updatedAt:desc",e.cursor??"",e.limit??50],dependencies:["agent.create","agent.update","agent.delete"]}}}export const agentListInputToQueryEnvelope=createAgentListCanonicalQuery;export function createAgentListCanonicalResult(e){return l({data:e.items,cursor:e.nextCursor,approxTotal:e.approxTotal})}

package/dist/node/operations/agent/pause.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as n}from"../../ownership.js";import{IdempotencyKeyScalar as a}from"../../shared/index.js";import{defineCommand as i}from"../operation.js";import{AGENT_DOMAIN as s,AGENT_OWNERS as o,AGENT_TAGS as u,AgentDetail as r,AgentMutationErrors as p,AgentScopeFields as l}from"./shared-schemas.js";const f=new t({name:"AgentPauseInput",fields:{...l,agentId:{type:e.String_unsecure(),isOptional:!1},expectedVersion:{type:e.Int_unsecure(),isOptional:!1},idempotencyKey:{type:a,isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1},drainInflightRuns:{type:e.Boolean(),isOptional:!0}}}),m=new t({name:"AgentPauseOutput",fields:{agent:{type:r,isOptional:!1},inflightRunsPaused:{type:e.Int_unsecure(),isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentPauseCommand=i({meta:{key:"agent.pause",title:"Agent Pause",version:"1.0.0",description:"Pause an ACTIVE agent. drainInflightRuns defaults true (in-flight runs complete their current step first).",goal:"Suspend an agent without destroying state so it can be resumed cleanly.",context:"Phase 0.4.A mutation. Best-effort run drain when drainInflightRuns=false. See DOMAIN_NOTES §1.8.",domain:s,owners:[...o],tags:[...u,"pause","lifecycle"],stability:n.Experimental},io:{input:f,output:m,errors:{...p}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.paused"]}});

package/dist/node/operations/agent/set-autonomy.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as n}from"../../ownership.js";import{IdempotencyKeyScalar as o}from"../../shared/index.js";import{defineCommand as a}from"../operation.js";import{AGENT_DOMAIN as i,AGENT_OWNERS as r,AGENT_TAGS as s,AgentDetail as p,AgentMutationErrors as u,AgentScopeFields as m}from"./shared-schemas.js";const l=new t({name:"AgentSetAutonomyInput",fields:{...m,agentId:{type:e.String_unsecure(),isOptional:!1},expectedVersion:{type:e.Int_unsecure(),isOptional:!1},idempotencyKey:{type:o,isOptional:!1},autonomyLevel:{type:e.String_unsecure(),isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1},proposalId:{type:e.String_unsecure(),isOptional:!0}}}),y=new t({name:"AgentSetAutonomyOutput",fields:{agent:{type:p,isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentSetAutonomyCommand=a({meta:{key:"agent.set-autonomy",title:"Agent Set Autonomy",version:"1.0.0",description:"Change an agent's autonomy level. Promotion to act-autonomously requires an approved review proposal.",goal:"Govern agent autonomy with explicit review-gated promotions and unilateral demotion.",context:"Phase 0.4.A mutation. Reverse-dispatch callee in SEAMS §3.7 (review.approve). Audit retention regulatory. See DOMAIN_NOTES §1.11 and §6.3.",domain:i,owners:[...r],tags:[...s,"set-autonomy","autonomy"],stability:n.Experimental},io:{input:l,output:y,errors:{...u}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.autonomy-changed"]}});

package/dist/node/operations/agent/set-risk-tier.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as i}from"../../ownership.js";import{IdempotencyKeyScalar as n}from"../../shared/index.js";import{defineCommand as r}from"../operation.js";import{AGENT_DOMAIN as a,AGENT_OWNERS as s,AGENT_TAGS as o,AgentDetail as p,AgentMutationErrors as l,AgentScopeFields as u}from"./shared-schemas.js";const c=new t({name:"AgentSetRiskTierInput",fields:{...u,agentId:{type:e.String_unsecure(),isOptional:!1},expectedVersion:{type:e.Int_unsecure(),isOptional:!1},idempotencyKey:{type:n,isOptional:!1},riskTier:{type:e.String_unsecure(),isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1}}}),g=new t({name:"AgentSetRiskTierOutput",fields:{agent:{type:p,isOptional:!1},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentSetRiskTierCommand=r({meta:{key:"agent.set-risk-tier",title:"Agent Set Risk Tier",version:"1.0.0",description:"Raise or lower an agent's risk tier. Direction-conditional capability gate is enforced handler-side.",goal:"Adjust the review-escalation routing and policy bracket for an agent.",context:"Phase 0.4.A mutation. Audit retention regulatory when raising to high/critical. See DOMAIN_NOTES §1.12.",domain:a,owners:[...s],tags:[...o,"set-risk-tier","risk"],stability:i.Experimental},io:{input:c,output:g,errors:{...l}},policy:{auth:"user",permissions:["agent.fleet.manage"],pii:[]},sideEffects:{audit:["agent.risk-tier-changed"]}});

package/dist/node/operations/agent/shared-schemas.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";export const AGENT_DOMAIN="agent-fleet",AGENT_OWNERS=["@platform.agent-fleet","@platform.ai-agent"],AGENT_TAGS=["agent","agent-fleet","agent-workflow-pillar"],AGENT_STATES=["DRAFT","CONFIGURED","ACTIVE","PAUSED","STOPPED","ARCHIVED"],AUTONOMY_LEVELS=["observe","suggest","act-with-approval","act-autonomously"],RISK_TIERS=["low","medium","high","critical"],TOOL_BINDING_MODES=["attach","detach"],AgentMutationErrors={NOT_FOUND:{description:"Target agent (or referenced tool / template / review proposal) does not exist.",http:404,when:"The caller-supplied id resolves to no record in the active tenant scope.",recoverable:!1},CONFLICT:{description:"Optimistic-concurrency conflict (stale `expectedVersion`) or illegal state transition for the agent lifecycle FSM.",http:409,when:"Caller submitted a stale version, or the operation is not allowed from the agent's current state.",recoverable:!1},FORBIDDEN:{description:"Active persona lacks the required capability for this operation.",http:403,when:"Role-morph projection rejects the persona (e.g., auditor calling a manage/deploy op).",recoverable:!1},VALIDATION:{description:"Input payload shape, enum value, or business-rule precondition failed.",http:400,when:"The caller supplied a malformed or rule-violating payload (e.g., unknown autonomy level, missing readiness gate).",recoverable:!1},DEPENDENCY:{description:"A downstream collaborator (tool registry, review-approval proposal, governance policy, agent runtime) is unavailable or refused.",http:503,when:"A cross-domain seam (S-01, S-07, S-09) returned an error. Retry with backoff per the outbox invariant in SEAMS §1.4.",recoverable:!0},IDEMPOTENCY_FAIL:{description:"A prior request with the same `idempotencyKey` succeeded with a different payload — replay refused.",http:409,when:"Caller already succeeded with this key but the new payload differs. Read the original result instead.",recoverable:!1}},AgentReadErrors={NOT_FOUND:AgentMutationErrors.NOT_FOUND,FORBIDDEN:AgentMutationErrors.FORBIDDEN,VALIDATION:AgentMutationErrors.VALIDATION,DEPENDENCY:{...AgentMutationErrors.DEPENDENCY,when:"Read-model not warm; retry with backoff."}},AgentScopeFields={tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!0}},AgentSummaryFields={id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},state:{type:e.String_unsecure(),isOptional:!1},autonomyLevel:{type:e.String_unsecure(),isOptional:!1},riskTier:{type:e.String_unsecure(),isOptional:!1},ownerIds:{type:e.String_unsecure(),isOptional:!1,isArray:!0},toolCount:{type:e.Int_unsecure(),isOptional:!1},lastRunAt:{type:e.String_unsecure(),isOptional:!0},lastStateChangeReason:{type:e.String_unsecure(),isOptional:!0},updatedAt:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1}},AgentSummary=new t({name:"AgentSummary",fields:AgentSummaryFields}),ToolBindingFields={toolId:{type:e.String_unsecure(),isOptional:!1},bindingMode:{type:e.String_unsecure(),isOptional:!1},scopes:{type:e.String_unsecure(),isOptional:!1,isArray:!0},attachedAt:{type:e.String_unsecure(),isOptional:!1},attachedByActorRef:{type:e.String_unsecure(),isOptional:!1}},ToolBinding=new t({name:"AgentToolBinding",fields:ToolBindingFields}),AgentDetail=new t({name:"AgentDetail",fields:{...AgentSummaryFields,description:{type:e.String_unsecure(),isOptional:!0},tags:{type:e.String_unsecure(),isOptional:!1,isArray:!0},policyRefs:{type:e.String_unsecure(),isOptional:!1,isArray:!0},toolBindings:{type:ToolBinding,isOptional:!1,isArray:!0},createdAt:{type:e.String_unsecure(),isOptional:!1},archivedAt:{type:e.String_unsecure(),isOptional:!0}}}),AgentRunSummary=new t({name:"AgentRunSummary",fields:{id:{type:e.String_unsecure(),isOptional:!1},startedAt:{type:e.String_unsecure(),isOptional:!1},endedAt:{type:e.String_unsecure(),isOptional:!0},outcome:{type:e.String_unsecure(),isOptional:!1},durationMs:{type:e.Int_unsecure(),isOptional:!0}}});

package/dist/node/operations/agent/start.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as e}from"@lssm/lib.schema";import{StabilityEnum as a}from"../../ownership.js";import{IdempotencyKeyScalar as n}from"../../shared/index.js";import{defineCommand as i}from"../operation.js";import{AGENT_DOMAIN as o,AGENT_OWNERS as r,AGENT_TAGS as s,AgentDetail as p,AgentMutationErrors as l,AgentScopeFields as m}from"./shared-schemas.js";const u=new e({name:"AgentStartInput",fields:{...m,agentId:{type:t.String_unsecure(),isOptional:!1},expectedVersion:{type:t.Int_unsecure(),isOptional:!1},idempotencyKey:{type:n,isOptional:!1},resumeReason:{type:t.String_unsecure(),isOptional:!0}}}),d=new e({name:"AgentStartOutput",fields:{agent:{type:p,isOptional:!1},auditEventId:{type:t.String_unsecure(),isOptional:!1}}});export const AgentStartCommand=i({meta:{key:"agent.start",title:"Agent Start",version:"1.0.0",description:"Start a CONFIGURED agent or resume a PAUSED agent. Both transitions move state to ACTIVE.",goal:"Allow operators (and workflow dispatch via S-02) to activate an agent so its runtime sessions begin or resume.",context:"Phase 0.4.A mutation. Callable cross-domain via workflow.run.dispatch (SEAMS §3.2). Inbound idempotencyKey treated as authoritative. See DOMAIN_NOTES §1.7.",domain:o,owners:[...r],tags:[...s,"start","lifecycle"],stability:a.Experimental},io:{input:u,output:d,errors:{...l}},policy:{auth:"user",permissions:["agent.fleet.deploy"],pii:[]},sideEffects:{audit:["agent.started"]}});

package/dist/node/operations/agent/stop.command.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{StabilityEnum as n}from"../../ownership.js";import{IdempotencyKeyScalar as o}from"../../shared/index.js";import{defineCommand as i}from"../operation.js";import{AGENT_DOMAIN as a,AGENT_OWNERS as s,AGENT_TAGS as r,AgentDetail as p,AgentMutationErrors as l,AgentScopeFields as c}from"./shared-schemas.js";const u=new t({name:"AgentStopInput",fields:{...c,agentId:{type:e.String_unsecure(),isOptional:!1},expectedVersion:{type:e.Int_unsecure(),isOptional:!1},idempotencyKey:{type:o,isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1},force:{type:e.Boolean(),isOptional:!0}}}),d=new t({name:"AgentStopOutput",fields:{agent:{type:p,isOptional:!1},cancelledRunIds:{type:e.String_unsecure(),isOptional:!1,isArray:!0},auditEventId:{type:e.String_unsecure(),isOptional:!1}}});export const AgentStopCommand=i({meta:{key:"agent.stop",title:"Agent Stop",version:"1.0.0",description:"Stop an ACTIVE or PAUSED agent. force=true cancels in-flight runs immediately. cancelledRunIds enumerates affected runs.",goal:"Halt an agent decisively. force=true used for emergency or cascading cancellation from workflow.",context:"Phase 0.4.A mutation. Cascading callee in SEAMS §3.3. Inbound idempotencyKey treated as authoritative. See DOMAIN_NOTES §1.9.",domain:a,owners:[...s],tags:[...r,"stop","lifecycle"],stability:n.Experimental},io:{input:u,output:d,errors:{...l}},policy:{auth:"user",permissions:["agent.fleet.deploy"],pii:[]},sideEffects:{audit:["agent.stopped"]}});