@hotmeshio/long-tail 0.1.13 → 0.1.15

package/build/services/mcp-runs/sql.d.ts

@@ -4,4 +4,4 @@ export declare const ACTIVE_GRAPH_TOPICS = "SELECT DISTINCT graph_topic FROM lt_
 export declare const COUNT_JOBS: (schema: string, where: string) => string;
 export declare const GET_JOB: (schema: string) => string;
 export declare const GET_JOB_ATTRIBUTES: (schema: string) => string;
-export declare const LIST_JOBS: (schema: string, appId: string, where: string, limitIdx: number, offsetIdx: number) => string;
+export declare const LIST_JOBS: (schema: string, appId: string, where: string, limitIdx: number, offsetIdx: number, orderBy?: string) => string;

package/build/services/mcp-runs/sql.js

@@ -18,7 +18,7 @@ exports.GET_JOB = GET_JOB;
 const GET_JOB_ATTRIBUTES = (schema) => `SELECT symbol, dimension, value FROM ${schema}.jobs_attributes WHERE job_id = $1 ORDER BY symbol, dimension`;
 exports.GET_JOB_ATTRIBUTES = GET_JOB_ATTRIBUTES;
 // ─── Queries (queries.ts) ───────────────────────────────────────────────────
-const LIST_JOBS = (schema, appId, where, limitIdx, offsetIdx) => `WITH ju_symbols AS (
+const LIST_JOBS = (schema, appId, where, limitIdx, offsetIdx, orderBy) => `WITH ju_symbols AS (
      SELECT value FROM ${schema}.symbols
      WHERE key LIKE 'keys:%' AND field = 'metadata/ju'
    )
@@ -33,6 +33,6 @@ const LIST_JOBS = (schema, appId, where, limitIdx, offsetIdx) => `WITH ju_symbol
      AND ju.symbol IN (SELECT value FROM ju_symbols)
      AND (ju.dimension IS NULL OR ju.dimension = '')
    ${where}
-   ORDER BY (CASE WHEN j.status > 0 THEN 0 ELSE 1 END), j.created_at DESC
+   ORDER BY ${orderBy || '(CASE WHEN j.status > 0 THEN 0 ELSE 1 END), j.created_at DESC'}
    LIMIT $${limitIdx} OFFSET $${offsetIdx}`;
 exports.LIST_JOBS = LIST_JOBS;

package/build/services/workflow-sets/db.d.ts

@@ -2,6 +2,7 @@ import type { LTWorkflowSetRecord, LTWorkflowSetStatus, CreateWorkflowSetInput,
 export declare function createWorkflowSet(input: CreateWorkflowSetInput): Promise<LTWorkflowSetRecord>;
 export declare function getWorkflowSet(id: string): Promise<LTWorkflowSetRecord | null>;
 export declare function updateWorkflowSetPlan(id: string, plan: PlanItem[], namespaces: string[]): Promise<LTWorkflowSetRecord | null>;
+export declare function appendWorkflowSetSpecification(id: string, specification: string): Promise<LTWorkflowSetRecord | null>;
 export declare function updateWorkflowSetStatus(id: string, status: LTWorkflowSetStatus): Promise<LTWorkflowSetRecord | null>;
 export declare function updateWorkflowSetSourceWorkflow(id: string, sourceWorkflowId: string): Promise<void>;
 export declare function deleteWorkflowSet(id: string): Promise<boolean>;

package/build/services/workflow-sets/db.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createWorkflowSet = createWorkflowSet;
 exports.getWorkflowSet = getWorkflowSet;
 exports.updateWorkflowSetPlan = updateWorkflowSetPlan;
+exports.appendWorkflowSetSpecification = appendWorkflowSetSpecification;
 exports.updateWorkflowSetStatus = updateWorkflowSetStatus;
 exports.updateWorkflowSetSourceWorkflow = updateWorkflowSetSourceWorkflow;
 exports.deleteWorkflowSet = deleteWorkflowSet;
@@ -36,6 +37,11 @@ async function updateWorkflowSetPlan(id, plan, namespaces) {
     ]);
     return rows[0] || null;
 }
+async function appendWorkflowSetSpecification(id, specification) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.APPEND_WORKFLOW_SET_SPECIFICATION, [id, specification]);
+    return rows[0] || null;
+}
 async function updateWorkflowSetStatus(id, status) {
     const pool = (0, db_1.getPool)();
     const { rows } = await pool.query(sql_1.UPDATE_WORKFLOW_SET_STATUS, [id, status]);

package/build/services/workflow-sets/index.d.ts

@@ -1 +1 @@
-export { createWorkflowSet, getWorkflowSet, updateWorkflowSetPlan, updateWorkflowSetStatus, updateWorkflowSetSourceWorkflow, deleteWorkflowSet, listWorkflowSets, } from './db';
+export { createWorkflowSet, getWorkflowSet, updateWorkflowSetPlan, updateWorkflowSetStatus, updateWorkflowSetSourceWorkflow, appendWorkflowSetSpecification, deleteWorkflowSet, listWorkflowSets, } from './db';

package/build/services/workflow-sets/index.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listWorkflowSets = exports.deleteWorkflowSet = exports.updateWorkflowSetSourceWorkflow = exports.updateWorkflowSetStatus = exports.updateWorkflowSetPlan = exports.getWorkflowSet = exports.createWorkflowSet = void 0;
+exports.listWorkflowSets = exports.deleteWorkflowSet = exports.appendWorkflowSetSpecification = exports.updateWorkflowSetSourceWorkflow = exports.updateWorkflowSetStatus = exports.updateWorkflowSetPlan = exports.getWorkflowSet = exports.createWorkflowSet = void 0;
 var db_1 = require("./db");
 Object.defineProperty(exports, "createWorkflowSet", { enumerable: true, get: function () { return db_1.createWorkflowSet; } });
 Object.defineProperty(exports, "getWorkflowSet", { enumerable: true, get: function () { return db_1.getWorkflowSet; } });
 Object.defineProperty(exports, "updateWorkflowSetPlan", { enumerable: true, get: function () { return db_1.updateWorkflowSetPlan; } });
 Object.defineProperty(exports, "updateWorkflowSetStatus", { enumerable: true, get: function () { return db_1.updateWorkflowSetStatus; } });
 Object.defineProperty(exports, "updateWorkflowSetSourceWorkflow", { enumerable: true, get: function () { return db_1.updateWorkflowSetSourceWorkflow; } });
+Object.defineProperty(exports, "appendWorkflowSetSpecification", { enumerable: true, get: function () { return db_1.appendWorkflowSetSpecification; } });
 Object.defineProperty(exports, "deleteWorkflowSet", { enumerable: true, get: function () { return db_1.deleteWorkflowSet; } });
 Object.defineProperty(exports, "listWorkflowSets", { enumerable: true, get: function () { return db_1.listWorkflowSets; } });

package/build/services/workflow-sets/sql.d.ts

@@ -2,5 +2,6 @@ export declare const CREATE_WORKFLOW_SET = "\n  INSERT INTO lt_workflow_sets (na
 export declare const GET_WORKFLOW_SET = "\n  SELECT * FROM lt_workflow_sets WHERE id = $1";
 export declare const UPDATE_WORKFLOW_SET_PLAN = "\n  UPDATE lt_workflow_sets\n  SET plan = $2, namespaces = $3, status = 'planned', updated_at = NOW()\n  WHERE id = $1\n  RETURNING *";
 export declare const UPDATE_WORKFLOW_SET_STATUS = "\n  UPDATE lt_workflow_sets\n  SET status = $2, updated_at = NOW()\n  WHERE id = $1\n  RETURNING *";
+export declare const APPEND_WORKFLOW_SET_SPECIFICATION = "\n  UPDATE lt_workflow_sets\n  SET specification = specification || E'\\n\\n---\\n\\n' || $2, updated_at = NOW()\n  WHERE id = $1\n  RETURNING *";
 export declare const DELETE_WORKFLOW_SET = "\n  DELETE FROM lt_workflow_sets WHERE id = $1";
 export declare const LIST_WORKFLOW_SETS_BASE = "\n  SELECT * FROM lt_workflow_sets";

package/build/services/workflow-sets/sql.js

@@ -1,7 +1,7 @@
 "use strict";
 // ─── Workflow set CRUD ──────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIST_WORKFLOW_SETS_BASE = exports.DELETE_WORKFLOW_SET = exports.UPDATE_WORKFLOW_SET_STATUS = exports.UPDATE_WORKFLOW_SET_PLAN = exports.GET_WORKFLOW_SET = exports.CREATE_WORKFLOW_SET = void 0;
+exports.LIST_WORKFLOW_SETS_BASE = exports.DELETE_WORKFLOW_SET = exports.APPEND_WORKFLOW_SET_SPECIFICATION = exports.UPDATE_WORKFLOW_SET_STATUS = exports.UPDATE_WORKFLOW_SET_PLAN = exports.GET_WORKFLOW_SET = exports.CREATE_WORKFLOW_SET = void 0;
 exports.CREATE_WORKFLOW_SET = `
   INSERT INTO lt_workflow_sets (name, description, specification, plan, namespaces, source_workflow_id)
   VALUES ($1, $2, $3, $4, $5, $6)
@@ -18,6 +18,11 @@ exports.UPDATE_WORKFLOW_SET_STATUS = `
   SET status = $2, updated_at = NOW()
   WHERE id = $1
   RETURNING *`;
+exports.APPEND_WORKFLOW_SET_SPECIFICATION = `
+  UPDATE lt_workflow_sets
+  SET specification = specification || E'\\n\\n---\\n\\n' || $2, updated_at = NOW()
+  WHERE id = $1
+  RETURNING *`;
 exports.DELETE_WORKFLOW_SET = `
   DELETE FROM lt_workflow_sets WHERE id = $1`;
 exports.LIST_WORKFLOW_SETS_BASE = `

package/build/services/yaml-workflow/builder-regenerate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Regenerate a Plan Build workflow from its original prompt + compilation feedback.
+ *
+ * Reuses the builder's LLM call and prompt structure without spawning a full
+ * durable workflow. This is the fast path for "Recompile Pipeline" on Plan Build
+ * workflows that don't have an execution trace.
+ */
+interface RebuildResult {
+    yaml: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    activityManifest: unknown[];
+    tags: string[];
+}
+/**
+ * Rebuild a YAML workflow from a prompt with optional feedback on the prior attempt.
+ */
+export declare function rebuildFromPrompt(options: {
+    prompt: string;
+    feedback?: string;
+    priorYaml?: string;
+    name: string;
+    appId: string;
+}): Promise<RebuildResult>;
+export {};

package/build/services/yaml-workflow/builder-regenerate.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Regenerate a Plan Build workflow from its original prompt + compilation feedback.
+ *
+ * Reuses the builder's LLM call and prompt structure without spawning a full
+ * durable workflow. This is the fast path for "Recompile Pipeline" on Plan Build
+ * workflows that don't have an execution trace.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rebuildFromPrompt = rebuildFromPrompt;
+const llm_1 = require("../llm");
+const defaults_1 = require("../../modules/defaults");
+const logger_1 = require("../../lib/logger");
+const BUILDER_MAX_TOKENS = 8192;
+/**
+ * Rebuild a YAML workflow from a prompt with optional feedback on the prior attempt.
+ */
+async function rebuildFromPrompt(options) {
+    // Load the builder's system prompt and tool inventory
+    const { loadBuilderTools } = await Promise.resolve().then(() => __importStar(require('../../system/workflows/mcp-workflow-builder/activities')));
+    const { BUILDER_SYSTEM_PROMPT, REFINE_PROMPT } = await Promise.resolve().then(() => __importStar(require('../../system/workflows/mcp-workflow-builder/prompts')));
+    const raw = await loadBuilderTools();
+    const serverSection = [
+        raw.strategy ? `${raw.strategy}\n` : '',
+        `## Available MCP Servers & Tools\n\n${raw.inventory}`,
+    ].filter(Boolean).join('\n');
+    const messages = [
+        { role: 'system', content: BUILDER_SYSTEM_PROMPT(serverSection) },
+    ];
+    if (options.feedback && options.priorYaml) {
+        messages.push({ role: 'user', content: `Build a workflow for: ${options.prompt}` });
+        messages.push({
+            role: 'assistant',
+            content: `Here is the prior YAML that needs fixing:\n\`\`\`yaml\n${options.priorYaml.slice(0, 3000)}\n\`\`\``,
+        });
+        messages.push({
+            role: 'user',
+            content: `${REFINE_PROMPT}\n\nExecution feedback:\n${options.feedback}`,
+        });
+    }
+    else {
+        messages.push({ role: 'user', content: `Build a workflow for: ${options.prompt}` });
+    }
+    // Call LLM with retry
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const t0 = Date.now();
+        const response = await (0, llm_1.callLLM)({
+            model: defaults_1.LLM_MODEL_PRIMARY,
+            messages,
+            temperature: 0,
+            max_tokens: BUILDER_MAX_TOKENS,
+        });
+        logger_1.loggerRegistry.info(`[builder-regenerate] attempt=${attempt + 1} ${Date.now() - t0}ms | in=${response.usage?.prompt_tokens} out=${response.usage?.completion_tokens}`);
+        const content = response.content || '';
+        const cleaned = content.replace(/^```(?:json)?\s*/m, '').replace(/\s*```\s*$/m, '');
+        try {
+            const parsed = JSON.parse(cleaned);
+            if (!parsed.yaml)
+                throw new Error('Missing yaml in response');
+            return {
+                yaml: parsed.yaml,
+                inputSchema: parsed.input_schema || {},
+                outputSchema: parsed.output_schema || {},
+                activityManifest: parsed.activity_manifest || [],
+                tags: parsed.tags || [],
+            };
+        }
+        catch (err) {
+            logger_1.loggerRegistry.warn(`[builder-regenerate] parse failed (attempt ${attempt + 1}): ${err.message}`);
+            messages.push({ role: 'assistant', content });
+            messages.push({
+                role: 'user',
+                content: `Your response was not valid JSON. Return ONLY a JSON object with "yaml", "input_schema", "output_schema", "activity_manifest", and "tags" fields.`,
+            });
+        }
+    }
+    throw new Error('Failed to regenerate YAML after 3 attempts');
+}

package/build/services/yaml-workflow/db-versions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Version history and cron scheduling DB operations for yaml-workflows.
+ *
+ * Extracted from db.ts to keep each file under 300 lines.
+ */
+import type { LTYamlWorkflowRecord, LTYamlWorkflowVersionRecord, ActivityManifestEntry } from '../../types/yaml-workflow';
+export declare function createVersionSnapshot(workflowId: string, version: number, yamlContent: string, activityManifest: ActivityManifestEntry[] | unknown, inputSchema: Record<string, unknown> | unknown, outputSchema: Record<string, unknown> | unknown, inputFieldMeta?: unknown, changeSummary?: string): Promise<LTYamlWorkflowVersionRecord>;
+export declare function getVersionHistory(workflowId: string, limit?: number, offset?: number): Promise<{
+    versions: LTYamlWorkflowVersionRecord[];
+    total: number;
+}>;
+export declare function getVersionSnapshot(workflowId: string, version: number): Promise<LTYamlWorkflowVersionRecord | null>;
+export declare function markContentDeployed(workflowId: string): Promise<void>;
+export declare function markAppIdContentDeployed(appId: string): Promise<void>;
+export declare function updateCronSchedule(id: string, cronSchedule: string, cronEnvelope: Record<string, unknown> | null, executeAs: string | null): Promise<LTYamlWorkflowRecord | null>;
+export declare function clearCronSchedule(id: string): Promise<LTYamlWorkflowRecord | null>;
+export declare function getCronScheduledWorkflows(): Promise<LTYamlWorkflowRecord[]>;

package/build/services/yaml-workflow/db-versions.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Version history and cron scheduling DB operations for yaml-workflows.
+ *
+ * Extracted from db.ts to keep each file under 300 lines.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVersionSnapshot = createVersionSnapshot;
+exports.getVersionHistory = getVersionHistory;
+exports.getVersionSnapshot = getVersionSnapshot;
+exports.markContentDeployed = markContentDeployed;
+exports.markAppIdContentDeployed = markAppIdContentDeployed;
+exports.updateCronSchedule = updateCronSchedule;
+exports.clearCronSchedule = clearCronSchedule;
+exports.getCronScheduledWorkflows = getCronScheduledWorkflows;
+const db_1 = require("../../lib/db");
+const defaults_1 = require("../../modules/defaults");
+const sql_1 = require("./sql");
+// -- Version history ---------------------------------------------------------
+async function createVersionSnapshot(workflowId, version, yamlContent, activityManifest, inputSchema, outputSchema, inputFieldMeta, changeSummary) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.CREATE_VERSION_SNAPSHOT, [
+        workflowId, version, yamlContent,
+        JSON.stringify(activityManifest),
+        JSON.stringify(inputSchema),
+        JSON.stringify(outputSchema),
+        JSON.stringify(inputFieldMeta || []),
+        changeSummary || null,
+    ]);
+    return rows[0];
+}
+async function getVersionHistory(workflowId, limit = defaults_1.YAML_VERSION_LIMIT, offset = 0) {
+    const pool = (0, db_1.getPool)();
+    const [countResult, dataResult] = await Promise.all([
+        pool.query(sql_1.COUNT_VERSIONS, [workflowId]),
+        pool.query(sql_1.LIST_VERSIONS, [workflowId, limit, offset]),
+    ]);
+    return {
+        versions: dataResult.rows,
+        total: parseInt(countResult.rows[0].count, 10),
+    };
+}
+async function getVersionSnapshot(workflowId, version) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.GET_VERSION_SNAPSHOT, [workflowId, version]);
+    return rows[0] || null;
+}
+async function markContentDeployed(workflowId) {
+    const pool = (0, db_1.getPool)();
+    await pool.query(sql_1.MARK_CONTENT_DEPLOYED, [workflowId]);
+}
+async function markAppIdContentDeployed(appId) {
+    const pool = (0, db_1.getPool)();
+    await pool.query(sql_1.MARK_APP_ID_CONTENT_DEPLOYED, [appId]);
+}
+// -- Cron scheduling ---------------------------------------------------------
+async function updateCronSchedule(id, cronSchedule, cronEnvelope, executeAs) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.UPDATE_CRON_SCHEDULE, [
+        id,
+        cronSchedule,
+        cronEnvelope ? JSON.stringify(cronEnvelope) : null,
+        executeAs,
+    ]);
+    return rows[0] || null;
+}
+async function clearCronSchedule(id) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.CLEAR_CRON_SCHEDULE, [id]);
+    return rows[0] || null;
+}
+async function getCronScheduledWorkflows() {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.GET_CRON_SCHEDULED_WORKFLOWS);
+    return rows;
+}

package/build/services/yaml-workflow/db.d.ts

@@ -1,6 +1,7 @@
-import type { LTYamlWorkflowRecord, LTYamlWorkflowVersionRecord, ActivityManifestEntry } from '../../types/yaml-workflow';
+import type { LTYamlWorkflowRecord } from '../../types/yaml-workflow';
 import type { CreateYamlWorkflowInput } from './types';
 export { parseVersionFromYaml, updateYamlWorkflowStatus, listYamlWorkflows, findYamlWorkflowsByTags, } from './db-utils';
+export { createVersionSnapshot, getVersionHistory, getVersionSnapshot, markContentDeployed, markAppIdContentDeployed, updateCronSchedule, clearCronSchedule, getCronScheduledWorkflows, } from './db-versions';
 /**
  * Check whether a graph_topic is already in use by a non-archived workflow
  * in the same namespace. Returns the conflicting workflow name, or null.
@@ -21,15 +22,16 @@ export declare function discoverWorkflows(prompt: string, tags: string[], catego
 })[]>;
 export declare function getActiveYamlWorkflows(): Promise<LTYamlWorkflowRecord[]>;
 export declare function listYamlWorkflowsByAppId(appId: string): Promise<LTYamlWorkflowRecord[]>;
+/**
+ * Return the next app-level version for a namespace.
+ *
+ * Each deploy of an app (namespace) must use a strictly increasing integer
+ * version. This queries the current max across all non-archived workflows
+ * in the namespace and returns max + 1.
+ *
+ * A new namespace with no workflows returns '1'.
+ * An existing namespace with one active tool at v1 returns '2' when a
+ * second tool is added -- even though that second tool is "version 1" of itself.
+ */
+export declare function getNextAppVersion(appId: string): Promise<string>;
 export declare function getDistinctAppIds(): Promise<string[]>;
-export declare function createVersionSnapshot(workflowId: string, version: number, yamlContent: string, activityManifest: ActivityManifestEntry[] | unknown, inputSchema: Record<string, unknown> | unknown, outputSchema: Record<string, unknown> | unknown, inputFieldMeta?: unknown, changeSummary?: string): Promise<LTYamlWorkflowVersionRecord>;
-export declare function getVersionHistory(workflowId: string, limit?: number, offset?: number): Promise<{
-    versions: LTYamlWorkflowVersionRecord[];
-    total: number;
-}>;
-export declare function getVersionSnapshot(workflowId: string, version: number): Promise<LTYamlWorkflowVersionRecord | null>;
-export declare function markContentDeployed(workflowId: string): Promise<void>;
-export declare function markAppIdContentDeployed(appId: string): Promise<void>;
-export declare function updateCronSchedule(id: string, cronSchedule: string, cronEnvelope: Record<string, unknown> | null, executeAs: string | null): Promise<LTYamlWorkflowRecord | null>;
-export declare function clearCronSchedule(id: string): Promise<LTYamlWorkflowRecord | null>;
-export declare function getCronScheduledWorkflows(): Promise<LTYamlWorkflowRecord[]>;

package/build/services/yaml-workflow/db.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findYamlWorkflowsByTags = exports.listYamlWorkflows = exports.updateYamlWorkflowStatus = exports.parseVersionFromYaml = void 0;
+exports.getCronScheduledWorkflows = exports.clearCronSchedule = exports.updateCronSchedule = exports.markAppIdContentDeployed = exports.markContentDeployed = exports.getVersionSnapshot = exports.getVersionHistory = exports.createVersionSnapshot = exports.findYamlWorkflowsByTags = exports.listYamlWorkflows = exports.updateYamlWorkflowStatus = exports.parseVersionFromYaml = void 0;
 exports.checkTopicConflict = checkTopicConflict;
 exports.createYamlWorkflow = createYamlWorkflow;
 exports.getYamlWorkflow = getYamlWorkflow;
@@ -11,25 +11,28 @@ exports.deleteYamlWorkflow = deleteYamlWorkflow;
 exports.discoverWorkflows = discoverWorkflows;
 exports.getActiveYamlWorkflows = getActiveYamlWorkflows;
 exports.listYamlWorkflowsByAppId = listYamlWorkflowsByAppId;
+exports.getNextAppVersion = getNextAppVersion;
 exports.getDistinctAppIds = getDistinctAppIds;
-exports.createVersionSnapshot = createVersionSnapshot;
-exports.getVersionHistory = getVersionHistory;
-exports.getVersionSnapshot = getVersionSnapshot;
-exports.markContentDeployed = markContentDeployed;
-exports.markAppIdContentDeployed = markAppIdContentDeployed;
-exports.updateCronSchedule = updateCronSchedule;
-exports.clearCronSchedule = clearCronSchedule;
-exports.getCronScheduledWorkflows = getCronScheduledWorkflows;
 const db_1 = require("../../lib/db");
-const defaults_1 = require("../../modules/defaults");
 const sql_1 = require("./sql");
 const db_utils_1 = require("./db-utils");
+const db_versions_1 = require("./db-versions");
 // Re-export functions from db-utils
 var db_utils_2 = require("./db-utils");
 Object.defineProperty(exports, "parseVersionFromYaml", { enumerable: true, get: function () { return db_utils_2.parseVersionFromYaml; } });
 Object.defineProperty(exports, "updateYamlWorkflowStatus", { enumerable: true, get: function () { return db_utils_2.updateYamlWorkflowStatus; } });
 Object.defineProperty(exports, "listYamlWorkflows", { enumerable: true, get: function () { return db_utils_2.listYamlWorkflows; } });
 Object.defineProperty(exports, "findYamlWorkflowsByTags", { enumerable: true, get: function () { return db_utils_2.findYamlWorkflowsByTags; } });
+// Re-export version history and cron scheduling from db-versions
+var db_versions_2 = require("./db-versions");
+Object.defineProperty(exports, "createVersionSnapshot", { enumerable: true, get: function () { return db_versions_2.createVersionSnapshot; } });
+Object.defineProperty(exports, "getVersionHistory", { enumerable: true, get: function () { return db_versions_2.getVersionHistory; } });
+Object.defineProperty(exports, "getVersionSnapshot", { enumerable: true, get: function () { return db_versions_2.getVersionSnapshot; } });
+Object.defineProperty(exports, "markContentDeployed", { enumerable: true, get: function () { return db_versions_2.markContentDeployed; } });
+Object.defineProperty(exports, "markAppIdContentDeployed", { enumerable: true, get: function () { return db_versions_2.markAppIdContentDeployed; } });
+Object.defineProperty(exports, "updateCronSchedule", { enumerable: true, get: function () { return db_versions_2.updateCronSchedule; } });
+Object.defineProperty(exports, "clearCronSchedule", { enumerable: true, get: function () { return db_versions_2.clearCronSchedule; } });
+Object.defineProperty(exports, "getCronScheduledWorkflows", { enumerable: true, get: function () { return db_versions_2.getCronScheduledWorkflows; } });
 /**
  * Check whether a graph_topic is already in use by a non-archived workflow
  * in the same namespace. Returns the conflicting workflow name, or null.
@@ -67,7 +70,7 @@ async function createYamlWorkflow(input) {
         input.set_build_order ?? null,
     ]);
     const record = rows[0];
-    await createVersionSnapshot(record.id, 1, record.yaml_content, input.activity_manifest || [], input.input_schema || {}, input.output_schema || {}, input.input_field_meta || [], 'Initial version');
+    await (0, db_versions_1.createVersionSnapshot)(record.id, 1, record.yaml_content, input.activity_manifest || [], input.input_schema || {}, input.output_schema || {}, input.input_field_meta || [], 'Initial version');
     return record;
 }
 async function getYamlWorkflow(id) {
@@ -144,7 +147,7 @@ async function updateYamlWorkflow(id, updates) {
     const { rows } = await pool.query(`UPDATE lt_yaml_workflows SET ${sets.join(', ')} WHERE id = $${idx} RETURNING *`, values);
     const record = rows[0] || null;
     if (record && yamlChanging) {
-        await createVersionSnapshot(record.id, record.content_version, record.yaml_content, record.activity_manifest, record.input_schema, record.output_schema, record.input_field_meta);
+        await (0, db_versions_1.createVersionSnapshot)(record.id, record.content_version, record.yaml_content, record.activity_manifest, record.input_schema, record.output_schema, record.input_field_meta);
     }
     return record;
 }
@@ -172,66 +175,25 @@ async function listYamlWorkflowsByAppId(appId) {
     const { rows } = await pool.query(sql_1.LIST_BY_APP_ID, [appId]);
     return rows;
 }
+/**
+ * Return the next app-level version for a namespace.
+ *
+ * Each deploy of an app (namespace) must use a strictly increasing integer
+ * version. This queries the current max across all non-archived workflows
+ * in the namespace and returns max + 1.
+ *
+ * A new namespace with no workflows returns '1'.
+ * An existing namespace with one active tool at v1 returns '2' when a
+ * second tool is added -- even though that second tool is "version 1" of itself.
+ */
+async function getNextAppVersion(appId) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.GET_MAX_APP_VERSION, [appId]);
+    const max = parseInt(rows[0]?.max_version ?? '0', 10);
+    return String(max + 1);
+}
 async function getDistinctAppIds() {
     const pool = (0, db_1.getPool)();
     const { rows } = await pool.query(sql_1.GET_DISTINCT_APP_IDS);
     return rows.map((r) => r.app_id);
 }
-// -- Version history ---------------------------------------------------------
-async function createVersionSnapshot(workflowId, version, yamlContent, activityManifest, inputSchema, outputSchema, inputFieldMeta, changeSummary) {
-    const pool = (0, db_1.getPool)();
-    const { rows } = await pool.query(sql_1.CREATE_VERSION_SNAPSHOT, [
-        workflowId, version, yamlContent,
-        JSON.stringify(activityManifest),
-        JSON.stringify(inputSchema),
-        JSON.stringify(outputSchema),
-        JSON.stringify(inputFieldMeta || []),
-        changeSummary || null,
-    ]);
-    return rows[0];
-}
-async function getVersionHistory(workflowId, limit = defaults_1.YAML_VERSION_LIMIT, offset = 0) {
-    const pool = (0, db_1.getPool)();
-    const [countResult, dataResult] = await Promise.all([
-        pool.query(sql_1.COUNT_VERSIONS, [workflowId]),
-        pool.query(sql_1.LIST_VERSIONS, [workflowId, limit, offset]),
-    ]);
-    return {
-        versions: dataResult.rows,
-        total: parseInt(countResult.rows[0].count, 10),
-    };
-}
-async function getVersionSnapshot(workflowId, version) {
-    const pool = (0, db_1.getPool)();
-    const { rows } = await pool.query(sql_1.GET_VERSION_SNAPSHOT, [workflowId, version]);
-    return rows[0] || null;
-}
-async function markContentDeployed(workflowId) {
-    const pool = (0, db_1.getPool)();
-    await pool.query(sql_1.MARK_CONTENT_DEPLOYED, [workflowId]);
-}
-async function markAppIdContentDeployed(appId) {
-    const pool = (0, db_1.getPool)();
-    await pool.query(sql_1.MARK_APP_ID_CONTENT_DEPLOYED, [appId]);
-}
-// -- Cron scheduling ---------------------------------------------------------
-async function updateCronSchedule(id, cronSchedule, cronEnvelope, executeAs) {
-    const pool = (0, db_1.getPool)();
-    const { rows } = await pool.query(sql_1.UPDATE_CRON_SCHEDULE, [
-        id,
-        cronSchedule,
-        cronEnvelope ? JSON.stringify(cronEnvelope) : null,
-        executeAs,
-    ]);
-    return rows[0] || null;
-}
-async function clearCronSchedule(id) {
-    const pool = (0, db_1.getPool)();
-    const { rows } = await pool.query(sql_1.CLEAR_CRON_SCHEDULE, [id]);
-    return rows[0] || null;
-}
-async function getCronScheduledWorkflows() {
-    const pool = (0, db_1.getPool)();
-    const { rows } = await pool.query(sql_1.GET_CRON_SCHEDULED_WORKFLOWS);
-    return rows;
-}

package/build/services/yaml-workflow/deployer-helpers.js

@@ -56,27 +56,28 @@ async function buildMergedYaml(appId, version) {
             allGraphs.push(...parsed.app.graphs);
         }
     }
-    // Pre-validate: check for duplicate activity IDs across all graphs
-    const activityIds = new Map(); // id -> graph subscribes topic
-    const duplicates = [];
+    // Resolve duplicate activity IDs across graphs by rewriting suffixes
+    const activityIds = new Set();
     for (const graph of allGraphs) {
         const g = graph;
-        const topic = g.subscribes || 'unknown';
-        if (g.activities) {
-            for (const id of Object.keys(g.activities)) {
-                if (activityIds.has(id)) {
-                    duplicates.push(`"${id}" in both "${activityIds.get(id)}" and "${topic}"`);
-                }
-                else {
-                    activityIds.set(id, topic);
-                }
+        if (!g.activities)
+            continue;
+        // Check if any activity IDs collide with previously seen IDs
+        const ids = Object.keys(g.activities);
+        const hasCollision = ids.some((id) => activityIds.has(id));
+        if (hasCollision) {
+            // Rewrite all activity IDs in this graph with a unique suffix
+            const newSuffix = Math.random().toString(36).slice(2, 6);
+            const oldSuffix = extractSuffix(ids[0]);
+            if (oldSuffix) {
+                rewriteGraphSuffix(g, oldSuffix, newSuffix);
+                logger_1.loggerRegistry.info(`[yaml-workflow] rewrote activity suffix ${oldSuffix}→${newSuffix} in "${g.subscribes}" to resolve collision`);
             }
         }
-    }
-    if (duplicates.length > 0) {
-        const msg = `Duplicate activity IDs across graphs in app "${appId}": ${duplicates.join('; ')}`;
-        logger_1.loggerRegistry.error(`[yaml-workflow] ${msg}`);
-        throw new Error(msg);
+        // Register all (possibly rewritten) activity IDs
+        for (const id of Object.keys(g.activities)) {
+            activityIds.add(id);
+        }
     }
     const merged = {
         app: {
@@ -87,6 +88,36 @@ async function buildMergedYaml(appId, version) {
     };
     return yaml.dump(merged, { lineWidth: defaults_1.YAML_LINE_WIDTH, noRefs: true, sortKeys: false });
 }
+/** Extract the 4-char suffix from an activity ID like "trigger_x8kf" */
+function extractSuffix(activityId) {
+    const match = activityId.match(/_([a-z0-9]{4})$/);
+    return match ? match[1] : null;
+}
+/** Rewrite all activity ID suffixes in a graph definition */
+function rewriteGraphSuffix(graph, oldSuffix, newSuffix) {
+    const suffixPattern = new RegExp(`_${oldSuffix}\\b`, 'g');
+    const replace = (obj) => {
+        if (typeof obj === 'string')
+            return obj.replace(suffixPattern, `_${newSuffix}`);
+        if (Array.isArray(obj))
+            return obj.map(replace);
+        if (obj && typeof obj === 'object') {
+            const result = {};
+            for (const [k, v] of Object.entries(obj)) {
+                const newKey = k.replace(suffixPattern, `_${newSuffix}`);
+                result[newKey] = replace(v);
+            }
+            return result;
+        }
+        return obj;
+    };
+    if (graph.activities)
+        graph.activities = replace(graph.activities);
+    if (graph.transitions)
+        graph.transitions = replace(graph.transitions);
+    if (graph.hooks)
+        graph.hooks = replace(graph.hooks);
+}
 /**
  * Re-run the compilation pipeline for the most recently compiled workflow
  * in the app, feeding the deployment error as context so the LLM can

package/build/services/yaml-workflow/durable-compiler/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Durable-to-YAML compiler — converts procedural TypeScript workflows to YAML DAGs.
+ *
+ * This is "Path 3" for YAML DAG creation: static compilation from durable source
+ * code without executing the workflow. The LLM translates the procedural orchestration
+ * into an equivalent HotMesh YAML DAG that runs without replay overhead.
+ *
+ * Pipeline:
+ *   1. Read source (file or inline string)
+ *   2. Optionally resolve and read the activities module
+ *   3. Extract metadata (activity names, primitives, control flow)
+ *   4. Build LLM messages (system prompt + source + metadata)
+ *   5. Call LLM (temperature 0, retry on parse failure)
+ *   6. Fix known @pipe anti-patterns
+ *   7. Return result compatible with existing YAML workflow CRUD
+ */
+import type { CompileDurableOptions, CompileDurableResult } from './types';
+export type { CompileDurableOptions, CompileDurableResult } from './types';
+/**
+ * Compile a durable TypeScript workflow into a HotMesh YAML DAG.
+ */
+export declare function compileDurableToYaml(options: CompileDurableOptions): Promise<CompileDurableResult>;