@promptowl/contextnest-community 1.24.0 → 1.25.0

package/dist/{chunk-YVMSM7LS.js → chunk-LHWOJPFE.js}

@@ -31,6 +31,12 @@ var ValidationError = class extends AppError {
     this.name = "ValidationError";
   }
 };
+var PayloadTooLargeError = class extends AppError {
+  constructor(message) {
+    super(413, message);
+    this.name = "PayloadTooLargeError";
+  }
+};
 var ConflictError = class extends AppError {
   constructor(message) {
     super(409, message);
@@ -61,6 +67,7 @@ export {
   ForbiddenError,
   UnauthorizedError,
   ValidationError,
+  PayloadTooLargeError,
   ConflictError,
   LockedError,
   VaultBusyError,

package/dist/{chunk-ZTT4U4NE.js → chunk-TI7HMP64.js}

@@ -2,13 +2,88 @@ import {
   buildTitleMap,
   insertOrReplace,
   nowExpr
-} from "./chunk-KIAAEHWL.js";
+} from "./chunk-7FROMOZM.js";
+import {
+  ValidationError
+} from "./chunk-LHWOJPFE.js";
 import {
   getDb
-} from "./chunk-LA3VTQ22.js";
+} from "./chunk-JDAOA5KP.js";
 
 // src/governance/version-service.ts
 import { createHash } from "crypto";
+
+// src/shared/client-metadata.ts
+import {
+  clientField,
+  clientMetadataSchema,
+  CLIENT_METADATA_MAX_VALUE_LENGTH
+} from "@promptowl/contextnest-engine/api";
+import { z } from "zod";
+var clientToolField = {
+  client: z.any().optional().describe(clientField.client.description ?? "")
+};
+function boundedValue(raw) {
+  const cut = raw.slice(0, CLIENT_METADATA_MAX_VALUE_LENGTH);
+  const last = cut.charCodeAt(cut.length - 1);
+  return last >= 55296 && last <= 56319 ? cut.slice(0, -1) : cut;
+}
+function orAbsent(value) {
+  return Object.keys(value).length > 0 ? value : void 0;
+}
+function parseClientMetadata(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  const parsed = clientMetadataSchema.safeParse(raw);
+  if (!parsed.success) {
+    const detail = parsed.error.issues.map((i) => i.path.length ? `${i.path.join(".")}: ${i.message}` : i.message).join("; ");
+    throw new ValidationError(`Invalid client metadata \u2014 ${detail}`);
+  }
+  return orAbsent(parsed.data);
+}
+function mergeClient(derived, supplied) {
+  return orAbsent({ ...derived, ...supplied });
+}
+function derivedClient(c, connection) {
+  if (process.env.CONTEXTNEST_NO_ATTRIBUTION === "1") return {};
+  const agent = process.env.CONTEXTNEST_AGENT || connection?.agent || c.get("apiKeyLabel") || "";
+  const session = process.env.CONTEXTNEST_SESSION_ID || connection?.session_id || c.req.header("Mcp-Session-Id") || "";
+  return {
+    // Truncated to the engine's bound, not rejected: a derived value must never
+    // be the reason an otherwise valid call fails validation.
+    ...agent ? { agent: boundedValue(String(agent)) } : {},
+    ...session ? { session_id: boundedValue(String(session)) } : {}
+  };
+}
+function connectionClient(server) {
+  const name = server.server.getClientVersion()?.name;
+  const sessionId = server.server.transport?.sessionId;
+  return {
+    ...name ? { agent: name } : {},
+    ...sessionId ? { session_id: sessionId } : {}
+  };
+}
+function attributeRequest(c, supplied, connection) {
+  const client = mergeClient(
+    derivedClient(c, connection),
+    parseClientMetadata(supplied)
+  );
+  if (client) c.set("clientMetadata", client);
+  return client;
+}
+function serializeClient(value) {
+  return value ? JSON.stringify(value) : null;
+}
+function deserializeClient(raw) {
+  if (typeof raw !== "string" || !raw) return void 0;
+  try {
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? orAbsent(parsed) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/governance/version-service.ts
 function hashContent(content) {
   return createHash("sha256").update(content).digest("hex");
 }
@@ -20,8 +95,8 @@ async function createVersion(params) {
   const db = getDb();
   const contentHash = hashContent(params.content);
   await db.run(
-    `INSERT INTO node_versions (nest_id, node_id, version, content_hash, author, status, change_note, tags_json)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+    `INSERT INTO node_versions (nest_id, node_id, version, content_hash, author, status, change_note, tags_json, client_json)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
     [
       params.nestId,
       params.nodeId,
@@ -30,7 +105,8 @@ async function createVersion(params) {
       params.author,
       params.status,
       params.changeNote || null,
-      params.tags ? JSON.stringify(params.tags) : null
+      params.tags ? JSON.stringify(params.tags) : null,
+      serializeClient(params.client)
     ]
   );
   return {
@@ -39,7 +115,8 @@ async function createVersion(params) {
     editedBy: params.author,
     editedAt: (/* @__PURE__ */ new Date()).toISOString(),
     changeNote: params.changeNote,
-    status: params.status
+    status: params.status,
+    client: params.client
   };
 }
 async function upsertVersion(params) {
@@ -47,13 +124,13 @@ async function upsertVersion(params) {
   const contentHash = hashContent(params.content);
   const sql = insertOrReplace(
     db,
-    `INSERT INTO node_versions (nest_id, node_id, version, content_hash, author, status, change_note, tags_json)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+    `INSERT INTO node_versions (nest_id, node_id, version, content_hash, author, status, change_note, tags_json, client_json)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
     ["nest_id", "node_id", "version"],
     // Reset created_at on conflict too: SQLite's INSERT OR REPLACE deletes+
     // reinserts (created_at → now), so mirror that on Postgres — otherwise a
     // draft edited in place would keep its original (import-time) "edited at".
-    `content_hash = excluded.content_hash, author = excluded.author, status = excluded.status, change_note = excluded.change_note, tags_json = excluded.tags_json, created_at = ${nowExpr(db)}`
+    `content_hash = excluded.content_hash, author = excluded.author, status = excluded.status, change_note = excluded.change_note, tags_json = excluded.tags_json, client_json = excluded.client_json, created_at = ${nowExpr(db)}`
   );
   await db.run(sql, [
     params.nestId,
@@ -63,7 +140,8 @@ async function upsertVersion(params) {
     params.author,
     params.status,
     params.changeNote || null,
-    params.tags ? JSON.stringify(params.tags) : null
+    params.tags ? JSON.stringify(params.tags) : null,
+    serializeClient(params.client)
   ]);
   return {
     version: params.version,
@@ -71,7 +149,8 @@ async function upsertVersion(params) {
     editedBy: params.author,
     editedAt: (/* @__PURE__ */ new Date()).toISOString(),
     changeNote: params.changeNote,
-    status: params.status
+    status: params.status,
+    client: params.client
   };
 }
 async function getVersions(nestId, nodeId) {
@@ -354,11 +433,19 @@ function rowToVersion(row) {
     editedBy: row.author,
     editedAt: row.created_at,
     changeNote: row.change_note || void 0,
-    status: row.status
+    status: row.status,
+    client: deserializeClient(row.client_json)
   };
 }
 
 export {
+  clientToolField,
+  parseClientMetadata,
+  mergeClient,
+  connectionClient,
+  attributeRequest,
+  serializeClient,
+  deserializeClient,
   hashContent,
   SYSTEM_AUTHOR_PREFIX,
   systemAuthor,

package/dist/{client-KEY4PYJH.js → client-D44ZHDTJ.js}

@@ -2,7 +2,7 @@ import {
   getDb,
   initDb,
   resetDb
-} from "./chunk-LA3VTQ22.js";
+} from "./chunk-JDAOA5KP.js";
 import "./chunk-YB3LKF7U.js";
 export {
   getDb,

package/dist/{engine-S3QBQ7LH.js → engine-TER6FDBP.js}

@@ -2,9 +2,9 @@ import {
   engineApi,
   engineCache,
   opContext
-} from "./chunk-KIAAEHWL.js";
-import "./chunk-YVMSM7LS.js";
-import "./chunk-LA3VTQ22.js";
+} from "./chunk-7FROMOZM.js";
+import "./chunk-LHWOJPFE.js";
+import "./chunk-JDAOA5KP.js";
 import "./chunk-YB3LKF7U.js";
 import "./chunk-FRQJWGN3.js";
 export {

package/dist/{external-edit-service-6FNFPOJJ.js → external-edit-service-CAGENHDJ.js}

@@ -11,10 +11,10 @@ import {
   scanNestForDrift,
   startDriftScanner,
   stopDriftScanner
-} from "./chunk-XUIWAWDO.js";
-import "./chunk-KIAAEHWL.js";
-import "./chunk-YVMSM7LS.js";
-import "./chunk-LA3VTQ22.js";
+} from "./chunk-32SZCH36.js";
+import "./chunk-7FROMOZM.js";
+import "./chunk-LHWOJPFE.js";
+import "./chunk-JDAOA5KP.js";
 import "./chunk-YB3LKF7U.js";
 import "./chunk-FRQJWGN3.js";
 export {

package/dist/{grants-service-UT3EQ3R7.js → grants-service-2OTFS7EH.js}

@@ -6,9 +6,9 @@ import {
   listGrants,
   listUserGrants,
   resolveNodeGrant
-} from "./chunk-I3CSD6CK.js";
-import "./chunk-YVMSM7LS.js";
-import "./chunk-LA3VTQ22.js";
+} from "./chunk-KPGNZLZL.js";
+import "./chunk-LHWOJPFE.js";
+import "./chunk-JDAOA5KP.js";
 import "./chunk-YB3LKF7U.js";
 export {
   createGrant,