@tleblancureta/proto 0.1.0

package/dist/core-mcp/src/workflow-tools.js

@@ -0,0 +1,382 @@
+/**
+ * buildWorkflowTools — generates MCP tools from a WorkflowDefinition.
+ *
+ * Emits 9 tools per workflow (names are configurable via `toolNames`):
+ *
+ *   get_item_state, list_items_by_phase, advance_step,
+ *   block_item, unblock_item, hold_item, resume_item, cancel_item,
+ *   request_human_approval
+ *
+ * Defaults keep the tool names stable so existing skills keep working. If an
+ * app has multiple workflows, set `toolNames` on each to avoid collisions.
+ */
+import { z } from 'zod';
+import { workflowPhaseNames, workflowPhaseSteps, workflowPhaseIndex, workflowIsValidStep, workflowRequiresHumanApproval, workflowExecution, } from '../../core-shared/src/index.js';
+import { defineTool, registerTools } from './define-tool.js';
+import { getSupabase } from './supabase.js';
+import { agent, agentErr } from './tools/_helpers.js';
+const DEFAULT_COLS = {
+    phase: 'current_phase',
+    step: 'current_step',
+    onHold: 'on_hold',
+    blocked: 'blocked_reason',
+    cancelled: 'cancelled',
+    company: 'company_id',
+    updatedAt: 'updated_at',
+};
+const DEFAULT_NAMES = {
+    getState: 'get_item_state',
+    listByPhase: 'list_items_by_phase',
+    advanceStep: 'advance_step',
+    blockItem: 'block_item',
+    unblockItem: 'unblock_item',
+    holdItem: 'hold_item',
+    resumeItem: 'resume_item',
+    cancelItem: 'cancel_item',
+    requestHumanApproval: 'request_human_approval',
+};
+function resolveCols(wf) {
+    return { ...DEFAULT_COLS, ...(wf.columns || {}) };
+}
+function resolveNames(wf) {
+    return { ...DEFAULT_NAMES, ...(wf.toolNames || {}) };
+}
+function flagsSummary(item, cols) {
+    const flags = [];
+    if (item[cols.onHold])
+        flags.push('ON HOLD');
+    if (item[cols.blocked])
+        flags.push(`BLOCKED: ${item[cols.blocked]}`);
+    if (item[cols.cancelled])
+        flags.push('CANCELLED');
+    return flags.length ? ` [${flags.join(', ')}]` : '';
+}
+function buildStepHint(wf, phase, step) {
+    const key = `${phase}.${step}`;
+    if (wf.stepHints?.[key])
+        return wf.stepHints[key];
+    if (workflowRequiresHumanApproval(wf, phase, step)) {
+        return 'Este step requiere aprobacion humana. Llama request_human_approval con el packet de datos.';
+    }
+    const steps = workflowPhaseSteps(wf, phase);
+    const idx = steps.indexOf(step);
+    if (idx === -1)
+        return undefined;
+    if (idx < steps.length - 1) {
+        return `Proximo step en ${phase}: "${steps[idx + 1]}"`;
+    }
+    const phaseIdx = workflowPhaseIndex(wf, phase);
+    if (phaseIdx < wf.phases.length - 1) {
+        const nextPhase = wf.phases[phaseIdx + 1];
+        return `Ultimo step de ${phase}. Proxima fase: "${nextPhase.name}" (primer step: "${workflowPhaseSteps(wf, nextPhase.name)[0]}")`;
+    }
+    return undefined;
+}
+export function buildWorkflowTools(wf) {
+    const cols = resolveCols(wf);
+    const names = resolveNames(wf);
+    const phaseNames = workflowPhaseNames(wf);
+    const executions = workflowExecution(wf);
+    // Zod enum needs a non-empty tuple; cast fits.
+    const phaseEnum = z.enum(phaseNames);
+    return [
+        defineTool({
+            name: names.getState,
+            description: `Snapshot del state machine para un item del workflow ${wf.name}: fase, sub-paso, flags, y si requiere aprobacion humana.`,
+            schema: { item_id: z.string() },
+            handler: async ({ item_id }) => {
+                const db = getSupabase();
+                const selectCols = [
+                    'id', 'order_id',
+                    cols.phase, cols.step, cols.onHold, cols.blocked, cols.cancelled,
+                ].join(', ');
+                const { data: item, error } = await db
+                    .from(wf.entityTable)
+                    .select(selectCols)
+                    .eq('id', item_id)
+                    .single();
+                if (error || !item)
+                    return agentErr(error?.message ?? 'Item no encontrado');
+                const phase = item[cols.phase];
+                const step = item[cols.step];
+                const stepsForPhase = workflowPhaseSteps(wf, phase);
+                const stepIdx = stepsForPhase.indexOf(step);
+                return agent({
+                    summary: `Item ${item_id}: ${phase}.${step}${flagsSummary(item, cols)}`,
+                    data: {
+                        item_id: item.id,
+                        order_id: item.order_id,
+                        phase,
+                        step,
+                        on_hold: item[cols.onHold],
+                        blocked_reason: item[cols.blocked],
+                        cancelled: item[cols.cancelled],
+                        steps_in_phase: stepsForPhase,
+                        step_index: stepIdx,
+                        is_last_step: stepIdx === stepsForPhase.length - 1,
+                        requires_human_approval: workflowRequiresHumanApproval(wf, phase, step),
+                        execution_context: executions[phase] ?? null,
+                    },
+                    hint: buildStepHint(wf, phase, step),
+                });
+            },
+        }),
+        defineTool({
+            name: names.listByPhase,
+            description: `Lista items de una empresa en el workflow ${wf.name}, opcionalmente filtrando por fase.`,
+            schema: {
+                company_id: z.string(),
+                phase: phaseEnum.optional(),
+                include_cancelled: z.boolean().default(false),
+            },
+            handler: async ({ company_id, phase, include_cancelled }) => {
+                const db = getSupabase();
+                const selectCols = [
+                    'id', 'order_id', 'description',
+                    cols.phase, cols.step, cols.onHold, cols.blocked,
+                ].join(', ');
+                let q = db.from(wf.entityTable).select(selectCols).eq(cols.company, company_id);
+                if (phase)
+                    q = q.eq(cols.phase, phase);
+                if (!include_cancelled)
+                    q = q.eq(cols.cancelled, false);
+                const { data, error } = await q.order(cols.updatedAt, { ascending: false });
+                if (error)
+                    return agentErr(`Error listando items: ${error.message}`);
+                const items = (data || []).map((i) => ({
+                    id: i.id,
+                    order_id: i.order_id,
+                    description: i.description,
+                    phase: i[cols.phase],
+                    step: i[cols.step],
+                    on_hold: i[cols.onHold],
+                    blocked: !!i[cols.blocked],
+                }));
+                return agent({
+                    summary: `${items.length} item(s)${phase ? ` en ${phase}` : ''} para empresa ${company_id}`,
+                    data: { items },
+                });
+            },
+        }),
+        defineTool({
+            name: names.advanceStep,
+            description: `Avanza un item al siguiente sub-paso o a una nueva fase dentro del workflow ${wf.name}. Valida transicion legal.`,
+            schema: {
+                item_id: z.string(),
+                to_phase: phaseEnum,
+                to_step: z.string(),
+                actor: z.string().describe('agent | user'),
+                reason: z.string().optional(),
+                evidence: z.record(z.string(), z.any()).optional(),
+            },
+            handler: async ({ item_id, to_phase, to_step, actor, reason, evidence }) => {
+                const db = getSupabase();
+                const selectCols = [
+                    'id', 'order_id', cols.company,
+                    cols.phase, cols.step, cols.onHold, cols.blocked, cols.cancelled,
+                ].join(', ');
+                const { data: item, error: e1 } = await db
+                    .from(wf.entityTable)
+                    .select(selectCols)
+                    .eq('id', item_id)
+                    .single();
+                if (e1 || !item)
+                    return agentErr(e1?.message ?? 'Item no encontrado');
+                const row = item;
+                if (row[cols.cancelled])
+                    return agentErr('Item cancelado, no se puede avanzar');
+                if (row[cols.onHold])
+                    return agentErr('Item en hold. Llama resume_item primero.');
+                if (row[cols.blocked])
+                    return agentErr(`Item bloqueado: ${row[cols.blocked]}. Llama unblock_item primero.`);
+                if (!workflowIsValidStep(wf, to_phase, to_step)) {
+                    return agentErr(`Step "${to_step}" no existe en fase "${to_phase}"`, {
+                        valid_steps: workflowPhaseSteps(wf, to_phase),
+                    });
+                }
+                const fromIdx = workflowPhaseIndex(wf, row[cols.phase]);
+                const toIdx = workflowPhaseIndex(wf, to_phase);
+                if (toIdx < fromIdx)
+                    return agentErr('No se puede retroceder de fase');
+                if (toIdx > fromIdx + 1)
+                    return agentErr('Solo se puede avanzar 1 fase a la vez');
+                if (workflowRequiresHumanApproval(wf, to_phase, to_step) && actor !== 'user') {
+                    return agentErr(`Step "${to_phase}.${to_step}" requiere aprobacion humana. Llama request_human_approval.`);
+                }
+                const { error: e2 } = await db
+                    .from(wf.entityTable)
+                    .update({
+                    [cols.phase]: to_phase,
+                    [cols.step]: to_step,
+                    [cols.updatedAt]: new Date().toISOString(),
+                })
+                    .eq('id', item_id);
+                if (e2)
+                    return agentErr(`Error avanzando: ${e2.message}`);
+                await db.from(wf.transitionsTable).insert({
+                    item_id,
+                    company_id: row[cols.company],
+                    from_phase: row[cols.phase],
+                    to_phase,
+                    from_step: row[cols.step],
+                    to_step,
+                    actor,
+                    reason,
+                    evidence: evidence ?? {},
+                });
+                return agent({
+                    summary: `Item ${item_id} avanzado a ${to_phase}.${to_step}`,
+                    data: { item_id, phase: to_phase, step: to_step },
+                    hint: buildStepHint(wf, to_phase, to_step),
+                });
+            },
+        }),
+        defineTool({
+            name: names.blockItem,
+            description: 'Marca un item como bloqueado con razon.',
+            schema: { item_id: z.string(), reason: z.string() },
+            handler: async ({ item_id, reason }) => {
+                const db = getSupabase();
+                const { error } = await db.from(wf.entityTable)
+                    .update({ [cols.blocked]: reason, [cols.updatedAt]: new Date().toISOString() })
+                    .eq('id', item_id);
+                if (error)
+                    return agentErr(`Error bloqueando: ${error.message}`);
+                return agent({
+                    summary: `Item ${item_id} bloqueado: ${reason}`,
+                    data: { item_id, blocked_reason: reason },
+                });
+            },
+        }),
+        defineTool({
+            name: names.unblockItem,
+            description: 'Quita el bloqueo de un item.',
+            schema: { item_id: z.string() },
+            handler: async ({ item_id }) => {
+                const db = getSupabase();
+                const { error } = await db.from(wf.entityTable)
+                    .update({ [cols.blocked]: null, [cols.updatedAt]: new Date().toISOString() })
+                    .eq('id', item_id);
+                if (error)
+                    return agentErr(`Error desbloqueando: ${error.message}`);
+                return agent({
+                    summary: `Item ${item_id} desbloqueado.`,
+                    data: { item_id },
+                    hint: 'Item puede avanzar. Revisa get_item_state para ver posicion actual.',
+                });
+            },
+        }),
+        defineTool({
+            name: names.holdItem,
+            description: 'Pausa un item (on_hold=true).',
+            schema: { item_id: z.string() },
+            handler: async ({ item_id }) => {
+                const db = getSupabase();
+                const { error } = await db.from(wf.entityTable)
+                    .update({ [cols.onHold]: true, [cols.updatedAt]: new Date().toISOString() })
+                    .eq('id', item_id);
+                if (error)
+                    return agentErr(`Error pausando: ${error.message}`);
+                return agent({
+                    summary: `Item ${item_id} pausado.`,
+                    data: { item_id, on_hold: true },
+                });
+            },
+        }),
+        defineTool({
+            name: names.resumeItem,
+            description: 'Reanuda un item pausado.',
+            schema: { item_id: z.string() },
+            handler: async ({ item_id }) => {
+                const db = getSupabase();
+                const { error } = await db.from(wf.entityTable)
+                    .update({ [cols.onHold]: false, [cols.updatedAt]: new Date().toISOString() })
+                    .eq('id', item_id);
+                if (error)
+                    return agentErr(`Error reanudando: ${error.message}`);
+                return agent({
+                    summary: `Item ${item_id} reanudado.`,
+                    data: { item_id, on_hold: false },
+                    hint: 'Item puede avanzar. Revisa get_item_state para ver posicion actual.',
+                });
+            },
+        }),
+        defineTool({
+            name: names.cancelItem,
+            description: 'Cancela un item (terminal).',
+            schema: { item_id: z.string(), reason: z.string().optional() },
+            handler: async ({ item_id, reason }) => {
+                const db = getSupabase();
+                const selectCols = [cols.company, cols.phase, cols.step].join(', ');
+                const { data: item } = await db.from(wf.entityTable)
+                    .select(selectCols)
+                    .eq('id', item_id)
+                    .single();
+                const { error } = await db.from(wf.entityTable)
+                    .update({ [cols.cancelled]: true, [cols.updatedAt]: new Date().toISOString() })
+                    .eq('id', item_id);
+                if (error)
+                    return agentErr(`Error cancelando: ${error.message}`);
+                if (item) {
+                    const row = item;
+                    await db.from(wf.transitionsTable).insert({
+                        item_id,
+                        company_id: row[cols.company],
+                        from_phase: row[cols.phase],
+                        to_phase: row[cols.phase],
+                        from_step: row[cols.step],
+                        to_step: 'cancelled',
+                        actor: 'agent',
+                        reason,
+                    });
+                }
+                return agent({
+                    summary: `Item ${item_id} cancelado.`,
+                    data: { item_id, cancelled: true },
+                });
+            },
+        }),
+        defineTool({
+            name: names.requestHumanApproval,
+            description: 'Marca un item como esperando aprobacion humana. La UI debe llamar advance_step con actor=user para confirmar.',
+            schema: {
+                item_id: z.string(),
+                packet: z.record(z.string(), z.any()).describe('Datos a presentar al humano (resumen de costos, docs, etc.)'),
+            },
+            handler: async ({ item_id, packet }) => {
+                const db = getSupabase();
+                const selectCols = [cols.company, cols.phase, cols.step].join(', ');
+                const { data: item } = await db.from(wf.entityTable)
+                    .select(selectCols)
+                    .eq('id', item_id)
+                    .single();
+                if (!item)
+                    return agentErr('Item no encontrado');
+                const row = item;
+                if (!workflowRequiresHumanApproval(wf, row[cols.phase], row[cols.step])) {
+                    return agentErr('Este step no es un gate de aprobacion humana');
+                }
+                await db.from(wf.transitionsTable).insert({
+                    item_id,
+                    company_id: row[cols.company],
+                    from_phase: row[cols.phase],
+                    to_phase: row[cols.phase],
+                    from_step: row[cols.step],
+                    to_step: row[cols.step],
+                    actor: 'agent',
+                    reason: 'awaiting_human_approval',
+                    evidence: packet,
+                });
+                return agent({
+                    summary: `Aprobacion humana solicitada para item ${item_id} en ${row[cols.phase]}.${row[cols.step]}`,
+                    data: { item_id, phase: row[cols.phase], step: row[cols.step] },
+                    hint: 'NO llames advance_step. El usuario aprobara via UI, que llama advance_step con actor="user".',
+                });
+            },
+        }),
+    ];
+}
+export function registerWorkflowTools(server, wf) {
+    registerTools(server, buildWorkflowTools(wf));
+}
+//# sourceMappingURL=workflow-tools.js.map

package/dist/core-mcp/src/workflow-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-tools.js","sourceRoot":"","sources":["../../../core-mcp/src/workflow-tools.ts"],"names":[],"mappings":"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"}

package/dist/core-shared/src/define-entity.d.ts

@@ -0,0 +1,73 @@
+/**
+ * defineEntity — declarative activatable entity.
+ *
+ * An entity is a first-class object in the app that can be "focused" by the
+ * agent or the user. Activating it triggers:
+ *   - The MCP side: `activate_<name>`, `deactivate_<name>`, `get_active_<name>`
+ *     tools generated from this definition (see @proto/core-mcp → registerEntityTools).
+ *   - The web side: Shell switches to cockpit mode using `cockpit` layouts + widgets.
+ *   - The chat side: `snapshotBuilder` runs and injects the markdown into the
+ *     agent's context so the next turn has fresh data without tool calls.
+ *
+ * The definition is pure data (plus an optional async function). It loads from
+ * both Node (MCP) and the browser (Shell + chat) without React imports.
+ *
+ * Example:
+ *
+ *   export default defineEntity({
+ *     name: 'order',
+ *     displayName: 'pedido',
+ *     table: 'orders',
+ *     labelField: 'supplier_name',
+ *     cockpit: {
+ *       widgets: [
+ *         { id: 'cockpit-header', type: 'order-header', title: 'Pedido' },
+ *         ...
+ *       ],
+ *       layouts: { lg: [...], md: [...], sm: [...] },
+ *     },
+ *     snapshotBuilder: async (entity, { supabase }) => {
+ *       // query related data, return markdown string
+ *     },
+ *   })
+ */
+export interface EntityCockpitWidget {
+    id: string;
+    type: string;
+    title: string;
+    props?: Record<string, unknown>;
+}
+export interface EntityCockpit {
+    widgets: EntityCockpitWidget[];
+    /** react-grid-layout Layouts — opaque at this layer. */
+    layouts: Record<string, unknown>;
+}
+export interface EntityDefinition<T = Record<string, unknown>> {
+    /** Unique id used as activeEntity.type and as the tool suffix. */
+    name: string;
+    /** Human-readable singular noun used in generated tool descriptions. */
+    displayName: string;
+    /** Supabase table the entity lives in. */
+    table: string;
+    /** Column to use as the default label when surfacing this entity. */
+    labelField: string;
+    /** Shell cockpit layout shown when this entity is active. */
+    cockpit?: EntityCockpit;
+    /**
+     * Builds a markdown snapshot of the entity + related data. Called from the
+     * browser before each chat turn so the agent has fresh context without
+     * burning tool calls on reads. Return null to skip injection.
+     */
+    snapshotBuilder?: (entity: T, ctx: {
+        supabase: unknown;
+    }) => Promise<string | null>;
+    /**
+     * Optional override for the agent-facing description of the generated
+     * `activate_<name>` tool. If omitted, a generic template is used.
+     */
+    activateDescription?: string;
+}
+export declare function defineEntity<T = Record<string, unknown>>(def: EntityDefinition<T>): EntityDefinition<T>;
+export type EntityRegistry = Map<string, EntityDefinition>;
+export declare function buildEntityRegistry(defs: readonly EntityDefinition[]): EntityRegistry;
+//# sourceMappingURL=define-entity.d.ts.map

package/dist/core-shared/src/define-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-entity.d.ts","sourceRoot":"","sources":["../../../core-shared/src/define-entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAA;IACnB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,MAAM,EAAE,CAAC,EACT,GAAG,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,KACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACvB,gBAAgB,CAAC,CAAC,CAAC,CAErB;AAED,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;AAE1D,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAChC,cAAc,CAShB"}

package/dist/core-shared/src/define-entity.js

@@ -0,0 +1,47 @@
+/**
+ * defineEntity — declarative activatable entity.
+ *
+ * An entity is a first-class object in the app that can be "focused" by the
+ * agent or the user. Activating it triggers:
+ *   - The MCP side: `activate_<name>`, `deactivate_<name>`, `get_active_<name>`
+ *     tools generated from this definition (see @proto/core-mcp → registerEntityTools).
+ *   - The web side: Shell switches to cockpit mode using `cockpit` layouts + widgets.
+ *   - The chat side: `snapshotBuilder` runs and injects the markdown into the
+ *     agent's context so the next turn has fresh data without tool calls.
+ *
+ * The definition is pure data (plus an optional async function). It loads from
+ * both Node (MCP) and the browser (Shell + chat) without React imports.
+ *
+ * Example:
+ *
+ *   export default defineEntity({
+ *     name: 'order',
+ *     displayName: 'pedido',
+ *     table: 'orders',
+ *     labelField: 'supplier_name',
+ *     cockpit: {
+ *       widgets: [
+ *         { id: 'cockpit-header', type: 'order-header', title: 'Pedido' },
+ *         ...
+ *       ],
+ *       layouts: { lg: [...], md: [...], sm: [...] },
+ *     },
+ *     snapshotBuilder: async (entity, { supabase }) => {
+ *       // query related data, return markdown string
+ *     },
+ *   })
+ */
+export function defineEntity(def) {
+    return def;
+}
+export function buildEntityRegistry(defs) {
+    const map = new Map();
+    for (const def of defs) {
+        if (map.has(def.name)) {
+            console.warn(`[defineEntity] duplicate entity name: ${def.name}`);
+        }
+        map.set(def.name, def);
+    }
+    return map;
+}
+//# sourceMappingURL=define-entity.js.map

package/dist/core-shared/src/define-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-entity.js","sourceRoot":"","sources":["../../../core-shared/src/define-entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA0CH,MAAM,UAAU,YAAY,CAC1B,GAAwB;IAExB,OAAO,GAAG,CAAA;AACZ,CAAC;AAID,MAAM,UAAU,mBAAmB,CACjC,IAAiC;IAEjC,MAAM,GAAG,GAAmB,IAAI,GAAG,EAAE,CAAA;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,yCAAyC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QACnE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/core-shared/src/define-workflow.d.ts

@@ -0,0 +1,111 @@
+/**
+ * defineWorkflow — declarative state machine over a Supabase table.
+ *
+ * A workflow describes a sequence of phases, each with sub-steps. Items
+ * (rows in `entityTable`) carry `phase_column` + `step_column` values and
+ * advance through the phases under agent or user control. Transitions are
+ * recorded into `transitionsTable`.
+ *
+ * The definition is pure data. `@proto/core-mcp` has `buildWorkflowTools()`
+ * that consumes a WorkflowDefinition and emits 9 MCP tools:
+ *
+ *   get_item_state, list_items_by_phase, advance_step,
+ *   block_item, unblock_item, hold_item, resume_item, cancel_item,
+ *   request_human_approval
+ *
+ * Tool names can be customized via `toolNames` when multiple workflows
+ * coexist in one app; otherwise the defaults keep skills compatible.
+ *
+ * Example:
+ *
+ *   export default defineWorkflow({
+ *     name: 'import',
+ *     entityTable: 'order_items',
+ *     transitionsTable: 'phase_transitions',
+ *     phases: [
+ *       {
+ *         name: 'sourcing',
+ *         label: 'Sourcing',
+ *         steps: ['identify_need', 'search_suppliers', 'shortlist'],
+ *         execution: { skills: ['products'], fork: true },
+ *       },
+ *       {
+ *         name: 'final_costing',
+ *         steps: [
+ *           'compute_final_landed',
+ *           { name: 'awaiting_client_approval', requires_human_approval: true },
+ *           'approved',
+ *         ],
+ *       },
+ *     ],
+ *   })
+ */
+export interface WorkflowStepConfig {
+    name: string;
+    requires_human_approval?: boolean;
+}
+export type WorkflowStep = string | WorkflowStepConfig;
+export interface PhaseExecution {
+    skills?: string[];
+    subagent?: string;
+    fork?: boolean;
+    rationale?: string;
+}
+export interface WorkflowPhase {
+    name: string;
+    label?: string;
+    steps: WorkflowStep[];
+    execution?: PhaseExecution;
+}
+export interface WorkflowToolNames {
+    getState?: string;
+    listByPhase?: string;
+    advanceStep?: string;
+    blockItem?: string;
+    unblockItem?: string;
+    holdItem?: string;
+    resumeItem?: string;
+    cancelItem?: string;
+    requestHumanApproval?: string;
+}
+export interface WorkflowColumns {
+    phase?: string;
+    step?: string;
+    onHold?: string;
+    blocked?: string;
+    cancelled?: string;
+    company?: string;
+    updatedAt?: string;
+}
+export interface WorkflowDefinition {
+    /** Unique workflow id (e.g. 'import'). */
+    name: string;
+    /** Human-readable singular (e.g. 'importacion'). */
+    displayName?: string;
+    /** Table holding the stateful items (e.g. 'order_items'). */
+    entityTable: string;
+    /** Table for transition history (e.g. 'phase_transitions'). */
+    transitionsTable: string;
+    /** Column name overrides. Sensible defaults for Hermes-style schemas. */
+    columns?: WorkflowColumns;
+    /** Phase list in forward order. */
+    phases: WorkflowPhase[];
+    /** Extra per-step hints keyed by `${phase}.${step}`. */
+    stepHints?: Record<string, string>;
+    /** Tool name overrides for multi-workflow apps. */
+    toolNames?: WorkflowToolNames;
+}
+export declare function defineWorkflow(def: WorkflowDefinition): WorkflowDefinition;
+export declare function workflowPhaseNames(wf: WorkflowDefinition): string[];
+export declare function workflowPhaseIndex(wf: WorkflowDefinition, phase: string): number;
+export declare function workflowPhaseLabels(wf: WorkflowDefinition): Record<string, string>;
+export declare function workflowPhaseSteps(wf: WorkflowDefinition, phase: string): string[];
+export declare function workflowAllPhaseSteps(wf: WorkflowDefinition): Record<string, string[]>;
+export declare function workflowIsValidStep(wf: WorkflowDefinition, phase: string, step: string): boolean;
+export declare function workflowRequiresHumanApproval(wf: WorkflowDefinition, phase: string, step: string): boolean;
+export declare function workflowHumanApprovalGates(wf: WorkflowDefinition): Array<{
+    phase: string;
+    step: string;
+}>;
+export declare function workflowExecution(wf: WorkflowDefinition): Record<string, PhaseExecution>;
+//# sourceMappingURL=define-workflow.d.ts.map

package/dist/core-shared/src/define-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../../core-shared/src/define-workflow.ts"],"names":[],"mappings":"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"}