@tangle-network/agent-app 0.34.0 → 0.36.0

package/dist/chunk-DTS5TZRN.js

@@ -0,0 +1,293 @@
+// src/studio/generation.ts
+var GENERATION_TYPES = ["image", "video", "avatar", "speech", "transcription"];
+function isGenerationType(value) {
+  return GENERATION_TYPES.includes(value);
+}
+var DESTINATIONS = [
+  { id: "instagram", label: "Instagram", providerIds: ["instagram"], fields: "Caption, hashtags, crop" },
+  { id: "tiktok", label: "TikTok", providerIds: ["tiktok"], fields: "Caption, audio note, vertical video" },
+  { id: "youtube-shorts", label: "YouTube Shorts", providerIds: ["youtube"], fields: "Title, description, vertical video" },
+  { id: "linkedin", label: "LinkedIn", providerIds: ["linkedin"], fields: "Caption, link, creator/company page" },
+  { id: "x", label: "X", providerIds: ["twitter"], fields: "Short copy, mentions, thread option" }
+];
+var CADENCES = ["Manual approval", "Publish now", "Daily creative drop", "Weekly series"];
+var MIN_IMAGE_COUNT = 1;
+var MAX_IMAGE_COUNT = 4;
+function relativeTime(date) {
+  if (!date) return "";
+  const now = Date.now();
+  const diff = now - new Date(date).getTime();
+  const minutes = Math.floor(diff / 6e4);
+  if (minutes < 1) return "just now";
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d ago`;
+  return new Date(date).toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+function outputPathFor(type) {
+  if (type === "image") return "generated/images";
+  if (type === "video") return "generated/videos";
+  if (type === "avatar") return "generated/avatars";
+  if (type === "speech") return "generated/audio";
+  return "generated/transcripts";
+}
+function generationVaultPath(generation) {
+  const value = generation.metadata?.vaultPath;
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function buildPublishPackage({
+  caption,
+  postDescription,
+  mentions,
+  cadence,
+  destinations
+}) {
+  const trimmedCaption = caption.trim();
+  const trimmedDescription = postDescription.trim();
+  const parsedMentions = mentions.split(",").map((item) => item.trim()).filter(Boolean);
+  const selectedDestinations = destinations.filter(Boolean);
+  const trimmedCadence = cadence.trim() || "Manual approval";
+  const hasPublishContent = Boolean(
+    trimmedCaption || trimmedDescription || parsedMentions.length > 0 || selectedDestinations.length > 0 || trimmedCadence !== "Manual approval"
+  );
+  if (!hasPublishContent) return null;
+  return {
+    caption: trimmedCaption,
+    description: trimmedDescription,
+    mentions: parsedMentions,
+    destinations: selectedDestinations,
+    cadence: trimmedCadence,
+    workflowDraft: trimmedCadence !== "Manual approval",
+    evalContract: {
+      artifactType: "publish_package",
+      deterministicChecks: ["has_asset", "has_destination", "has_caption_or_description", "has_cadence"]
+    }
+  };
+}
+function isPublishPackage(value) {
+  if (!value || typeof value !== "object") return false;
+  const publishPackage = value;
+  const destinations = Array.isArray(publishPackage.destinations) ? publishPackage.destinations.filter(Boolean) : [];
+  const mentions = Array.isArray(publishPackage.mentions) ? publishPackage.mentions.filter(Boolean) : [];
+  return Boolean(
+    destinations.length > 0 || mentions.length > 0 || typeof publishPackage.caption === "string" && publishPackage.caption.trim() || typeof publishPackage.description === "string" && publishPackage.description.trim() || typeof publishPackage.cadence === "string" && publishPackage.cadence.trim() && publishPackage.cadence.trim() !== "Manual approval"
+  );
+}
+function isDestinationConnected(destination, connections) {
+  return connections.some((connection) => connection.status === "connected" && (destination.providerIds.includes(connection.providerId) || destination.providerIds.includes(connection.connectorId)));
+}
+function selectedModelsWithDefaults(current, catalog) {
+  const next = { ...current };
+  for (const key of GENERATION_TYPES) {
+    const models = catalog.models[key] ?? [];
+    const currentOption = models.find((model) => model.id === next[key]);
+    if (!next[key] || !currentOption || currentOption.status === "unavailable") {
+      next[key] = preferredModelId(key, catalog) ?? "";
+    }
+  }
+  return next;
+}
+function preferredModelId(type, catalog) {
+  if (!catalog) return void 0;
+  const models = catalog.models[type] ?? [];
+  const preferred = catalog.defaults[type];
+  return models.find((model) => model.id === preferred)?.id ?? models.find((model) => model.status !== "unavailable")?.id ?? models[0]?.id;
+}
+function modelMessage(model, loading, count) {
+  if (loading) return "Loading media models...";
+  if (count === 0) return "No models are available for this media type.";
+  if (!model) return "Select a model.";
+  if (model.status === "unavailable") return model.reason ?? "This model is not configured.";
+  if (model.status === "limited") return model.reason ? `Limited: ${model.reason}` : "Limited availability.";
+  return null;
+}
+function buildGenerationRequestBody(fields) {
+  const body = {
+    workspaceId: fields.workspaceId,
+    clientRequestId: fields.clientRequestId,
+    type: fields.type,
+    model: fields.model,
+    prompt: fields.prompt.trim(),
+    negativePrompt: fields.negativePrompt.trim() || void 0,
+    outputPath: fields.outputPath.trim() || void 0
+  };
+  if (fields.publishPackage) body.publishPackage = fields.publishPackage;
+  if (fields.type === "image") Object.assign(body, {
+    size: fields.image.size,
+    quality: fields.image.quality,
+    n: fields.image.count
+  });
+  if (fields.type === "video") {
+    const duration = Number(fields.video.duration);
+    Object.assign(body, {
+      // omit (let the API default) rather than serialize NaN → null on bad input
+      duration: Number.isFinite(duration) ? duration : void 0,
+      resolution: fields.video.resolution,
+      aspectRatio: fields.video.aspectRatio.trim() || void 0,
+      referenceImageUrl: fields.video.referenceImageUrl.trim() || void 0
+    });
+  }
+  if (fields.type === "speech") Object.assign(body, { voice: fields.speech.voice });
+  if (fields.type === "avatar") Object.assign(body, {
+    audioUrl: fields.avatar.audioUrl.trim(),
+    imageUrl: fields.avatar.imageUrl.trim() || void 0,
+    avatarId: fields.avatar.avatarId.trim() || void 0
+  });
+  if (fields.type === "transcription") {
+    const temperature = Number(fields.transcription.temperature);
+    Object.assign(body, {
+      audioUrl: fields.transcription.audioUrl.trim(),
+      language: fields.transcription.language.trim() || void 0,
+      responseFormat: fields.transcription.responseFormat,
+      // omit (let the API default) rather than serialize NaN → null on bad input
+      temperature: Number.isFinite(temperature) ? temperature : void 0
+    });
+  }
+  return body;
+}
+function generationStatus(generation) {
+  const metadata = generation.metadata ?? {};
+  const status = typeof metadata.generationStatus === "string" ? metadata.generationStatus : "";
+  if (status === "pending" || status === "running" || status === "failed" || status === "succeeded") return status;
+  return generation.result ? "succeeded" : "pending";
+}
+function generationError(generation) {
+  const metadata = generation.metadata ?? {};
+  if (typeof metadata.providerError === "string" && metadata.providerError.trim()) {
+    return userSafeGenerationMessage(metadata.providerError);
+  }
+  if (typeof metadata.storageError === "string" && metadata.storageError.trim()) {
+    return metadata.storageError;
+  }
+  return null;
+}
+function generationClientRequestId(generation) {
+  const metadata = generation.metadata ?? {};
+  return typeof metadata.clientRequestId === "string" && metadata.clientRequestId.trim() ? metadata.clientRequestId : null;
+}
+function generationBatchSlotKey(generation) {
+  const metadata = generation.metadata ?? {};
+  const batchId = typeof metadata.batchId === "string" && metadata.batchId.trim() ? metadata.batchId : null;
+  return batchId && typeof metadata.outputIndex === "number" ? `${batchId}:${metadata.outputIndex}` : null;
+}
+function generationMergeKey(generation) {
+  return generationBatchSlotKey(generation) ?? generationClientRequestId(generation);
+}
+function mergeLiveGeneration(current, generation) {
+  const mergeKey = generationMergeKey(generation);
+  const existingIndex = current.findIndex((item) => item.id === generation.id || mergeKey && generationMergeKey(item) === mergeKey);
+  if (existingIndex === -1) return [generation, ...current];
+  const next = [...current];
+  next[existingIndex] = generation;
+  return next;
+}
+function mergeLoaderAndLive(loader, live) {
+  if (live.length === 0) return loader;
+  const leading = live.map((generation) => {
+    const mergeKey = generationMergeKey(generation);
+    return mergeKey ? loader.find((gen) => generationMergeKey(gen) === mergeKey) ?? generation : loader.find((gen) => gen.id === generation.id) ?? generation;
+  });
+  const leadingIds = new Set(leading.map((gen) => gen.id));
+  const leadingMergeKeys = new Set(leading.map((gen) => generationMergeKey(gen)).filter((id) => Boolean(id)));
+  return [
+    ...leading,
+    ...loader.filter((gen) => !leadingIds.has(gen.id) && !leadingMergeKeys.has(generationMergeKey(gen) ?? ""))
+  ];
+}
+function isLocalGeneration(generation) {
+  return generation.id.startsWith("local-");
+}
+function generationOutputIndex(generation) {
+  const value = generation.metadata?.outputIndex;
+  return typeof value === "number" ? value : 0;
+}
+function latestBatchOf(generations) {
+  const first = generations[0];
+  if (!first) return [];
+  const key = generationClientRequestId(first);
+  const batch = key ? generations.filter((generation) => generationClientRequestId(generation) === key) : [first];
+  return [...batch].sort((a, b) => generationOutputIndex(a) - generationOutputIndex(b));
+}
+function userSafeGenerationMessage(message) {
+  if (!message) return "Generation failed";
+  if (/Tangle API key is invalid or expired/i.test(message)) return message;
+  if (/(api[_ -]?key|secret|token|credential|env|configured|configuration)/i.test(message)) {
+    return "Generation failed";
+  }
+  return message;
+}
+function optimisticGeneration({
+  type,
+  prompt,
+  model,
+  clientRequestId,
+  outputIndex,
+  outputCount
+}) {
+  const batchId = outputIndex == null ? void 0 : clientRequestId;
+  return {
+    id: outputIndex == null ? `local-${clientRequestId}` : `local-${clientRequestId}-${outputIndex}`,
+    type,
+    prompt,
+    result: null,
+    model: model ?? null,
+    cost: null,
+    createdAt: /* @__PURE__ */ new Date(),
+    metadata: {
+      generationStatus: "pending",
+      provider: type,
+      clientRequestId,
+      batchId,
+      outputIndex,
+      outputCount
+    }
+  };
+}
+function failedOptimisticGeneration(generation) {
+  return {
+    ...generation,
+    metadata: {
+      ...generation.metadata ?? {},
+      generationStatus: "failed",
+      providerError: "Generation failed"
+    }
+  };
+}
+function normalizeImageCount(value) {
+  const numeric = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numeric)) return MIN_IMAGE_COUNT;
+  return Math.min(Math.max(Math.trunc(numeric), MIN_IMAGE_COUNT), MAX_IMAGE_COUNT);
+}
+
+export {
+  GENERATION_TYPES,
+  isGenerationType,
+  DESTINATIONS,
+  CADENCES,
+  MIN_IMAGE_COUNT,
+  MAX_IMAGE_COUNT,
+  relativeTime,
+  outputPathFor,
+  generationVaultPath,
+  buildPublishPackage,
+  isPublishPackage,
+  isDestinationConnected,
+  selectedModelsWithDefaults,
+  preferredModelId,
+  modelMessage,
+  buildGenerationRequestBody,
+  generationStatus,
+  generationError,
+  generationMergeKey,
+  mergeLiveGeneration,
+  mergeLoaderAndLive,
+  isLocalGeneration,
+  latestBatchOf,
+  userSafeGenerationMessage,
+  optimisticGeneration,
+  failedOptimisticGeneration,
+  normalizeImageCount
+};
+//# sourceMappingURL=chunk-DTS5TZRN.js.map

package/dist/chunk-DTS5TZRN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/studio/generation.ts"],"sourcesContent":["// Minimal structural view of a connected integration — `isDestinationConnected`\n// only reads the connection status and the provider/connector identifiers, so\n// the logic layer declares its own shape instead of depending on the\n// design-system package. A sandbox-ui `IntegrationConnection` is assignable to\n// this (it carries all three fields).\nexport interface StudioIntegrationConnection {\n  status: string\n  providerId: string\n  connectorId: string\n}\n\nexport type GenerationType = 'image' | 'video' | 'speech' | 'avatar' | 'transcription'\n\nexport type GenerationStatus = 'pending' | 'running' | 'succeeded' | 'failed'\n\nexport type MediaModelStatus = 'available' | 'limited' | 'unavailable'\n\nexport interface Generation {\n  id: string\n  type: string\n  prompt: string\n  result: string | null\n  model: string | null\n  cost: number | null\n  createdAt: Date | null\n  metadata: Record<string, unknown> | null\n}\n\nexport interface MediaModelOption {\n  id: string\n  name: string\n  provider?: string\n  type: GenerationType\n  status: MediaModelStatus\n  reason?: string\n}\n\nexport interface MediaModelCatalogResponse {\n  defaults: Record<GenerationType, string>\n  models: Record<GenerationType, MediaModelOption[]>\n  error?: string\n}\n\nexport interface PublishPackage {\n  caption: string\n  description: string\n  mentions: string[]\n  destinations: string[]\n  cadence: string\n  workflowDraft: boolean\n  evalContract: {\n    artifactType: string\n    deterministicChecks: string[]\n  }\n}\n\nexport interface PublishDestination {\n  id: string\n  label: string\n  providerIds: string[]\n  fields: string\n}\n\n// Order drives the type filter tabs and the composer segmented control\nexport const GENERATION_TYPES: readonly GenerationType[] = ['image', 'video', 'avatar', 'speech', 'transcription']\n\nexport function isGenerationType(value: string): value is GenerationType {\n  return (GENERATION_TYPES as readonly string[]).includes(value)\n}\n\nexport const DESTINATIONS: PublishDestination[] = [\n  { id: 'instagram', label: 'Instagram', providerIds: ['instagram'], fields: 'Caption, hashtags, crop' },\n  { id: 'tiktok', label: 'TikTok', providerIds: ['tiktok'], fields: 'Caption, audio note, vertical video' },\n  { id: 'youtube-shorts', label: 'YouTube Shorts', providerIds: ['youtube'], fields: 'Title, description, vertical video' },\n  { id: 'linkedin', label: 'LinkedIn', providerIds: ['linkedin'], fields: 'Caption, link, creator/company page' },\n  { id: 'x', label: 'X', providerIds: ['twitter'], fields: 'Short copy, mentions, thread option' },\n]\n\nexport const CADENCES = ['Manual approval', 'Publish now', 'Daily creative drop', 'Weekly series']\n\nexport const MIN_IMAGE_COUNT = 1\nexport const MAX_IMAGE_COUNT = 4\n\nexport function relativeTime(date: Date | null): string {\n  if (!date) return ''\n  const now = Date.now()\n  const diff = now - new Date(date).getTime()\n  const minutes = Math.floor(diff / 60000)\n  if (minutes < 1) return 'just now'\n  if (minutes < 60) return `${minutes}m ago`\n  const hours = Math.floor(minutes / 60)\n  if (hours < 24) return `${hours}h ago`\n  const days = Math.floor(hours / 24)\n  if (days < 7) return `${days}d ago`\n  return new Date(date).toLocaleDateString('en-US', { month: 'short', day: 'numeric' })\n}\n\nexport function outputPathFor(type: GenerationType): string {\n  if (type === 'image') return 'generated/images'\n  if (type === 'video') return 'generated/videos'\n  if (type === 'avatar') return 'generated/avatars'\n  if (type === 'speech') return 'generated/audio'\n  return 'generated/transcripts'\n}\n\nexport function generationVaultPath(generation: Generation): string | null {\n  const value = generation.metadata?.vaultPath\n  return typeof value === 'string' && value.trim() ? value.trim() : null\n}\n\nexport function buildPublishPackage({\n  caption,\n  postDescription,\n  mentions,\n  cadence,\n  destinations,\n}: {\n  caption: string\n  postDescription: string\n  mentions: string\n  cadence: string\n  destinations: string[]\n}): PublishPackage | null {\n  const trimmedCaption = caption.trim()\n  const trimmedDescription = postDescription.trim()\n  const parsedMentions = mentions.split(',').map((item) => item.trim()).filter(Boolean)\n  const selectedDestinations = destinations.filter(Boolean)\n  const trimmedCadence = cadence.trim() || 'Manual approval'\n  const hasPublishContent = Boolean(\n    trimmedCaption\n    || trimmedDescription\n    || parsedMentions.length > 0\n    || selectedDestinations.length > 0\n    || trimmedCadence !== 'Manual approval',\n  )\n  if (!hasPublishContent) return null\n\n  return {\n    caption: trimmedCaption,\n    description: trimmedDescription,\n    mentions: parsedMentions,\n    destinations: selectedDestinations,\n    cadence: trimmedCadence,\n    workflowDraft: trimmedCadence !== 'Manual approval',\n    evalContract: {\n      artifactType: 'publish_package',\n      deterministicChecks: ['has_asset', 'has_destination', 'has_caption_or_description', 'has_cadence'],\n    },\n  }\n}\n\nexport function isPublishPackage(value: unknown): value is { caption?: string; description?: string; mentions?: string[]; destinations?: string[]; cadence?: string } {\n  if (!value || typeof value !== 'object') return false\n  const publishPackage = value as {\n    caption?: unknown\n    description?: unknown\n    mentions?: unknown\n    destinations?: unknown\n    cadence?: unknown\n  }\n  const destinations = Array.isArray(publishPackage.destinations) ? publishPackage.destinations.filter(Boolean) : []\n  const mentions = Array.isArray(publishPackage.mentions) ? publishPackage.mentions.filter(Boolean) : []\n  return Boolean(\n    destinations.length > 0\n    || mentions.length > 0\n    || (typeof publishPackage.caption === 'string' && publishPackage.caption.trim())\n    || (typeof publishPackage.description === 'string' && publishPackage.description.trim())\n    || (typeof publishPackage.cadence === 'string' && publishPackage.cadence.trim() && publishPackage.cadence.trim() !== 'Manual approval'),\n  )\n}\n\nexport function isDestinationConnected(\n  destination: PublishDestination,\n  connections: StudioIntegrationConnection[],\n): boolean {\n  return connections.some((connection) => connection.status === 'connected'\n    && (destination.providerIds.includes(connection.providerId) || destination.providerIds.includes(connection.connectorId)))\n}\n\nexport function selectedModelsWithDefaults(\n  current: Partial<Record<GenerationType, string>>,\n  catalog: MediaModelCatalogResponse,\n): Partial<Record<GenerationType, string>> {\n  const next = { ...current }\n  for (const key of GENERATION_TYPES) {\n    const models = catalog.models[key] ?? []\n    const currentOption = models.find((model) => model.id === next[key])\n    // Reset when: no selection, selection not in catalog, or selection is unavailable.\n    // This ensures the Generate button is never stuck disabled when routeable\n    // models exist but the stored default isn't one of them.\n    if (!next[key] || !currentOption || currentOption.status === 'unavailable') {\n      next[key] = preferredModelId(key, catalog) ?? ''\n    }\n  }\n  return next\n}\n\nexport function preferredModelId(type: GenerationType, catalog: MediaModelCatalogResponse | null): string | undefined {\n  if (!catalog) return undefined\n  const models = catalog.models[type] ?? []\n  const preferred = catalog.defaults[type]\n  return models.find((model) => model.id === preferred)?.id\n    ?? models.find((model) => model.status !== 'unavailable')?.id\n    ?? models[0]?.id\n}\n\nexport function modelMessage(model: MediaModelOption | undefined, loading: boolean, count: number): string | null {\n  if (loading) return 'Loading media models...'\n  if (count === 0) return 'No models are available for this media type.'\n  if (!model) return 'Select a model.'\n  if (model.status === 'unavailable') return model.reason ?? 'This model is not configured.'\n  if (model.status === 'limited') return model.reason ? `Limited: ${model.reason}` : 'Limited availability.'\n  return null\n}\n\nexport interface GenerationRequestFields {\n  workspaceId: string\n  clientRequestId: string\n  type: GenerationType\n  model: string\n  prompt: string\n  negativePrompt: string\n  outputPath: string\n  publishPackage: PublishPackage | null\n  image: { size: string; quality: string; count: number }\n  video: { duration: string; resolution: string; aspectRatio: string; referenceImageUrl: string }\n  speech: { voice: string }\n  avatar: { audioUrl: string; imageUrl: string; avatarId: string }\n  transcription: { audioUrl: string; language: string; responseFormat: string; temperature: string }\n}\n\n// image.count must already be normalized — it is also the optimistic-card count on the caller side\nexport function buildGenerationRequestBody(fields: GenerationRequestFields): Record<string, unknown> {\n  const body: Record<string, unknown> = {\n    workspaceId: fields.workspaceId,\n    clientRequestId: fields.clientRequestId,\n    type: fields.type,\n    model: fields.model,\n    prompt: fields.prompt.trim(),\n    negativePrompt: fields.negativePrompt.trim() || undefined,\n    outputPath: fields.outputPath.trim() || undefined,\n  }\n  if (fields.publishPackage) body.publishPackage = fields.publishPackage\n  if (fields.type === 'image') Object.assign(body, {\n    size: fields.image.size,\n    quality: fields.image.quality,\n    n: fields.image.count,\n  })\n  if (fields.type === 'video') {\n    const duration = Number(fields.video.duration)\n    Object.assign(body, {\n      // omit (let the API default) rather than serialize NaN → null on bad input\n      duration: Number.isFinite(duration) ? duration : undefined,\n      resolution: fields.video.resolution,\n      aspectRatio: fields.video.aspectRatio.trim() || undefined,\n      referenceImageUrl: fields.video.referenceImageUrl.trim() || undefined,\n    })\n  }\n  if (fields.type === 'speech') Object.assign(body, { voice: fields.speech.voice })\n  if (fields.type === 'avatar') Object.assign(body, {\n    audioUrl: fields.avatar.audioUrl.trim(),\n    imageUrl: fields.avatar.imageUrl.trim() || undefined,\n    avatarId: fields.avatar.avatarId.trim() || undefined,\n  })\n  if (fields.type === 'transcription') {\n    const temperature = Number(fields.transcription.temperature)\n    Object.assign(body, {\n      audioUrl: fields.transcription.audioUrl.trim(),\n      language: fields.transcription.language.trim() || undefined,\n      responseFormat: fields.transcription.responseFormat,\n      // omit (let the API default) rather than serialize NaN → null on bad input\n      temperature: Number.isFinite(temperature) ? temperature : undefined,\n    })\n  }\n  return body\n}\n\nexport function generationStatus(generation: Generation): GenerationStatus {\n  const metadata = generation.metadata ?? {}\n  const status = typeof metadata.generationStatus === 'string' ? metadata.generationStatus : ''\n  if (status === 'pending' || status === 'running' || status === 'failed' || status === 'succeeded') return status\n  return generation.result ? 'succeeded' : 'pending'\n}\n\nexport function generationError(generation: Generation): string | null {\n  const metadata = generation.metadata ?? {}\n  if (typeof metadata.providerError === 'string' && metadata.providerError.trim()) {\n    return userSafeGenerationMessage(metadata.providerError)\n  }\n  if (typeof metadata.storageError === 'string' && metadata.storageError.trim()) {\n    return metadata.storageError\n  }\n  return null\n}\n\nfunction generationClientRequestId(generation: Generation): string | null {\n  const metadata = generation.metadata ?? {}\n  return typeof metadata.clientRequestId === 'string' && metadata.clientRequestId.trim()\n    ? metadata.clientRequestId\n    : null\n}\n\nfunction generationBatchSlotKey(generation: Generation): string | null {\n  const metadata = generation.metadata ?? {}\n  const batchId = typeof metadata.batchId === 'string' && metadata.batchId.trim() ? metadata.batchId : null\n  return batchId && typeof metadata.outputIndex === 'number'\n    ? `${batchId}:${metadata.outputIndex}`\n    : null\n}\n\nexport function generationMergeKey(generation: Generation): string | null {\n  return generationBatchSlotKey(generation) ?? generationClientRequestId(generation)\n}\n\nexport function mergeLiveGeneration(current: Generation[], generation: Generation): Generation[] {\n  const mergeKey = generationMergeKey(generation)\n  const existingIndex = current.findIndex((item) => (\n    item.id === generation.id\n    || (mergeKey && generationMergeKey(item) === mergeKey)\n  ))\n  if (existingIndex === -1) return [generation, ...current]\n\n  const next = [...current]\n  next[existingIndex] = generation\n  return next\n}\n\n// Overlay in-flight `live` generations on the loader's rows: each live row leads\n// (prefer the matching loader row by merge key / id so it carries the freshest\n// server state), then the remaining loader rows that no live row already\n// represents — deduped by BOTH id and merge key so a server row and its\n// optimistic twin never both appear. Returns `loader` unchanged when nothing is\n// live. Drives the canvas, library, and polling off one list.\nexport function mergeLoaderAndLive(loader: Generation[], live: Generation[]): Generation[] {\n  if (live.length === 0) return loader\n  const leading = live.map((generation) => {\n    const mergeKey = generationMergeKey(generation)\n    return mergeKey\n      ? loader.find((gen) => generationMergeKey(gen) === mergeKey) ?? generation\n      : loader.find((gen) => gen.id === generation.id) ?? generation\n  })\n  const leadingIds = new Set(leading.map((gen) => gen.id))\n  const leadingMergeKeys = new Set(leading\n    .map((gen) => generationMergeKey(gen))\n    .filter((id): id is string => Boolean(id)))\n  return [\n    ...leading,\n    ...loader.filter((gen) => (\n      !leadingIds.has(gen.id)\n      && !leadingMergeKeys.has(generationMergeKey(gen) ?? '')\n    )),\n  ]\n}\n\nexport function isLocalGeneration(generation: Generation): boolean {\n  return generation.id.startsWith('local-')\n}\n\nfunction generationOutputIndex(generation: Generation): number {\n  const value = generation.metadata?.outputIndex\n  return typeof value === 'number' ? value : 0\n}\n\n// The most-recent run: all generations sharing the leading item's clientRequestId\n// (a multi-image batch), ordered by output slot. Falls back to the single leading\n// item when no request id is present. Drives the result canvas.\nexport function latestBatchOf(generations: Generation[]): Generation[] {\n  const first = generations[0]\n  if (!first) return []\n  const key = generationClientRequestId(first)\n  const batch = key\n    ? generations.filter((generation) => generationClientRequestId(generation) === key)\n    : [first]\n  return [...batch].sort((a, b) => generationOutputIndex(a) - generationOutputIndex(b))\n}\n\nexport function userSafeGenerationMessage(message?: string): string {\n  if (!message) return 'Generation failed'\n  if (/Tangle API key is invalid or expired/i.test(message)) return message\n  if (/(api[_ -]?key|secret|token|credential|env|configured|configuration)/i.test(message)) {\n    return 'Generation failed'\n  }\n  return message\n}\n\nexport function optimisticGeneration({\n  type,\n  prompt,\n  model,\n  clientRequestId,\n  outputIndex,\n  outputCount,\n}: {\n  type: GenerationType\n  prompt: string\n  model?: string\n  clientRequestId: string\n  outputIndex?: number\n  outputCount?: number\n}): Generation {\n  const batchId = outputIndex == null ? undefined : clientRequestId\n  return {\n    id: outputIndex == null ? `local-${clientRequestId}` : `local-${clientRequestId}-${outputIndex}`,\n    type,\n    prompt,\n    result: null,\n    model: model ?? null,\n    cost: null,\n    createdAt: new Date(),\n    metadata: {\n      generationStatus: 'pending',\n      provider: type,\n      clientRequestId,\n      batchId,\n      outputIndex,\n      outputCount,\n    },\n  }\n}\n\nexport function failedOptimisticGeneration(generation: Generation): Generation {\n  return {\n    ...generation,\n    metadata: {\n      ...(generation.metadata ?? {}),\n      generationStatus: 'failed',\n      providerError: 'Generation failed',\n    },\n  }\n}\n\nexport function normalizeImageCount(value: unknown): number {\n  const numeric = typeof value === 'number' ? value : Number(value)\n  if (!Number.isFinite(numeric)) return MIN_IMAGE_COUNT\n  return Math.min(Math.max(Math.trunc(numeric), MIN_IMAGE_COUNT), MAX_IMAGE_COUNT)\n}\n"],"mappings":"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","names":[]}

package/dist/completion-Kaqp_tWk.d.ts

@@ -0,0 +1,41 @@
+import { e as IntakeAnswers, b as IntakeGraph, I as IntakeAnswerValue } from './model-Bzi5i63l.js';
+
+/**
+ * Pure completion-state helpers for an intake payload — the small algebra over
+ * the JSON blob the store persists. No I/O: the store reads/writes the row;
+ * these functions only build and judge the payload shape, so the same logic
+ * runs in the UI, the handlers, and the DB layer without divergence.
+ *
+ * A payload is `{ graphId, answers, completedAt? }`. It carries the answers
+ * and the id of the graph they were collected against, so a later graph
+ * revision can detect a stale payload (`graphId` mismatch) rather than
+ * silently mixing answers from two question sets.
+ */
+
+/** The persisted JSON for one intake (the `payload` column). */
+interface IntakePayload {
+    /** The graph id the answers were collected against — guards stale schemas. */
+    graphId: string;
+    answers: IntakeAnswers;
+    /** ISO-8601 instant the intake was completed, or undefined while in progress. */
+    completedAt?: string;
+}
+/** An empty payload for a fresh intake against `graph`. */
+declare function emptyPayload(graph: IntakeGraph): IntakePayload;
+/** A copy of `payload` with one answer set (does not mutate the input). */
+declare function withAnswer(payload: IntakePayload, questionId: string, value: IntakeAnswerValue): IntakePayload;
+/**
+ * True when the payload's answers complete the graph AND the payload was
+ * collected against THIS graph. A `graphId` mismatch is never "complete" —
+ * the answers belong to a different question set and must be re-collected.
+ */
+declare function payloadComplete(graph: IntakeGraph, payload: IntakePayload): boolean;
+/** True when the payload was collected against a DIFFERENT graph revision. */
+declare function payloadIsStale(graph: IntakeGraph, payload: IntakePayload): boolean;
+/**
+ * Stamp the payload complete at `at` (default now). Returns a copy; pure. The
+ * caller has already checked `payloadComplete` — this only records the instant.
+ */
+declare function markComplete(payload: IntakePayload, at?: Date): IntakePayload;
+
+export { type IntakePayload as I, payloadIsStale as a, emptyPayload as e, markComplete as m, payloadComplete as p, withAnswer as w };

package/dist/intakes/api.d.ts

@@ -1,7 +1,7 @@
-import { I as IntakeAnswerValue, a as IntakeQuestion, b as IntakeGraph } from '../model-Cuj7d-xT.js';
+import { I as IntakeAnswerValue, a as IntakeQuestion, b as IntakeGraph } from '../model-Bzi5i63l.js';
 import { IntakeStore } from './drizzle.js';
 import 'drizzle-orm/sqlite-core';
-import './index.js';
+import '../completion-Kaqp_tWk.js';
 
 /**
  * Framework-neutral intake API: the get-current / save-answer / complete logic,

package/dist/intakes/drizzle.d.ts

@@ -1,7 +1,7 @@
 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-Cuj7d-xT.js';
-import { IntakePayload } from './index.js';
+import { I as IntakeAnswerValue, b as IntakeGraph } from '../model-Bzi5i63l.js';
+import { I as IntakePayload } from '../completion-Kaqp_tWk.js';
 
 /** A product table referenced by FK — only the `id` column is touched. */
 type IntakeParentTable = AnySQLiteTable & {

package/dist/intakes/index.d.ts

@@ -1,42 +1,118 @@
-import { c as IntakeAnswers, b as IntakeGraph, I as IntakeAnswerValue } from '../model-Cuj7d-xT.js';
-export { A as AnswerRejectionReason, d as AnswerValidationResult, e as IntakeAnswerType, 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-Cuj7d-xT.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-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';
 
 /**
- * Pure completion-state helpers for an intake payload — the small algebra over
- * the JSON blob the store persists. No I/O: the store reads/writes the row;
- * these functions only build and judge the payload shape, so the same logic
- * runs in the UI, the handlers, and the DB layer without divergence.
+ * Pure context-sufficiency floor + conversational-gather scaffold — the
+ * product-agnostic core of a CONVERSATIONAL intake. Where the question-graph
+ * model (`./model`) runs a one-question-at-a-time interview, this leaf judges
+ * whether an agent has gathered ENOUGH context to act, and renders the prompt
+ * directive that tells the agent to fold the remaining gaps into its work
+ * instead of running a form.
  *
- * A payload is `{ graphId, answers, completedAt? }`. It carries the answers
- * and the id of the graph they were collected against, so a later graph
- * revision can detect a stale payload (`graphId` mismatch) rather than
- * silently mixing answers from two question sets.
+ * Zero dependencies: no drizzle, no env, no react, no I/O, no product reads.
+ * A product declares WHICH facts matter (`ContextFactSpec`), and its own
+ * adapter resolves those facts + named substrate flags from whatever substrate
+ * it owns (`ResolvedContextSignals`); this leaf only does the deterministic
+ * combine and the wording. That separation is what makes the framework opt-in
+ * and tree-shakeable, and what lets gtm/tax/legal/insurance share one core.
+ *
+ * Readiness is a two-part floor: SCOPE (every required fact has a value) AND
+ * SUBSTRATE (at least one named substrate flag is true). Scope alone is not
+ * enough — knowing the goal without any durable thing to act on is still
+ * not-ready; substrate alone is not enough either. The product's adapter
+ * decides what counts as a fact and what counts as substrate.
  */
-
-/** The persisted JSON for one intake (the `payload` column). */
-interface IntakePayload {
-    /** The graph id the answers were collected against — guards stale schemas. */
-    graphId: string;
-    answers: IntakeAnswers;
-    /** ISO-8601 instant the intake was completed, or undefined while in progress. */
-    completedAt?: string;
+/** One fact the product treats as known context once it has a value. */
+interface ContextFact {
+    /** Stable key the resolved-signals map is keyed on. */
+    key: string;
+    /** Human label shown in the prompt's known/missing lists. */
+    label: string;
+    /** When true, this fact must have a value for SCOPE to be met. */
+    required?: boolean;
+    /** How the agent should gather this fact conversationally, if missing. */
+    gatherHint?: string;
+}
+/**
+ * The product's declaration of what context matters: the facts that make up
+ * scope, plus optional tool hints appended verbatim to the gather prompt (e.g.
+ * a product passes the command that extracts a brand from a URL). Pure data —
+ * the product supplies labels, hints, and tool lines; the framework never
+ * names a product-specific concept itself.
+ */
+interface ContextFactSpec {
+    facts: ContextFact[];
+    /** Lines appended after the gather directive — e.g. product tool pointers. */
+    toolHints?: string[];
+}
+/**
+ * What a product's adapter resolves from its own substrate, ready to combine.
+ * `facts` carries the resolved VALUE per fact key (undefined/empty = not
+ * known); `substrate` carries named boolean flags (e.g.
+ * `{ brandConfirmed, configHasContext, coreKnowledgePresent }`) — any one true
+ * satisfies the substrate half of the floor.
+ */
+interface ResolvedContextSignals {
+    facts: Record<string, string | undefined>;
+    substrate: Record<string, boolean>;
+}
+/** A resolved fact that has a value — surfaced to the prompt as known context. */
+interface KnownFact {
+    key: string;
+    label: string;
+    value: string;
+}
+/** A required fact with no value — surfaced to the prompt as a gap to close. */
+interface MissingFact {
+    key: string;
+    label: string;
+    gatherHint?: string;
+}
+/** The deterministic verdict over the resolved signals. */
+interface ContextSufficiency {
+    /** True when the floor is met: `hasScope && hasSubstrate`. */
+    ready: boolean;
+    /** Every REQUIRED fact has a non-empty value. */
+    hasScope: boolean;
+    /** At least one named substrate flag is true. */
+    hasSubstrate: boolean;
+    /** Facts (required or not) that have a value. */
+    knownFacts: KnownFact[];
+    /** Required facts that have no value yet. */
+    missingFacts: MissingFact[];
+    /** The substrate flags as resolved, passed through for the prompt/caller. */
+    substrate: Record<string, boolean>;
 }
-/** An empty payload for a fresh intake against `graph`. */
-declare function emptyPayload(graph: IntakeGraph): IntakePayload;
-/** A copy of `payload` with one answer set (does not mutate the input). */
-declare function withAnswer(payload: IntakePayload, questionId: string, value: IntakeAnswerValue): IntakePayload;
 /**
- * True when the payload's answers complete the graph AND the payload was
- * collected against THIS graph. A `graphId` mismatch is never "complete" —
- * the answers belong to a different question set and must be re-collected.
+ * Combine a fact spec with resolved signals into the readiness verdict. Pure,
+ * deterministic, never throws — a missing fact key or an empty substrate map
+ * reads as not-ready, not an error, so a fresh scope is honestly not-ready
+ * rather than crashing the caller.
+ *
+ * SCOPE = every `required` fact resolves to a non-empty value.
+ * SUBSTRATE = any value in `signals.substrate` is true.
+ * READY = SCOPE && SUBSTRATE.
+ *
+ * `knownFacts` lists every fact (required or optional) that resolved to a
+ * value, in spec declaration order; `missingFacts` lists every REQUIRED fact
+ * that did not — optional facts never appear as missing because they never gate
+ * scope.
  */
-declare function payloadComplete(graph: IntakeGraph, payload: IntakePayload): boolean;
-/** True when the payload was collected against a DIFFERENT graph revision. */
-declare function payloadIsStale(graph: IntakeGraph, payload: IntakePayload): boolean;
+declare function computeContextSufficiency(spec: ContextFactSpec, signals: ResolvedContextSignals): ContextSufficiency;
 /**
- * Stamp the payload complete at `at` (default now). Returns a copy; pure. The
- * caller has already checked `payloadComplete` — this only records the instant.
+ * Render the prompt section that mirrors a conversational-gather flow:
+ *  - "### Context you already have" — the known facts, as `label: value`.
+ *  - "### Context still missing — gather it while you work, not as a form" —
+ *    the missing facts (with their gather hints), the act-first directive, and
+ *    any product tool hints appended verbatim.
+ *
+ * When scope is met but the floor still is not (no substrate flag), it emits
+ * the substrate directive instead of a missing-facts list. Returns '' when
+ * there is nothing to say (no known facts, no gaps, and ready) so a caller can
+ * concatenate it unconditionally. Pure: wording is product-neutral; every
+ * product-specific phrase comes from the spec's labels, gather hints, and tool
+ * hints.
  */
-declare function markComplete(payload: IntakePayload, at?: Date): IntakePayload;
+declare function buildContextGatherPrompt(spec: ContextFactSpec, sufficiency: ContextSufficiency): string;
 
-export { IntakeAnswerValue, IntakeAnswers, IntakeGraph, type IntakePayload, emptyPayload, markComplete, payloadComplete, payloadIsStale, withAnswer };
+export { type ContextFact, type ContextFactSpec, type ContextSufficiency, type KnownFact, type MissingFact, type ResolvedContextSignals, buildContextGatherPrompt, computeContextSufficiency };

package/dist/intakes/index.js

@@ -14,7 +14,73 @@ import {
   reachableQuestions,
   validateAnswer
 } from "../chunk-ND3XEGBE.js";
+
+// src/intakes/context-sufficiency.ts
+function presentValue(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function computeContextSufficiency(spec, signals) {
+  const facts = spec.facts ?? [];
+  const resolvedFacts = signals.facts ?? {};
+  const substrate = signals.substrate ?? {};
+  const knownFacts = [];
+  const missingFacts = [];
+  let hasScope = true;
+  for (const fact of facts) {
+    const value = presentValue(resolvedFacts[fact.key]);
+    if (value !== void 0) {
+      knownFacts.push({ key: fact.key, label: fact.label, value });
+    } else if (fact.required) {
+      hasScope = false;
+      missingFacts.push({ key: fact.key, label: fact.label, gatherHint: fact.gatherHint });
+    }
+  }
+  const hasSubstrate = Object.values(substrate).some(Boolean);
+  return {
+    ready: hasScope && hasSubstrate,
+    hasScope,
+    hasSubstrate,
+    knownFacts,
+    missingFacts,
+    substrate
+  };
+}
+var GATHER_DIRECTIVE = "Do not run an interview. Act on the message first, then fold AT MOST one or two pointed questions into the same turn to close the highest-leverage gap. Never present a form.";
+var SUBSTRATE_DIRECTIVE = "You have the scope but no durable substrate to act on yet. As you work, persist what you learn \u2014 that is what makes this context-ready.";
+function buildContextGatherPrompt(spec, sufficiency) {
+  const lines = [];
+  if (sufficiency.knownFacts.length > 0) {
+    lines.push("### Context you already have");
+    lines.push(sufficiency.knownFacts.map((f) => `- ${f.label}: ${f.value}`).join("\n"));
+  }
+  if (sufficiency.missingFacts.length > 0) {
+    if (lines.length > 0) lines.push("");
+    lines.push("### Context still missing \u2014 gather it while you work, not as a form");
+    const gaps = sufficiency.missingFacts.map((f) => f.gatherHint ? `- ${f.label} \u2014 ${f.gatherHint}` : `- ${f.label}`).join("\n");
+    lines.push(`You do NOT have:
+${gaps}`);
+    lines.push(GATHER_DIRECTIVE);
+    for (const hint of spec.toolHints ?? []) {
+      const trimmed = hint.trim();
+      if (trimmed) lines.push(trimmed);
+    }
+  } else if (!sufficiency.ready) {
+    if (lines.length > 0) lines.push("");
+    lines.push(SUBSTRATE_DIRECTIVE);
+    for (const hint of spec.toolHints ?? []) {
+      const trimmed = hint.trim();
+      if (trimmed) lines.push(trimmed);
+    }
+  }
+  if (lines.length === 0) return "";
+  return `## Project Context & Sufficiency
+${lines.join("\n")}`;
+}
 export {
+  buildContextGatherPrompt,
+  computeContextSufficiency,
   emptyPayload,
   getQuestion,
   hasAnswer,