@case-framework/survey-assistant 0.7.0 → 0.8.0

package/dist/storage-postgres.mjs

@@ -1,4 +1,4 @@
-import { u as SurveyAssistantRequestError } from "./request-guardrails-TmgQtqp4.mjs";
+import { u as SurveyAssistantRequestError } from "./request-guardrails-C0ugBOp0.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import { OBSERVATIONAL_MEMORY_TABLE_SCHEMA } from "@mastra/core/storage";
 import { PostgresStore } from "@mastra/pg";
@@ -6,7 +6,7 @@ import { PostgresStore } from "@mastra/pg";
 const OBSERVATIONAL_MEMORY_TABLE = "mastra_observational_memory";
 const THREAD_DOCUMENTS_TABLE = "survey_assistant_thread_documents";
 const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENTS_PER_THREAD = 100;
-const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENT_BYTES_PER_THREAD = 200 * 1024 * 1024;
+const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENT_BYTES_PER_THREAD = 209715200;
 const quoteIdentifier = (value) => `"${value.replaceAll("\"", "\"\"")}"`;
 const postgresType = (column) => {
 	switch (column.type) {
@@ -91,7 +91,7 @@ const createSurveyAssistantPostgresThreadDocumentRepository = ({ getStorage, max
 		async put({ bytes, data, mediaType, name, resourceId, threadId }) {
 			const storage = await getStorage();
 			const contentHash = createHash("sha256").update(data).digest("hex");
-			return toThreadDocument(await storage.db.tx(async (transaction) => {
+			const row = await storage.db.tx(async (transaction) => {
 				await transaction.none("SELECT pg_advisory_xact_lock(hashtext($1), hashtext($2))", [resourceId, threadId]);
 				const existing = await transaction.oneOrNone(`SELECT id, name, media_type, byte_size, content_hash, created_at FROM ${tableName}
            WHERE resource_id = $1 AND thread_id = $2 AND content_hash = $3`, [
@@ -118,7 +118,8 @@ const createSurveyAssistantPostgresThreadDocumentRepository = ({ getStorage, max
 					contentHash,
 					data
 				]);
-			}));
+			});
+			return toThreadDocument(row);
 		},
 		async list({ resourceId, threadId }) {
 			return (await (await getStorage()).db.manyOrNone(`SELECT id, name, media_type, byte_size, content_hash, created_at

package/dist/storage-postgres.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-postgres.mjs","names":[],"sources":["../src/storage/postgres.ts"],"sourcesContent":["import { OBSERVATIONAL_MEMORY_TABLE_SCHEMA, type StorageColumn } from \"@mastra/core/storage\";\nimport { PostgresStore, type PostgresStoreConfig } from \"@mastra/pg\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { SurveyAssistantRequestError } from \"../server/request-guardrails\";\nimport type {\n  SurveyAssistantThreadDocument,\n  SurveyAssistantThreadDocumentRepository,\n} from \"../server/thread-documents\";\n\nconst OBSERVATIONAL_MEMORY_TABLE = \"mastra_observational_memory\";\nconst THREAD_DOCUMENTS_TABLE = \"survey_assistant_thread_documents\";\nexport const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENTS_PER_THREAD = 100;\nexport const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENT_BYTES_PER_THREAD = 200 * 1024 * 1024;\n\nconst quoteIdentifier = (value: string) => `\"${value.replaceAll('\"', '\"\"')}\"`;\n\nconst postgresType = (column: StorageColumn) => {\n  switch (column.type) {\n    case \"text\":\n      return \"TEXT\";\n    case \"timestamp\":\n      return \"TIMESTAMP\";\n    case \"jsonb\":\n      return \"JSONB\";\n    case \"integer\":\n      return \"INTEGER\";\n    case \"float\":\n      return \"DOUBLE PRECISION\";\n    case \"bigint\":\n      return \"BIGINT\";\n    case \"boolean\":\n      return \"BOOLEAN\";\n    case \"uuid\":\n      return \"UUID\";\n  }\n};\n\nconst migrationDefault = (column: StorageColumn) => {\n  switch (column.type) {\n    case \"boolean\":\n      return \"FALSE\";\n    case \"integer\":\n    case \"bigint\":\n    case \"float\":\n      return \"0\";\n    case \"jsonb\":\n      return \"'{}'::jsonb\";\n    case \"timestamp\":\n      return \"NOW()\";\n    case \"text\":\n      return \"''\";\n    case \"uuid\":\n      return \"gen_random_uuid()\";\n  }\n};\n\nconst columnSql = (name: string, column: StorageColumn, includeMigrationDefault = false) => {\n  const constraints = [\n    column.primaryKey ? \"PRIMARY KEY\" : undefined,\n    column.nullable === false ? \"NOT NULL\" : undefined,\n    includeMigrationDefault && column.nullable === false\n      ? `DEFAULT ${migrationDefault(column)}`\n      : undefined,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n  return `${quoteIdentifier(name)} ${postgresType(column)}${constraints ? ` ${constraints}` : \"\"}`;\n};\n\nconst ensureObservationalMemorySchema = async (storage: PostgresStore, schemaName: string) => {\n  const tableSchema = OBSERVATIONAL_MEMORY_TABLE_SCHEMA[OBSERVATIONAL_MEMORY_TABLE];\n  if (!tableSchema) throw new Error(\"Mastra observational memory schema is unavailable.\");\n\n  const tableName = `${quoteIdentifier(schemaName)}.${quoteIdentifier(OBSERVATIONAL_MEMORY_TABLE)}`;\n  const columns = Object.entries(tableSchema).flatMap(([name, column]) => [\n    columnSql(name, column),\n    ...(column.type === \"timestamp\"\n      ? [`${quoteIdentifier(`${name}Z`)} TIMESTAMPTZ DEFAULT NOW()`]\n      : []),\n  ]);\n\n  await storage.db.none(`CREATE TABLE IF NOT EXISTS ${tableName} (${columns.join(\", \")})`);\n  for (const [name, column] of Object.entries(tableSchema)) {\n    await storage.db.none(\n      `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${columnSql(name, column, true)}`,\n    );\n    if (column.type === \"timestamp\") {\n      await storage.db.none(\n        `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${quoteIdentifier(`${name}Z`)} TIMESTAMPTZ DEFAULT NOW()`,\n      );\n    }\n  }\n  await storage.db.none(\n    `CREATE INDEX IF NOT EXISTS idx_om_lookup_key ON ${tableName} (${quoteIdentifier(\"lookupKey\")})`,\n  );\n};\n\nconst ensureThreadDocumentsSchema = async (storage: PostgresStore, schemaName: string) => {\n  const tableName = `${quoteIdentifier(schemaName)}.${quoteIdentifier(THREAD_DOCUMENTS_TABLE)}`;\n  await storage.db.none(`\n    CREATE TABLE IF NOT EXISTS ${tableName} (\n      id TEXT PRIMARY KEY,\n      resource_id TEXT NOT NULL,\n      thread_id TEXT NOT NULL,\n      name TEXT NOT NULL,\n      media_type TEXT NOT NULL,\n      byte_size INTEGER NOT NULL,\n      content_hash TEXT NOT NULL,\n      data BYTEA NOT NULL,\n      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n      UNIQUE (resource_id, thread_id, content_hash)\n    )\n  `);\n  await storage.db.none(\n    `CREATE INDEX IF NOT EXISTS idx_survey_assistant_thread_documents_thread ON ${tableName} (resource_id, thread_id, created_at)`,\n  );\n};\n\nexport interface InitializeSurveyAssistantPostgresStorageOptions {\n  ensureObservationalMemory?: boolean;\n  schemaName?: string;\n}\n\nexport const initializeSurveyAssistantPostgresStorage = async (\n  storage: PostgresStore,\n  {\n    ensureObservationalMemory = true,\n    schemaName = \"public\",\n  }: InitializeSurveyAssistantPostgresStorageOptions = {},\n) => {\n  await storage.init();\n  if (ensureObservationalMemory) await ensureObservationalMemorySchema(storage, schemaName);\n  await ensureThreadDocumentsSchema(storage, schemaName);\n  return storage;\n};\n\nconst toThreadDocument = (row: {\n  id: string;\n  name: string;\n  media_type: string;\n  byte_size: number;\n  content_hash: string;\n  created_at: Date | string;\n}): SurveyAssistantThreadDocument => ({\n  id: row.id,\n  name: row.name,\n  mediaType: row.media_type,\n  bytes: row.byte_size,\n  contentHash: row.content_hash,\n  createdAt: new Date(row.created_at).toISOString(),\n});\n\nexport interface CreateSurveyAssistantPostgresThreadDocumentRepositoryOptions {\n  getStorage(): PostgresStore | Promise<PostgresStore>;\n  maxStoredAttachmentsPerThread?: number;\n  maxStoredBytesPerThread?: number;\n  schemaName?: string;\n}\n\nexport const createSurveyAssistantPostgresThreadDocumentRepository = ({\n  getStorage,\n  maxStoredAttachmentsPerThread = SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENTS_PER_THREAD,\n  maxStoredBytesPerThread = SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENT_BYTES_PER_THREAD,\n  schemaName = \"public\",\n}: CreateSurveyAssistantPostgresThreadDocumentRepositoryOptions): SurveyAssistantThreadDocumentRepository => {\n  if (\n    !Number.isSafeInteger(maxStoredAttachmentsPerThread) ||\n    maxStoredAttachmentsPerThread <= 0 ||\n    !Number.isSafeInteger(maxStoredBytesPerThread) ||\n    maxStoredBytesPerThread <= 0\n  ) {\n    throw new Error(\"Survey assistant stored attachment limits must be positive integers.\");\n  }\n  const tableName = `${quoteIdentifier(schemaName)}.${quoteIdentifier(THREAD_DOCUMENTS_TABLE)}`;\n  return {\n    async put({ bytes, data, mediaType, name, resourceId, threadId }) {\n      const storage = await getStorage();\n      const contentHash = createHash(\"sha256\").update(data).digest(\"hex\");\n      const row = await storage.db.tx(async (transaction) => {\n        await transaction.none(\"SELECT pg_advisory_xact_lock(hashtext($1), hashtext($2))\", [\n          resourceId,\n          threadId,\n        ]);\n        const existing = await transaction.oneOrNone(\n          `SELECT id, name, media_type, byte_size, content_hash, created_at FROM ${tableName}\n           WHERE resource_id = $1 AND thread_id = $2 AND content_hash = $3`,\n          [resourceId, threadId, contentHash],\n        );\n        if (existing) return existing;\n\n        const usage = await transaction.one<{ count: string; bytes: string }>(\n          `SELECT COUNT(*) AS count, COALESCE(SUM(byte_size), 0) AS bytes FROM ${tableName}\n           WHERE resource_id = $1 AND thread_id = $2`,\n          [resourceId, threadId],\n        );\n        if (Number(usage.count) >= maxStoredAttachmentsPerThread) {\n          throw new SurveyAssistantRequestError(\n            `A chat can contain up to ${maxStoredAttachmentsPerThread} stored attachments.`,\n          );\n        }\n        if (Number(usage.bytes) + bytes > maxStoredBytesPerThread) {\n          throw new SurveyAssistantRequestError(\n            \"The attachments stored for this chat are too large in total.\",\n          );\n        }\n\n        return transaction.one(\n          `INSERT INTO ${tableName}\n            (id, resource_id, thread_id, name, media_type, byte_size, content_hash, data)\n           VALUES\n            ($1, $2, $3, $4, $5, $6, $7, decode($8, 'base64'))\n           RETURNING id, name, media_type, byte_size, content_hash, created_at`,\n          [randomUUID(), resourceId, threadId, name, mediaType, bytes, contentHash, data],\n        );\n      });\n      return toThreadDocument(row);\n    },\n    async list({ resourceId, threadId }) {\n      const storage = await getStorage();\n      const rows = await storage.db.manyOrNone(\n        `SELECT id, name, media_type, byte_size, content_hash, created_at\n         FROM ${tableName}\n         WHERE resource_id = $1 AND thread_id = $2\n         ORDER BY created_at ASC`,\n        [resourceId, threadId],\n      );\n      return rows.map(toThreadDocument);\n    },\n    async read({ documentId, resourceId, threadId }) {\n      const storage = await getStorage();\n      const row = await storage.db.oneOrNone(\n        `SELECT id, name, media_type, byte_size, content_hash, created_at,\n                encode(data, 'base64') AS data\n         FROM ${tableName}\n         WHERE id = $1 AND resource_id = $2 AND thread_id = $3`,\n        [documentId, resourceId, threadId],\n      );\n      return row\n        ? {\n            ...toThreadDocument(row),\n            // PostgreSQL wraps encoded BYTEA output at 76 characters.\n            data: String(row.data).replace(/\\s+/g, \"\"),\n          }\n        : null;\n    },\n    async deleteThread({ resourceId, threadId }) {\n      const storage = await getStorage();\n      await storage.db.none(`DELETE FROM ${tableName} WHERE resource_id = $1 AND thread_id = $2`, [\n        resourceId,\n        threadId,\n      ]);\n    },\n  };\n};\n\nexport interface CreateSurveyAssistantPostgresRuntimeOptions {\n  ensureObservationalMemory?: boolean;\n  maxStoredAttachmentsPerThread?: number;\n  maxStoredBytesPerThread?: number;\n  schemaName?: string;\n  store: PostgresStore | PostgresStoreConfig;\n}\n\nexport const createSurveyAssistantPostgresRuntime = ({\n  ensureObservationalMemory,\n  maxStoredAttachmentsPerThread,\n  maxStoredBytesPerThread,\n  schemaName = \"public\",\n  store: storeOrConfig,\n}: CreateSurveyAssistantPostgresRuntimeOptions) => {\n  const storage =\n    storeOrConfig instanceof PostgresStore ? storeOrConfig : new PostgresStore(storeOrConfig);\n  let initialization: Promise<PostgresStore> | undefined;\n  const getStorage = () => {\n    initialization ??= initializeSurveyAssistantPostgresStorage(storage, {\n      ensureObservationalMemory,\n      schemaName,\n    }).catch((error: unknown) => {\n      initialization = undefined;\n      throw error;\n    });\n    return initialization;\n  };\n\n  return {\n    storage,\n    getStorage,\n    threadDocuments: createSurveyAssistantPostgresThreadDocumentRepository({\n      getStorage,\n      maxStoredAttachmentsPerThread,\n      maxStoredBytesPerThread,\n      schemaName,\n    }),\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"storage-postgres.mjs","names":[],"sources":["../src/storage/postgres.ts"],"sourcesContent":["import { OBSERVATIONAL_MEMORY_TABLE_SCHEMA, type StorageColumn } from \"@mastra/core/storage\";\nimport { PostgresStore, type PostgresStoreConfig } from \"@mastra/pg\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { SurveyAssistantRequestError } from \"../server/request-guardrails\";\nimport type {\n  SurveyAssistantThreadDocument,\n  SurveyAssistantThreadDocumentRepository,\n} from \"../server/thread-documents\";\n\nconst OBSERVATIONAL_MEMORY_TABLE = \"mastra_observational_memory\";\nconst THREAD_DOCUMENTS_TABLE = \"survey_assistant_thread_documents\";\nexport const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENTS_PER_THREAD = 100;\nexport const SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENT_BYTES_PER_THREAD = 200 * 1024 * 1024;\n\nconst quoteIdentifier = (value: string) => `\"${value.replaceAll('\"', '\"\"')}\"`;\n\nconst postgresType = (column: StorageColumn) => {\n  switch (column.type) {\n    case \"text\":\n      return \"TEXT\";\n    case \"timestamp\":\n      return \"TIMESTAMP\";\n    case \"jsonb\":\n      return \"JSONB\";\n    case \"integer\":\n      return \"INTEGER\";\n    case \"float\":\n      return \"DOUBLE PRECISION\";\n    case \"bigint\":\n      return \"BIGINT\";\n    case \"boolean\":\n      return \"BOOLEAN\";\n    case \"uuid\":\n      return \"UUID\";\n  }\n};\n\nconst migrationDefault = (column: StorageColumn) => {\n  switch (column.type) {\n    case \"boolean\":\n      return \"FALSE\";\n    case \"integer\":\n    case \"bigint\":\n    case \"float\":\n      return \"0\";\n    case \"jsonb\":\n      return \"'{}'::jsonb\";\n    case \"timestamp\":\n      return \"NOW()\";\n    case \"text\":\n      return \"''\";\n    case \"uuid\":\n      return \"gen_random_uuid()\";\n  }\n};\n\nconst columnSql = (name: string, column: StorageColumn, includeMigrationDefault = false) => {\n  const constraints = [\n    column.primaryKey ? \"PRIMARY KEY\" : undefined,\n    column.nullable === false ? \"NOT NULL\" : undefined,\n    includeMigrationDefault && column.nullable === false\n      ? `DEFAULT ${migrationDefault(column)}`\n      : undefined,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n  return `${quoteIdentifier(name)} ${postgresType(column)}${constraints ? ` ${constraints}` : \"\"}`;\n};\n\nconst ensureObservationalMemorySchema = async (storage: PostgresStore, schemaName: string) => {\n  const tableSchema = OBSERVATIONAL_MEMORY_TABLE_SCHEMA[OBSERVATIONAL_MEMORY_TABLE];\n  if (!tableSchema) throw new Error(\"Mastra observational memory schema is unavailable.\");\n\n  const tableName = `${quoteIdentifier(schemaName)}.${quoteIdentifier(OBSERVATIONAL_MEMORY_TABLE)}`;\n  const columns = Object.entries(tableSchema).flatMap(([name, column]) => [\n    columnSql(name, column),\n    ...(column.type === \"timestamp\"\n      ? [`${quoteIdentifier(`${name}Z`)} TIMESTAMPTZ DEFAULT NOW()`]\n      : []),\n  ]);\n\n  await storage.db.none(`CREATE TABLE IF NOT EXISTS ${tableName} (${columns.join(\", \")})`);\n  for (const [name, column] of Object.entries(tableSchema)) {\n    await storage.db.none(\n      `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${columnSql(name, column, true)}`,\n    );\n    if (column.type === \"timestamp\") {\n      await storage.db.none(\n        `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${quoteIdentifier(`${name}Z`)} TIMESTAMPTZ DEFAULT NOW()`,\n      );\n    }\n  }\n  await storage.db.none(\n    `CREATE INDEX IF NOT EXISTS idx_om_lookup_key ON ${tableName} (${quoteIdentifier(\"lookupKey\")})`,\n  );\n};\n\nconst ensureThreadDocumentsSchema = async (storage: PostgresStore, schemaName: string) => {\n  const tableName = `${quoteIdentifier(schemaName)}.${quoteIdentifier(THREAD_DOCUMENTS_TABLE)}`;\n  await storage.db.none(`\n    CREATE TABLE IF NOT EXISTS ${tableName} (\n      id TEXT PRIMARY KEY,\n      resource_id TEXT NOT NULL,\n      thread_id TEXT NOT NULL,\n      name TEXT NOT NULL,\n      media_type TEXT NOT NULL,\n      byte_size INTEGER NOT NULL,\n      content_hash TEXT NOT NULL,\n      data BYTEA NOT NULL,\n      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n      UNIQUE (resource_id, thread_id, content_hash)\n    )\n  `);\n  await storage.db.none(\n    `CREATE INDEX IF NOT EXISTS idx_survey_assistant_thread_documents_thread ON ${tableName} (resource_id, thread_id, created_at)`,\n  );\n};\n\nexport interface InitializeSurveyAssistantPostgresStorageOptions {\n  ensureObservationalMemory?: boolean;\n  schemaName?: string;\n}\n\nexport const initializeSurveyAssistantPostgresStorage = async (\n  storage: PostgresStore,\n  {\n    ensureObservationalMemory = true,\n    schemaName = \"public\",\n  }: InitializeSurveyAssistantPostgresStorageOptions = {},\n) => {\n  await storage.init();\n  if (ensureObservationalMemory) await ensureObservationalMemorySchema(storage, schemaName);\n  await ensureThreadDocumentsSchema(storage, schemaName);\n  return storage;\n};\n\nconst toThreadDocument = (row: {\n  id: string;\n  name: string;\n  media_type: string;\n  byte_size: number;\n  content_hash: string;\n  created_at: Date | string;\n}): SurveyAssistantThreadDocument => ({\n  id: row.id,\n  name: row.name,\n  mediaType: row.media_type,\n  bytes: row.byte_size,\n  contentHash: row.content_hash,\n  createdAt: new Date(row.created_at).toISOString(),\n});\n\nexport interface CreateSurveyAssistantPostgresThreadDocumentRepositoryOptions {\n  getStorage(): PostgresStore | Promise<PostgresStore>;\n  maxStoredAttachmentsPerThread?: number;\n  maxStoredBytesPerThread?: number;\n  schemaName?: string;\n}\n\nexport const createSurveyAssistantPostgresThreadDocumentRepository = ({\n  getStorage,\n  maxStoredAttachmentsPerThread = SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENTS_PER_THREAD,\n  maxStoredBytesPerThread = SURVEY_ASSISTANT_DEFAULT_MAX_STORED_ATTACHMENT_BYTES_PER_THREAD,\n  schemaName = \"public\",\n}: CreateSurveyAssistantPostgresThreadDocumentRepositoryOptions): SurveyAssistantThreadDocumentRepository => {\n  if (\n    !Number.isSafeInteger(maxStoredAttachmentsPerThread) ||\n    maxStoredAttachmentsPerThread <= 0 ||\n    !Number.isSafeInteger(maxStoredBytesPerThread) ||\n    maxStoredBytesPerThread <= 0\n  ) {\n    throw new Error(\"Survey assistant stored attachment limits must be positive integers.\");\n  }\n  const tableName = `${quoteIdentifier(schemaName)}.${quoteIdentifier(THREAD_DOCUMENTS_TABLE)}`;\n  return {\n    async put({ bytes, data, mediaType, name, resourceId, threadId }) {\n      const storage = await getStorage();\n      const contentHash = createHash(\"sha256\").update(data).digest(\"hex\");\n      const row = await storage.db.tx(async (transaction) => {\n        await transaction.none(\"SELECT pg_advisory_xact_lock(hashtext($1), hashtext($2))\", [\n          resourceId,\n          threadId,\n        ]);\n        const existing = await transaction.oneOrNone(\n          `SELECT id, name, media_type, byte_size, content_hash, created_at FROM ${tableName}\n           WHERE resource_id = $1 AND thread_id = $2 AND content_hash = $3`,\n          [resourceId, threadId, contentHash],\n        );\n        if (existing) return existing;\n\n        const usage = await transaction.one<{ count: string; bytes: string }>(\n          `SELECT COUNT(*) AS count, COALESCE(SUM(byte_size), 0) AS bytes FROM ${tableName}\n           WHERE resource_id = $1 AND thread_id = $2`,\n          [resourceId, threadId],\n        );\n        if (Number(usage.count) >= maxStoredAttachmentsPerThread) {\n          throw new SurveyAssistantRequestError(\n            `A chat can contain up to ${maxStoredAttachmentsPerThread} stored attachments.`,\n          );\n        }\n        if (Number(usage.bytes) + bytes > maxStoredBytesPerThread) {\n          throw new SurveyAssistantRequestError(\n            \"The attachments stored for this chat are too large in total.\",\n          );\n        }\n\n        return transaction.one(\n          `INSERT INTO ${tableName}\n            (id, resource_id, thread_id, name, media_type, byte_size, content_hash, data)\n           VALUES\n            ($1, $2, $3, $4, $5, $6, $7, decode($8, 'base64'))\n           RETURNING id, name, media_type, byte_size, content_hash, created_at`,\n          [randomUUID(), resourceId, threadId, name, mediaType, bytes, contentHash, data],\n        );\n      });\n      return toThreadDocument(row);\n    },\n    async list({ resourceId, threadId }) {\n      const storage = await getStorage();\n      const rows = await storage.db.manyOrNone(\n        `SELECT id, name, media_type, byte_size, content_hash, created_at\n         FROM ${tableName}\n         WHERE resource_id = $1 AND thread_id = $2\n         ORDER BY created_at ASC`,\n        [resourceId, threadId],\n      );\n      return rows.map(toThreadDocument);\n    },\n    async read({ documentId, resourceId, threadId }) {\n      const storage = await getStorage();\n      const row = await storage.db.oneOrNone(\n        `SELECT id, name, media_type, byte_size, content_hash, created_at,\n                encode(data, 'base64') AS data\n         FROM ${tableName}\n         WHERE id = $1 AND resource_id = $2 AND thread_id = $3`,\n        [documentId, resourceId, threadId],\n      );\n      return row\n        ? {\n            ...toThreadDocument(row),\n            // PostgreSQL wraps encoded BYTEA output at 76 characters.\n            data: String(row.data).replace(/\\s+/g, \"\"),\n          }\n        : null;\n    },\n    async deleteThread({ resourceId, threadId }) {\n      const storage = await getStorage();\n      await storage.db.none(`DELETE FROM ${tableName} WHERE resource_id = $1 AND thread_id = $2`, [\n        resourceId,\n        threadId,\n      ]);\n    },\n  };\n};\n\nexport interface CreateSurveyAssistantPostgresRuntimeOptions {\n  ensureObservationalMemory?: boolean;\n  maxStoredAttachmentsPerThread?: number;\n  maxStoredBytesPerThread?: number;\n  schemaName?: string;\n  store: PostgresStore | PostgresStoreConfig;\n}\n\nexport const createSurveyAssistantPostgresRuntime = ({\n  ensureObservationalMemory,\n  maxStoredAttachmentsPerThread,\n  maxStoredBytesPerThread,\n  schemaName = \"public\",\n  store: storeOrConfig,\n}: CreateSurveyAssistantPostgresRuntimeOptions) => {\n  const storage =\n    storeOrConfig instanceof PostgresStore ? storeOrConfig : new PostgresStore(storeOrConfig);\n  let initialization: Promise<PostgresStore> | undefined;\n  const getStorage = () => {\n    initialization ??= initializeSurveyAssistantPostgresStorage(storage, {\n      ensureObservationalMemory,\n      schemaName,\n    }).catch((error: unknown) => {\n      initialization = undefined;\n      throw error;\n    });\n    return initialization;\n  };\n\n  return {\n    storage,\n    getStorage,\n    threadDocuments: createSurveyAssistantPostgresThreadDocumentRepository({\n      getStorage,\n      maxStoredAttachmentsPerThread,\n      maxStoredBytesPerThread,\n      schemaName,\n    }),\n  };\n};\n"],"mappings":"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"}

package/dist/{tasks-CYqrcaRO.d.mts → tasks-B9h3LPam.d.mts}

@@ -1,12 +1,10 @@
-import { c as SurveyAssistantSuggestItemKeyInput, d as SurveyAssistantSuggestItemLabelResult, l as SurveyAssistantSuggestItemKeyResult, m as SurveyAssistantTaskInvocationMode, p as SurveyAssistantTaskContext, u as SurveyAssistantSuggestItemLabelInput, v as SurveyAssistantTranslateContentInput, y as SurveyAssistantTranslateContentResult } from "./index-nhrgbgO5.mjs";
-import { a as SurveyAssistantModelSelection, n as SURVEY_ASSISTANT_TASK_AGENT_ID, o as SurveyAssistantRequestContext } from "./constants-Be91Gay9.mjs";
+import { b as SurveyAssistantTranslateContentInput, c as SurveyAssistantSuggestItemLabelInput, d as SurveyAssistantSuggestResponseNameResult, f as SurveyAssistantSuggestResponseSettingsInput, g as SurveyAssistantTaskInvocationMode, h as SurveyAssistantTaskContext, l as SurveyAssistantSuggestItemLabelResult, u as SurveyAssistantSuggestResponseNameInput, x as SurveyAssistantTranslateContentResult } from "./index-D7wT6P3t.mjs";
+import { a as SurveyAssistantModelSelection, n as SURVEY_ASSISTANT_TASK_AGENT_ID, o as SurveyAssistantRequestContext } from "./constants-B6HzpEsx.mjs";
 import { z } from "zod";
 import { RequestContext } from "@mastra/core/request-context";
-import * as _$_mastra_core_agent0 from "@mastra/core/agent";
 import { Agent, AgentConfig, AgentExecutionOptions } from "@mastra/core/agent";
-
 //#region src/server/authoring-references.d.ts
-declare const surveyAuthoringReferenceTopics: readonly ["core-rules", "survey-data-model", "source-material-surveys", "localization", "rich-text-content", "item-types", "embedded-forms", "expressions", "assistant-operations", "fair-by-design", "survey-quality"];
+declare const surveyAuthoringReferenceTopics: readonly ["core-rules", "survey-data-model", "response-variables", "source-material-surveys", "localization", "rich-text-content", "item-types", "embedded-forms", "expressions", "assistant-operations", "fair-by-design", "survey-quality"];
 type SurveyAuthoringReferenceTopic = (typeof surveyAuthoringReferenceTopics)[number];
 declare const surveyAuthoringReferences: {
   readonly "core-rules": {
@@ -14,6 +12,11 @@ declare const surveyAuthoringReferences: {
     readonly content: string;
     readonly loadWhen: "Load when the task depends on canonical tool choice, validation/apply semantics, identifier handling, or another cross-cutting authoring rule that the current turn has not already established.";
   };
+  readonly "response-variables": {
+    readonly title: "Response variables and coding";
+    readonly content: string;
+    readonly loadWhen: "Load before creating response inputs, changing variable names, option codes, matrix coding components, or export settings. Inspect current response slots for exact IDs and domains.";
+  };
   readonly "survey-data-model": {
     readonly title: "Survey data model";
     readonly content: string;
@@ -72,9 +75,7 @@ type SurveyAssistantTaskAgentConfig = AgentConfig<typeof SURVEY_ASSISTANT_TASK_A
 interface CreateSurveyAssistantTaskAgentOptions {
   model: SurveyAssistantTaskAgentConfig["model"];
 }
-declare const createSurveyAssistantTaskAgent: ({
-  model
-}: CreateSurveyAssistantTaskAgentOptions) => Agent<"survey-assistant-task-agent", Record<string, never>, undefined, SurveyAssistantRequestContext, _$_mastra_core_agent0.AgentEditorConfig | undefined>;
+declare const createSurveyAssistantTaskAgent: ({ model }: CreateSurveyAssistantTaskAgentOptions) => Agent<"survey-assistant-task-agent", Record<string, never>, undefined, SurveyAssistantRequestContext, import("@mastra/core/agent").AgentEditorConfig | undefined>;
 interface RunSurveyAssistantTaskOptions<TSchema extends z.ZodType> {
   agent: Pick<Agent, "generate">;
   taskId: string;
@@ -87,18 +88,7 @@ interface RunSurveyAssistantTaskOptions<TSchema extends z.ZodType> {
   providerOptions?: AgentExecutionOptions["providerOptions"];
   abortSignal?: AbortSignal;
 }
-declare const runSurveyAssistantTask: <TSchema extends z.ZodType>({
-  agent,
-  taskId,
-  input,
-  context,
-  schema,
-  instructions,
-  referenceTopics,
-  requestContext,
-  providerOptions,
-  abortSignal
-}: RunSurveyAssistantTaskOptions<TSchema>) => Promise<z.output<TSchema>>;
+declare const runSurveyAssistantTask: <TSchema extends z.ZodType>({ agent, taskId, input, context, schema, instructions, referenceTopics, requestContext, providerOptions, abortSignal }: RunSurveyAssistantTaskOptions<TSchema>) => Promise<z.output<TSchema>>;
 interface RunSurveyAssistantBuiltInTaskOptions {
   agent: Pick<Agent, "generate">;
   context: SurveyAssistantTaskContext;
@@ -107,7 +97,11 @@ interface RunSurveyAssistantBuiltInTaskOptions {
   providerOptions?: AgentExecutionOptions["providerOptions"];
   abortSignal?: AbortSignal;
 }
-declare const runSurveyAssistantSuggestItemKeyTask: (input: SurveyAssistantSuggestItemKeyInput, options: RunSurveyAssistantBuiltInTaskOptions) => Promise<SurveyAssistantSuggestItemKeyResult>;
+declare const runSurveyAssistantSuggestResponseNameTask: (input: SurveyAssistantSuggestResponseNameInput, options: RunSurveyAssistantBuiltInTaskOptions) => Promise<SurveyAssistantSuggestResponseNameResult>;
+declare const runSurveyAssistantSuggestResponseSettingsTask: (input: SurveyAssistantSuggestResponseSettingsInput, options: RunSurveyAssistantBuiltInTaskOptions) => Promise<{
+  naming: import("@case-framework/survey-core/editor").ResponseNamingEdit[];
+  settings: import("@case-framework/survey-core/editor").ResponseSettingsEdit[];
+}>;
 declare const runSurveyAssistantSuggestItemLabelTask: (input: SurveyAssistantSuggestItemLabelInput, options: RunSurveyAssistantBuiltInTaskOptions) => Promise<SurveyAssistantSuggestItemLabelResult>;
 declare const runSurveyAssistantTranslateContentTask: (input: SurveyAssistantTranslateContentInput, options: RunSurveyAssistantBuiltInTaskOptions) => Promise<SurveyAssistantTranslateContentResult>;
 interface SurveyAssistantTaskAuthorizedIdentity {
@@ -140,17 +134,7 @@ interface CreateSurveyAssistantTaskHandlerOptions {
   providerOptions?: AgentExecutionOptions["providerOptions"];
   resolveModel?(input: SurveyAssistantTaskModelResolutionInput): SurveyAssistantModelSelection | null | undefined | Promise<SurveyAssistantModelSelection | null | undefined>;
 }
-declare const createSurveyAssistantTaskHandler: ({
-  agent,
-  authorize,
-  getReadinessError,
-  isEnabled,
-  maxConcurrentRequests,
-  maxDurationMs,
-  onTaskMetrics,
-  providerOptions,
-  resolveModel
-}: CreateSurveyAssistantTaskHandlerOptions) => (request: Request) => Promise<Response>;
+declare const createSurveyAssistantTaskHandler: ({ agent, authorize, getReadinessError, isEnabled, maxConcurrentRequests, maxDurationMs, onTaskMetrics, providerOptions, resolveModel }: CreateSurveyAssistantTaskHandlerOptions) => (request: Request) => Promise<Response>;
 //#endregion
-export { surveyAuthoringReferences as _, SurveyAssistantTaskAuthorizationInput as a, createSurveyAssistantTaskAgent as c, runSurveyAssistantSuggestItemLabelTask as d, runSurveyAssistantTask as f, surveyAuthoringReferenceTopics as g, formatSurveyAuthoringReferenceRoutingInstructions as h, RunSurveyAssistantTaskOptions as i, createSurveyAssistantTaskHandler as l, SurveyAuthoringReferenceTopic as m, CreateSurveyAssistantTaskHandlerOptions as n, SurveyAssistantTaskAuthorizedIdentity as o, runSurveyAssistantTranslateContentTask as p, RunSurveyAssistantBuiltInTaskOptions as r, SurveyAssistantTaskModelResolutionInput as s, CreateSurveyAssistantTaskAgentOptions as t, runSurveyAssistantSuggestItemKeyTask as u };
-//# sourceMappingURL=tasks-CYqrcaRO.d.mts.map
+export { surveyAuthoringReferenceTopics as _, SurveyAssistantTaskAuthorizationInput as a, createSurveyAssistantTaskAgent as c, runSurveyAssistantSuggestResponseNameTask as d, runSurveyAssistantSuggestResponseSettingsTask as f, formatSurveyAuthoringReferenceRoutingInstructions as g, SurveyAuthoringReferenceTopic as h, RunSurveyAssistantTaskOptions as i, createSurveyAssistantTaskHandler as l, runSurveyAssistantTranslateContentTask as m, CreateSurveyAssistantTaskHandlerOptions as n, SurveyAssistantTaskAuthorizedIdentity as o, runSurveyAssistantTask as p, RunSurveyAssistantBuiltInTaskOptions as r, SurveyAssistantTaskModelResolutionInput as s, CreateSurveyAssistantTaskAgentOptions as t, runSurveyAssistantSuggestItemLabelTask as u, surveyAuthoringReferences as v };
+//# sourceMappingURL=tasks-B9h3LPam.d.mts.map

package/dist/tasks-B9h3LPam.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-B9h3LPam.d.mts","names":[],"sources":["../src/server/authoring-references.ts","../src/server/tasks.ts"],"mappings":";;;;;;cAMa;KAeD,wCAAwC;cAsCvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2EA;;;KCrGR,iCAAiC,mBAC7B,gCACP,kCAEA;UAGe;EACf,OAAO;;cAGI,mCAAkC,SAAW,0CAAqC,qCAAA,kCAAA,4DAAA;UAc9E,8BAA8B,gBAAgB,EAAE;EAC/D,OAAO,KAAK;EACZ;EACA;EACA,SAAS;EACT,QAAQ;EACR;EACA,2BAA2B;EAC3B,iBAAiB,eAAe;EAChC,kBAAkB;EAClB,cAAc;;cAUH,yBAAgC,gBAAgB,EAAE,WAAS,OAAA,QAAA,OAAA,SAAA,QAAA,cAAA,iBAAA,gBAAA,iBAAA,eAWrE,8BAA8B,aAAW,QAAQ,EAAE,OAAO;UA6E5C;EACf,OAAO,KAAK;EACZ,SAAS;EACT,OAAO;EACP,iBAAiB,eAAe;EAChC,kBAAkB;EAClB,cAAc;;cA8CH,4CACX,OAAO,yCACP,SAAS,yCACR,QAAQ;cAkEE,gDACX,OAAO,6CACP,SAAS,yCAAoC;;;;cAuDlC,yCACX,OAAO,sCACP,SAAS,yCACR,QAAQ;cA6CE,yCACX,OAAO,sCACP,SAAS,yCACR,QAAQ;UA6DM;EACf;EACA;;UAGe;EACf,SAAS;EACT;EACA;;UAGe;EACf,UAAU;EACV,SAAS;EACT;;UAGe;EACf,OACI,KAAK,4BACE,KAAK,qBAAqB,QAAQ,KAAK;EAClD,UACE,OAAO,wCACN,wCAAwC,QAAQ;EACnD,mBAAmB,SAAS,0BAA0B;EACtD,WAAW,SAAS,oBAAoB;EACxC;EACA;EACA,eAAe;IACb;IACA,UAAU;IACV;IACA;;EAEF,kBAAkB;EAClB,cACE,OAAO,0CAEL,mDAGA,QAAQ;;cAmCD,qCAAoC,OAAA,WAAA,mBAAA,WAAA,uBAAA,eAAA,eAAA,iBAAA,gBAU9C,6CAWa,SAAS,YAAU,QAAQ"}

package/dist/tasks-BZEiwgxA.mjs

@@ -0,0 +1,396 @@
+import { D as surveyAssistantTaskRequestSchema, S as surveyAssistantSuggestResponseSettingsResultSchema, jt as responseExportSettingsSchema } from "./protocol-CF4Bh_Ch.mjs";
+import { n as SURVEY_ASSISTANT_TASK_AGENT_ID } from "./constants-Ct-vv9cu.mjs";
+import { d as readSurveyAssistantRequestJson, u as SurveyAssistantRequestError } from "./request-guardrails-C0ugBOp0.mjs";
+import { a as surveyAuthoringReferences } from "./authoring-references-DbuOKerg.mjs";
+import { n as FAIR_ITEM_KEY_RULES_TEXT } from "./fair-guidance-BmO4PswW.mjs";
+import { z } from "zod";
+import { isValidResponseVariableName } from "@case-framework/survey-core";
+import { RequestContext } from "@mastra/core/request-context";
+import { Agent } from "@mastra/core/agent";
+//#region src/server/response-settings-output.ts
+const optionalEntries = z.array(z.object({
+	id: z.string().min(1),
+	value: z.string()
+}).strict()).nullable().optional();
+const exportSettings = responseExportSettingsSchema.omit({
+	optionCodes: true,
+	optionLabels: true
+}).extend({
+	optionCodes: optionalEntries,
+	optionLabels: optionalEntries
+});
+const createResponseSettingsGenerationSchema = (compact = false) => {
+	const name = compact ? z.string().min(2).max(5).regex(/^[a-z][a-z0-9]{1,4}$/) : z.string().min(1);
+	const components = z.array(z.object({
+		id: z.string().min(1),
+		value: name
+	}).strict()).nullable().optional();
+	return z.object({
+		naming: z.array(z.union([z.object({
+			slotId: z.string().min(1),
+			variableName: name
+		}).strict(), z.object({
+			primitiveId: z.string().min(1),
+			prefix: name.nullable().optional(),
+			rows: components,
+			columns: components
+		}).strict()])).max(200),
+		settings: z.array(z.object({
+			slotId: z.string().min(1),
+			optionCodes: optionalEntries,
+			exportSettings: exportSettings.nullable().optional()
+		}).strict()).max(200)
+	}).strict();
+};
+createResponseSettingsGenerationSchema();
+const entryMap = (values) => {
+	if (!values) return void 0;
+	if (new Set(values.map((entry) => entry.id)).size !== values.length) throw new Error("A coding suggestion repeats the same component or option ID.");
+	return Object.fromEntries(values.map(({ id, value }) => [id, value]));
+};
+const decodeResponseSettingsGeneration = (result) => surveyAssistantSuggestResponseSettingsResultSchema.parse({
+	naming: result.naming.map((edit) => "slotId" in edit ? edit : {
+		primitiveId: edit.primitiveId,
+		prefix: edit.prefix ?? void 0,
+		rows: entryMap(edit.rows),
+		columns: entryMap(edit.columns)
+	}),
+	settings: result.settings.map((edit) => ({
+		slotId: edit.slotId,
+		optionCodes: entryMap(edit.optionCodes),
+		exportSettings: edit.exportSettings ? {
+			...edit.exportSettings,
+			optionCodes: entryMap(edit.exportSettings.optionCodes),
+			optionLabels: entryMap(edit.exportSettings.optionLabels)
+		} : void 0
+	}))
+});
+//#endregion
+//#region src/server/tasks.ts
+const createSurveyAssistantTaskAgent = ({ model }) => new Agent({
+	id: SURVEY_ASSISTANT_TASK_AGENT_ID,
+	name: "Survey Assistant Tasks",
+	instructions: "Perform the supplied bounded survey-authoring task and return only its requested structured output.",
+	model
+});
+const BASE_TASK_INSTRUCTIONS = [
+	"You perform one bounded CASE Survey Editor AI task and return only the requested structured result.",
+	"The supplied task context was derived from the current canonical survey document snapshot. Use it as current survey context, but do not mutate it and do not claim that any editor change was applied.",
+	"Follow the supplied CASE authoring references where relevant. Do not invent item types, locales, ids, or capabilities that are absent from the task input and context.",
+	"Keep generated respondent-facing wording neutral, concise, and consistent with the requested locale and surrounding survey content."
+];
+const runSurveyAssistantTask = async ({ agent, taskId, input, context, schema, instructions, referenceTopics = [], requestContext, providerOptions, abortSignal }) => {
+	const references = referenceTopics.map((topic) => ({
+		topic,
+		title: surveyAuthoringReferences[topic].title,
+		content: surveyAuthoringReferences[topic].content
+	}));
+	const response = await agent.generate(JSON.stringify({
+		taskId,
+		input,
+		currentSurveyContext: context
+	}), {
+		instructions: [
+			...BASE_TASK_INSTRUCTIONS,
+			...instructions,
+			...references.map((entry) => `Reference: ${entry.title}\n${entry.content}`)
+		],
+		activeTools: [],
+		inputProcessors: [],
+		maxSteps: 1,
+		structuredOutput: {
+			schema,
+			errorStrategy: "strict"
+		},
+		...requestContext ? { requestContext } : {},
+		...providerOptions ? { providerOptions } : {},
+		...abortSignal ? { abortSignal } : {}
+	});
+	return schema.parse(response.object);
+};
+const keySuggestionValueSchema = z.object({
+	text: z.string().min(1),
+	rationale: z.string().optional()
+});
+const keySuggestionCategorySchema = z.enum([
+	"survey-pattern",
+	"compact",
+	"preferred",
+	"fair"
+]);
+const keySuggestionSchema = z.object({
+	surveyPattern: keySuggestionValueSchema.describe("A key that follows the strongest naming and numbering pattern in the current survey."),
+	compact: keySuggestionValueSchema.extend({ text: z.string().min(2).max(5).regex(/^[a-z][a-z0-9]{1,4}$/).describe("A recognizable 2-5 character lowercase abbreviation.") }),
+	preferred: keySuggestionValueSchema.describe("The key the model considers clearest without a category-specific naming constraint."),
+	fair: keySuggestionValueSchema.extend({ text: z.string().min(1).max(32).regex(/^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/).describe("A FAIR-by-design lowercase snake_case variable name.") }),
+	alternatives: z.array(keySuggestionValueSchema.extend({ category: keySuggestionCategorySchema })).max(2)
+});
+const labelSuggestionSchema = z.object({ suggestions: z.array(z.object({ text: z.string().min(1) })) });
+const clampLimit = (value, fallback, maximum) => Math.min(Math.max(1, value ?? fallback), maximum);
+const sanitizeCodingKey = (value) => value.trim().replace(/[.\s-]+/g, "_").replace(/[^A-Za-z0-9_]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+const getCodingKeyIdentity = (value) => sanitizeCodingKey(value).toLocaleLowerCase();
+const getNumberedKeyParts = (value) => {
+	const match = /^(.+?)_(\d+)$/.exec(getCodingKeyIdentity(value));
+	return match ? {
+		stem: match[1],
+		number: Number(match[2])
+	} : void 0;
+};
+const isUnsupportedFocusedItemSequence = (candidate, input, context) => {
+	const candidateParts = getNumberedKeyParts(candidate);
+	const focusItem = context.focus?.item;
+	if (!candidateParts || !focusItem) return false;
+	if (![input.currentName, input.draftName].map(getNumberedKeyParts).find((parts) => parts?.stem === candidateParts.stem && parts.number < candidateParts.number)) return false;
+	return !context.naming?.keyExamples.some((example) => {
+		const exampleParts = getNumberedKeyParts(example.key);
+		return example.itemType === focusItem.itemType && exampleParts?.stem === candidateParts.stem;
+	});
+};
+const invocationInstruction = (mode) => mode === "background" ? "This is a background invocation. Be efficient, but do not relax task conventions, completeness, or output quality." : "This is an explicit user invocation. Prioritize quality and useful variation.";
+const runSurveyAssistantSuggestResponseNameTask = async (input, options) => {
+	const slot = options.context.responseVariables?.find((slot) => slot.slotId === input.slotId && slot.itemId === input.itemId);
+	if (!slot) throw new Error("The selected response variable is absent from task context.");
+	if (slot.naming?.kind === "matrix") throw new Error("Matrix names are derived; request response-settings suggestions for the matrix family.");
+	const maxSuggestions = Math.min(Math.max(4, input.maxSuggestions ?? 6), 6);
+	const result = await runSurveyAssistantTask({
+		...options,
+		taskId: "suggest-response-name",
+		input,
+		schema: keySuggestionSchema,
+		instructions: [
+			"Suggest names for the exact response variable identified by input.slotId. Item editor names are separate from response variable names.",
+			"Use currentSurveyContext.responseVariables and responseOwners for the slot's field label, help, units, value type, raw/computed status, matrix row/column meaning, option codes, and supplied instrument metadata. Do not name every field after its composite item's dominant topic.",
+			"Infer conventions only from other variables in naming.keyExamples and existingVariableNames. The focused variable's current or draft placeholder is not evidence of a pattern.",
+			"Return surveyPattern, compact, preferred and fair alternatives. All must use valid lowercase snake_case, start with a letter and have at most 32 characters. Compact means a recognizable 2-5 character lowercase abbreviation.",
+			`FAIR direction: ${FAIR_ITEM_KEY_RULES_TEXT}. These are project conventions supporting FAIR, not syntax mandated by FAIR. If no meaningful survey convention exists, prefer this direction. Preserve supplied instrument codes without inventing standards.`,
+			"Matrix variables are derived. Do not propose per-cell names; use suggest-response-settings for matrix coding components.",
+			`You may return up to ${Math.max(0, maxSuggestions - 4)} genuinely useful alternatives when another category has more than one strong candidate. Tag each alternative with its category.`,
+			"Never repeat the same suggestion, including case-only or punctuation-only variations.",
+			"Do not return the current name, an existing variable name, or a semantically unrelated abbreviation.",
+			`Return between 4 and ${maxSuggestions} distinct suggestions in total.`,
+			invocationInstruction(options.mode)
+		]
+	});
+	const excluded = new Set([
+		input.currentName,
+		...input.existingNames,
+		...options.context.existingVariableNames ?? []
+	].map(getCodingKeyIdentity).filter(Boolean));
+	const seen = /* @__PURE__ */ new Set();
+	return { suggestions: [
+		{
+			...result.surveyPattern,
+			category: "survey-pattern"
+		},
+		{
+			...result.compact,
+			category: "compact"
+		},
+		{
+			...result.preferred,
+			category: "preferred"
+		},
+		{
+			...result.fair,
+			category: "fair"
+		},
+		...result.alternatives
+	].flatMap((suggestion) => {
+		const text = suggestion.text.trim();
+		const identity = getCodingKeyIdentity(text);
+		if (!isValidResponseVariableName(text) || excluded.has(identity) || seen.has(identity) || isUnsupportedFocusedItemSequence(text, input, options.context)) return [];
+		seen.add(identity);
+		return [{
+			...suggestion,
+			text
+		}];
+	}).slice(0, maxSuggestions) };
+};
+const runSurveyAssistantSuggestResponseSettingsTask = async (input, options) => {
+	const slots = options.context.responseVariables ?? [];
+	const selected = slots.filter((slot) => input.slotIds.includes(String(slot.slotId)));
+	if (input.slotIds.some((id) => !selected.some((slot) => slot.slotId === id))) throw new Error("The selected response variables are absent from task context.");
+	const matrixIds = new Set(selected.filter((slot) => slot.naming?.kind === "matrix").map((slot) => slot.primitiveId));
+	const allowed = new Set(slots.filter((slot) => input.slotIds.includes(String(slot.slotId)) || matrixIds.has(slot.primitiveId)).map((slot) => slot.slotId));
+	const generated = await runSurveyAssistantTask({
+		...options,
+		taskId: "suggest-response-settings",
+		input,
+		schema: createResponseSettingsGenerationSchema(input.category === "compact"),
+		instructions: [
+			"Suggest coherent response coding for the selected persistent slot IDs. Return naming and settings edits only; nothing has been applied.",
+			"In this structured result, rows, columns, optionCodes and optionLabels are arrays of {id,value} entries, not dictionaries. Use exact existing row/column/option IDs. Omit unchanged fields (or use null); use empty arrays for no edits. The authoring references show the canonical operation format; the application converts these entry arrays to that format.",
+			`The requested style is ${input.category}. For compact, use recognizable 2-5 character lowercase abbreviations for scalar names and each matrix prefix/row/column component; derived full matrix names may be longer. For survey-pattern, follow other authored variable names; fall back to FAIR only when no pattern exists. For preferred, prioritize clear useful names. FAIR direction: ${FAIR_ITEM_KEY_RULES_TEXT}. All categories obey the shared syntax and 32-character full-name limit.`,
+			"Use the exact slot-specific field/row/column content, value type, units, option labels, and supplied instrument metadata. Never infer a value's meaning from the composite item's dominant topic alone. Existing names from other variables provide naming-pattern evidence; the selected variable's placeholder does not.",
+			"For scalars use {slotId,variableName}. For matrices use {primitiveId,prefix,rows,columns} with the exact row and column IDs. Matrix cells and computed names are derived; never rename an individual matrix slot. Preview all affected family names mentally against existingVariableNames, including names of unselected variables. A selected matrix member permits component edits affecting that entire matrix family.",
+			"Option IDs, export codes, labels, and numeric scores are separate. Suggest stable meaningful optionCodes indexed by existing option IDs, preserve supplied instrument/standard codes and scores, and never invent IDs or standards. Shared matrix/dropdown option codes affect all slots that reuse those options.",
+			"Only change selected scalars or selected matrix families. Use settings for optionCodes and explicit export settings when needed, otherwise leave settings empty. Do not invent missing-value sentinels. Preserve false, zero, empty selection and missing as distinct values.",
+			"Avoid changing already meaningful codes without a clear reason. The editor validates survey-wide uniqueness and projected headers and presents a before/after preview before applying one undoable change."
+		],
+		referenceTopics: ["fair-by-design", "response-variables"]
+	});
+	const result = decodeResponseSettingsGeneration(generated);
+	if (result.naming.some((edit) => "slotId" in edit ? !allowed.has(edit.slotId) || (slots.find((slot) => slot.slotId === edit.slotId)?.naming)?.kind === "matrix" : !matrixIds.has(edit.primitiveId)) || result.settings.some((edit) => !allowed.has(edit.slotId))) throw new Error("The suggestion targets variables outside the requested scope or directly names a derived matrix cell.");
+	return result;
+};
+const runSurveyAssistantSuggestItemLabelTask = async (input, options) => {
+	const maxSuggestions = clampLimit(input.maxSuggestions, 3, 10);
+	const locale = input.locale ?? options.context.survey.selectedLocale;
+	const result = await runSurveyAssistantTask({
+		...options,
+		taskId: "suggest-item-label",
+		input,
+		schema: labelSuggestionSchema,
+		instructions: [
+			"Suggest concise editor-only item labels, not coding keys and not respondent-facing question text.",
+			"Infer the item's purpose from its type, draft label, visible content, hierarchy, siblings, and descendants.",
+			"Use currentSurveyContext.naming.labelExamples to infer established capitalization, prefixes, abbreviations, delimiters, and typical length.",
+			"If existing label examples are available, the first suggestion must follow their dominant pattern while still describing the focused item accurately. Other suggestions may offer useful concise alternatives.",
+			"Do not copy the subject matter of an unrelated example merely to imitate its style, and do not return an existing unrelated label verbatim.",
+			`Write labels in locale ${locale}.`,
+			`Return at most ${maxSuggestions} distinct, specific, human-readable suggestions.`,
+			invocationInstruction(options.mode)
+		],
+		referenceTopics: ["core-rules"]
+	});
+	const normalizeLabel = (value) => value.trim().toLocaleLowerCase();
+	const excludedLabels = /* @__PURE__ */ new Set([normalizeLabel(input.draftLabel), ...(options.context.naming?.labelExamples ?? []).map((example) => normalizeLabel(example.label))]);
+	const seen = /* @__PURE__ */ new Set();
+	return { suggestions: result.suggestions.flatMap((suggestion) => {
+		const text = suggestion.text.trim();
+		const normalizedText = normalizeLabel(text);
+		if (!text || excludedLabels.has(normalizedText) || seen.has(normalizedText)) return [];
+		seen.add(normalizedText);
+		return [{
+			...suggestion,
+			text
+		}];
+	}).slice(0, maxSuggestions) };
+};
+const getProtectedTokens = (value) => value.match(/\{\{[^{}]+\}\}|\{[^{}]+\}|\$\{[^{}]+\}|%\d*\$?[a-z]/gi) ?? [];
+const runSurveyAssistantTranslateContentTask = async (input, options) => {
+	const result = await runSurveyAssistantTask({
+		...options,
+		taskId: "translate-content",
+		input,
+		schema: z.object({ translations: z.object(Object.fromEntries(input.targetLocales.map((locale) => [locale, z.object(Object.fromEntries(input.entries.map((entry) => [entry.id, z.string()]))).strict()]))).strict() }).strict(),
+		instructions: [
+			"Translate every supplied survey-content entry faithfully without adding explanations or omitting content.",
+			`Translate from ${input.sourceLocale} into exactly these target locales: ${input.targetLocales.join(", ")}.`,
+			"Use currentSurveyContext.translation.examples as a terminology and style reference when relevant. The supplied source entries remain authoritative.",
+			"Preserve meaning, register, survey terminology, punctuation, line breaks, response semantics, placeholders, interpolation tokens, URLs, and identifiers that should not be translated.",
+			"Keep repeated terminology consistent across all entries and target locales. Do not use a neighboring translation when its meaning differs.",
+			"Return plain strings keyed first by target locale and then by the original entry id. Return every requested locale and entry exactly once.",
+			invocationInstruction(options.mode)
+		],
+		referenceTopics: ["localization"]
+	});
+	const translations = {};
+	for (const locale of input.targetLocales) {
+		const entries = result.translations[locale];
+		if (!entries) throw new Error(`Translation result is missing locale ${locale}.`);
+		const translatedEntries = {};
+		for (const entry of input.entries) {
+			const translation = entries[entry.id];
+			if (typeof translation !== "string" || translation.trim().length === 0) throw new Error(`Translation result is missing entry ${entry.id} for locale ${locale}.`);
+			const sourceTokens = getProtectedTokens(entry.text).sort();
+			const translatedTokens = getProtectedTokens(translation).sort();
+			if (sourceTokens.join("\0") !== translatedTokens.join("\0")) throw new Error(`Translation result changed protected tokens in entry ${entry.id} for locale ${locale}.`);
+			translatedEntries[entry.id] = translation;
+		}
+		translations[locale] = translatedEntries;
+	}
+	return { translations };
+};
+const MAX_TASK_REQUEST_BYTES = 524288;
+const DEFAULT_MAX_TASK_CONCURRENT_REQUESTS = 4;
+const DEFAULT_MAX_TASK_DURATION_MS = 6e4;
+const taskErrorResponse = (error) => {
+	const status = typeof error === "object" && error !== null && "status" in error && typeof error.status === "number" ? error.status : error instanceof SyntaxError || error instanceof Error && error.name === "ZodError" ? 400 : 500;
+	const message = error instanceof SurveyAssistantRequestError ? error.message : status === 401 || status === 403 || status === 404 ? status === 404 ? "Survey assistant task not found." : "The survey assistant task is not authorized." : status >= 500 ? "The survey assistant task could not be completed." : "The survey assistant task request is invalid.";
+	return Response.json({
+		code: status === 401 || status === 403 || status === 404 ? "authorization_failed" : "request_failed",
+		error: message
+	}, { status });
+};
+const createSurveyAssistantTaskHandler = ({ agent, authorize, getReadinessError, isEnabled, maxConcurrentRequests = DEFAULT_MAX_TASK_CONCURRENT_REQUESTS, maxDurationMs = DEFAULT_MAX_TASK_DURATION_MS, onTaskMetrics, providerOptions, resolveModel }) => {
+	const concurrency = Number.isInteger(maxConcurrentRequests) && maxConcurrentRequests > 0 ? maxConcurrentRequests : DEFAULT_MAX_TASK_CONCURRENT_REQUESTS;
+	const duration = Number.isFinite(maxDurationMs) && maxDurationMs > 0 ? maxDurationMs : DEFAULT_MAX_TASK_DURATION_MS;
+	let activeRequests = 0;
+	return async (request) => {
+		if (activeRequests >= concurrency) return Response.json({
+			code: "rate_limited",
+			error: "The survey assistant is handling too many tasks. Try again shortly."
+		}, { status: 429 });
+		activeRequests += 1;
+		const startedAt = Date.now();
+		let metricsIdentity;
+		let metricsTaskId = "unknown";
+		let completed = false;
+		try {
+			if (isEnabled && !await isEnabled(request)) return Response.json({
+				code: "request_failed",
+				error: "Survey assistant is disabled."
+			}, { status: 404 });
+			const task = surveyAssistantTaskRequestSchema.parse(await readSurveyAssistantRequestJson(request, MAX_TASK_REQUEST_BYTES));
+			metricsTaskId = task.taskId;
+			const identity = await authorize({
+				request,
+				requestedResourceId: task.resourceId,
+				requestedSurveyId: task.surveyId
+			});
+			if (!identity?.resourceId?.trim() || identity.resourceId.trim().length > 240 || identity.surveyId !== void 0 && (!identity.surveyId.trim() || identity.surveyId.trim().length > 240)) throw Object.assign(/* @__PURE__ */ new Error("The host returned an invalid task identity."), { status: 500 });
+			metricsIdentity = {
+				resourceId: identity.resourceId.trim(),
+				...identity.surveyId?.trim() ? { surveyId: identity.surveyId.trim() } : {}
+			};
+			const readinessError = await getReadinessError?.(request);
+			if (readinessError) return Response.json({
+				code: "request_failed",
+				error: readinessError
+			}, { status: 503 });
+			const requestContext = new RequestContext();
+			let modelSelection;
+			if (resolveModel) {
+				modelSelection = await resolveModel({
+					identity: metricsIdentity,
+					request,
+					requestedModelId: task.modelId
+				}) ?? void 0;
+				if (!modelSelection) return Response.json({
+					code: "request_failed",
+					error: "The selected survey assistant model is unavailable."
+				}, { status: 400 });
+				requestContext.set("modelSelection", modelSelection);
+			}
+			const resolvedAgent = typeof agent === "function" ? await agent() : agent;
+			const runtime = {
+				abortSignal: AbortSignal.any([request.signal, AbortSignal.timeout(duration)]),
+				agent: resolvedAgent,
+				context: task.context,
+				mode: task.mode,
+				requestContext,
+				providerOptions: modelSelection?.providerOptions ?? providerOptions
+			};
+			const result = task.taskId === "suggest-response-settings" ? await runSurveyAssistantSuggestResponseSettingsTask(task.input, runtime) : task.taskId === "suggest-response-name" ? await runSurveyAssistantSuggestResponseNameTask(task.input, runtime) : task.taskId === "suggest-item-label" ? await runSurveyAssistantSuggestItemLabelTask(task.input, runtime) : await runSurveyAssistantTranslateContentTask(task.input, runtime);
+			completed = true;
+			return Response.json(result);
+		} catch (error) {
+			return taskErrorResponse(error);
+		} finally {
+			activeRequests = Math.max(0, activeRequests - 1);
+			if (metricsIdentity) try {
+				onTaskMetrics?.({
+					durationMs: Date.now() - startedAt,
+					identity: metricsIdentity,
+					status: completed ? "completed" : "failed",
+					taskId: metricsTaskId
+				});
+			} catch {}
+		}
+	};
+};
+//#endregion
+export { runSurveyAssistantSuggestResponseSettingsTask as a, runSurveyAssistantSuggestResponseNameTask as i, createSurveyAssistantTaskHandler as n, runSurveyAssistantTask as o, runSurveyAssistantSuggestItemLabelTask as r, runSurveyAssistantTranslateContentTask as s, createSurveyAssistantTaskAgent as t };
+
+//# sourceMappingURL=tasks-BZEiwgxA.mjs.map