@elevasis/sdk 1.33.1 → 1.34.1

package/dist/cli.cjs

@@ -7142,14 +7142,14 @@ var require_async_iterator = __commonJS({
       };
     }
     function readAndResolve(iter) {
-      var resolve5 = iter[kLastResolve];
-      if (resolve5 !== null) {
+      var resolve6 = iter[kLastResolve];
+      if (resolve6 !== null) {
         var data = iter[kStream].read();
         if (data !== null) {
           iter[kLastPromise] = null;
           iter[kLastResolve] = null;
           iter[kLastReject] = null;
-          resolve5(createIterResult(data, false));
+          resolve6(createIterResult(data, false));
         }
       }
     }
@@ -7157,13 +7157,13 @@ var require_async_iterator = __commonJS({
       process.nextTick(readAndResolve, iter);
     }
     function wrapForNext(lastPromise, iter) {
-      return function(resolve5, reject) {
+      return function(resolve6, reject) {
         lastPromise.then(function() {
           if (iter[kEnded]) {
-            resolve5(createIterResult(void 0, true));
+            resolve6(createIterResult(void 0, true));
             return;
           }
-          iter[kHandlePromise](resolve5, reject);
+          iter[kHandlePromise](resolve6, reject);
         }, reject);
       };
     }
@@ -7183,12 +7183,12 @@ var require_async_iterator = __commonJS({
           return Promise.resolve(createIterResult(void 0, true));
         }
         if (this[kStream].destroyed) {
-          return new Promise(function(resolve5, reject) {
+          return new Promise(function(resolve6, reject) {
             process.nextTick(function() {
               if (_this[kError]) {
                 reject(_this[kError]);
               } else {
-                resolve5(createIterResult(void 0, true));
+                resolve6(createIterResult(void 0, true));
               }
             });
           });
@@ -7211,13 +7211,13 @@ var require_async_iterator = __commonJS({
       return this;
     }), _defineProperty(_Object$setPrototypeO, "return", function _return() {
       var _this2 = this;
-      return new Promise(function(resolve5, reject) {
+      return new Promise(function(resolve6, reject) {
         _this2[kStream].destroy(null, function(err) {
           if (err) {
             reject(err);
             return;
           }
-          resolve5(createIterResult(void 0, true));
+          resolve6(createIterResult(void 0, true));
         });
       });
     }), _Object$setPrototypeO), AsyncIteratorPrototype);
@@ -7239,15 +7239,15 @@ var require_async_iterator = __commonJS({
         value: stream._readableState.endEmitted,
         writable: true
       }), _defineProperty(_Object$create, kHandlePromise, {
-        value: function value(resolve5, reject) {
+        value: function value(resolve6, reject) {
           var data = iterator[kStream].read();
           if (data) {
             iterator[kLastPromise] = null;
             iterator[kLastResolve] = null;
             iterator[kLastReject] = null;
-            resolve5(createIterResult(data, false));
+            resolve6(createIterResult(data, false));
           } else {
-            iterator[kLastResolve] = resolve5;
+            iterator[kLastResolve] = resolve6;
             iterator[kLastReject] = reject;
           }
         },
@@ -7266,12 +7266,12 @@ var require_async_iterator = __commonJS({
           iterator[kError] = err;
           return;
         }
-        var resolve5 = iterator[kLastResolve];
-        if (resolve5 !== null) {
+        var resolve6 = iterator[kLastResolve];
+        if (resolve6 !== null) {
           iterator[kLastPromise] = null;
           iterator[kLastResolve] = null;
           iterator[kLastReject] = null;
-          resolve5(createIterResult(void 0, true));
+          resolve6(createIterResult(void 0, true));
         }
         iterator[kEnded] = true;
       });
@@ -7286,7 +7286,7 @@ var require_async_iterator = __commonJS({
 var require_from = __commonJS({
   "../../node_modules/.pnpm/readable-stream@3.6.2/node_modules/readable-stream/lib/internal/streams/from.js"(exports2, module2) {
     "use strict";
-    function asyncGeneratorStep(gen, resolve5, reject, _next, _throw, key, arg) {
+    function asyncGeneratorStep(gen, resolve6, reject, _next, _throw, key, arg) {
       try {
         var info = gen[key](arg);
         var value = info.value;
@@ -7295,7 +7295,7 @@ var require_from = __commonJS({
         return;
       }
       if (info.done) {
-        resolve5(value);
+        resolve6(value);
       } else {
         Promise.resolve(value).then(_next, _throw);
       }
@@ -7303,13 +7303,13 @@ var require_from = __commonJS({
     function _asyncToGenerator(fn) {
       return function() {
         var self2 = this, args = arguments;
-        return new Promise(function(resolve5, reject) {
+        return new Promise(function(resolve6, reject) {
           var gen = fn.apply(self2, args);
           function _next(value) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "next", value);
+            asyncGeneratorStep(gen, resolve6, reject, _next, _throw, "next", value);
           }
           function _throw(err) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "throw", err);
+            asyncGeneratorStep(gen, resolve6, reject, _next, _throw, "throw", err);
           }
           _next(void 0);
         });
@@ -23629,18 +23629,18 @@ var init_config = __esm({
 // src/cli/commands/om/project-layout.ts
 function assertSplitLayout(projectDir) {
   const omDir = (0, import_node_path9.join)(projectDir, "core", "config", "organization-model");
-  const missing = REQUIRED_FILES.filter((f) => !(0, import_node_fs8.existsSync)((0, import_node_path9.join)(omDir, f)));
+  const missing = REQUIRED_FILES.filter((f) => !(0, import_node_fs11.existsSync)((0, import_node_path9.join)(omDir, f)));
   if (missing.length > 0) {
     throw new Error(
       "Legacy single-file OM layout detected. Split into `core/config/organization-model/{profile.ts, systems.ts, navigation.ts}` before scaffolding."
     );
   }
 }
-var import_node_fs8, import_node_path9, REQUIRED_FILES;
+var import_node_fs11, import_node_path9, REQUIRED_FILES;
 var init_project_layout = __esm({
   "src/cli/commands/om/project-layout.ts"() {
     "use strict";
-    import_node_fs8 = require("node:fs");
+    import_node_fs11 = require("node:fs");
     import_node_path9 = require("node:path");
     REQUIRED_FILES = ["profile.ts", "systems.ts", "navigation.ts"];
   }
@@ -23656,11 +23656,11 @@ async function promptIfAbsent(value, question, options) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const prompt = options?.default ? `${question} [${options.default}]: ` : `${question}: `;
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve5(answer.trim() || (options?.default ?? ""));
+      resolve6(answer.trim() || (options?.default ?? ""));
     });
   });
 }
@@ -23741,7 +23741,7 @@ async function withSnapshotRollback(filePaths, op) {
   const snapshots = /* @__PURE__ */ new Map();
   for (const filePath of filePaths) {
     try {
-      snapshots.set(filePath, (0, import_node_fs9.readFileSync)(filePath, "utf8"));
+      snapshots.set(filePath, (0, import_node_fs12.readFileSync)(filePath, "utf8"));
     } catch {
       snapshots.set(filePath, null);
     }
@@ -23752,7 +23752,7 @@ async function withSnapshotRollback(filePaths, op) {
     for (const [filePath, snapshot] of snapshots) {
       if (snapshot !== null) {
         try {
-          (0, import_node_fs9.writeFileSync)(filePath, snapshot, "utf8");
+          (0, import_node_fs12.writeFileSync)(filePath, snapshot, "utf8");
         } catch {
         }
       }
@@ -23773,14 +23773,14 @@ function insertBeforeAnchorInContent(content, code, anchor) {
   return lines.join("\n");
 }
 async function appendBeforeAnchor(filePath, code, anchor) {
-  const content = (0, import_node_fs9.readFileSync)(filePath, "utf8");
+  const content = (0, import_node_fs12.readFileSync)(filePath, "utf8");
   const updated = insertBeforeAnchorInContent(content, code, anchor);
-  (0, import_node_fs9.writeFileSync)(filePath, updated, "utf8");
+  (0, import_node_fs12.writeFileSync)(filePath, updated, "utf8");
 }
 async function applyConstImport(systemsFilePath, importLine, fieldLine, importAnchor, fieldAnchor, newConstFilePath, newConstFileCode) {
-  (0, import_node_fs9.mkdirSync)((0, import_node_path10.dirname)(newConstFilePath), { recursive: true });
-  (0, import_node_fs9.writeFileSync)(newConstFilePath, newConstFileCode, "utf8");
-  const systemsContent = (0, import_node_fs9.readFileSync)(systemsFilePath, "utf8");
+  (0, import_node_fs12.mkdirSync)((0, import_node_path10.dirname)(newConstFilePath), { recursive: true });
+  (0, import_node_fs12.writeFileSync)(newConstFilePath, newConstFileCode, "utf8");
+  const systemsContent = (0, import_node_fs12.readFileSync)(systemsFilePath, "utf8");
   const afterImport = insertBeforeAnchorInContent(systemsContent, importLine + "\n", importAnchor);
   const lines = afterImport.split("\n");
   const fieldAnchorIndex = lines.findIndex((line) => fieldAnchor.test(line));
@@ -23790,13 +23790,13 @@ async function applyConstImport(systemsFilePath, importLine, fieldLine, importAn
     );
   }
   lines.splice(fieldAnchorIndex + 1, 0, fieldLine);
-  (0, import_node_fs9.writeFileSync)(systemsFilePath, lines.join("\n"), "utf8");
+  (0, import_node_fs12.writeFileSync)(systemsFilePath, lines.join("\n"), "utf8");
 }
-var import_node_fs9, import_node_path10;
+var import_node_fs12, import_node_path10;
 var init_splice = __esm({
   "src/cli/commands/om/splice.ts"() {
     "use strict";
-    import_node_fs9 = require("node:fs");
+    import_node_fs12 = require("node:fs");
     import_node_path10 = require("node:path");
   }
 });
@@ -24168,24 +24168,24 @@ async function scaffoldKnowledge(opts) {
     return;
   }
   const absoluteFilePath = (0, import_node_path14.join)(projectDir, relativeFilePath);
-  if ((0, import_node_fs10.existsSync)(absoluteFilePath)) {
+  if ((0, import_node_fs13.existsSync)(absoluteFilePath)) {
     process.stderr.write(
       source_default.red(`Knowledge node file already exists at \`${relativeFilePath}\`. Choose a different id.
 `)
     );
     process.exit(1);
   }
-  (0, import_node_fs10.mkdirSync)((0, import_node_path14.join)(projectDir, "core", "config", "knowledge", "nodes"), { recursive: true });
-  (0, import_node_fs10.writeFileSync)(absoluteFilePath, content, "utf8");
+  (0, import_node_fs13.mkdirSync)((0, import_node_path14.join)(projectDir, "core", "config", "knowledge", "nodes"), { recursive: true });
+  (0, import_node_fs13.writeFileSync)(absoluteFilePath, content, "utf8");
   console.log(source_default.green(`Knowledge node \`${id}\` written to \`${relativeFilePath}\``));
   console.log(source_default.yellow("Run `elevasis-sdk om:generate` to register this node."));
 }
-var import_node_path14, import_node_fs10, VALID_KINDS;
+var import_node_path14, import_node_fs13, VALID_KINDS;
 var init_scaffold_knowledge = __esm({
   "src/cli/commands/om/scaffold-knowledge.ts"() {
     "use strict";
     import_node_path14 = require("node:path");
-    import_node_fs10 = require("node:fs");
+    import_node_fs13 = require("node:fs");
     init_source();
     init_config();
     init_project_layout();
@@ -24261,7 +24261,7 @@ async function scaffoldFill(opts) {
     process.stderr.write(source_default.red("Missing gaps file. Pass --gaps <path> pointing to a conformance gap JSON file.\n"));
     process.exit(1);
   }
-  if (!(0, import_node_fs11.existsSync)(options.gaps)) {
+  if (!(0, import_node_fs14.existsSync)(options.gaps)) {
     process.stderr.write(
       source_default.red(
         `Missing gaps file. Pass --gaps <path> pointing to a conformance gap JSON file.
@@ -24273,7 +24273,7 @@ async function scaffoldFill(opts) {
   }
   let payload;
   try {
-    const raw = (0, import_node_fs11.readFileSync)(options.gaps, "utf8");
+    const raw = (0, import_node_fs14.readFileSync)(options.gaps, "utf8");
     payload = JSON.parse(raw);
   } catch {
     process.stderr.write(
@@ -24394,7 +24394,7 @@ async function scaffoldFill(opts) {
   }
   if (skippedGaps.length > 0) {
     const skippedPath = options.skipped ?? (0, import_node_path15.join)(os2.tmpdir(), `elevasis-fill-skipped-${systemPath}-${Date.now()}.json`);
-    (0, import_node_fs11.writeFileSync)(skippedPath, JSON.stringify({ systemPath, skipped: skippedGaps }, null, 2), "utf8");
+    (0, import_node_fs14.writeFileSync)(skippedPath, JSON.stringify({ systemPath, skipped: skippedGaps }, null, 2), "utf8");
     console.log(
       source_default.yellow(
         `Partial fill: ${appliedGaps.length} gap(s) applied, ${skippedGaps.length} skipped \u2014 see \`${skippedPath}\` for fields requiring manual input.`
@@ -24408,13 +24408,13 @@ async function scaffoldFill(opts) {
     )
   );
 }
-var import_node_path15, os2, import_node_fs11, import_node_child_process5;
+var import_node_path15, os2, import_node_fs14, import_node_child_process5;
 var init_scaffold_fill = __esm({
   "src/cli/commands/om/scaffold-fill.ts"() {
     "use strict";
     import_node_path15 = require("node:path");
     os2 = __toESM(require("node:os"), 1);
-    import_node_fs11 = require("node:fs");
+    import_node_fs14 = require("node:fs");
     import_node_child_process5 = require("node:child_process");
     init_source();
     init_config();
@@ -37533,16 +37533,13 @@ var OntologyKindSchema = external_exports.enum([
   "value-type",
   "property",
   "group",
-  "surface"
+  "endpoint"
 ]);
 var SYSTEM_PATH_PATTERN = "[a-z0-9][a-z0-9-]*(?:\\.[a-z0-9][a-z0-9-]*)*";
 var LOCAL_ID_PATTERN = "[a-z0-9][a-z0-9._-]*";
 var ONTOLOGY_ID_PATTERN = `^(global|${SYSTEM_PATH_PATTERN}):(${OntologyKindSchema.options.join("|")})\\/(${LOCAL_ID_PATTERN})$`;
 var ONTOLOGY_ID_REGEX = new RegExp(ONTOLOGY_ID_PATTERN);
-var OntologyIdSchema = external_exports.string().trim().min(1).max(300).regex(
-  ONTOLOGY_ID_REGEX,
-  "Ontology IDs must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>"
-);
+var OntologyIdSchema = external_exports.string().trim().min(1).max(300).regex(ONTOLOGY_ID_REGEX, "Ontology IDs must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>");
 function parseOntologyId(id) {
   const normalized = OntologyIdSchema.parse(id);
   const match = ONTOLOGY_ID_REGEX.exec(normalized);
@@ -37605,7 +37602,7 @@ var OntologySharedPropertySchema = OntologyRecordBaseSchema.extend({
 var OntologyGroupSchema = OntologyRecordBaseSchema.extend({
   members: OntologyReferenceListSchema
 });
-var OntologySurfaceTypeSchema = OntologyRecordBaseSchema.extend({
+var OntologyEndpointTypeSchema = OntologyRecordBaseSchema.extend({
   route: external_exports.string().trim().min(1).max(500).optional()
 });
 var OntologyScopeSchema = external_exports.object({
@@ -37618,7 +37615,7 @@ var OntologyScopeSchema = external_exports.object({
   valueTypes: external_exports.record(OntologyIdSchema, OntologyValueTypeSchema).default({}).optional(),
   sharedProperties: external_exports.record(OntologyIdSchema, OntologySharedPropertySchema).default({}).optional(),
   groups: external_exports.record(OntologyIdSchema, OntologyGroupSchema).default({}).optional(),
-  surfaces: external_exports.record(OntologyIdSchema, OntologySurfaceTypeSchema).default({}).optional()
+  endpoints: external_exports.record(OntologyIdSchema, OntologyEndpointTypeSchema).default({}).optional()
 }).default({});
 var DEFAULT_ONTOLOGY_SCOPE = {
   valueTypes: {
@@ -37654,7 +37651,7 @@ var SCOPE_KIND = {
   valueTypes: "value-type",
   sharedProperties: "property",
   groups: "group",
-  surfaces: "surface"
+  endpoints: "endpoint"
 };
 var SCOPE_KEYS = Object.keys(SCOPE_KIND);
 function ontologyGraphNodeId(id) {
@@ -37690,7 +37687,7 @@ function createEmptyIndex() {
     valueTypes: {},
     sharedProperties: {},
     groups: {},
-    surfaces: {}
+    endpoints: {}
   };
 }
 function sortResolvedOntologyIndex(index) {
@@ -37923,7 +37920,7 @@ var ONTOLOGY_REFERENCE_KEY_KINDS = {
   interfaceType: "interface",
   propertyType: "property",
   groupType: "group",
-  surfaceType: "surface",
+  endpointType: "endpoint",
   stepCatalog: "catalog"
 };
 var omCompilationContextCache = /* @__PURE__ */ new WeakMap();
@@ -37951,7 +37948,7 @@ function buildOmCrossRefIndexFromOntology(model, ontologyCompilation) {
     "value-type": ontologyCompilation.ontology.valueTypes,
     property: ontologyCompilation.ontology.sharedProperties,
     group: ontologyCompilation.ontology.groups,
-    surface: ontologyCompilation.ontology.surfaces
+    endpoint: ontologyCompilation.ontology.endpoints
   };
   const ontologyIds = new Set(Object.values(ontologyIndexByKind).flatMap((index) => Object.keys(index)));
   const stageIds = /* @__PURE__ */ new Set();
@@ -41180,17 +41177,38 @@ var GoogleConfigSchema = external_exports.object({
   topP: external_exports.number().min(0).max(1).optional(),
   modelOptions: GoogleOptionsSchema.optional()
 });
-var AnthropicOptionsSchema = external_exports.object({});
-var AnthropicConfigSchema = external_exports.object({
-  model: external_exports.enum(["claude-sonnet-4-5"]),
+var AnthropicOptionsSchema = external_exports.object({}).strict();
+var AnthropicStandardConfigSchema = external_exports.object({
+  model: external_exports.enum([
+    "claude-sonnet-4-6",
+    "claude-haiku-4-5-20251001",
+    "claude-haiku-4-5",
+    "claude-sonnet-4-5"
+  ]),
   provider: external_exports.literal("anthropic"),
   apiKey: external_exports.string(),
   temperature: external_exports.number().min(0).max(1).optional(),
-  maxOutputTokens: external_exports.number().min(1e3).optional(),
+  maxOutputTokens: external_exports.number().min(1e3).max(64e3).optional(),
   // Anthropic requires max_tokens
   topP: external_exports.number().min(0).max(1).optional(),
   modelOptions: AnthropicOptionsSchema.optional()
 });
+var AnthropicOpus48ConfigSchema = external_exports.object({
+  model: external_exports.literal("claude-opus-4-8"),
+  provider: external_exports.literal("anthropic"),
+  apiKey: external_exports.string(),
+  temperature: external_exports.literal(1).optional(),
+  maxOutputTokens: external_exports.number().min(1e3).max(128e3).optional(),
+  // Anthropic requires max_tokens
+  topP: external_exports.literal(1).optional(),
+  topK: external_exports.undefined().optional(),
+  top_k: external_exports.undefined().optional(),
+  modelOptions: AnthropicOptionsSchema.optional()
+});
+var AnthropicConfigSchema = external_exports.discriminatedUnion("model", [
+  AnthropicOpus48ConfigSchema,
+  AnthropicStandardConfigSchema
+]);
 var MODEL_INFO = {
   // OpenAI GPT-5 (Reasoning Models)
   "gpt-5": {
@@ -41283,6 +41301,58 @@ var MODEL_INFO = {
     configSchema: GoogleConfigSchema
   },
   // Anthropic Claude Models (direct SDK access via @anthropic-ai/sdk)
+  "claude-opus-4-8": {
+    inputCostPer1M: 500,
+    // $5.00 per 1M tokens
+    outputCostPer1M: 2500,
+    // $25.00 per 1M tokens
+    minTokens: 4e3,
+    recommendedTokens: 8e3,
+    maxTokens: 1e6,
+    // 1M context window
+    maxOutputTokens: 128e3,
+    category: "reasoning",
+    configSchema: AnthropicConfigSchema
+  },
+  "claude-sonnet-4-6": {
+    inputCostPer1M: 300,
+    // $3.00 per 1M tokens
+    outputCostPer1M: 1500,
+    // $15.00 per 1M tokens
+    minTokens: 4e3,
+    recommendedTokens: 8e3,
+    maxTokens: 1e6,
+    // 1M context window
+    maxOutputTokens: 64e3,
+    category: "standard",
+    configSchema: AnthropicConfigSchema
+  },
+  "claude-haiku-4-5-20251001": {
+    inputCostPer1M: 100,
+    // $1.00 per 1M tokens
+    outputCostPer1M: 500,
+    // $5.00 per 1M tokens
+    minTokens: 4e3,
+    recommendedTokens: 8e3,
+    maxTokens: 2e5,
+    // 200k context window
+    maxOutputTokens: 64e3,
+    category: "standard",
+    configSchema: AnthropicConfigSchema
+  },
+  "claude-haiku-4-5": {
+    inputCostPer1M: 100,
+    // $1.00 per 1M tokens
+    outputCostPer1M: 500,
+    // $5.00 per 1M tokens
+    minTokens: 4e3,
+    recommendedTokens: 8e3,
+    maxTokens: 2e5,
+    // 200k context window
+    maxOutputTokens: 64e3,
+    category: "standard",
+    configSchema: AnthropicConfigSchema
+  },
   "claude-sonnet-4-5": {
     inputCostPer1M: 300,
     // $3.00 per 1M tokens
@@ -41292,6 +41362,7 @@ var MODEL_INFO = {
     recommendedTokens: 8e3,
     maxTokens: 2e5,
     // 200k context window
+    maxOutputTokens: 64e3,
     category: "standard",
     configSchema: AnthropicConfigSchema
   }
@@ -41873,8 +41944,8 @@ function ontologyIndexForKind(index, kind) {
       return index.sharedProperties;
     case "group":
       return index.groups;
-    case "surface":
-      return index.surfaces;
+    case "endpoint":
+      return index.endpoints;
   }
 }
 function sameJson(left, right) {
@@ -45734,7 +45805,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.33.1",
+  version: "1.34.1",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -45777,8 +45848,10 @@ var package_default = {
     build: `node -e "require('fs').rmSync('dist',{recursive:true,force:true})" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --banner:js="#!/usr/bin/env node" && node scripts/verify-skill-coverage.mjs && node scripts/copy-reference-docs.mjs && node ../../scripts/monorepo/generate-reference-artifacts.js`,
     "type-check": "tsc --noEmit",
     "check-types": "pnpm type-check",
-    test: "pnpm build && node ../../scripts/monorepo/validate-reference-artifacts.js && vitest run --config vitest.bundle.config.ts",
-    "test:bundle": "pnpm test"
+    test: "pnpm test:bundle",
+    "test:source": "vitest run --config vitest.config.ts",
+    "test:dist": "pnpm build && node ../../scripts/monorepo/validate-reference-artifacts.js && vitest run --config vitest.bundle.config.ts",
+    "test:bundle": "pnpm test:source && pnpm test:dist"
   },
   dependencies: {
     "@mdx-js/mdx": "^3.1.1",
@@ -45911,7 +45984,8 @@ function extractResourceMetadata(resource, schemaWarnings) {
     version: resource.config.version,
     status: resource.config.status,
     description: resource.config.description,
-    category: resource.config.category
+    category: resource.config.category,
+    sessionCapable: resource.config.sessionCapable
   };
   if (resource.contract.inputSchema) {
     try {
@@ -46577,7 +46651,7 @@ async function pollForCompletion(resourceId, executionId, apiUrl) {
     if (interrupted) {
       return;
     }
-    await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS));
+    await new Promise((resolve6) => setTimeout(resolve6, POLL_INTERVAL_MS));
     if (interrupted) {
       return;
     }
@@ -46711,6 +46785,9 @@ function registerExecCommand(program3) {
 // src/cli/commands/resources.ts
 init_source();
 init_config();
+function getResourceType(resource) {
+  return resource.type ?? resource.resourceType;
+}
 function registerResourcesCommand(program3) {
   program3.command("resources").description("List deployed resources for your organization").option("--api-url <url>", "API URL").option("--json", "Output as JSON").action(wrapAction("resources", async (options) => {
     const apiUrl = resolveApiUrl(options.apiUrl);
@@ -46729,8 +46806,8 @@ function registerResourcesCommand(program3) {
       console.log(source_default.gray("Deploy with: elevasis-sdk deploy"));
       return;
     }
-    const workflows = data.resources.filter((r) => r.resourceType === "workflow");
-    const agents = data.resources.filter((r) => r.resourceType === "agent");
+    const workflows = data.resources.filter((r) => getResourceType(r) === "workflow");
+    const agents = data.resources.filter((r) => getResourceType(r) === "agent");
     if (workflows.length > 0) {
       console.log(source_default.yellow("Workflows:"));
       for (const w of workflows) {
@@ -46747,6 +46824,7 @@ function registerResourcesCommand(program3) {
         console.log(source_default.white(`  ${source_default.bold(a.resourceId)}`));
         if (a.name) console.log(source_default.gray(`    Name: ${a.name}`));
         if (a.description) console.log(source_default.gray(`    Description: ${a.description}`));
+        console.log(source_default.gray(`    Session capable: ${a.sessionCapable ? "yes" : "no"}`));
         console.log(source_default.gray(`    Status: ${a.status}`));
         console.log();
       }
@@ -47213,10 +47291,10 @@ init_source();
 var import_readline = require("readline");
 function confirm(message) {
   const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     rl.question(message, (answer) => {
       rl.close();
-      resolve5(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve6(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -47970,8 +48048,28 @@ Project ${id} deleted.`));
 }
 
 // src/cli/commands/project/milestones.ts
+var import_node_fs3 = require("node:fs");
 init_source();
 init_config();
+function parseChecklistOption(options) {
+  if (options.checklist !== void 0 && options.checklistFile !== void 0) {
+    process.stderr.write(
+      JSON.stringify({
+        error: "Provide only one of --checklist or --checklist-file",
+        code: "CONFLICTING_FLAGS"
+      }) + "\n"
+    );
+    process.exit(1);
+  }
+  const raw = options.checklistFile !== void 0 ? (0, import_node_fs3.readFileSync)(resolveProjectRelative(options.checklistFile), "utf8") : options.checklist;
+  if (raw === void 0) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    process.stderr.write(JSON.stringify({ error: "Checklist must be valid JSON", code: "INVALID_JSON" }) + "\n");
+    process.exit(1);
+  }
+}
 function registerMilestoneList(program3) {
   program3.command("project:milestone:list").description("List milestones for a project\n  Example: elevasis-sdk project:milestone:list --project <uuid>").requiredOption("--project <project-id>", "Project ID (UUID)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction("project:milestone:list", async (options) => {
@@ -48031,7 +48129,10 @@ Milestone created: ${m.name}`));
   );
 }
 function registerMilestoneUpdate(program3) {
-  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--description <description>", "New description").option("--due-date <date>", "New due date (ISO 8601)").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--description <description>", "New description").option("--due-date <date>", "New due date (ISO 8601)").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option(
+    "--checklist-file <path>",
+    "Read replacement checklist from a JSON file. Relative paths resolve against the project root."
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:milestone:update",
       async (id, options) => {
@@ -48040,20 +48141,12 @@ function registerMilestoneUpdate(program3) {
         if (options.status !== void 0) body.status = options.status;
         if (options.description !== void 0) body.description = options.description;
         if (options.dueDate !== void 0) body.due_date = options.dueDate;
-        if (options.checklist !== void 0) {
-          try {
-            body.checklist = JSON.parse(options.checklist);
-          } catch {
-            process.stderr.write(
-              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
-            );
-            process.exit(1);
-          }
-        }
+        const checklist = parseChecklistOption(options);
+        if (checklist !== void 0) body.checklist = checklist;
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--name, --status, --description, --due-date, --checklist)",
+              error: "At least one field must be provided (--name, --status, --description, --due-date, --checklist, --checklist-file)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -48091,8 +48184,28 @@ Milestone ${id} deleted.`));
 }
 
 // src/cli/commands/project/tasks.ts
+var import_node_fs4 = require("node:fs");
 init_source();
 init_config();
+function parseChecklistOption2(options) {
+  if (options.checklist !== void 0 && options.checklistFile !== void 0) {
+    process.stderr.write(
+      JSON.stringify({
+        error: "Provide only one of --checklist or --checklist-file",
+        code: "CONFLICTING_FLAGS"
+      }) + "\n"
+    );
+    process.exit(1);
+  }
+  const raw = options.checklistFile !== void 0 ? (0, import_node_fs4.readFileSync)(resolveProjectRelative(options.checklistFile), "utf8") : options.checklist;
+  if (raw === void 0) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    process.stderr.write(JSON.stringify({ error: "Checklist must be valid JSON", code: "INVALID_JSON" }) + "\n");
+    process.exit(1);
+  }
+}
 function registerTaskList(program3) {
   program3.command("project:task:list").description(
     "List tasks for a project\n  Example: elevasis-sdk project:task:list --project <uuid> --status in_progress"
@@ -48160,7 +48273,10 @@ function registerTaskCreate(program3) {
   ).requiredOption("--project <project-id>", "Project ID (UUID)").requiredOption("--title <title>", "Task title / name").option("--status <status>", "Status: planned | in_progress | blocked | completed | cancelled").option(
     "--type <type>",
     "Type: documentation | code | report | design | refactor | feature | bug | research | other"
-  ).option("--milestone <milestone-id>", "Milestone ID (UUID)").option("--parent <parent-task-id>", "Parent task ID (UUID) for subtasks").option("--description <description>", "Task description").option("--checklist <json>", `Checklist items as JSON array: '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).option("--milestone <milestone-id>", "Milestone ID (UUID)").option("--parent <parent-task-id>", "Parent task ID (UUID) for subtasks").option("--description <description>", "Task description").option("--checklist <json>", `Checklist items as JSON array: '[{"id":"1","label":"Step","completed":false}]'`).option(
+    "--checklist-file <path>",
+    "Read checklist items from a JSON file. Relative paths resolve against the project root."
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:task:create",
       async (options) => {
@@ -48173,16 +48289,8 @@ function registerTaskCreate(program3) {
         if (options.milestone) body.milestone_id = options.milestone;
         if (options.parent) body.parent_task_id = options.parent;
         if (options.description) body.description = options.description;
-        if (options.checklist) {
-          try {
-            body.checklist = JSON.parse(options.checklist);
-          } catch {
-            process.stderr.write(
-              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
-            );
-            process.exit(1);
-          }
-        }
+        const checklist = parseChecklistOption2(options);
+        if (checklist !== void 0) body.checklist = checklist;
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPost("/api/external/project-tasks", body, apiUrl);
         if (options.pretty) {
@@ -48203,7 +48311,10 @@ function registerTaskUpdate(program3) {
   program3.command("project:task:update <id>").description("Update a task\n  Example: elevasis-sdk project:task:update <uuid> --status completed").option("--title <title>", "New task title").option(
     "--status <status>",
     "New status: planned | in_progress | blocked | completed | cancelled | submitted | approved | rejected | revision_requested"
-  ).option("--milestone <milestone-id>", "New milestone ID (UUID)").option("--description <description>", "New description").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).option("--milestone <milestone-id>", "New milestone ID (UUID)").option("--description <description>", "New description").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option(
+    "--checklist-file <path>",
+    "Read replacement checklist from a JSON file. Relative paths resolve against the project root."
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:task:update",
       async (id, options) => {
@@ -48212,20 +48323,12 @@ function registerTaskUpdate(program3) {
         if (options.status !== void 0) body.status = options.status;
         if (options.milestone !== void 0) body.milestone_id = options.milestone;
         if (options.description !== void 0) body.description = options.description;
-        if (options.checklist !== void 0) {
-          try {
-            body.checklist = JSON.parse(options.checklist);
-          } catch {
-            process.stderr.write(
-              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
-            );
-            process.exit(1);
-          }
-        }
+        const checklist = parseChecklistOption2(options);
+        if (checklist !== void 0) body.checklist = checklist;
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--title, --status, --milestone, --description, --checklist)",
+              error: "At least one field must be provided (--title, --status, --milestone, --description, --checklist, --checklist-file)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -48652,6 +48755,15 @@ function registerProjectCommands(program3) {
 }
 
 // ../core/src/knowledge/queries.ts
+var DOMAIN_ITEM_KINDS = ["clients", "roles", "policies", "customers", "offerings", "goals"];
+var BARE_PREFIX_TO_DOMAIN = {
+  client: "clients",
+  role: "roles",
+  policy: "policies",
+  customer: "customers",
+  offering: "offerings",
+  goal: "goals"
+};
 function toGraphNodeId(omNodeId) {
   return `knowledge:${omNodeId}`;
 }
@@ -48800,11 +48912,32 @@ function parsePath(pathString) {
   if (first === "all-roles" && rest.length === 0) {
     return { mount: "all-roles", args: [] };
   }
+  if (first === "by-domain") {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-domain requires a domain argument, got: "${pathString}"`);
+    }
+    const domain2 = rest[0];
+    if (!DOMAIN_ITEM_KINDS.includes(domain2)) {
+      throw new Error(`parsePath: /by-domain unknown domain "${domain2}". Supported: ${DOMAIN_ITEM_KINDS.join(", ")}`);
+    }
+    return { mount: "by-domain", args: [domain2] };
+  }
+  if (first === "by-item") {
+    if (rest.length < 2) {
+      throw new Error(`parsePath: /by-item requires <domain>/<itemId>, got: "${pathString}"`);
+    }
+    const domain2 = rest[0];
+    if (!DOMAIN_ITEM_KINDS.includes(domain2)) {
+      throw new Error(`parsePath: /by-item unknown domain "${domain2}". Supported: ${DOMAIN_ITEM_KINDS.join(", ")}`);
+    }
+    const itemId = rest.slice(1).join("/");
+    return { mount: "by-item", args: [domain2, itemId] };
+  }
   if (segments.length === 1) {
     return { mount: "node", args: [first] };
   }
   throw new Error(
-    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /by-domain/<domain>, /by-item/<domain>/<itemId>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
   );
 }
 function omSearch(model, query, options = {}) {
@@ -48989,7 +49122,7 @@ function collectOntologyEntries(scope) {
     ["value-type", scope.valueTypes],
     ["property", scope.sharedProperties],
     ["group", scope.groups],
-    ["surface", scope.surfaces]
+    ["endpoint", scope.endpoints]
   ];
   for (const [subKind, records] of buckets) {
     if (!records) continue;
@@ -49013,12 +49146,26 @@ function collectOntologyEntries(scope) {
   return entries;
 }
 function detectKind(model, id) {
-  if (/:(object|action|event|catalog|link|interface|value-type|property|group|surface)\//.test(id)) {
+  if (/:(object|action|event|catalog|link|interface|value-type|property|group|endpoint)\//.test(id)) {
     return "ontology";
   }
   if (id.startsWith("knowledge.")) return "knowledge";
   if (id.startsWith("role.")) return "role";
   if (id.startsWith("policy.")) return "policy";
+  if (id.startsWith("item:")) {
+    const afterItem = id.slice("item:".length);
+    const colonIdx = afterItem.indexOf(":");
+    if (colonIdx > 0) {
+      const domain2 = afterItem.slice(0, colonIdx);
+      if (DOMAIN_ITEM_KINDS.includes(domain2)) return "domain-item";
+    }
+    return void 0;
+  }
+  const firstColon = id.indexOf(":");
+  if (firstColon > 0) {
+    const prefix = id.slice(0, firstColon);
+    if (prefix in BARE_PREFIX_TO_DOMAIN) return "domain-item";
+  }
   if (model.systems && getSystemByPath(model.systems, id)) return "system";
   if (model.resources?.[id]) return "resource";
   return void 0;
@@ -49051,6 +49198,8 @@ function omDescribe(model, id) {
       return describeRole(model, id);
     case "policy":
       return describePolicy(model, id);
+    case "domain-item":
+      return describeDomainItem(model, id);
   }
 }
 function describeSystem(model, path3) {
@@ -49087,7 +49236,7 @@ function describeSystem(model, path3) {
       ["value-type", ontology.valueTypes],
       ["property", ontology.sharedProperties],
       ["group", ontology.groups],
-      ["surface", ontology.surfaces]
+      ["endpoint", ontology.endpoints]
     ];
     for (const [k, records] of buckets) {
       const count = records ? Object.keys(records).length : 0;
@@ -49165,7 +49314,7 @@ function describeOntology(model, id) {
     ["value-type", "valueTypes"],
     ["property", "sharedProperties"],
     ["group", "groups"],
-    ["surface", "surfaces"]
+    ["endpoint", "endpoints"]
   ];
   const bucketKey = buckets.find((b) => b[0] === ontologyKind)?.[1];
   if (!bucketKey) return void 0;
@@ -49226,6 +49375,77 @@ function describePolicy(model, id) {
     effectKinds: (policy.actions ?? []).map((a) => a.kind)
   };
 }
+var DOMAIN_LABEL = {
+  clients: "Clients",
+  roles: "Roles",
+  policies: "Policies",
+  customers: "Customers",
+  offerings: "Offerings",
+  goals: "Goals"
+};
+var DOMAIN_GRAPH_PREFIX = {
+  clients: "client",
+  roles: "role",
+  policies: "policy",
+  customers: "customer-segment",
+  offerings: "offering",
+  goals: "goal"
+};
+function parseDomainItemRef(id) {
+  if (id.startsWith("item:")) {
+    const afterItem = id.slice("item:".length);
+    const colonIdx = afterItem.indexOf(":");
+    if (colonIdx <= 0) return void 0;
+    const domain3 = afterItem.slice(0, colonIdx);
+    const itemId2 = afterItem.slice(colonIdx + 1);
+    if (!DOMAIN_ITEM_KINDS.includes(domain3) || !itemId2) return void 0;
+    return { domain: domain3, itemId: itemId2 };
+  }
+  const firstColon = id.indexOf(":");
+  if (firstColon <= 0) return void 0;
+  const prefix = id.slice(0, firstColon);
+  const domain2 = BARE_PREFIX_TO_DOMAIN[prefix];
+  if (!domain2) return void 0;
+  const itemId = id.slice(firstColon + 1);
+  if (!itemId) return void 0;
+  return { domain: domain2, itemId };
+}
+function describeDomainItem(model, id) {
+  const parsed = parseDomainItemRef(id);
+  if (!parsed) return void 0;
+  const { domain: domain2, itemId } = parsed;
+  const collection = model[domain2];
+  const record2 = collection?.[itemId];
+  if (!record2) return void 0;
+  const name = domain2 === "clients" ? String(record2["name"] ?? itemId) : domain2 === "roles" ? String(record2["title"] ?? itemId) : domain2 === "policies" ? String(record2["label"] ?? itemId) : domain2 === "goals" ? String(record2["description"] ?? itemId) : String(record2["name"] ?? itemId);
+  const graphNodeId = `${DOMAIN_GRAPH_PREFIX[domain2]}:${itemId}`;
+  const containsParentIds = ["organization-model"];
+  const governingKnowledge = [];
+  for (const node of Object.values(model.knowledge ?? {})) {
+    const governs2 = (node.links ?? []).some((link) => link.nodeId === graphNodeId);
+    if (governs2) {
+      governingKnowledge.push({
+        id: node.id,
+        title: node.title,
+        knowledgeKind: node.kind
+      });
+    }
+  }
+  const canonicalId = `item:${domain2}:${itemId}`;
+  return {
+    kind: "domain-item",
+    id: canonicalId,
+    domain: domain2,
+    name,
+    location: {
+      domainLabel: DOMAIN_LABEL[domain2],
+      graphNodeId,
+      containsParentIds
+    },
+    record: record2,
+    governingKnowledge
+  };
+}
 
 // ../core/src/knowledge/format.ts
 function formatText(results) {
@@ -49287,6 +49507,8 @@ function formatOmDescribe(result) {
       return formatRoleDescribe(result);
     case "policy":
       return formatPolicyDescribe(result);
+    case "domain-item":
+      return formatDomainItemDescribe(result);
   }
 }
 function section(title, body) {
@@ -49409,6 +49631,31 @@ function formatPolicyDescribe(r) {
 ${appliesLines.join("\n")}` : "";
   return join5([header, effectSection, appliesSection]);
 }
+function formatDomainItemDescribe(r) {
+  const header = join5([
+    `Domain Item: ${r.id}`,
+    [
+      field("Domain", r.location.domainLabel),
+      field("Name", r.name),
+      field("Graph node", r.location.graphNodeId),
+      field("Parent nodes", r.location.containsParentIds.join(", "))
+    ].filter((s) => s.length > 0).join("\n")
+  ]);
+  const recordLines = [];
+  for (const [k, v] of Object.entries(r.record)) {
+    if (v === void 0 || v === null) continue;
+    if (typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0) continue;
+    const display = Array.isArray(v) ? v.length === 0 ? null : `[${v.slice(0, 5).join(", ")}${v.length > 5 ? `, ...+${v.length - 5}` : ""}]` : typeof v === "object" ? JSON.stringify(v).slice(0, 120) : String(v);
+    if (display === null) continue;
+    recordLines.push(`  ${k}: ${display}`);
+  }
+  const recordSection = recordLines.length ? `Record:
+${recordLines.join("\n")}` : "";
+  const govLines = r.governingKnowledge.map((g) => `  - ${g.id} [${g.knowledgeKind}] ${g.title}`);
+  const govSection = govLines.length ? `Governing knowledge:
+${govLines.join("\n")}` : "Governing knowledge:\n  (none)";
+  return join5([header, recordSection, govSection]);
+}
 
 // ../core/src/knowledge/cli-helpers.ts
 var OM_SEARCH_HIT_KINDS = ["system", "resource", "knowledge", "ontology", "role", "policy"];
@@ -49565,53 +49812,29 @@ init_config();
 // src/cli/commands/knowledge/load-org-model.ts
 var import_path3 = require("path");
 var import_fs3 = require("fs");
-var import_module2 = require("module");
 var ORG_MODEL_REL_PATH = "core/config/organization-model.ts";
-function getEsbuild2(startDir) {
-  const consumerRequire = (0, import_module2.createRequire)((0, import_path3.resolve)(startDir, "package.json"));
-  return consumerRequire("esbuild");
-}
 async function loadOrgModel(projectRoot) {
   const orgModelPath = (0, import_path3.resolve)(projectRoot, ORG_MODEL_REL_PATH);
   if (!(0, import_fs3.existsSync)(orgModelPath)) {
     return DEFAULT_ORGANIZATION_MODEL;
   }
-  let pkgDir = projectRoot;
-  while (!(0, import_fs3.existsSync)((0, import_path3.resolve)(pkgDir, "package.json"))) {
-    const parent = (0, import_path3.resolve)(pkgDir, "..");
-    if (parent === pkgDir) break;
-    pkgDir = parent;
-  }
-  let esbuild;
-  try {
-    esbuild = getEsbuild2(pkgDir);
-  } catch {
-    return DEFAULT_ORGANIZATION_MODEL;
-  }
-  const tmpOut = (0, import_path3.resolve)(projectRoot, `.elevasis-knowledge-tmp-${Date.now()}.mjs`);
   try {
-    await esbuild.build({
-      entryPoints: [orgModelPath],
-      bundle: true,
-      platform: "node",
-      format: "esm",
-      outfile: tmpOut,
-      packages: "external",
-      logLevel: "silent"
-    });
-    const fileUrl = `file:///${tmpOut.replace(/\\/g, "/")}`;
-    const mod = await import(fileUrl);
+    const mod = await loadTsModule(orgModelPath);
     const model = mod["organizationModel"] ?? mod["canonicalOrganizationModel"] ?? mod["default"];
     if (model && typeof model === "object" && "systems" in model) {
       return model;
     }
-  } catch {
-  } finally {
-    try {
-      const { unlinkSync: unlinkSync3 } = await import("fs");
-      unlinkSync3(tmpOut);
-    } catch {
-    }
+    process.stderr.write(
+      `[elevasis-sdk] loaded ${ORG_MODEL_REL_PATH} but found no organizationModel export; using empty default.
+`
+    );
+  } catch (error46) {
+    const message = error46 instanceof Error ? error46.message : String(error46);
+    process.stderr.write(
+      `[elevasis-sdk] failed to load ${ORG_MODEL_REL_PATH}: ${message}
+  Falling back to empty default model.
+`
+    );
   }
   return DEFAULT_ORGANIZATION_MODEL;
 }
@@ -49619,7 +49842,7 @@ async function loadOrgModel(projectRoot) {
 // src/cli/commands/knowledge/ls.ts
 function registerKnowledgeLs(program3) {
   program3.command("knowledge:ls <path>").alias("om:ls").description(
-    "List knowledge nodes for a Knowledge Map path\n  Examples:\n    elevasis-sdk om:ls /by-kind/playbook\n    elevasis-sdk om:ls /by-system/sales.crm\n    elevasis-sdk om:ls /by-ontology/sales.crm:object/deal\n    elevasis-sdk om:ls /by-owner/role.ops-lead\n    elevasis-sdk om:ls /graph/knowledge.outreach-playbook/governs\n    elevasis-sdk om:ls /graph/system:sales.crm/governed-by\n    elevasis-sdk om:ls /all-systems\n    elevasis-sdk om:ls /all-resources\n    elevasis-sdk om:ls /all-roles"
+    "List knowledge nodes for a Knowledge Map path\n  Examples:\n    elevasis-sdk om:ls /by-kind/playbook\n    elevasis-sdk om:ls /by-system/sales.crm\n    elevasis-sdk om:ls /by-ontology/sales.crm:object/deal\n    elevasis-sdk om:ls /by-owner/role.ops-lead\n    elevasis-sdk om:ls /graph/knowledge.outreach-playbook/governs\n    elevasis-sdk om:ls /graph/system:sales.crm/governed-by\n    elevasis-sdk om:ls /all-systems\n    elevasis-sdk om:ls /all-resources\n    elevasis-sdk om:ls /all-roles\n    elevasis-sdk om:ls /by-domain/clients\n    elevasis-sdk om:ls /by-item/clients/<uuid>"
   ).option("--json", "Print wrapped JSON envelope { path, mount, args, results }").option("--ids-only", "Print one ID per line (for piping)").action(
     wrapAction("knowledge:ls", async (pathArg, options) => {
       let parsed;
@@ -49668,6 +49891,49 @@ function registerKnowledgeLs(program3) {
         }
         return;
       }
+      if (parsed.mount === "by-domain") {
+        const domain2 = parsed.args[0];
+        const collection = model[domain2] ?? {};
+        const ids = Object.keys(collection).map((id) => `item:${domain2}:${id}`);
+        if (options.json) {
+          process.stdout.write(formatJson({ path: pathArg, parsed, results: ids }) + "\n");
+        } else if (options.idsOnly) {
+          if (ids.length > 0) process.stdout.write(ids.join("\n") + "\n");
+        } else {
+          if (ids.length === 0) {
+            process.stdout.write(`(no items in domain "${domain2}")
+`);
+          } else {
+            process.stdout.write(`Domain: ${domain2}  (${ids.length} item${ids.length === 1 ? "" : "s"})
+`);
+            for (const id of ids) process.stdout.write(`  ${id}
+`);
+          }
+        }
+        return;
+      }
+      if (parsed.mount === "by-item") {
+        const domain2 = parsed.args[0];
+        const itemId = parsed.args[1];
+        const canonicalId = `item:${domain2}:${itemId}`;
+        const result = omDescribe(model, canonicalId);
+        if (!result) {
+          process.stderr.write(
+            `knowledge:ls: no item found for "${canonicalId}".
+  Use om:ls /by-domain/${domain2} to list all items in this domain.
+`
+          );
+          process.exit(1);
+        }
+        if (options.json) {
+          process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        } else if (options.idsOnly) {
+          process.stdout.write(result.id + "\n");
+        } else {
+          process.stdout.write(formatOmDescribe(result) + "\n");
+        }
+        return;
+      }
       const graph = buildOrganizationGraph({ organizationModel: model });
       const knowledgeNodes = Object.values(model.knowledge);
       let results;
@@ -49841,11 +50107,11 @@ function registerKnowledgeSkills(program3) {
 }
 
 // src/cli/commands/knowledge/generate.ts
-var import_node_fs4 = require("node:fs");
+var import_node_fs6 = require("node:fs");
 var import_node_path5 = require("node:path");
 
 // src/knowledge-codegen.ts
-var import_node_fs3 = require("node:fs");
+var import_node_fs5 = require("node:fs");
 var import_node_path4 = require("node:path");
 function targetFromNodeId2(nodeId2) {
   const [kind, ...idParts] = nodeId2.split(":");
@@ -49864,7 +50130,7 @@ function canonicalizeKnowledgeNodeLinks(node) {
   };
 }
 function listMdxFiles(directory) {
-  return (0, import_node_fs3.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
+  return (0, import_node_fs5.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
     const path3 = (0, import_node_path4.join)(directory, entry.name);
     if (entry.isDirectory()) return listMdxFiles(path3);
     return entry.isFile() && (0, import_node_path4.extname)(entry.name) === ".mdx" ? [path3] : [];
@@ -49875,6 +50141,9 @@ function parseScalar(value) {
   const quoted = trimmed.match(/^['"]([\s\S]*)['"]$/);
   return quoted ? quoted[1] : trimmed;
 }
+function normalizeLineEndings(value) {
+  return value.replace(/\r\n/g, "\n");
+}
 function parseFrontmatter(raw, filePath) {
   const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
   if (!match) throw new Error(`[knowledge-node-codegen] Missing frontmatter in ${filePath}`);
@@ -49898,7 +50167,7 @@ function parseFrontmatter(raw, filePath) {
     }
     frontmatter[key] = values;
   }
-  return { frontmatter, body: match[2].trim() };
+  return { frontmatter, body: normalizeLineEndings(match[2]).trim() };
 }
 function assertString(frontmatter, key, filePath) {
   const value = frontmatter[key];
@@ -50062,7 +50331,7 @@ function readCommandForNode(node, cliCommand = "elevasis") {
   ];
 }
 function readKnowledgeNodeMdx(filePath) {
-  const raw = (0, import_node_fs3.readFileSync)(filePath, "utf8");
+  const raw = (0, import_node_fs5.readFileSync)(filePath, "utf8");
   const { frontmatter, body } = parseFrontmatter(raw, filePath);
   return {
     id: assertString(frontmatter, "id", filePath),
@@ -50177,8 +50446,8 @@ function generateKnowledgeNodes(options) {
     if (ids.has(node.id)) throw new Error(`[knowledge-node-codegen] Duplicate knowledge node id: ${node.id}`);
     ids.add(node.id);
   }
-  (0, import_node_fs3.mkdirSync)((0, import_node_path4.dirname)(options.outputPath), { recursive: true });
-  (0, import_node_fs3.writeFileSync)(
+  (0, import_node_fs5.mkdirSync)((0, import_node_path4.dirname)(options.outputPath), { recursive: true });
+  (0, import_node_fs5.writeFileSync)(
     options.outputPath,
     generateKnowledgeNodesTs({
       nodes,
@@ -50189,8 +50458,8 @@ function generateKnowledgeNodes(options) {
     "utf8"
   );
   if (options.knowledgeFlagsOutputPath) {
-    (0, import_node_fs3.mkdirSync)((0, import_node_path4.dirname)(options.knowledgeFlagsOutputPath), { recursive: true });
-    (0, import_node_fs3.writeFileSync)(
+    (0, import_node_fs5.mkdirSync)((0, import_node_path4.dirname)(options.knowledgeFlagsOutputPath), { recursive: true });
+    (0, import_node_fs5.writeFileSync)(
       options.knowledgeFlagsOutputPath,
       `${JSON.stringify(
         generateKnowledgeFlagRegistry(nodes, sourcePaths, {
@@ -50228,7 +50497,7 @@ function registerKnowledgeGenerate(program3) {
         projectRoot,
         options.flagsOutput ?? ".claude/registries/knowledge-flags.json"
       );
-      if (!(0, import_node_fs4.existsSync)(sourceDir)) {
+      if (!(0, import_node_fs6.existsSync)(sourceDir)) {
         process.stderr.write(`knowledge:generate: source directory not found: ${sourceDir}
 `);
         process.exitCode = 1;
@@ -50280,7 +50549,7 @@ function registerKnowledgeSearch(program3) {
 init_config();
 function registerKnowledgeDescribe(program3) {
   program3.command("knowledge:describe <nodeId>").alias("om:describe").description(
-    "Show a structured neighborhood view for any OM node id\n  (system, resource, knowledge, ontology, role, policy \u2014 auto-detected from id shape)\n  Example: elevasis-sdk om:describe sales.lead-gen\n  Example: elevasis-sdk om:describe knowledge.outreach-playbook"
+    "Show a structured neighborhood view for any OM node id\n  (system, resource, knowledge, ontology, role, policy, domain-item \u2014 auto-detected)\n  Domain items: item:<domain>:<id>  OR bare client:<uuid>, role:<id>, etc.\n  Example: elevasis-sdk om:describe sales.lead-gen\n  Example: elevasis-sdk om:describe knowledge.outreach-playbook\n  Example: elevasis-sdk om:describe item:clients:<uuid>\n  Example: elevasis-sdk om:describe client:<uuid>  (back-compat bare form)\n  Note: for portfolio/DB data (deals, lineage) use client:get <id> instead."
   ).option("--json", "Print as JSON").action(
     wrapAction("knowledge:describe", async (nodeId2, options) => {
       const projectRoot = getProjectRoot();
@@ -50288,7 +50557,11 @@ function registerKnowledgeDescribe(program3) {
       const result = omDescribe(model, nodeId2);
       if (!result) {
         process.stderr.write(
-          `knowledge:describe: no OM node found for id "${nodeId2}". Use knowledge:search (alias: om:search) to discover nodes by keyword.
+          `knowledge:describe: no OM node found for id "${nodeId2}".
+  - For domain items use: om:describe item:<domain>:<id>  (domains: clients, roles, policies, customers, offerings, goals)
+  - Bare forms also work:  om:describe client:<uuid>, om:describe role:<id>, etc.
+  - To find nodes by keyword: om:search <keyword>
+  - To list all items in a domain: om:ls /by-domain/<domain>
 `
         );
         process.exit(1);
@@ -50314,7 +50587,7 @@ function registerKnowledgeCommands(program3) {
 }
 
 // src/cli/commands/request/request.ts
-var import_node_fs5 = require("node:fs");
+var import_node_fs7 = require("node:fs");
 var import_node_path6 = require("node:path");
 init_source();
 init_config();
@@ -50379,7 +50652,7 @@ function registerRequestCommands(program3) {
         throw new Error("Provide --input <json> or --input-file <path>");
       }
       const resolvedInputFile = options.inputFile ? resolveProjectRelative(options.inputFile) : void 0;
-      const raw = resolvedInputFile ? JSON.parse((0, import_node_fs5.readFileSync)(resolvedInputFile, "utf8")) : JSON.parse(options.input);
+      const raw = resolvedInputFile ? JSON.parse((0, import_node_fs7.readFileSync)(resolvedInputFile, "utf8")) : JSON.parse(options.input);
       const parsed = CreateRequestInputSchema.safeParse(raw);
       if (!parsed.success) {
         const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
@@ -50403,7 +50676,7 @@ ${issues}`);
         const tmpDir = (0, import_node_path6.join)(getProjectRoot(), "tmp");
         if (resolvedInputFile.startsWith(tmpDir + "/") || resolvedInputFile.startsWith(tmpDir + "\\")) {
           try {
-            (0, import_node_fs5.unlinkSync)(resolvedInputFile);
+            (0, import_node_fs7.unlinkSync)(resolvedInputFile);
           } catch {
           }
         } else {
@@ -50472,7 +50745,7 @@ ${rows.length} request${rows.length === 1 ? "" : "s"}`));
 
 // src/cli/commands/ui/ui-switcher.ts
 var import_node_child_process = require("node:child_process");
-var import_node_fs6 = __toESM(require("node:fs"), 1);
+var import_node_fs8 = __toESM(require("node:fs"), 1);
 var import_node_path7 = __toESM(require("node:path"), 1);
 init_config();
 function run(command, args, cwd) {
@@ -50483,10 +50756,10 @@ function run(command, args, cwd) {
   });
 }
 function readJson(filePath) {
-  return JSON.parse(import_node_fs6.default.readFileSync(filePath, "utf8"));
+  return JSON.parse(import_node_fs8.default.readFileSync(filePath, "utf8"));
 }
 function writeJson(filePath, value) {
-  import_node_fs6.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+  import_node_fs8.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
 `);
 }
 function requireDependencies(packageJson, filePath) {
@@ -50497,7 +50770,7 @@ function requireDependencies(packageJson, filePath) {
 }
 function resolveExistingDir(label, dir) {
   const resolved = import_node_path7.default.resolve(dir);
-  if (!import_node_fs6.default.existsSync(resolved) || !import_node_fs6.default.statSync(resolved).isDirectory()) {
+  if (!import_node_fs8.default.existsSync(resolved) || !import_node_fs8.default.statSync(resolved).isDirectory()) {
     throw new Error(`${label} not found: ${resolved}`);
   }
   return resolved;
@@ -50505,7 +50778,7 @@ function resolveExistingDir(label, dir) {
 function findRepoRootFromProject(projectRoot) {
   let dir = projectRoot;
   while (true) {
-    if (import_node_fs6.default.existsSync(import_node_path7.default.join(dir, "packages", "ui", "package.json"))) return dir;
+    if (import_node_fs8.default.existsSync(import_node_path7.default.join(dir, "packages", "ui", "package.json"))) return dir;
     const parent = import_node_path7.default.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
@@ -50522,10 +50795,10 @@ function resolveUiPackageRoot(projectRoot, explicitRoot) {
   return import_node_path7.default.join(repoRoot, "packages", "ui");
 }
 function removeLocalUiTarballs(templateTmpDir) {
-  if (!import_node_fs6.default.existsSync(templateTmpDir)) return;
-  for (const entry of import_node_fs6.default.readdirSync(templateTmpDir)) {
+  if (!import_node_fs8.default.existsSync(templateTmpDir)) return;
+  for (const entry of import_node_fs8.default.readdirSync(templateTmpDir)) {
     if (entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz")) {
-      import_node_fs6.default.rmSync(import_node_path7.default.join(templateTmpDir, entry), { force: true });
+      import_node_fs8.default.rmSync(import_node_path7.default.join(templateTmpDir, entry), { force: true });
     }
   }
 }
@@ -50550,24 +50823,24 @@ function useLocalUi(options = {}) {
   const templateTmpDir = import_node_path7.default.join(projectRoot, "tmp");
   const uiPackageJsonPath = import_node_path7.default.join(uiPackageRoot, "package.json");
   const uiPackageBackupPath = import_node_path7.default.join(uiPackageRoot, "package.json.local-pack.bak");
-  if (!import_node_fs6.default.existsSync(templateUiPackageJsonPath)) {
+  if (!import_node_fs8.default.existsSync(templateUiPackageJsonPath)) {
     throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
   }
-  import_node_fs6.default.mkdirSync(templateTmpDir, { recursive: true });
+  import_node_fs8.default.mkdirSync(templateTmpDir, { recursive: true });
   removeLocalUiTarballs(templateTmpDir);
   run("pnpm", ["--filter", "@repo/ui", "build:publish"], commandRoot);
   try {
-    const raw = import_node_fs6.default.readFileSync(uiPackageJsonPath, "utf8");
-    import_node_fs6.default.writeFileSync(uiPackageBackupPath, raw);
+    const raw = import_node_fs8.default.readFileSync(uiPackageJsonPath, "utf8");
+    import_node_fs8.default.writeFileSync(uiPackageBackupPath, raw);
     writeJson(uiPackageJsonPath, prepareUiPackageForPack(JSON.parse(raw)));
     run("pnpm", ["-C", uiPackageRoot, "pack", "--pack-destination", templateTmpDir], commandRoot);
   } finally {
-    if (import_node_fs6.default.existsSync(uiPackageBackupPath)) {
-      import_node_fs6.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
-      import_node_fs6.default.rmSync(uiPackageBackupPath, { force: true });
+    if (import_node_fs8.default.existsSync(uiPackageBackupPath)) {
+      import_node_fs8.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
+      import_node_fs8.default.rmSync(uiPackageBackupPath, { force: true });
     }
   }
-  const tarballName = import_node_fs6.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
+  const tarballName = import_node_fs8.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
   if (!tarballName) {
     throw new Error(`Failed to create local @elevasis/ui tarball in ${templateTmpDir}`);
   }
@@ -50588,7 +50861,7 @@ function usePublishedUi(options = {}) {
   if (!uiVersion) {
     throw new Error("Could not determine @elevasis/ui version. Pass --version <version>.");
   }
-  if (!import_node_fs6.default.existsSync(templateUiPackageJsonPath)) {
+  if (!import_node_fs8.default.existsSync(templateUiPackageJsonPath)) {
     throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
   }
   const templateUiPackageJson = readJson(templateUiPackageJsonPath);
@@ -50614,7 +50887,7 @@ function registerUiCommands(program3) {
 }
 
 // src/cli/commands/doctor.ts
-var import_node_fs7 = require("node:fs");
+var import_node_fs9 = require("node:fs");
 var import_node_path8 = __toESM(require("node:path"), 1);
 init_source();
 init_config();
@@ -50654,7 +50927,7 @@ function registerDoctorCommand(program3) {
       process.exit(1);
     }
     const envPath2 = import_node_path8.default.join(projectRoot, ".env");
-    const envExists = (0, import_node_fs7.existsSync)(envPath2);
+    const envExists = (0, import_node_fs9.existsSync)(envPath2);
     if (!envExists) {
       fail(".env", `Not found at ${envPath2}. Create it from .env.example and fill in ELEVASIS_PLATFORM_KEY.`);
       if (isVerbose) verbose(`Checked: ${envPath2}`);
@@ -51624,6 +51897,9 @@ function registerNoteCommands(program3) {
 // src/cli/commands/agent/agent.ts
 init_source();
 init_config();
+function getResourceType2(resource) {
+  return resource.type ?? resource.resourceType;
+}
 function printJson6(value) {
   console.log(JSON.stringify(value, null, 2));
 }
@@ -51632,7 +51908,7 @@ function registerAgentList(program3) {
     wrapAction("agent:list", async (options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet("/api/external/resources", apiUrl);
-      const agents = result.resources.filter((resource) => resource.resourceType === "agent");
+      const agents = result.resources.filter((resource) => getResourceType2(resource) === "agent");
       if (options.json) {
         printJson6({ agents, total: agents.length });
         return;
@@ -51685,6 +51961,7 @@ function registerAgentCommands(program3) {
 }
 
 // src/cli/commands/session/session.ts
+var import_node_fs10 = require("node:fs");
 init_source();
 init_config();
 function printJson7(value) {
@@ -51698,8 +51975,108 @@ function endpointWithQuery6(endpoint, params) {
   const query = params.toString();
   return query ? `${endpoint}?${query}` : endpoint;
 }
+function parseJson(value, label) {
+  try {
+    return JSON.parse(value);
+  } catch (error46) {
+    const message = error46 instanceof Error ? error46.message : String(error46);
+    throw new Error(`Invalid JSON for ${label}: ${message}`);
+  }
+}
+function readJsonFile(path3, label) {
+  const resolved = resolveProjectRelative(path3);
+  return parseJson((0, import_node_fs10.readFileSync)(resolved, "utf8"), label);
+}
+function resolveTurnInput(options) {
+  if (options.input && options.inputFile) {
+    throw new Error("Use either --input or --input-file, not both.");
+  }
+  if (options.inputFile) {
+    return readJsonFile(options.inputFile, "--input-file");
+  }
+  if (options.input) {
+    return parseJson(options.input, "--input");
+  }
+  throw new Error("Provide turn input with --input <json> or --input-file <path>.");
+}
+function messagesEndpoint(sessionId, limit, cursor) {
+  const params = new URLSearchParams();
+  appendQuery6(params, "limit", limit);
+  appendQuery6(params, "cursor", cursor);
+  return endpointWithQuery6(`/api/external/sessions/${sessionId}/messages`, params);
+}
+async function fetchSessionMessages(sessionId, apiUrl, options) {
+  const fetchAll = options.all === true || options.page !== true;
+  let cursor = options.cursor;
+  let firstCursor;
+  let lastPage;
+  let pagesFetched = 0;
+  const messages = [];
+  while (true) {
+    const page = await apiGet(messagesEndpoint(sessionId, options.limit, cursor), apiUrl);
+    pagesFetched += 1;
+    if (!fetchAll) {
+      return { ...page, pagesFetched };
+    }
+    if (pagesFetched === 1) {
+      firstCursor = page.cursor;
+    }
+    messages.push(...page.messages);
+    lastPage = page;
+    if (!page.hasMore) {
+      return {
+        sessionId: page.sessionId,
+        messages,
+        limit: page.limit,
+        cursor: firstCursor,
+        nextCursor: void 0,
+        total: page.total ?? messages.length,
+        hasMore: false,
+        pagesFetched
+      };
+    }
+    if (page.nextCursor === void 0 || page.nextCursor === null) {
+      throw new Error("Messages response had hasMore=true but no nextCursor.");
+    }
+    cursor = String(page.nextCursor);
+  }
+}
+function messageText(message) {
+  const value = message.text ?? message.content;
+  if (value !== void 0) return String(value);
+  return JSON.stringify(message, null, 2);
+}
+function printMessage(message) {
+  const index = message.messageIndex === void 0 ? "" : `#${message.messageIndex}`;
+  const role = message.role ?? message.messageType ?? "message";
+  const turn = message.turnNumber === void 0 ? "" : ` turn ${message.turnNumber}`;
+  const heading = [index, role + turn].filter(Boolean).join(" ");
+  console.log(source_default.white(`  ${heading}`));
+  for (const line of messageText(message).split(/\r?\n/)) {
+    console.log(source_default.gray(`    ${line}`));
+  }
+}
+function registerSessionCreate(program3) {
+  program3.command("session:create <resourceId>").description("Create a multi-turn agent session").option("--user-id <id>", "User ID for the session").option("--metadata <json>", "Session metadata as JSON").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
+    wrapAction("session:create", async (resourceId, options) => {
+      const apiUrl = resolveApiUrl(options.apiUrl);
+      const body = { resourceId };
+      if (options.userId) body.userId = options.userId;
+      if (options.metadata) body.metadata = parseJson(options.metadata, "--metadata");
+      const session = await apiPost("/api/external/sessions", body, apiUrl);
+      if (options.json) {
+        printJson7(session);
+        return;
+      }
+      console.log(source_default.green(`Created session ${session.sessionId}.`));
+      console.log(source_default.gray(`  Agent:   ${session.resourceId}`));
+      console.log(source_default.gray(`  Turns:   ${session.turnCount}`));
+      console.log(source_default.gray(`  Created: ${new Date(session.createdAt).toLocaleString()}`));
+    })
+  );
+}
 function registerSessionList(program3) {
-  program3.command("session:list").description("List active multi-turn agent sessions").option("--resource-id <id>", "Filter by agent resource ID").option("--user-id <id>", "Filter by user ID").option("--limit <limit>", "Maximum number of sessions to return").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
+  program3.command("session:list").description("List multi-turn agent sessions").option("--resource-id <id>", "Filter by agent resource ID").option("--user-id <id>", "Filter by user ID").option("--limit <limit>", "Maximum number of sessions to return").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
     wrapAction("session:list", async (options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const params = new URLSearchParams();
@@ -51711,16 +52088,16 @@ function registerSessionList(program3) {
         printJson7(result);
         return;
       }
-      const activeSessions = result.sessions.filter((session) => !session.isEnded);
-      if (activeSessions.length === 0) {
-        console.log(source_default.yellow("No active sessions found."));
+      if (result.sessions.length === 0) {
+        console.log(source_default.yellow("No sessions found."));
         return;
       }
-      console.log(source_default.cyan(`Sessions (${activeSessions.length} active of ${result.total}):`));
-      for (const session of activeSessions) {
+      console.log(source_default.cyan(`Sessions (${result.sessions.length} of ${result.total}):`));
+      for (const session of result.sessions) {
         console.log(source_default.white(`  ${source_default.bold(session.sessionId)}`));
         if (session.title) console.log(source_default.gray(`    Title: ${session.title}`));
         console.log(source_default.gray(`    Agent: ${session.resourceId}`));
+        console.log(source_default.gray(`    Status: ${session.isEnded ? "ended" : "active"}`));
         console.log(source_default.gray(`    Turns: ${session.turnCount}`));
         console.log(source_default.gray(`    Updated: ${new Date(session.updatedAt).toLocaleString()}`));
         console.log();
@@ -51729,7 +52106,7 @@ function registerSessionList(program3) {
   );
 }
 function registerSessionGet(program3) {
-  program3.command("session:get <id>").description("Get session details and transcript").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
+  program3.command("session:get <id>").description("Get session details").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
     wrapAction("session:get", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const session = await apiGet(`/api/external/sessions/${id}`, apiUrl);
@@ -51749,11 +52126,57 @@ function registerSessionGet(program3) {
     })
   );
 }
+function registerSessionTurn(program3) {
+  program3.command("session:turn <id>").description("Execute a turn in an active agent session").option("-i, --input <json>", "Turn input as JSON").option("-f, --input-file <path>", "Read turn input from a JSON file").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
+    wrapAction("session:turn", async (id, options) => {
+      const apiUrl = resolveApiUrl(options.apiUrl);
+      const input = resolveTurnInput(options);
+      const result = await apiPost(`/api/external/sessions/${id}/turns`, { input }, apiUrl);
+      if (options.json) {
+        printJson7(result);
+        return;
+      }
+      console.log(source_default.green(`Turn ${result.turnNumber} complete.`));
+      console.log(source_default.gray(`  Session ID:   ${result.sessionId}`));
+      console.log(source_default.gray(`  Execution ID: ${result.executionId}`));
+      if (result.duration !== void 0) console.log(source_default.gray(`  Duration:     ${result.duration}ms`));
+      console.log();
+      console.log(source_default.green("Output:"));
+      console.log(JSON.stringify(result.output, null, 2));
+    })
+  );
+}
+function registerSessionMessages(program3) {
+  program3.command("session:messages <id>").description("Export session transcript messages").option("--limit <limit>", "Messages per API page").option("--cursor <cursor>", "Message_index cursor to start after").option("--page", "Fetch one API page instead of the full transcript").option("--all", "Fetch all pages (default)").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
+    wrapAction("session:messages", async (id, options) => {
+      const apiUrl = resolveApiUrl(options.apiUrl);
+      const result = await fetchSessionMessages(id, apiUrl, options);
+      if (options.json) {
+        printJson7(result);
+        return;
+      }
+      const total = result.total === void 0 ? result.messages.length : result.total;
+      console.log(source_default.cyan(`Messages (${result.messages.length} of ${total}, ${result.pagesFetched} page(s)):`));
+      if (result.messages.length === 0) {
+        console.log(source_default.yellow("No messages found."));
+        return;
+      }
+      for (const message of result.messages) {
+        printMessage(message);
+        console.log();
+      }
+    })
+  );
+}
 function registerSessionEnd(program3) {
-  program3.command("session:end <id>").description("Terminate an active agent session").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
+  program3.command("session:end <id>").description("End an active agent session").option("--api-url <url>", "API base URL").option("--json", "Output as JSON").action(
     wrapAction("session:end", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
-      const result = await apiDelete(`/api/external/sessions/${id}`, apiUrl);
+      const result = await apiPost(
+        `/api/external/sessions/${id}/end`,
+        {},
+        apiUrl
+      );
       if (options.json) {
         printJson7(result);
         return;
@@ -51765,8 +52188,11 @@ function registerSessionEnd(program3) {
 
 // src/cli/commands/session/index.ts
 function registerSessionCommands(program3) {
+  registerSessionCreate(program3);
   registerSessionList(program3);
   registerSessionGet(program3);
+  registerSessionTurn(program3);
+  registerSessionMessages(program3);
   registerSessionEnd(program3);
 }
 
@@ -51877,6 +52303,52 @@ function registerSkillScaffoldCommand(program3) {
   );
 }
 
+// src/cli/json-file-argv.ts
+var import_node_fs15 = require("node:fs");
+var import_node_path16 = require("node:path");
+init_config();
+var JSON_FILE_PREFIX = "@json:";
+var JsonFileArgError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "JsonFileArgError";
+  }
+};
+function resolveJsonFilePath(path3, options) {
+  if (path3.trim() === "") {
+    throw new JsonFileArgError("@json: requires a file path", "EMPTY_JSON_FILE_REF");
+  }
+  if ((0, import_node_path16.isAbsolute)(path3)) return path3;
+  const cwd = options.cwd ?? process.cwd();
+  const projectRoot = (options.findProjectRoot ?? tryFindProjectRoot)(cwd);
+  return (0, import_node_path16.resolve)(projectRoot ?? cwd, path3);
+}
+function readJsonFileReference(ref, options) {
+  const relativeOrAbsolutePath = ref.slice(JSON_FILE_PREFIX.length);
+  const resolvedPath = resolveJsonFilePath(relativeOrAbsolutePath, options);
+  const raw = (options.readFile ?? ((path3) => (0, import_node_fs15.readFileSync)(path3, "utf8")))(resolvedPath);
+  try {
+    JSON.parse(raw);
+  } catch {
+    throw new JsonFileArgError(`@json file must contain valid JSON: ${relativeOrAbsolutePath}`, "INVALID_JSON_FILE");
+  }
+  return raw;
+}
+function expandArg(arg, options) {
+  if (arg.startsWith(JSON_FILE_PREFIX)) {
+    return readJsonFileReference(arg, options);
+  }
+  const equalsRefIndex = arg.indexOf(`=${JSON_FILE_PREFIX}`);
+  if (equalsRefIndex === -1) return arg;
+  const prefix = arg.slice(0, equalsRefIndex + 1);
+  const ref = arg.slice(equalsRefIndex + 1);
+  return `${prefix}${readJsonFileReference(ref, options)}`;
+}
+function expandJsonFileArgs(args, options = {}) {
+  return args.map((arg) => expandArg(arg, options));
+}
+
 // src/cli/index.ts
 init_config();
 var PREFLIGHT_SKIP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
@@ -51962,9 +52434,12 @@ Commands:
   elevasis-sdk schedule:create --name <name> ...    Create a task schedule
   elevasis-sdk agent:list                           List deployed agents
   elevasis-sdk agent:get <id>                       Get agent metadata and OM linkage
-  elevasis-sdk session:list                         List active agent sessions
-  elevasis-sdk session:get <id>                     Get session details and transcript
-  elevasis-sdk session:end <id>                     Terminate an active agent session
+  elevasis-sdk session:create <resourceId>          Create an agent session
+  elevasis-sdk session:turn <id> -f tmp/turn.json   Execute a session turn
+  elevasis-sdk session:messages <id>                Export session transcript messages
+  elevasis-sdk session:list                         List agent sessions
+  elevasis-sdk session:get <id>                     Get session details
+  elevasis-sdk session:end <id>                     End an active agent session
   elevasis-sdk acquisition:list:list                 List acquisition lists
   elevasis-sdk acquisition:deal:list                 List acquisition deals
   elevasis-sdk knowledge:generate                   Generate knowledge nodes from MDX files
@@ -52012,7 +52487,15 @@ registerCliCatalogCommand(program2);
 registerOmScaffoldCommands(program2);
 registerSkillScaffoldCommand(program2);
 registerSkillCheckCoverageCommand(program2);
-program2.parse();
+try {
+  program2.parse(expandJsonFileArgs(process.argv), { from: "node" });
+} catch (error46) {
+  if (error46 instanceof JsonFileArgError) {
+    process.stderr.write(JSON.stringify({ error: error46.message, code: error46.code }) + "\n");
+    process.exit(1);
+  }
+  throw error46;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getProjectRoot