@hotmeshio/long-tail 0.1.12 → 0.1.14

package/build/services/insight/index.d.ts

@@ -44,6 +44,19 @@ export interface WorkflowPlannerInput {
     setId: string;
     wait?: boolean;
     userId?: string;
+    /** When adding to an existing set, pass the current plan items so the planner avoids duplicates. */
+    existingPlan?: Array<{
+        name: string;
+        description: string;
+        namespace: string;
+    }>;
+    /** Sibling schemas from already-built workflows for composition context. */
+    existingSchemas?: Array<{
+        name: string;
+        input_schema: Record<string, unknown>;
+        output_schema: Record<string, unknown>;
+        graph_topic: string;
+    }>;
 }
 export declare function startWorkflowPlanner(input: WorkflowPlannerInput): Promise<McpQueryResult>;
 export declare function describeWorkflow(input: DescribeInput): Promise<DescribeResult>;

package/build/services/insight/index.js

@@ -11,6 +11,7 @@ exports.describeWorkflow = describeWorkflow;
 const hotmesh_1 = require("@hotmeshio/hotmesh");
 const db_1 = require("../../lib/db");
 const defaults_1 = require("../../modules/defaults");
+const utils_1 = require("../../modules/utils");
 const llm_1 = require("../llm");
 const prompts_1 = require("./prompts");
 // ── MCP query invocation ─────────────────────────────────────────────────────
@@ -76,13 +77,13 @@ async function startWorkflowBuilder(input) {
     };
 }
 async function startWorkflowPlanner(input) {
-    const { specification, setId, wait = true, userId } = input;
+    const { specification, setId, wait = true, userId, existingPlan, existingSchemas } = input;
     const startTime = Date.now();
     const client = new hotmesh_1.Durable.Client({ connection: (0, db_1.getConnection)() });
     const workflowId = `wf-planner-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     const handle = await client.workflow.start({
         args: [{
-                data: { specification, setId },
+                data: { specification, setId, existingPlan, existingSchemas },
                 metadata: { source: 'dashboard' },
                 lt: { userId },
             }],
@@ -126,11 +127,7 @@ async function describeWorkflow(input) {
     const raw = response.content || '{}';
     const cleaned = raw.replace(/^```(?:json)?\s*/m, '').replace(/\s*```$/m, '').trim();
     const parsed = JSON.parse(cleaned);
-    const toolName = (parsed.tool_name || '')
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-|-$/g, '')
-        .slice(0, 60);
+    const toolName = (0, utils_1.sanitizeToolName)(parsed.tool_name || '').slice(0, 60);
     return {
         tool_name: toolName || undefined,
         description: parsed.description || prompt,

package/build/services/insight/prompts.d.ts

@@ -1,4 +1,4 @@
 /**
  * Externalized LLM prompt constants for the insight service.
  */
-export declare const DESCRIBE_WORKFLOW_SYSTEM_PROMPT = "You generate concise workflow descriptions, tool names, and discovery tags.\n\nGiven a user's original query and the execution result, produce:\n1. A short, descriptive tool name as a lowercase kebab-case slug (e.g. \"screenshot-all-nav-pages\", \"fetch-order-status\", \"translate-content\"). The name should describe what the workflow does, not be generic like \"query-complete\".\n2. A clear, reusable description of what this workflow does (not what the user asked, but what the workflow accomplishes as a reusable tool). Write it as if describing a tool in a catalog. 2-3 sentences max.\n3. Discovery tags \u2014 lowercase keywords that help find this workflow when similar future queries are made.\n\nReturn ONLY a JSON object:\n{ \"tool_name\": \"...\", \"description\": \"...\", \"tags\": [\"tag1\", \"tag2\", ...] }";
+export declare const DESCRIBE_WORKFLOW_SYSTEM_PROMPT = "You generate concise workflow descriptions, tool names, and discovery tags.\n\nGiven a user's original query and the execution result, produce:\n1. A short, descriptive tool name in snake_case (e.g. \"screenshot_all_nav_pages\", \"fetch_order_status\", \"translate_content\"). Only lowercase letters, digits, and underscores. The name should describe what the workflow does, not be generic like \"query_complete\".\n2. A clear, reusable description of what this workflow does (not what the user asked, but what the workflow accomplishes as a reusable tool). Write it as if describing a tool in a catalog. 2-3 sentences max.\n3. Discovery tags \u2014 lowercase keywords that help find this workflow when similar future queries are made.\n\nReturn ONLY a JSON object:\n{ \"tool_name\": \"...\", \"description\": \"...\", \"tags\": [\"tag1\", \"tag2\", ...] }";

package/build/services/insight/prompts.js

@@ -7,7 +7,7 @@ exports.DESCRIBE_WORKFLOW_SYSTEM_PROMPT = void 0;
 exports.DESCRIBE_WORKFLOW_SYSTEM_PROMPT = `You generate concise workflow descriptions, tool names, and discovery tags.
 
 Given a user's original query and the execution result, produce:
-1. A short, descriptive tool name as a lowercase kebab-case slug (e.g. "screenshot-all-nav-pages", "fetch-order-status", "translate-content"). The name should describe what the workflow does, not be generic like "query-complete".
+1. A short, descriptive tool name in snake_case (e.g. "screenshot_all_nav_pages", "fetch_order_status", "translate_content"). Only lowercase letters, digits, and underscores. The name should describe what the workflow does, not be generic like "query_complete".
 2. A clear, reusable description of what this workflow does (not what the user asked, but what the workflow accomplishes as a reusable tool). Write it as if describing a tool in a catalog. 2-3 sentences max.
 3. Discovery tags — lowercase keywords that help find this workflow when similar future queries are made.
 

package/build/services/mcp/server.js

@@ -64,6 +64,10 @@ const claimAndResolveSchema = zod_1.z.object({
     resolver_id: zod_1.z.string().describe('Identifier for who/what is resolving'),
     payload: zod_1.z.record(zod_1.z.any()).describe('Resolution payload data'),
 });
+const resolveEscalationSchema = zod_1.z.object({
+    escalation_id: zod_1.z.string().describe('The escalation ID to resolve'),
+    payload: zod_1.z.record(zod_1.z.any()).describe('Resolution payload data'),
+});
 const escalateAndWaitSchema = zod_1.z.object({
     role: zod_1.z.string().describe('Target role for the escalation (e.g., "reviewer")'),
     message: zod_1.z.string().describe('Description of what input is needed from the human'),
@@ -218,6 +222,33 @@ async function createHumanQueueServer(options) {
                 }],
         };
     });
+    // ── resolve_escalation ──────────────────────────────────────────────
+    server.registerTool('resolve_escalation', {
+        title: 'Resolve Escalation',
+        description: 'Resolve an already-claimed escalation with a payload. Use when the claim happened externally (e.g. via API).',
+        inputSchema: resolveEscalationSchema,
+    }, async (args) => {
+        const resolved = await escalationService.resolveEscalation(args.escalation_id, args.payload);
+        if (!resolved) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: 'Failed to resolve escalation' }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        escalation_id: resolved.id,
+                        status: resolved.status,
+                        resolved_at: resolved.resolved_at,
+                    }),
+                }],
+        };
+    });
     // ── escalate_and_wait ──────────────────────────────────────────────
     server.registerTool('escalate_and_wait', {
         title: 'Escalate and Wait',

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

@@ -5,6 +5,8 @@ export interface ListJobsParams {
     entity?: string;
     search?: string;
     status?: string;
+    sort_by?: string;
+    order?: 'asc' | 'desc';
 }
 interface JobRow {
     workflow_id: string;

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

@@ -5,6 +5,15 @@ exports.listJobs = listJobs;
 const db_1 = require("../../lib/db");
 const hotmesh_utils_1 = require("../hotmesh-utils");
 const sql_1 = require("./sql");
+const SORTABLE_COLUMNS = new Set(['created_at', 'updated_at', 'entity', 'status']);
+function buildOrderBy(sortBy, order) {
+    if (!sortBy || !SORTABLE_COLUMNS.has(sortBy)) {
+        return '(CASE WHEN j.status > 0 THEN 0 ELSE 1 END), j.created_at DESC';
+    }
+    const dir = order === 'asc' ? 'ASC' : 'DESC';
+    const col = sortBy === 'status' ? '(CASE WHEN j.status > 0 THEN 0 WHEN j.status = 0 THEN 1 ELSE 2 END)' : `j.${sortBy}`;
+    return `${col} ${dir}`;
+}
 /**
  * Return distinct entity names from job runs + yaml workflow graph_topics.
  */
@@ -55,9 +64,10 @@ async function listJobs(params) {
     }
     const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
     const keyPrefix = `hmsh:${appId}:j:`;
+    const orderBy = buildOrderBy(params.sort_by, params.order);
     const [countResult, dataResult] = await Promise.all([
         pool.query((0, sql_1.COUNT_JOBS)(schema, where), values),
-        pool.query((0, sql_1.LIST_JOBS)(schema, appId, where, idx++, idx++), [...values, limit, offset]),
+        pool.query((0, sql_1.LIST_JOBS)(schema, appId, where, idx++, idx++, orderBy), [...values, limit, offset]),
     ]);
     const jobs = dataResult.rows.map((row) => ({
         workflow_id: row.key.startsWith(keyPrefix) ? row.key.slice(keyPrefix.length) : row.key,

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/db.d.ts

@@ -21,6 +21,18 @@ 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<{

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

@@ -11,6 +11,7 @@ exports.deleteYamlWorkflow = deleteYamlWorkflow;
 exports.discoverWorkflows = discoverWorkflows;
 exports.getActiveYamlWorkflows = getActiveYamlWorkflows;
 exports.listYamlWorkflowsByAppId = listYamlWorkflowsByAppId;
+exports.getNextAppVersion = getNextAppVersion;
 exports.getDistinctAppIds = getDistinctAppIds;
 exports.createVersionSnapshot = createVersionSnapshot;
 exports.getVersionHistory = getVersionHistory;
@@ -172,6 +173,23 @@ 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);

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

@@ -50,10 +50,10 @@ const analyze_1 = require("./pipeline/analyze");
 const compile_1 = require("./pipeline/compile");
 const build_1 = require("./pipeline/build");
 const validate_1 = require("./pipeline/validate");
-const build_2 = require("./pipeline/build");
+const utils_1 = require("../../modules/utils");
 // Re-exports for backward compatibility
-var build_3 = require("./pipeline/build");
-Object.defineProperty(exports, "capToolArguments", { enumerable: true, get: function () { return build_3.capToolArguments; } });
+var build_2 = require("./pipeline/build");
+Object.defineProperty(exports, "capToolArguments", { enumerable: true, get: function () { return build_2.capToolArguments; } });
 /**
  * Generate a HotMesh YAML workflow from a completed execution's tool call sequence.
  *
@@ -63,7 +63,7 @@ Object.defineProperty(exports, "capToolArguments", { enumerable: true, get: func
  */
 async function generateYamlFromExecution(options) {
     const appId = options.appId || 'longtail';
-    const graphTopic = options.subscribes || (0, build_2.sanitizeName)(options.name);
+    const graphTopic = (0, utils_1.sanitizeToolName)(options.subscribes || options.name);
     // 1. Export the execution to get events
     const execution = await (0, index_1.exportWorkflowExecution)(options.workflowId, options.taskQueue, options.workflowName);
     // 2. Initialize pipeline context

package/build/services/yaml-workflow/pipeline/build/index.d.ts

@@ -6,7 +6,8 @@
  * Falls back to mechanical heuristics when no plan is available.
  */
 import type { PipelineContext } from '../../types';
-export { capToolArguments, sanitizeName } from './utils';
+export { capToolArguments } from './utils';
+export { sanitizeToolName } from '../../../../modules/utils';
 /**
  * Build pipeline stage: construct the HotMesh YAML DAG.
  *

package/build/services/yaml-workflow/pipeline/build/index.js

@@ -7,7 +7,7 @@
  * Falls back to mechanical heuristics when no plan is available.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sanitizeName = exports.capToolArguments = void 0;
+exports.sanitizeToolName = exports.capToolArguments = void 0;
 exports.build = build;
 const input_analyzer_1 = require("../../input-analyzer");
 const utils_1 = require("./utils");
@@ -17,7 +17,8 @@ const dag_1 = require("./dag");
 // Re-export public utilities used by other modules
 var utils_2 = require("./utils");
 Object.defineProperty(exports, "capToolArguments", { enumerable: true, get: function () { return utils_2.capToolArguments; } });
-Object.defineProperty(exports, "sanitizeName", { enumerable: true, get: function () { return utils_2.sanitizeName; } });
+var utils_3 = require("../../../../modules/utils");
+Object.defineProperty(exports, "sanitizeToolName", { enumerable: true, get: function () { return utils_3.sanitizeToolName; } });
 /**
  * Build pipeline stage: construct the HotMesh YAML DAG.
  *

package/build/services/yaml-workflow/pipeline/build/utils.d.ts

@@ -8,8 +8,6 @@
 export declare function keysRelated(a: string, b: string): boolean;
 /** Cap `limit` in tool arguments to avoid sending huge payloads to downstream LLM steps. */
 export declare function capToolArguments(args: Record<string, unknown>): Record<string, unknown>;
-/** Sanitize a name for use in HotMesh app IDs and topics. */
-export declare function sanitizeName(name: string): string;
 /** Convert a snake_case/camelCase field name to a readable label. */
 export declare function humanize(name: string): string;
 /**

package/build/services/yaml-workflow/pipeline/build/utils.js

@@ -5,7 +5,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.keysRelated = keysRelated;
 exports.capToolArguments = capToolArguments;
-exports.sanitizeName = sanitizeName;
 exports.humanize = humanize;
 exports.inferSchema = inferSchema;
 exports.buildInputMappings = buildInputMappings;
@@ -35,13 +34,6 @@ function capToolArguments(args) {
     }
     return capped;
 }
-/** Sanitize a name for use in HotMesh app IDs and topics. */
-function sanitizeName(name) {
-    return name
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-|-$/g, '');
-}
 /** Convert a snake_case/camelCase field name to a readable label. */
 function humanize(name) {
     return name

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

@@ -6,7 +6,8 @@ export declare const UPDATE_YAML_WORKFLOW_VERSION = "\n  UPDATE lt_yaml_workflow
 export declare const DELETE_YAML_WORKFLOW = "\n  DELETE FROM lt_yaml_workflows WHERE id = $1";
 export declare const GET_ACTIVE_YAML_WORKFLOWS = "\n  SELECT * FROM lt_yaml_workflows\n  WHERE status = 'active'\n  ORDER BY name";
 export declare const LIST_BY_APP_ID = "\n  SELECT * FROM lt_yaml_workflows\n  WHERE app_id = $1 AND status != 'archived'\n  ORDER BY name";
-export declare const GET_DISTINCT_APP_IDS = "\n  SELECT DISTINCT app_id FROM lt_yaml_workflows\n  WHERE status != 'archived'\n  ORDER BY app_id";
+export declare const GET_MAX_APP_VERSION = "\n  SELECT COALESCE(MAX(CAST(app_version AS INTEGER)), 0) AS max_version\n  FROM lt_yaml_workflows\n  WHERE app_id = $1 AND status != 'archived'";
+export declare const GET_DISTINCT_APP_IDS = "\n  SELECT DISTINCT app_id FROM (\n    SELECT app_id FROM lt_yaml_workflows WHERE status != 'archived'\n    UNION\n    SELECT app_id FROM hmsh_applications WHERE active = true\n  ) all_apps\n  ORDER BY app_id";
 export declare const MARK_CONTENT_DEPLOYED = "\n  UPDATE lt_yaml_workflows\n  SET deployed_content_version = content_version\n  WHERE id = $1";
 export declare const MARK_APP_ID_CONTENT_DEPLOYED = "\n  UPDATE lt_yaml_workflows\n  SET deployed_content_version = content_version\n  WHERE app_id = $1 AND status != 'archived'";
 export declare const CREATE_VERSION_SNAPSHOT = "\n  INSERT INTO lt_yaml_workflow_versions\n    (workflow_id, version, yaml_content, activity_manifest, input_schema, output_schema, input_field_meta, change_summary)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8)\n  ON CONFLICT (workflow_id, version) DO NOTHING\n  RETURNING *";

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

@@ -1,7 +1,7 @@
 "use strict";
 // ─── YAML workflow CRUD ─────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FIND_BY_TAGS_ALL = exports.FIND_BY_TAGS_ANY = exports.GET_CRON_SCHEDULED_WORKFLOWS = exports.CLEAR_CRON_SCHEDULE = exports.UPDATE_CRON_SCHEDULE = exports.UPDATE_STATUS_SUFFIX = exports.UPDATE_STATUS_BASE = exports.GET_VERSION_SNAPSHOT = exports.DISCOVER_WORKFLOWS = exports.LIST_VERSIONS = exports.COUNT_VERSIONS = exports.CREATE_VERSION_SNAPSHOT = exports.MARK_APP_ID_CONTENT_DEPLOYED = exports.MARK_CONTENT_DEPLOYED = exports.GET_DISTINCT_APP_IDS = exports.LIST_BY_APP_ID = exports.GET_ACTIVE_YAML_WORKFLOWS = exports.DELETE_YAML_WORKFLOW = exports.UPDATE_YAML_WORKFLOW_VERSION = exports.GET_YAML_WORKFLOW_BY_NAME = exports.GET_YAML_WORKFLOW = exports.CHECK_TOPIC_UNIQUE = exports.CREATE_YAML_WORKFLOW = void 0;
+exports.FIND_BY_TAGS_ALL = exports.FIND_BY_TAGS_ANY = exports.GET_CRON_SCHEDULED_WORKFLOWS = exports.CLEAR_CRON_SCHEDULE = exports.UPDATE_CRON_SCHEDULE = exports.UPDATE_STATUS_SUFFIX = exports.UPDATE_STATUS_BASE = exports.GET_VERSION_SNAPSHOT = exports.DISCOVER_WORKFLOWS = exports.LIST_VERSIONS = exports.COUNT_VERSIONS = exports.CREATE_VERSION_SNAPSHOT = exports.MARK_APP_ID_CONTENT_DEPLOYED = exports.MARK_CONTENT_DEPLOYED = exports.GET_DISTINCT_APP_IDS = exports.GET_MAX_APP_VERSION = exports.LIST_BY_APP_ID = exports.GET_ACTIVE_YAML_WORKFLOWS = exports.DELETE_YAML_WORKFLOW = exports.UPDATE_YAML_WORKFLOW_VERSION = exports.GET_YAML_WORKFLOW_BY_NAME = exports.GET_YAML_WORKFLOW = exports.CHECK_TOPIC_UNIQUE = exports.CREATE_YAML_WORKFLOW = void 0;
 exports.CREATE_YAML_WORKFLOW = `
   INSERT INTO lt_yaml_workflows
     (name, description, app_id, app_version, source_workflow_id,
@@ -32,9 +32,16 @@ exports.LIST_BY_APP_ID = `
   SELECT * FROM lt_yaml_workflows
   WHERE app_id = $1 AND status != 'archived'
   ORDER BY name`;
+exports.GET_MAX_APP_VERSION = `
+  SELECT COALESCE(MAX(CAST(app_version AS INTEGER)), 0) AS max_version
+  FROM lt_yaml_workflows
+  WHERE app_id = $1 AND status != 'archived'`;
 exports.GET_DISTINCT_APP_IDS = `
-  SELECT DISTINCT app_id FROM lt_yaml_workflows
-  WHERE status != 'archived'
+  SELECT DISTINCT app_id FROM (
+    SELECT app_id FROM lt_yaml_workflows WHERE status != 'archived'
+    UNION
+    SELECT app_id FROM hmsh_applications WHERE active = true
+  ) all_apps
   ORDER BY app_id`;
 exports.MARK_CONTENT_DEPLOYED = `
   UPDATE lt_yaml_workflows

package/build/system/activities/schema-exchange.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Schema-driven data exchange with external service endpoints.
+ *
+ * Three pillars: endpoint + schema + identity.
+ * Transport (fetch, Playwright, gRPC) is an implementation detail.
+ * The value is schema enforcement and credential resolution —
+ * validating both sides of the exchange and resolving auth from
+ * the connection store at the last mile.
+ */
+/**
+ * Validate data against a JSON Schema.
+ *
+ * Returns a list of human-readable error strings (empty when valid).
+ */
+export declare function validateSchema(data: unknown, schema: Record<string, unknown>): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Exchange data with an external service endpoint under schema enforcement.
+ *
+ * 1. If request_schema provided, validate body before sending.
+ *    On failure: return immediately (never send the request).
+ * 2. Make the HTTP call (transport layer — currently Node.js fetch).
+ * 3. Parse response body (JSON auto-detect).
+ * 4. If response_schema provided, validate response after receiving.
+ * 5. Return result with validated flag and any validation_errors.
+ */
+export declare function exchange(args: {
+    endpoint?: string;
+    url?: string;
+    method: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    body?: unknown;
+    request_schema?: Record<string, unknown>;
+    response_schema?: Record<string, unknown>;
+    timeout_ms?: number;
+    credential_provider?: string;
+    credential_label?: string;
+    auth_scheme?: string;
+    auth_header?: string;
+}): Promise<{
+    status: number;
+    data: unknown;
+    headers: Record<string, string>;
+    elapsed_ms: number;
+    validated: boolean;
+    validation_errors: string[];
+}>;