@tangle-network/agent-app 0.43.56 → 0.43.57

package/dist/intakes/api.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/intakes/api.ts"],"sourcesContent":["/**\n * Framework-neutral intake API: the get-current / save-answer / complete logic,\n * lifted out of any one app's route file. Each app mounts these in its own\n * route with its own auth — the handlers take an already-resolved store (the\n * caller built it from `createUserIntakeStore` / `createProjectIntakeStore`\n * after running RBAC), the intake graph, and the parsed inputs. They return\n * web-standard `Response`s (available in Workers, Node 18+, Deno, browsers), so\n * \"framework-neutral\" is literal: no Remix/React-Router/Express import anywhere.\n *\n * The handlers own the graph→HTTP mapping the UI needs: `getCurrentIntake`\n * returns the loaded state PLUS the next question to ask (the question-graph\n * traversal from the `./intakes` leaf) and the progress counter, so the client\n * renders one question at a time without re-deriving the graph. Store\n * `IntakeError`s map to typed 4xx codes, never a generic 500 — an invalid\n * answer is a 400, an incomplete-complete is a 409, never a silent success.\n *\n * Imports `drizzle-orm` transitively (through the store types), so this is a\n * subpath, never re-exported from root.\n */\n\nimport {\n  type IntakeAnswerValue,\n  type IntakeGraph,\n  type IntakeQuestion,\n  intakeProgress,\n  nextQuestion,\n} from './model'\nimport { type IntakeStore, IntakeError } from './drizzle/store'\n\n/** What the client renders: the saved state, the next prompt, and progress. */\nexport interface CurrentIntakeView {\n  graphId: string\n  title: string\n  description?: string\n  answers: Record<string, IntakeAnswerValue>\n  /** The next question to ask, or null when the interview is done. */\n  nextQuestion: IntakeQuestion | null\n  completed: boolean\n  completedAt: string | null\n  progress: { answered: number; total: number }\n}\n\nexport interface IntakeApiOptions {\n  store: IntakeStore\n  graph: IntakeGraph\n}\n\n/**\n * Build the intake API bound to one store + graph. Returns three handlers; an\n * app maps its route methods onto them (GET→getCurrentIntake, POST→saveAnswer,\n * a complete action→completeIntake).\n */\nexport function createIntakeApi(opts: IntakeApiOptions) {\n  const { store, graph } = opts\n\n  function view(state: Awaited<ReturnType<IntakeStore['get']>>): CurrentIntakeView {\n    return {\n      graphId: graph.id,\n      title: graph.title,\n      ...(graph.description ? { description: graph.description } : {}),\n      answers: state.payload.answers,\n      nextQuestion: nextQuestion(graph, state.payload.answers),\n      completed: state.completed,\n      completedAt: state.completedAt ? state.completedAt.toISOString() : null,\n      progress: intakeProgress(graph, state.payload.answers),\n    }\n  }\n\n  async function getCurrentIntake(): Promise<Response> {\n    const state = await store.get()\n    return Response.json(view(state))\n  }\n\n  async function saveAnswer(input: { questionId?: string; value?: IntakeAnswerValue }): Promise<Response> {\n    if (!input.questionId) return Response.json({ error: 'Missing questionId' }, { status: 400 })\n    try {\n      const state = await store.save(input.questionId, input.value ?? null)\n      return Response.json(view(state))\n    } catch (err) {\n      return intakeErrorResponse(err)\n    }\n  }\n\n  async function completeIntake(): Promise<Response> {\n    try {\n      const state = await store.complete()\n      return Response.json(view(state))\n    } catch (err) {\n      return intakeErrorResponse(err)\n    }\n  }\n\n  return { getCurrentIntake, saveAnswer, completeIntake }\n}\n\nconst ERROR_STATUS: Record<string, number> = {\n  'invalid-answer': 400,\n  'unknown-question': 404,\n  incomplete: 409,\n  'stale-graph': 409,\n}\n\nfunction intakeErrorResponse(err: unknown): Response {\n  if (err instanceof IntakeError) {\n    return Response.json({ error: err.message, code: err.code }, { status: ERROR_STATUS[err.code] ?? 400 })\n  }\n  throw err\n}\n"],"mappings":";;;;;;;;;;AAoDO,SAAS,gBAAgB,MAAwB;AACtD,QAAM,EAAE,OAAO,MAAM,IAAI;AAEzB,WAAS,KAAK,OAAmE;AAC/E,WAAO;AAAA,MACL,SAAS,MAAM;AAAA,MACf,OAAO,MAAM;AAAA,MACb,GAAI,MAAM,cAAc,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,MAC9D,SAAS,MAAM,QAAQ;AAAA,MACvB,cAAc,aAAa,OAAO,MAAM,QAAQ,OAAO;AAAA,MACvD,WAAW,MAAM;AAAA,MACjB,aAAa,MAAM,cAAc,MAAM,YAAY,YAAY,IAAI;AAAA,MACnE,UAAU,eAAe,OAAO,MAAM,QAAQ,OAAO;AAAA,IACvD;AAAA,EACF;AAEA,iBAAe,mBAAsC;AACnD,UAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,WAAO,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,EAClC;AAEA,iBAAe,WAAW,OAA8E;AACtG,QAAI,CAAC,MAAM,WAAY,QAAO,SAAS,KAAK,EAAE,OAAO,qBAAqB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAC5F,QAAI;AACF,YAAM,QAAQ,MAAM,MAAM,KAAK,MAAM,YAAY,MAAM,SAAS,IAAI;AACpE,aAAO,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,IAClC,SAAS,KAAK;AACZ,aAAO,oBAAoB,GAAG;AAAA,IAChC;AAAA,EACF;AAEA,iBAAe,iBAAoC;AACjD,QAAI;AACF,YAAM,QAAQ,MAAM,MAAM,SAAS;AACnC,aAAO,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,IAClC,SAAS,KAAK;AACZ,aAAO,oBAAoB,GAAG;AAAA,IAChC;AAAA,EACF;AAEA,SAAO,EAAE,kBAAkB,YAAY,eAAe;AACxD;AAEA,IAAM,eAAuC;AAAA,EAC3C,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,YAAY;AAAA,EACZ,eAAe;AACjB;AAEA,SAAS,oBAAoB,KAAwB;AACnD,MAAI,eAAe,aAAa;AAC9B,WAAO,SAAS,KAAK,EAAE,OAAO,IAAI,SAAS,MAAM,IAAI,KAAK,GAAG,EAAE,QAAQ,aAAa,IAAI,IAAI,KAAK,IAAI,CAAC;AAAA,EACxG;AACA,QAAM;AACR;","names":[]}
+{"version":3,"sources":["../../src/intakes/api.ts"],"sourcesContent":["/**\n * Framework-neutral intake API: the get-current / save-answer / complete logic,\n * lifted out of any one app's route file. Each app mounts these in its own\n * route with its own auth — the handlers take an already-resolved store (the\n * caller built it from `createUserIntakeStore` / `createProjectIntakeStore`\n * after running RBAC), the intake graph, and the parsed inputs. They return\n * web-standard `Response`s (available in Workers, Node 18+, Deno, browsers), so\n * \"framework-neutral\" is literal: no Remix/React-Router/Express import anywhere.\n *\n * The handlers own the graph→HTTP mapping the UI needs: `getCurrentIntake`\n * returns the loaded state PLUS the next question to ask (the question-graph\n * traversal from the `./intakes` leaf) and the progress counter, so the client\n * renders one question at a time without re-deriving the graph. Store\n * `IntakeError`s map to typed 4xx codes, never a generic 500 — an invalid\n * answer is a 400, an incomplete-complete is a 409, never a silent success.\n *\n * Imports `drizzle-orm` transitively (through the store types), so this is a\n * subpath, never re-exported from root.\n */\n\nimport {\n  type IntakeAnswerValue,\n  type IntakeGraph,\n  type IntakeQuestion,\n  intakeProgress,\n  nextQuestion,\n} from './model'\nimport { type IntakeStore, IntakeError } from './drizzle/store'\n\n/** What the client renders: the saved state, the next prompt, and progress. */\nexport interface CurrentIntakeView {\n  graphId: string\n  title: string\n  description?: string\n  answers: Record<string, IntakeAnswerValue>\n  /** The next question to ask, or null when the interview is done. */\n  nextQuestion: IntakeQuestion | null\n  completed: boolean\n  completedAt: string | null\n  progress: { answered: number; total: number }\n}\n\n/** Define configuration options for initializing the intake API with store and graph components */\nexport interface IntakeApiOptions {\n  store: IntakeStore\n  graph: IntakeGraph\n}\n\n/**\n * Build the intake API bound to one store + graph. Returns three handlers; an\n * app maps its route methods onto them (GET→getCurrentIntake, POST→saveAnswer,\n * a complete action→completeIntake).\n */\nexport function createIntakeApi(opts: IntakeApiOptions) {\n  const { store, graph } = opts\n\n  function view(state: Awaited<ReturnType<IntakeStore['get']>>): CurrentIntakeView {\n    return {\n      graphId: graph.id,\n      title: graph.title,\n      ...(graph.description ? { description: graph.description } : {}),\n      answers: state.payload.answers,\n      nextQuestion: nextQuestion(graph, state.payload.answers),\n      completed: state.completed,\n      completedAt: state.completedAt ? state.completedAt.toISOString() : null,\n      progress: intakeProgress(graph, state.payload.answers),\n    }\n  }\n\n  async function getCurrentIntake(): Promise<Response> {\n    const state = await store.get()\n    return Response.json(view(state))\n  }\n\n  async function saveAnswer(input: { questionId?: string; value?: IntakeAnswerValue }): Promise<Response> {\n    if (!input.questionId) return Response.json({ error: 'Missing questionId' }, { status: 400 })\n    try {\n      const state = await store.save(input.questionId, input.value ?? null)\n      return Response.json(view(state))\n    } catch (err) {\n      return intakeErrorResponse(err)\n    }\n  }\n\n  async function completeIntake(): Promise<Response> {\n    try {\n      const state = await store.complete()\n      return Response.json(view(state))\n    } catch (err) {\n      return intakeErrorResponse(err)\n    }\n  }\n\n  return { getCurrentIntake, saveAnswer, completeIntake }\n}\n\nconst ERROR_STATUS: Record<string, number> = {\n  'invalid-answer': 400,\n  'unknown-question': 404,\n  incomplete: 409,\n  'stale-graph': 409,\n}\n\nfunction intakeErrorResponse(err: unknown): Response {\n  if (err instanceof IntakeError) {\n    return Response.json({ error: err.message, code: err.code }, { status: ERROR_STATUS[err.code] ?? 400 })\n  }\n  throw err\n}\n"],"mappings":";;;;;;;;;;AAqDO,SAAS,gBAAgB,MAAwB;AACtD,QAAM,EAAE,OAAO,MAAM,IAAI;AAEzB,WAAS,KAAK,OAAmE;AAC/E,WAAO;AAAA,MACL,SAAS,MAAM;AAAA,MACf,OAAO,MAAM;AAAA,MACb,GAAI,MAAM,cAAc,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,MAC9D,SAAS,MAAM,QAAQ;AAAA,MACvB,cAAc,aAAa,OAAO,MAAM,QAAQ,OAAO;AAAA,MACvD,WAAW,MAAM;AAAA,MACjB,aAAa,MAAM,cAAc,MAAM,YAAY,YAAY,IAAI;AAAA,MACnE,UAAU,eAAe,OAAO,MAAM,QAAQ,OAAO;AAAA,IACvD;AAAA,EACF;AAEA,iBAAe,mBAAsC;AACnD,UAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,WAAO,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,EAClC;AAEA,iBAAe,WAAW,OAA8E;AACtG,QAAI,CAAC,MAAM,WAAY,QAAO,SAAS,KAAK,EAAE,OAAO,qBAAqB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAC5F,QAAI;AACF,YAAM,QAAQ,MAAM,MAAM,KAAK,MAAM,YAAY,MAAM,SAAS,IAAI;AACpE,aAAO,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,IAClC,SAAS,KAAK;AACZ,aAAO,oBAAoB,GAAG;AAAA,IAChC;AAAA,EACF;AAEA,iBAAe,iBAAoC;AACjD,QAAI;AACF,YAAM,QAAQ,MAAM,MAAM,SAAS;AACnC,aAAO,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,IAClC,SAAS,KAAK;AACZ,aAAO,oBAAoB,GAAG;AAAA,IAChC;AAAA,EACF;AAEA,SAAO,EAAE,kBAAkB,YAAY,eAAe;AACxD;AAEA,IAAM,eAAuC;AAAA,EAC3C,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,YAAY;AAAA,EACZ,eAAe;AACjB;AAEA,SAAS,oBAAoB,KAAwB;AACnD,MAAI,eAAe,aAAa;AAC9B,WAAO,SAAS,KAAK,EAAE,OAAO,IAAI,SAAS,MAAM,IAAI,KAAK,GAAG,EAAE,QAAQ,aAAa,IAAI,IAAI,KAAK,IAAI,CAAC;AAAA,EACxG;AACA,QAAM;AACR;","names":[]}

package/dist/intakes/drizzle.d.ts

@@ -1,12 +1,13 @@
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
 import { AnySQLiteTable, AnySQLiteColumn, BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
-import { I as IntakeAnswerValue, b as IntakeGraph } from '../model-Bzi5i63l.js';
-import { I as IntakePayload } from '../completion-Kaqp_tWk.js';
+import { I as IntakeAnswerValue, b as IntakeGraph } from '../model-C8U0HZxL.js';
+import { I as IntakePayload } from '../completion-CvcNUz07.js';
 
 /** A product table referenced by FK — only the `id` column is touched. */
 type IntakeParentTable = AnySQLiteTable & {
     id: AnySQLiteColumn;
 };
+/** Define options for creating intake tables including user and optional workspace references */
 interface CreateIntakeTablesOptions {
     /** The product's user table — user-intake rows reference `userTable.id`. */
     userTable: IntakeParentTable;
@@ -289,7 +290,9 @@ declare function createProjectIntakeTable(workspaceTable: IntakeParentTable): dr
  * workspace table cannot reference a table that does not exist.
  */
 declare function createIntakeTables<O extends CreateIntakeTablesOptions>(opts: O): IntakeTables<O>;
+/** Resolve the structure and data of a user intake table based on the createUserIntakeTable function */
 type UserIntakeTable = ReturnType<typeof createUserIntakeTable>;
+/** Resolve the structure and data of the project intake table from the factory function */
 type ProjectIntakeTable = ReturnType<typeof createProjectIntakeTable>;
 /**
  * The tables returned for a given options shape: `projectIntake` is present in
@@ -309,7 +312,9 @@ type AnyIntakeTables = {
     userIntake: UserIntakeTable;
     projectIntake?: ProjectIntakeTable;
 };
+/** Infer and represent a selected row from the UserIntakeTable data structure */
 type UserIntakeRow = UserIntakeTable['$inferSelect'];
+/** Resolve the selected data structure for a project intake table row */
 type ProjectIntakeRow = ProjectIntakeTable['$inferSelect'];
 
 /**
@@ -345,6 +350,7 @@ interface IntakeState {
     completed: boolean;
     completedAt: Date | null;
 }
+/** Define error codes representing specific intake validation failures */
 type IntakeErrorCode = 'invalid-answer' | 'unknown-question' | 'incomplete' | 'stale-graph';
 /** Thrown by store mutations on a refused write — callers map it to a 4xx. */
 declare class IntakeError extends Error {
@@ -360,6 +366,7 @@ interface IntakeStore {
     /** Stamp the intake complete; throws IntakeError when not yet completable. */
     complete(): Promise<IntakeState>;
 }
+/** Define options required to create a user intake store for onboarding data collection */
 interface CreateUserIntakeStoreOptions {
     db: IntakeDatabase;
     /** The user-intake table from createIntakeTables. */
@@ -371,6 +378,7 @@ interface CreateUserIntakeStoreOptions {
 }
 /** Build the per-user onboarding store, scoped to one userId. */
 declare function createUserIntakeStore(opts: CreateUserIntakeStoreOptions): IntakeStore;
+/** Define options required to create a project intake store including database, table, graph, and workspace ID */
 interface CreateProjectIntakeStoreOptions {
     db: IntakeDatabase;
     /** The project-intake table from createIntakeTables (workspace scope). */

package/dist/intakes/drizzle.js

@@ -2,9 +2,9 @@ import {
   IntakeError,
   createProjectIntakeStore,
   createUserIntakeStore
-} from "../chunk-4K7BZYO7.js";
-import "../chunk-USYXHDKE.js";
-import "../chunk-ND3XEGBE.js";
+} from "../chunk-VWAEWOWK.js";
+import "../chunk-YZ6KQULN.js";
+import "../chunk-JDEGS53O.js";
 
 // src/intakes/drizzle/schema.ts
 import { sql } from "drizzle-orm";

package/dist/intakes/drizzle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/intakes/drizzle/schema.ts"],"sourcesContent":["/**\n * Drizzle schema factory for the intake tables. The product owns the user (and\n * optionally workspace) tables; this factory creates the intake tables and\n * wires their foreign keys into the passed-in tables so the whole graph lives\n * in one drizzle schema with real cascade semantics.\n *\n * Two tables, two scopes:\n *   - `user_intake`    — the one-time onboarding interview, keyed on `user.id`\n *     (UNIQUE per user: one onboarding payload per user). ALWAYS created.\n *   - `project_intake` — the structured intake attached to a workspace, keyed\n *     on `workspace.id` (UNIQUE per workspace). Created ONLY when a\n *     `workspaceTable` is passed.\n *\n * `workspaceTable` is OPTIONAL by design: a non-workspace app (a single-user\n * tool, tax-without-workspaces) adopts per-user onboarding alone with zero\n * teams and zero workspace concept. When omitted, `createIntakeTables` returns\n * `{ userIntake }` and no `projectIntake` — the FK to a workspace table that\n * does not exist is never created.\n *\n * Imports `drizzle-orm` at module top — that is WHY this lives behind the\n * `/intakes/drizzle` sub-subpath. The pure `./intakes` leaf imports none of\n * this, so a consumer that never touches the DB never pulls the optional peer.\n */\n\nimport { sql } from 'drizzle-orm'\nimport { index, integer, sqliteTable, text, uniqueIndex } from 'drizzle-orm/sqlite-core'\nimport type { AnySQLiteColumn, AnySQLiteTable } from 'drizzle-orm/sqlite-core'\n\n/** A product table referenced by FK — only the `id` column is touched. */\nexport type IntakeParentTable = AnySQLiteTable & { id: AnySQLiteColumn }\n\nexport interface CreateIntakeTablesOptions {\n  /** The product's user table — user-intake rows reference `userTable.id`. */\n  userTable: IntakeParentTable\n  /**\n   * The product's workspace table — project-intake rows reference\n   * `workspaceTable.id`. OPTIONAL: omit it for a single-user / non-workspace\n   * app that wants per-user onboarding only. When omitted, no `projectIntake`\n   * table is created.\n   */\n  workspaceTable?: IntakeParentTable\n}\n\nconst hexId = () => text('id').primaryKey().default(sql`(lower(hex(randomblob(16))))`)\n\nconst createdAt = () => integer('created_at', { mode: 'timestamp' }).notNull().default(sql`(unixepoch())`)\n\nconst updatedAt = () => integer('updated_at', { mode: 'timestamp' }).notNull().default(sql`(unixepoch())`)\n\nfunction createUserIntakeTable(userTable: IntakeParentTable) {\n  return sqliteTable('user_intake', {\n    id: hexId(),\n    userId: text('user_id').notNull().references(() => userTable.id, { onDelete: 'cascade' }),\n    /** The intake definition id the payload was collected against. */\n    graphId: text('graph_id').notNull(),\n    /** The IntakePayload JSON blob. */\n    payload: text('payload', { mode: 'json' }).notNull(),\n    /** Set when the user finishes the onboarding interview; null while open. */\n    completedAt: integer('completed_at', { mode: 'timestamp' }),\n    createdAt: createdAt(),\n    updatedAt: updatedAt(),\n  }, (table) => [\n    uniqueIndex('uniq_user_intake_user').on(table.userId),\n  ])\n}\n\nfunction createProjectIntakeTable(workspaceTable: IntakeParentTable) {\n  return sqliteTable('project_intake', {\n    id: hexId(),\n    workspaceId: text('workspace_id').notNull().references(() => workspaceTable.id, { onDelete: 'cascade' }),\n    graphId: text('graph_id').notNull(),\n    payload: text('payload', { mode: 'json' }).notNull(),\n    completedAt: integer('completed_at', { mode: 'timestamp' }),\n    createdAt: createdAt(),\n    updatedAt: updatedAt(),\n  }, (table) => [\n    uniqueIndex('uniq_project_intake_workspace').on(table.workspaceId),\n    index('idx_project_intake_graph').on(table.graphId),\n  ])\n}\n\n/**\n * Build the intake tables wired to the product's tables. Always returns\n * `userIntake`; returns `projectIntake` only when `workspaceTable` is passed.\n * The return type carries `projectIntake?` so a consumer that passes no\n * workspace table cannot reference a table that does not exist.\n */\nexport function createIntakeTables<O extends CreateIntakeTablesOptions>(\n  opts: O,\n): IntakeTables<O> {\n  const userIntake = createUserIntakeTable(opts.userTable)\n  const result: { userIntake: ReturnType<typeof createUserIntakeTable>; projectIntake?: ReturnType<typeof createProjectIntakeTable> } = {\n    userIntake,\n  }\n  if (opts.workspaceTable) {\n    result.projectIntake = createProjectIntakeTable(opts.workspaceTable)\n  }\n  return result as IntakeTables<O>\n}\n\nexport type UserIntakeTable = ReturnType<typeof createUserIntakeTable>\nexport type ProjectIntakeTable = ReturnType<typeof createProjectIntakeTable>\n\n/**\n * The tables returned for a given options shape: `projectIntake` is present in\n * the type exactly when `workspaceTable` was provided.\n */\nexport type IntakeTables<O extends CreateIntakeTablesOptions> =\n  O extends { workspaceTable: IntakeParentTable }\n    ? { userIntake: UserIntakeTable; projectIntake: ProjectIntakeTable }\n    : { userIntake: UserIntakeTable; projectIntake?: ProjectIntakeTable }\n\n/** The union table shape, for code that handles either scope generically. */\nexport type AnyIntakeTables = { userIntake: UserIntakeTable; projectIntake?: ProjectIntakeTable }\n\nexport type UserIntakeRow = UserIntakeTable['$inferSelect']\nexport type ProjectIntakeRow = ProjectIntakeTable['$inferSelect']\n"],"mappings":";;;;;;;;;AAwBA,SAAS,WAAW;AACpB,SAAS,OAAO,SAAS,aAAa,MAAM,mBAAmB;AAkB/D,IAAM,QAAQ,MAAM,KAAK,IAAI,EAAE,WAAW,EAAE,QAAQ,iCAAiC;AAErF,IAAM,YAAY,MAAM,QAAQ,cAAc,EAAE,MAAM,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,kBAAkB;AAEzG,IAAM,YAAY,MAAM,QAAQ,cAAc,EAAE,MAAM,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,kBAAkB;AAEzG,SAAS,sBAAsB,WAA8B;AAC3D,SAAO,YAAY,eAAe;AAAA,IAChC,IAAI,MAAM;AAAA,IACV,QAAQ,KAAK,SAAS,EAAE,QAAQ,EAAE,WAAW,MAAM,UAAU,IAAI,EAAE,UAAU,UAAU,CAAC;AAAA;AAAA,IAExF,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA;AAAA,IAElC,SAAS,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC,EAAE,QAAQ;AAAA;AAAA,IAEnD,aAAa,QAAQ,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAAA,IAC1D,WAAW,UAAU;AAAA,IACrB,WAAW,UAAU;AAAA,EACvB,GAAG,CAAC,UAAU;AAAA,IACZ,YAAY,uBAAuB,EAAE,GAAG,MAAM,MAAM;AAAA,EACtD,CAAC;AACH;AAEA,SAAS,yBAAyB,gBAAmC;AACnE,SAAO,YAAY,kBAAkB;AAAA,IACnC,IAAI,MAAM;AAAA,IACV,aAAa,KAAK,cAAc,EAAE,QAAQ,EAAE,WAAW,MAAM,eAAe,IAAI,EAAE,UAAU,UAAU,CAAC;AAAA,IACvG,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA,IAClC,SAAS,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC,EAAE,QAAQ;AAAA,IACnD,aAAa,QAAQ,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAAA,IAC1D,WAAW,UAAU;AAAA,IACrB,WAAW,UAAU;AAAA,EACvB,GAAG,CAAC,UAAU;AAAA,IACZ,YAAY,+BAA+B,EAAE,GAAG,MAAM,WAAW;AAAA,IACjE,MAAM,0BAA0B,EAAE,GAAG,MAAM,OAAO;AAAA,EACpD,CAAC;AACH;AAQO,SAAS,mBACd,MACiB;AACjB,QAAM,aAAa,sBAAsB,KAAK,SAAS;AACvD,QAAM,SAAgI;AAAA,IACpI;AAAA,EACF;AACA,MAAI,KAAK,gBAAgB;AACvB,WAAO,gBAAgB,yBAAyB,KAAK,cAAc;AAAA,EACrE;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/intakes/drizzle/schema.ts"],"sourcesContent":["/**\n * Drizzle schema factory for the intake tables. The product owns the user (and\n * optionally workspace) tables; this factory creates the intake tables and\n * wires their foreign keys into the passed-in tables so the whole graph lives\n * in one drizzle schema with real cascade semantics.\n *\n * Two tables, two scopes:\n *   - `user_intake`    — the one-time onboarding interview, keyed on `user.id`\n *     (UNIQUE per user: one onboarding payload per user). ALWAYS created.\n *   - `project_intake` — the structured intake attached to a workspace, keyed\n *     on `workspace.id` (UNIQUE per workspace). Created ONLY when a\n *     `workspaceTable` is passed.\n *\n * `workspaceTable` is OPTIONAL by design: a non-workspace app (a single-user\n * tool, tax-without-workspaces) adopts per-user onboarding alone with zero\n * teams and zero workspace concept. When omitted, `createIntakeTables` returns\n * `{ userIntake }` and no `projectIntake` — the FK to a workspace table that\n * does not exist is never created.\n *\n * Imports `drizzle-orm` at module top — that is WHY this lives behind the\n * `/intakes/drizzle` sub-subpath. The pure `./intakes` leaf imports none of\n * this, so a consumer that never touches the DB never pulls the optional peer.\n */\n\nimport { sql } from 'drizzle-orm'\nimport { index, integer, sqliteTable, text, uniqueIndex } from 'drizzle-orm/sqlite-core'\nimport type { AnySQLiteColumn, AnySQLiteTable } from 'drizzle-orm/sqlite-core'\n\n/** A product table referenced by FK — only the `id` column is touched. */\nexport type IntakeParentTable = AnySQLiteTable & { id: AnySQLiteColumn }\n\n/** Define options for creating intake tables including user and optional workspace references */\nexport interface CreateIntakeTablesOptions {\n  /** The product's user table — user-intake rows reference `userTable.id`. */\n  userTable: IntakeParentTable\n  /**\n   * The product's workspace table — project-intake rows reference\n   * `workspaceTable.id`. OPTIONAL: omit it for a single-user / non-workspace\n   * app that wants per-user onboarding only. When omitted, no `projectIntake`\n   * table is created.\n   */\n  workspaceTable?: IntakeParentTable\n}\n\nconst hexId = () => text('id').primaryKey().default(sql`(lower(hex(randomblob(16))))`)\n\nconst createdAt = () => integer('created_at', { mode: 'timestamp' }).notNull().default(sql`(unixepoch())`)\n\nconst updatedAt = () => integer('updated_at', { mode: 'timestamp' }).notNull().default(sql`(unixepoch())`)\n\nfunction createUserIntakeTable(userTable: IntakeParentTable) {\n  return sqliteTable('user_intake', {\n    id: hexId(),\n    userId: text('user_id').notNull().references(() => userTable.id, { onDelete: 'cascade' }),\n    /** The intake definition id the payload was collected against. */\n    graphId: text('graph_id').notNull(),\n    /** The IntakePayload JSON blob. */\n    payload: text('payload', { mode: 'json' }).notNull(),\n    /** Set when the user finishes the onboarding interview; null while open. */\n    completedAt: integer('completed_at', { mode: 'timestamp' }),\n    createdAt: createdAt(),\n    updatedAt: updatedAt(),\n  }, (table) => [\n    uniqueIndex('uniq_user_intake_user').on(table.userId),\n  ])\n}\n\nfunction createProjectIntakeTable(workspaceTable: IntakeParentTable) {\n  return sqliteTable('project_intake', {\n    id: hexId(),\n    workspaceId: text('workspace_id').notNull().references(() => workspaceTable.id, { onDelete: 'cascade' }),\n    graphId: text('graph_id').notNull(),\n    payload: text('payload', { mode: 'json' }).notNull(),\n    completedAt: integer('completed_at', { mode: 'timestamp' }),\n    createdAt: createdAt(),\n    updatedAt: updatedAt(),\n  }, (table) => [\n    uniqueIndex('uniq_project_intake_workspace').on(table.workspaceId),\n    index('idx_project_intake_graph').on(table.graphId),\n  ])\n}\n\n/**\n * Build the intake tables wired to the product's tables. Always returns\n * `userIntake`; returns `projectIntake` only when `workspaceTable` is passed.\n * The return type carries `projectIntake?` so a consumer that passes no\n * workspace table cannot reference a table that does not exist.\n */\nexport function createIntakeTables<O extends CreateIntakeTablesOptions>(\n  opts: O,\n): IntakeTables<O> {\n  const userIntake = createUserIntakeTable(opts.userTable)\n  const result: { userIntake: ReturnType<typeof createUserIntakeTable>; projectIntake?: ReturnType<typeof createProjectIntakeTable> } = {\n    userIntake,\n  }\n  if (opts.workspaceTable) {\n    result.projectIntake = createProjectIntakeTable(opts.workspaceTable)\n  }\n  return result as IntakeTables<O>\n}\n\n/** Resolve the structure and data of a user intake table based on the createUserIntakeTable function */\nexport type UserIntakeTable = ReturnType<typeof createUserIntakeTable>\n/** Resolve the structure and data of the project intake table from the factory function */\nexport type ProjectIntakeTable = ReturnType<typeof createProjectIntakeTable>\n\n/**\n * The tables returned for a given options shape: `projectIntake` is present in\n * the type exactly when `workspaceTable` was provided.\n */\nexport type IntakeTables<O extends CreateIntakeTablesOptions> =\n  O extends { workspaceTable: IntakeParentTable }\n    ? { userIntake: UserIntakeTable; projectIntake: ProjectIntakeTable }\n    : { userIntake: UserIntakeTable; projectIntake?: ProjectIntakeTable }\n\n/** The union table shape, for code that handles either scope generically. */\nexport type AnyIntakeTables = { userIntake: UserIntakeTable; projectIntake?: ProjectIntakeTable }\n\n/** Infer and represent a selected row from the UserIntakeTable data structure */\nexport type UserIntakeRow = UserIntakeTable['$inferSelect']\n/** Resolve the selected data structure for a project intake table row */\nexport type ProjectIntakeRow = ProjectIntakeTable['$inferSelect']\n"],"mappings":";;;;;;;;;AAwBA,SAAS,WAAW;AACpB,SAAS,OAAO,SAAS,aAAa,MAAM,mBAAmB;AAmB/D,IAAM,QAAQ,MAAM,KAAK,IAAI,EAAE,WAAW,EAAE,QAAQ,iCAAiC;AAErF,IAAM,YAAY,MAAM,QAAQ,cAAc,EAAE,MAAM,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,kBAAkB;AAEzG,IAAM,YAAY,MAAM,QAAQ,cAAc,EAAE,MAAM,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,kBAAkB;AAEzG,SAAS,sBAAsB,WAA8B;AAC3D,SAAO,YAAY,eAAe;AAAA,IAChC,IAAI,MAAM;AAAA,IACV,QAAQ,KAAK,SAAS,EAAE,QAAQ,EAAE,WAAW,MAAM,UAAU,IAAI,EAAE,UAAU,UAAU,CAAC;AAAA;AAAA,IAExF,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA;AAAA,IAElC,SAAS,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC,EAAE,QAAQ;AAAA;AAAA,IAEnD,aAAa,QAAQ,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAAA,IAC1D,WAAW,UAAU;AAAA,IACrB,WAAW,UAAU;AAAA,EACvB,GAAG,CAAC,UAAU;AAAA,IACZ,YAAY,uBAAuB,EAAE,GAAG,MAAM,MAAM;AAAA,EACtD,CAAC;AACH;AAEA,SAAS,yBAAyB,gBAAmC;AACnE,SAAO,YAAY,kBAAkB;AAAA,IACnC,IAAI,MAAM;AAAA,IACV,aAAa,KAAK,cAAc,EAAE,QAAQ,EAAE,WAAW,MAAM,eAAe,IAAI,EAAE,UAAU,UAAU,CAAC;AAAA,IACvG,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA,IAClC,SAAS,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC,EAAE,QAAQ;AAAA,IACnD,aAAa,QAAQ,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAAA,IAC1D,WAAW,UAAU;AAAA,IACrB,WAAW,UAAU;AAAA,EACvB,GAAG,CAAC,UAAU;AAAA,IACZ,YAAY,+BAA+B,EAAE,GAAG,MAAM,WAAW;AAAA,IACjE,MAAM,0BAA0B,EAAE,GAAG,MAAM,OAAO;AAAA,EACpD,CAAC;AACH;AAQO,SAAS,mBACd,MACiB;AACjB,QAAM,aAAa,sBAAsB,KAAK,SAAS;AACvD,QAAM,SAAgI;AAAA,IACpI;AAAA,EACF;AACA,MAAI,KAAK,gBAAgB;AACvB,WAAO,gBAAgB,yBAAyB,KAAK,cAAc;AAAA,EACrE;AACA,SAAO;AACT;","names":[]}

package/dist/intakes/index.d.ts

@@ -1,5 +1,5 @@
-export { A as AnswerRejectionReason, c as AnswerValidationResult, d as IntakeAnswerType, I as IntakeAnswerValue, e as IntakeAnswers, b as IntakeGraph, f as IntakeOption, a as IntakeQuestion, g as getQuestion, h as hasAnswer, i as intakeProgress, j as isComplete, n as nextQuestion, r as reachableQuestions, v as validateAnswer } from '../model-Bzi5i63l.js';
-export { I as IntakePayload, e as emptyPayload, m as markComplete, p as payloadComplete, a as payloadIsStale, w as withAnswer } from '../completion-Kaqp_tWk.js';
+export { A as AnswerRejectionReason, c as AnswerValidationResult, d as IntakeAnswerType, I as IntakeAnswerValue, e as IntakeAnswers, b as IntakeGraph, f as IntakeOption, a as IntakeQuestion, g as getQuestion, h as hasAnswer, i as intakeProgress, j as isComplete, n as nextQuestion, r as reachableQuestions, v as validateAnswer } from '../model-C8U0HZxL.js';
+export { I as IntakePayload, e as emptyPayload, m as markComplete, p as payloadComplete, a as payloadIsStale, w as withAnswer } from '../completion-CvcNUz07.js';
 
 /**
  * Pure context-sufficiency floor + conversational-gather scaffold — the

package/dist/intakes/index.js

@@ -4,7 +4,7 @@ import {
   payloadComplete,
   payloadIsStale,
   withAnswer
-} from "../chunk-USYXHDKE.js";
+} from "../chunk-YZ6KQULN.js";
 import {
   getQuestion,
   hasAnswer,
@@ -13,7 +13,7 @@ import {
   nextQuestion,
   reachableQuestions,
   validateAnswer
-} from "../chunk-ND3XEGBE.js";
+} from "../chunk-JDEGS53O.js";
 
 // src/intakes/context-sufficiency.ts
 function presentValue(value) {

package/dist/intakes-react/index.d.ts

@@ -1,4 +1,4 @@
-import { I as IntakeAnswerValue, a as IntakeQuestion } from '../model-Bzi5i63l.js';
+import { I as IntakeAnswerValue, a as IntakeQuestion } from '../model-C8U0HZxL.js';
 import * as react from 'react';
 
 /**
@@ -22,6 +22,7 @@ interface IntakeView {
         total: number;
     };
 }
+/** Define properties and callbacks for managing the intake interview flow and user interactions */
 interface IntakeInterviewProps {
     view: IntakeView;
     /**

package/dist/intakes-react/index.js

@@ -1,7 +1,7 @@
 import {
   IntakeInterview
-} from "../chunk-5I72FRZY.js";
-import "../chunk-ND3XEGBE.js";
+} from "../chunk-VOJB7MVG.js";
+import "../chunk-JDEGS53O.js";
 export {
   IntakeInterview
 };

package/dist/intakes-react/lazy.d.ts

@@ -1,8 +1,9 @@
 import * as react from 'react';
 import { IntakeInterview } from './index.js';
 export { IntakeInterviewProps } from './index.js';
-import '../model-Bzi5i63l.js';
+import '../model-C8U0HZxL.js';
 
+/** Load IntakeInterview component lazily to optimize initial application rendering */
 declare const IntakeInterviewLazy: react.LazyExoticComponent<typeof IntakeInterview>;
 
 export { IntakeInterviewLazy };

package/dist/intakes-react/lazy.js

@@ -1,7 +1,7 @@
 // src/intakes-react/lazy.tsx
 import { lazy } from "react";
 var IntakeInterviewLazy = lazy(
-  () => import("../IntakeInterview-WHVKMNQW.js").then((m) => ({ default: m.IntakeInterview }))
+  () => import("../IntakeInterview-3ZIQMZS6.js").then((m) => ({ default: m.IntakeInterview }))
 );
 export {
   IntakeInterviewLazy

package/dist/intakes-react/lazy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/intakes-react/lazy.tsx"],"sourcesContent":["/**\n * Code-split entry for the intakes React surface. Products that don't need the\n * interview UI on initial load import this `React.lazy` handle instead of the\n * component directly, so the interview chunk loads on first render. Mount inside\n * a `<Suspense>` boundary; the product provides the fallback.\n */\n\nimport { lazy } from 'react'\nimport type { IntakeInterviewProps } from './contracts'\n\nexport type { IntakeInterviewProps }\n\nexport const IntakeInterviewLazy = lazy(\n  () => import('./components/IntakeInterview').then((m) => ({ default: m.IntakeInterview })),\n)\n"],"mappings":";AAOA,SAAS,YAAY;AAKd,IAAM,sBAAsB;AAAA,EACjC,MAAM,OAAO,gCAA8B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE;AAC3F;","names":[]}
+{"version":3,"sources":["../../src/intakes-react/lazy.tsx"],"sourcesContent":["/**\n * Code-split entry for the intakes React surface. Products that don't need the\n * interview UI on initial load import this `React.lazy` handle instead of the\n * component directly, so the interview chunk loads on first render. Mount inside\n * a `<Suspense>` boundary; the product provides the fallback.\n */\n\nimport { lazy } from 'react'\nimport type { IntakeInterviewProps } from './contracts'\n\nexport type { IntakeInterviewProps }\n\n/** Load IntakeInterview component lazily to optimize initial application rendering */\nexport const IntakeInterviewLazy = lazy(\n  () => import('./components/IntakeInterview').then((m) => ({ default: m.IntakeInterview })),\n)\n"],"mappings":";AAOA,SAAS,YAAY;AAMd,IAAM,sBAAsB;AAAA,EACjC,MAAM,OAAO,gCAA8B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE;AAC3F;","names":[]}

package/dist/integrations/index.d.ts

@@ -12,6 +12,7 @@ type HubExecResult = {
     message: string;
     approval?: unknown;
 };
+/** Define configuration options for initializing a Hub execution client */
 interface HubExecClientOptions {
     /** Platform base URL (e.g. `TANGLE_PLATFORM_URL`). */
     baseUrl: string;
@@ -53,16 +54,19 @@ declare class HubExecClient {
     }): Promise<HubExecResult>;
     private readEnvelope;
 }
+/** Define input parameters for invoking a hub tool with user ID, tool name, and optional arguments */
 interface HubInvokeInput {
     userId: string;
     /** The MCP tool name the agent called (`int_<provider>_<connector>_<action>`). */
     toolName: string;
     args?: Record<string, unknown>;
 }
+/** Describe the outcome of a hub invocation including status and response body */
 interface HubInvokeOutcome {
     status: number;
     body: Record<string, unknown>;
 }
+/** Define dependencies for invoking hub operations including API key resolution and optional configuration */
 interface HubInvokeDeps {
     /** Resolve the user's Tangle API key (the hub principal bearer). Required —
      *  the product binds its own session-key resolver. Null → user not linked. */

package/dist/integrations/index.js

@@ -2,7 +2,7 @@ import {
   HubExecClient,
   invokeIntegrationHub,
   resolveIntegrationAction
-} from "../chunk-L2TG5DBW.js";
+} from "../chunk-5TESA4SN.js";
 export {
   HubExecClient,
   invokeIntegrationHub,

package/dist/interactions/index.d.ts

@@ -1,5 +1,5 @@
-import { k as InteractionRequestWire } from '../contract-KfqJh_au.js';
-export { C as ChatInteraction, a as ChatInteractionField, b as ChatInteractionStatus, c as ChatSelectField, d as ComposerAnswerDelivery, I as INTERACTION_CANCEL_EVENT, e as INTERACTION_EVENT, f as INTERACTION_RESOLVED_EVENT, g as InteractionAnswerValue, h as InteractionAnswers, i as InteractionCancelData, j as InteractionPersistedPart, N as NoticeKind, l as NoticePersistedPart, P as ParseInteractionAnswersResult, m as ParseInteractionResult, n as canTransitionInteractionStatus, o as cancelStatusFor, p as composerAnswerData, q as composerAnswerDeliveries, r as dedupeQuestionInteractionsByContent, s as fieldAcceptsFreeText, t as interactionFromWireRequest, u as interactionPartKey, v as interactionToPersistedPart, w as isRenderableInteractionKind, x as isSafeInteractionFieldKey, y as isTerminalInteractionStatus, z as noticePart, A as noticePartKey, B as parseInteractionAnswers, D as parseInteractionCancel, E as parseInteractionRequest, F as persistedPartToInteraction, G as questionInteractionContentSignature, H as stampInteractionAnswers } from '../contract-KfqJh_au.js';
+import { k as InteractionRequestWire } from '../contract-TjB68uqA.js';
+export { C as ChatInteraction, a as ChatInteractionField, b as ChatInteractionStatus, c as ChatSelectField, d as ComposerAnswerDelivery, I as INTERACTION_CANCEL_EVENT, e as INTERACTION_EVENT, f as INTERACTION_RESOLVED_EVENT, g as InteractionAnswerValue, h as InteractionAnswers, i as InteractionCancelData, j as InteractionPersistedPart, N as NoticeKind, l as NoticePersistedPart, P as ParseInteractionAnswersResult, m as ParseInteractionResult, n as canTransitionInteractionStatus, o as cancelStatusFor, p as composerAnswerData, q as composerAnswerDeliveries, r as dedupeQuestionInteractionsByContent, s as fieldAcceptsFreeText, t as interactionFromWireRequest, u as interactionPartKey, v as interactionToPersistedPart, w as isRenderableInteractionKind, x as isSafeInteractionFieldKey, y as isTerminalInteractionStatus, z as noticePart, A as noticePartKey, B as parseInteractionAnswers, D as parseInteractionCancel, E as parseInteractionRequest, F as persistedPartToInteraction, G as questionInteractionContentSignature, H as stampInteractionAnswers } from '../contract-TjB68uqA.js';
 import { InteractionOutcome, InteractionData } from '@tangle-network/agent-interface';
 export { InteractionData, InteractionOutcome, InteractionRequest } from '@tangle-network/agent-interface';
 
@@ -15,12 +15,14 @@ export { InteractionData, InteractionOutcome, InteractionRequest } from '@tangle
  * session id) — no sandbox-SDK import, so any box-resolution strategy works.
  */
 
+/** Describe error details including code, message, and upstream HTTP status for sidecar interactions */
 interface SidecarInteractionsError {
     code: string;
     message: string;
     /** Upstream HTTP status; 0 when the sidecar was unreachable. */
     status: number;
 }
+/** Represent the outcome of sidecar interactions with success or error details */
 type SidecarInteractionsResult<T> = {
     succeeded: true;
     value: T;
@@ -79,7 +81,9 @@ declare function respondToSessionInteraction(connection: SidecarInteractionsConn
  * router import anywhere.
  */
 
+/** Define possible outcomes for an interaction client as accepted or declined */
 type InteractionClientOutcome = 'accepted' | 'declined';
+/** Validate interaction answer body and return success with data or failure with error message */
 type InteractionAnswerBodyValidation = {
     ok: true;
     id: string;
@@ -92,6 +96,7 @@ type InteractionAnswerBodyValidation = {
 /** Validates the client POST body: `{ id, outcome, data? }` with
  *  identifier-safe field keys and primitive/string-array values only. */
 declare function validateInteractionAnswerBody(body: Record<string, unknown>): InteractionAnswerBodyValidation;
+/** Provide logging methods for warnings and errors in interaction routes */
 type InteractionRouteLogger = Pick<Console, 'warn' | 'error'>;
 /** Sidecar error → the client-actionable contract. Every "the ask is gone"
  *  shape maps to 410 so the card flips to its expired state — a raw 404/409
@@ -111,6 +116,7 @@ type InteractionConnectionResolution = {
     ok: false;
     unavailable: string;
 };
+/** Define arguments required to resolve interaction connections based on request and intent */
 interface ResolveInteractionConnectionArgs {
     request: Request;
     intent: 'list' | 'answer';
@@ -118,6 +124,7 @@ interface ResolveInteractionConnectionArgs {
      *  read product routing fields (workspaceId/threadId) without re-parsing. */
     body?: Record<string, unknown>;
 }
+/** Describe the arguments provided before processing an interaction answer including request, body, and connection details */
 interface BeforeInteractionAnswerArgs {
     request: Request;
     /** Original parsed body, including product routing fields. */
@@ -133,6 +140,7 @@ interface BeforeInteractionAnswerArgs {
     /** Content-identical questions that the shared route will also answer. */
     duplicateRequests: InteractionRequestWire[];
 }
+/** Define arguments for durable interaction routes including a stable caller-created attempt key */
 interface DurableInteractionRouteArgs extends BeforeInteractionAnswerArgs {
     /** Caller-created opaque identifier, stable across an ambiguous retry. */
     attemptKey: string;
@@ -167,6 +175,7 @@ interface DurableInteractionRoutePersistence<TPrepared = unknown> {
         error: unknown;
     }): void | Promise<void>;
 }
+/** Define options to authenticate, authorize, and manage persistence for interaction answer routes */
 interface InteractionAnswerRouteOptions {
     /** Authenticate + authorize the caller and resolve the sidecar connection.
      *  This is the only product-supplied step: session auth, workspace/thread
@@ -180,6 +189,7 @@ interface InteractionAnswerRouteOptions {
     durable?: DurableInteractionRoutePersistence;
     logger?: InteractionRouteLogger;
 }
+/** Define routes to list outstanding interactions and resolve answers for live turns */
 interface InteractionAnswerRoute {
     /** GET — outstanding interactions for a live turn. Failures return an empty
      *  list with an explicit `unavailable` code: the caller is a best-effort
@@ -191,6 +201,7 @@ interface InteractionAnswerRoute {
      *  actually unblocked. */
     answer: (request: Request) => Promise<Response>;
 }
+/** Create an interaction answer route that handles listing and resolving interaction requests */
 declare function createInteractionAnswerRoute(options: InteractionAnswerRouteOptions): InteractionAnswerRoute;
 
 export { type BeforeInteractionAnswerArgs, type DurableInteractionRouteArgs, type DurableInteractionRoutePersistence, type InteractionAnswerBodyValidation, type InteractionAnswerRoute, type InteractionAnswerRouteOptions, type InteractionClientOutcome, type InteractionConnectionResolution, InteractionRequestWire, type InteractionRouteLogger, type ResolveInteractionConnectionArgs, type SidecarInteractionsConnection, type SidecarInteractionsError, type SidecarInteractionsResult, createInteractionAnswerRoute, listSessionInteractions, mapInteractionRespondFailure, respondToSessionInteraction, validateInteractionAnswerBody };

package/dist/interactions/index.js

@@ -5,7 +5,7 @@ import {
   mapInteractionRespondFailure,
   respondToSessionInteraction,
   validateInteractionAnswerBody
-} from "../chunk-6KVH5SP5.js";
+} from "../chunk-7YW6EBDX.js";
 import {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -30,7 +30,7 @@ import {
   persistedPartToInteraction,
   questionInteractionContentSignature,
   stampInteractionAnswers
-} from "../chunk-XAWFPMAR.js";
+} from "../chunk-YKOM4ZLQ.js";
 export {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,

package/dist/{invitations-CZ5G2tIn.d.ts → invitations-DoYMvXea.d.ts}

@@ -1,4 +1,4 @@
-import { A as AssignableWorkspaceRole } from './roles-BC1n4t37.js';
+import { A as AssignableWorkspaceRole } from './roles-B4nU3jDi.js';
 
 /**
  * Pure invitation helpers + email-template renderer for the teams capability.
@@ -15,11 +15,17 @@ import { A as AssignableWorkspaceRole } from './roles-BC1n4t37.js';
 
 /** The role an invitation grants — the assignable workspace ladder (never owner). */
 type InvitationPermission = AssignableWorkspaceRole;
+/** Define possible states for an invitation's lifecycle including pending, accepted, expired, and revoked */
 type InvitationStatus = 'pending' | 'accepted' | 'expired' | 'revoked';
+/** Define possible statuses for the sending state of an invitation email */
 type InvitationEmailStatus = 'not_sent' | 'sent' | 'failed';
+/** Define the number of days before an invitation expires */
 declare const INVITATION_EXPIRY_DAYS = 7;
+/** Normalize an invitation email by trimming whitespace and converting to lowercase */
 declare function normalizeInvitationEmail(email: string): string;
+/** Resolve invitation permission from a string or return null if invalid */
 declare function parseInvitationPermission(value: string | undefined): InvitationPermission | null;
+/** Calculate the expiration date of an invitation based on the given or current date */
 declare function getInvitationExpiresAt(now?: Date): Date;
 /**
  * A cryptographically-random, URL-safe invitation token. `inv_`-prefixed so a
@@ -27,7 +33,9 @@ declare function getInvitationExpiresAt(now?: Date): Date;
  * tokens minted by `members-api` (`generateInviteToken`).
  */
 declare function generateInvitationToken(): string;
+/** Generate an invite URL by combining the origin with an encoded token */
 declare function inviteUrlForToken(origin: string, token: string): string;
+/** Define input data required to render an invitation email template */
 interface RenderInvitationEmailInput {
     to: string;
     workspaceName: string;
@@ -36,10 +44,12 @@ interface RenderInvitationEmailInput {
     inviteUrl: string;
     expiresAt: Date;
 }
+/** Define the structure for an invitation email brand including the RFC-5322 From header */
 interface InvitationEmailBrand {
     /** RFC-5322 From header, e.g. `GTM Agent <noreply@gtm.tangle.tools>`. */
     fromAddress: string;
 }
+/** Define the structure of a fully rendered invitation email with sender, subject, and content fields */
 interface RenderedInvitationEmail {
     from: string;
     subject: string;

package/dist/{invitations-schema-DaMO4hZE.d.ts → invitations-schema-_fI7HkJP.d.ts}

@@ -1,6 +1,7 @@
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
-import { g as TeamParentTable } from './access-BZ81Btt5.js';
+import { g as TeamParentTable } from './access-490O6aOU.js';
 
+/** Define options for creating a workspace invitation table with user, workspace, and organization references */
 interface CreateWorkspaceInvitationTableOptions {
     /** The product's user table — `invitedByUserId` references `userTable.id`. */
     userTable: TeamParentTable;
@@ -9,6 +10,7 @@ interface CreateWorkspaceInvitationTableOptions {
     /** The `organizations` table from `createTeamTables` — `organizationId` references it. */
     organizationTable: TeamParentTable;
 }
+/** Build a workspace invitation table with defined columns and foreign key constraints */
 declare function createWorkspaceInvitationTable(opts: CreateWorkspaceInvitationTableOptions): {
     workspaceInvitations: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
         name: "workspace_invitation";
@@ -274,7 +276,9 @@ declare function createWorkspaceInvitationTable(opts: CreateWorkspaceInvitationT
         dialect: "sqlite";
     }>;
 };
+/** Resolve the structure of workspace invitation tables from the creation function */
 type WorkspaceInvitationTables = ReturnType<typeof createWorkspaceInvitationTable>;
+/** Resolve the structure of a workspace invitation row from the workspaceInvitations table */
 type WorkspaceInvitationRow = WorkspaceInvitationTables['workspaceInvitations']['$inferSelect'];
 
 export { type CreateWorkspaceInvitationTableOptions as C, type WorkspaceInvitationRow as W, type WorkspaceInvitationTables as a, createWorkspaceInvitationTable as c };

package/dist/knowledge/index.d.ts

@@ -40,6 +40,7 @@ type SatisfiedByRule =
 } | {
     allOf: SatisfiedByRule[];
 };
+/** Define the criteria and conditions required to satisfy a specific knowledge requirement */
 interface KnowledgeRequirementSpec {
     id: string;
     description: string;
@@ -70,6 +71,7 @@ interface KnowledgeStateAccessor {
         statusIn?: string[];
     }) => number | Promise<number>;
 }
+/** Define a signal representing knowledge with confidence level and optional supporting evidence */
 interface KnowledgeSignal {
     confidence: number;
     evidence?: string;

package/dist/knowledge/index.js

@@ -1,7 +1,7 @@
 import {
   buildKnowledgeRequirements,
   deriveSignals
-} from "../chunk-ZXNXAQAH.js";
+} from "../chunk-AP2UXKUK.js";
 export {
   buildKnowledgeRequirements,
   deriveSignals

package/dist/knowledge-loop/index.d.ts

@@ -2,7 +2,7 @@ import { KnowledgeResearchLoopContext, AddSourceTextInput, SourceAdapter, RunKno
 import { KnowledgeSourceSpec, AgentKnowledgeConfig } from '../config/index.js';
 import '../knowledge/index.js';
 import '@tangle-network/agent-eval';
-import '../model-dF2h4xT9.js';
+import '../model-DmdkIteM.js';
 
 /**
  * `@tangle-network/agent-app/knowledge-loop` — wire the declarative
@@ -99,6 +99,7 @@ interface KnowledgeGateVerdict {
 interface KnowledgeDecider {
     (input: KnowledgeDeciderInput): Promise<KnowledgeDecision> | KnowledgeDecision;
 }
+/** Define the input parameters required to decide knowledge proposals within an agent-knowledge loop */
 interface KnowledgeDeciderInput {
     /** The agent-knowledge loop context for this iteration. */
     context: KnowledgeResearchLoopContext;
@@ -113,6 +114,7 @@ interface KnowledgeDeciderInput {
     /** The agent-runtime turn driver, if one was supplied to the loop. */
     driver?: KnowledgeLoopDriver;
 }
+/** Define a decision containing a candidate and the gate's verdict on that candidate */
 interface KnowledgeDecision {
     /** The candidate the policy produced (may be empty to end the loop). */
     candidate: KnowledgeCandidate;
@@ -134,6 +136,7 @@ interface KnowledgeLoopDriver {
         finalText: string;
     }>;
 }
+/** Define dependencies required to create and run a knowledge processing loop */
 interface CreateKnowledgeLoopDeps {
     /**
      * The knowledge-base root the loop reads/writes (an agent-knowledge layout).

package/dist/knowledge-loop/index.js

@@ -2,7 +2,7 @@ import {
   createKnowledgeLoop,
   createReviewerDecider,
   reviewCandidate
-} from "../chunk-EEPJGZJW.js";
+} from "../chunk-GPBRL2XR.js";
 export {
   createKnowledgeLoop,
   createReviewerDecider,

package/dist/{lazy-C7LiVeFt.d.ts → lazy-DrkVyDpe.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { c as SceneDocument } from './model-BBwyOuWG.js';
-import { D as DesignCanvasProps, c as createSceneCommandStack, E as ExportTriggerOptions } from './command-stack-B_-WNfZU.js';
+import { c as SceneDocument } from './model-DnfO_PdJ.js';
+import { D as DesignCanvasProps, c as createSceneCommandStack, E as ExportTriggerOptions } from './command-stack-TNPWJCzW.js';
 
 /** Callers inject a workspace renderer so this chrome stays Konva-free. The
  *  workspace occupies the scrollable area between the rulers and the bottom bar. */

package/dist/{mcp-BHfIoGLW.d.ts → mcp-BjPqQ-3C.d.ts}

@@ -1,5 +1,5 @@
-import { c as AppToolContext, f as AppToolName, d as AppToolDefinition } from './types-BEOvc_ue.js';
-import { a as ToolHeaderNames } from './auth-DuptSkWh.js';
+import { c as AppToolContext, f as AppToolName, d as AppToolDefinition } from './types-CBRyqijY.js';
+import { a as ToolHeaderNames } from './auth-_FU8w01b.js';
 
 /** Default route path each app tool is served at. A product mounts its routes
  *  at these paths (or supplies its own via {@link BuildMcpServerOptions.paths}). */
@@ -16,6 +16,7 @@ interface AppToolMcpServer {
         description: string;
     };
 }
+/** Define configuration options for building an HTTP MCP server including path, baseUrl, token, context, and description */
 interface BuildHttpMcpServerOptions {
     /** Route path on the app the sandbox POSTs to (e.g. `/api/tools/propose`). */
     path: string;
@@ -73,6 +74,7 @@ declare function buildScopedMcpServerEntry(opts: ScopedMcpServerEntryOptions & {
     label: string;
     defaultDescription: string;
 }): AppToolMcpServer;
+/** Define configuration options required to build an MCP server including tool, baseUrl, token, and context */
 interface BuildMcpServerOptions {
     /** A built-in app tool name, or a product-registered {@link AppToolDefinition}.
      *  A custom tool supplies its route via `AppToolDefinition.path` (or `paths`). */

package/dist/{mcp-rpc-DLw_r9PQ.d.ts → mcp-rpc-BfUOsalw.d.ts}

@@ -17,7 +17,9 @@
  * retries. Protocol misuse becomes a JSON-RPC error object.
  */
 declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
+/** Resolve a valid protocol version from the predefined MCP_PROTOCOL_VERSIONS array */
 type McpProtocolVersion = (typeof MCP_PROTOCOL_VERSIONS)[number];
+/** Describe the structure of server information including name and version */
 interface McpServerInfo {
     name: string;
     version: string;
@@ -32,6 +34,7 @@ interface McpToolDefinition<TEnv = Record<string, never>> {
      *  surface an isError result — never throw for protocol/framing issues. */
     run(args: Record<string, unknown>, env: TEnv): Promise<unknown>;
 }
+/** Define options for creating a handler that manages MCP tools with environment support */
 interface CreateMcpToolHandlerOptions<TEnv = Record<string, never>> {
     serverInfo: McpServerInfo;
     /** Full tool list; order IS the tools/list order. */