aimeat 1.23.2 → 1.24.0

package/dist/src/models/workflow-schemas.d.ts

@@ -0,0 +1,220 @@
+/**
+ * @file workflow-schemas.ts
+ * @description The shared contract for Agent Workflows — the signal grammar and the workflow
+ *   descriptor types. A "signal" is a tree evaluated against owner memory (deterministic-first,
+ *   with a sparingly-used node-OpenRouter `llm` leaf); both an agent's offer (success_signal /
+ *   required_to_function) and a workflow step build to this same grammar. The deterministic engine
+ *   is node-owned; the non-deterministic inspector is crew-owned. See
+ *   docs/plans/2026-06-13-agent-workflows-node-plan.md and the crew spec (dev-organism
+ *   Development workspace, note doc-mqbukpqskhzq).
+ * @structure
+ *   - LocalizedStringSchema — string | { [locale]: text }
+ *   - SignalSchema / Signal — the recursive signal grammar (deterministic | llm | all | any | when)
+ *   - WorkflowVar / WorkflowStep / WorkflowDef / WorkflowRun — descriptor + run-record TS types
+ *     (Zod validation for the descriptor is added in Phase 3 with the CRUD routes)
+ * @usage import { SignalSchema, type Signal } from '../models/workflow-schemas.js';
+ * @version-history
+ *   v1.0.0 — 2026-06-13 — Initial: signal grammar (shared with offers) + descriptor/run types.
+ *   v1.1.0 — 2026-06-13 — Phase 3: Zod for the descriptor (WorkflowDefInputSchema) — CRUD validation.
+ */
+import { z } from 'zod';
+export declare const LocalizedStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+export type LocalizedString = z.infer<typeof LocalizedStringSchema>;
+export type DeterministicSignal = {
+    kind: 'deterministic';
+    key?: string;
+    key_glob?: string;
+    op: 'exists';
+} | {
+    kind: 'deterministic';
+    key?: string;
+    key_glob?: string;
+    op: 'nonempty';
+} | {
+    kind: 'deterministic';
+    key?: string;
+    key_glob?: string;
+    op: 'json_valid';
+} | {
+    kind: 'deterministic';
+    key?: string;
+    key_glob?: string;
+    op: 'count_nonempty';
+    min: number;
+} | {
+    kind: 'deterministic';
+    key?: string;
+    key_glob?: string;
+    op: 'json_schema';
+    schema: Record<string, unknown>;
+} | {
+    kind: 'deterministic';
+    key?: string;
+    key_glob?: string;
+    op: 'json_field';
+    path: string;
+    min?: number;
+    equals?: unknown;
+    nonempty?: boolean;
+};
+export type LlmSignal = {
+    kind: 'llm';
+    key?: string;
+    key_glob?: string;
+    ask: string;
+};
+export type Signal = DeterministicSignal | LlmSignal | {
+    all: Signal[];
+} | {
+    any: Signal[];
+} | {
+    when: Signal;
+    then: Signal;
+};
+export declare const SignalSchema: z.ZodType<Signal>;
+export interface WorkflowVar {
+    name: string;
+    type: string;
+    description: LocalizedString;
+    default?: string;
+    example?: string;
+}
+export interface WorkflowStep {
+    id: string;
+    agent: string | string[];
+    offer: string;
+    after?: string[];
+    description: LocalizedString;
+    required_to_function?: Signal | 'none';
+    success_signal?: Signal;
+    retry?: {
+        max: number;
+        backoff_min: number;
+    };
+    /** Max minutes to WAIT for this step's success signal before declaring it timed-out. A step may
+     *  legitimately run for many minutes; this only bounds how long we wait for its output. Default 60. */
+    timeout_min?: number;
+}
+export type WorkflowTrigger = {
+    kind: 'schedule';
+    cron: string;
+    timezone?: string;
+} | {
+    kind: 'manual';
+} | {
+    kind: 'event';
+    on: 'memory.write' | 'offer.ordered';
+    match: Record<string, string>;
+};
+export interface WorkflowDef {
+    id: string;
+    title: LocalizedString;
+    description: LocalizedString;
+    trigger: WorkflowTrigger;
+    vars: WorkflowVar[];
+    steps: WorkflowStep[];
+    on_step_fail: 'inspect';
+    llm?: {
+        approved: boolean;
+    };
+    costCapMorsels?: number | null;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type StepState = 'pending' | 'input-red' | 'dispatched' | 'green' | 'output-red' | 'timed-out' | 'skipped';
+export interface WorkflowRunStep {
+    state: StepState;
+    attempt: number;
+    taskIds?: string[];
+    inputObserved?: unknown;
+    outputObserved?: unknown;
+    reads: string[];
+    writes: string[];
+    startedAt?: string;
+    endedAt?: string;
+    /** Retry backoff: the engine won't (re-)dispatch this pending step before this ISO time. */
+    notBefore?: string;
+}
+/**
+ * The effective signals for a step, resolved from its offer AT START TIME and pinned into the run.
+ * The engine evaluates against THIS, never re-resolving against current offers mid-run — so editing
+ * or deleting an offer while a run is in flight can't silently turn a step's check into a false pass.
+ */
+export interface ResolvedStepSignals {
+    stepId: string;
+    agents: string[];
+    offerId: string;
+    success_signal?: Signal;
+    required_to_function?: Signal | 'none';
+    deliverableKey?: string;
+}
+export interface WorkflowRun {
+    runId: string;
+    workflowId: string;
+    defSnapshot: WorkflowDef;
+    resolved: ResolvedStepSignals[];
+    vars: Record<string, string>;
+    mode: 'full-live' | 'full-sandbox' | 'signals-only';
+    keyPrefix?: string;
+    status: 'running' | 'waiting-step' | 'red' | 'partial' | 'done';
+    steps: Record<string, WorkflowRunStep>;
+    /** Inspector tasks dispatched on RED steps (best-effort enrichment; the owner push is guaranteed). */
+    inspections?: Array<{
+        stepId: string;
+        taskId: string;
+        reason: string;
+        at: string;
+    }>;
+    startedAt: string;
+    endedAt?: string;
+}
+/** The accepted PUT body — server fills id (from the URL), createdBy, createdAt, updatedAt. */
+export declare const WorkflowDefInputSchema: z.ZodObject<{
+    title: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    description: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    trigger: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        cron: z.ZodString;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"manual">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        on: z.ZodEnum<{
+            "memory.write": "memory.write";
+            "offer.ordered": "offer.ordered";
+        }>;
+        match: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>], "kind">;
+    vars: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        description: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        default: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        agent: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        offer: z.ZodString;
+        after: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        description: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        required_to_function: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<Signal, unknown, z.core.$ZodTypeInternals<Signal, unknown>>, z.ZodLiteral<"none">]>>;
+        success_signal: z.ZodOptional<z.ZodType<Signal, unknown, z.core.$ZodTypeInternals<Signal, unknown>>>;
+        retry: z.ZodOptional<z.ZodObject<{
+            max: z.ZodNumber;
+            backoff_min: z.ZodNumber;
+        }, z.core.$strip>>;
+        timeout_min: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    on_step_fail: z.ZodLiteral<"inspect">;
+    llm: z.ZodOptional<z.ZodObject<{
+        approved: z.ZodBoolean;
+    }, z.core.$strip>>;
+    costCapMorsels: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type WorkflowDefInput = z.infer<typeof WorkflowDefInputSchema>;
+/** Workflow id: lowercase slug, used directly in the memory key `workflows.def.<id>`. */
+export declare const WORKFLOW_ID_RE: RegExp;
+//# sourceMappingURL=workflow-schemas.d.ts.map

package/dist/src/models/workflow-schemas.d.ts.map

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

package/dist/src/models/workflow-schemas.js

@@ -0,0 +1,102 @@
+/**
+ * @file workflow-schemas.ts
+ * @description The shared contract for Agent Workflows — the signal grammar and the workflow
+ *   descriptor types. A "signal" is a tree evaluated against owner memory (deterministic-first,
+ *   with a sparingly-used node-OpenRouter `llm` leaf); both an agent's offer (success_signal /
+ *   required_to_function) and a workflow step build to this same grammar. The deterministic engine
+ *   is node-owned; the non-deterministic inspector is crew-owned. See
+ *   docs/plans/2026-06-13-agent-workflows-node-plan.md and the crew spec (dev-organism
+ *   Development workspace, note doc-mqbukpqskhzq).
+ * @structure
+ *   - LocalizedStringSchema — string | { [locale]: text }
+ *   - SignalSchema / Signal — the recursive signal grammar (deterministic | llm | all | any | when)
+ *   - WorkflowVar / WorkflowStep / WorkflowDef / WorkflowRun — descriptor + run-record TS types
+ *     (Zod validation for the descriptor is added in Phase 3 with the CRUD routes)
+ * @usage import { SignalSchema, type Signal } from '../models/workflow-schemas.js';
+ * @version-history
+ *   v1.0.0 — 2026-06-13 — Initial: signal grammar (shared with offers) + descriptor/run types.
+ *   v1.1.0 — 2026-06-13 — Phase 3: Zod for the descriptor (WorkflowDefInputSchema) — CRUD validation.
+ */
+import { z } from 'zod';
+// ── Localized string ─────────────────────────────────────────────────────────
+// A plain string, or a { locale: text } map (e.g. { en_US: "…", fi_FI: "…" }).
+export const LocalizedStringSchema = z.union([
+    z.string().max(2000),
+    z.record(z.string().max(20), z.string().max(2000)),
+]);
+// Common leaf fields — a leaf targets exactly one of key | key_glob (enforced by the evaluator).
+const leafTarget = {
+    key: z.string().max(400).optional(),
+    key_glob: z.string().max(400).optional(),
+};
+const DeterministicLeafSchema = z.discriminatedUnion('op', [
+    z.object({ kind: z.literal('deterministic'), ...leafTarget, op: z.literal('exists') }),
+    z.object({ kind: z.literal('deterministic'), ...leafTarget, op: z.literal('nonempty') }),
+    z.object({ kind: z.literal('deterministic'), ...leafTarget, op: z.literal('json_valid') }),
+    z.object({ kind: z.literal('deterministic'), ...leafTarget, op: z.literal('count_nonempty'), min: z.number().int().nonnegative() }),
+    z.object({ kind: z.literal('deterministic'), ...leafTarget, op: z.literal('json_schema'), schema: z.record(z.string(), z.unknown()) }),
+    z.object({
+        kind: z.literal('deterministic'), ...leafTarget, op: z.literal('json_field'),
+        path: z.string().min(1).max(200),
+        min: z.number().optional(),
+        equals: z.unknown().optional(),
+        nonempty: z.boolean().optional(),
+    }),
+]);
+const LlmLeafSchema = z.object({
+    kind: z.literal('llm'),
+    ...leafTarget,
+    ask: z.string().min(1).max(2000),
+});
+// Recursive: composites nest signals. z.lazy breaks the cycle.
+export const SignalSchema = z.lazy(() => z.union([
+    DeterministicLeafSchema,
+    LlmLeafSchema,
+    z.object({ all: z.array(SignalSchema).min(1).max(50) }),
+    z.object({ any: z.array(SignalSchema).min(1).max(50) }),
+    z.object({ when: SignalSchema, then: SignalSchema }),
+]));
+// ── Zod for the descriptor (Phase 3 — CRUD validation) ─────────────────────────
+// The PUT body shape: server-managed fields (id from the URL, createdBy + timestamps) are added by
+// the store, not accepted from the client.
+const RetrySchema = z.object({
+    max: z.number().int().min(0).max(10),
+    backoff_min: z.number().min(0).max(1440),
+});
+const WorkflowVarSchema = z.object({
+    name: z.string().min(1).max(80).regex(/^[a-zA-Z0-9_]+$/, 'var name must be [a-zA-Z0-9_]'),
+    type: z.string().min(1).max(40),
+    description: LocalizedStringSchema,
+    default: z.string().max(500).optional(),
+    example: z.string().max(500).optional(),
+});
+const WorkflowStepSchema = z.object({
+    id: z.string().min(1).max(100),
+    agent: z.union([z.string().min(1).max(100), z.array(z.string().min(1).max(100)).min(1).max(20)]),
+    offer: z.string().min(1).max(100),
+    after: z.array(z.string().min(1).max(100)).max(50).optional(),
+    description: LocalizedStringSchema,
+    required_to_function: z.union([SignalSchema, z.literal('none')]).optional(),
+    success_signal: SignalSchema.optional(),
+    retry: RetrySchema.optional(),
+    timeout_min: z.number().int().min(1).max(10080).optional(), // minutes to wait for the signal; default 60 (engine), max 7 days
+});
+const WorkflowTriggerSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('schedule'), cron: z.string().min(1).max(120), timezone: z.string().max(60).optional() }),
+    z.object({ kind: z.literal('manual') }),
+    z.object({ kind: z.literal('event'), on: z.enum(['memory.write', 'offer.ordered']), match: z.record(z.string().max(120), z.string().max(400)) }),
+]);
+/** The accepted PUT body — server fills id (from the URL), createdBy, createdAt, updatedAt. */
+export const WorkflowDefInputSchema = z.object({
+    title: LocalizedStringSchema,
+    description: LocalizedStringSchema,
+    trigger: WorkflowTriggerSchema,
+    vars: z.array(WorkflowVarSchema).max(30),
+    steps: z.array(WorkflowStepSchema).min(1).max(50),
+    on_step_fail: z.literal('inspect'),
+    llm: z.object({ approved: z.boolean() }).optional(),
+    costCapMorsels: z.number().int().nonnegative().nullable().optional(),
+});
+/** Workflow id: lowercase slug, used directly in the memory key `workflows.def.<id>`. */
+export const WORKFLOW_ID_RE = /^[a-z0-9][a-z0-9-]{0,98}[a-z0-9]$/;
+//# sourceMappingURL=workflow-schemas.js.map

package/dist/src/models/workflow-schemas.js.map

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

package/dist/src/routes/agent-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-tasks.d.ts","sourceRoot":"","sources":["../../../src/routes/agent-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAA8E,MAAM,yBAAyB,CAAC;AAYnI,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAsBpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAotCtH"}
+{"version":3,"file":"agent-tasks.d.ts","sourceRoot":"","sources":["../../../src/routes/agent-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAA8E,MAAM,yBAAyB,CAAC;AAcnI,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAsBpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAmwCtH"}

package/dist/src/routes/agent-tasks.js

@@ -37,6 +37,8 @@ import { success, error } from '../middleware/envelope.js';
 import { requireAuth, requireRole, agentNotFoundResponse } from '../auth/middleware.js';
 import { resolveIdentity, buildGAII } from '../utils/gaii.js';
 import { emitChange, emitDelivery } from '../services/event-bus.js';
+import { getActiveWorkflowEngine } from '../services/workflow/engine.js';
+import { logger } from '../utils/logger.js';
 import { emitResourceUpdated } from '../mcp/index.js';
 import { recordTaskStarted, recordTaskCompleted, recordTaskFailed } from '../services/activity-recorder.js';
 import { recomputeAndCacheStatistics } from '../services/agent-statistics.js';
@@ -229,6 +231,15 @@ export function agentTasksRouter(config, storage, webhookDispatcher) {
             { description: 'List events', method: 'GET', url: `/v1/agents/${agentName}/tasks/${id}/events` },
         ]));
         emitChange('agent-tasks');
+        // Event-triggered workflows: a USER ordering an offer (the offers Ask flow tags the task with an
+        // `offer_id` scope) may start a workflow. The workflow engine's OWN dispatched tasks go through
+        // storage.createAgentTask directly (NOT this route) and use a different scope, so they don't fire
+        // this — only genuine user/agent orders do.
+        const orderedOfferId = record.scope?.find((s) => s.name === 'offer_id')?.value;
+        if (orderedOfferId) {
+            getActiveWorkflowEngine()?.onOfferOrdered(record.ownerGaii, orderedOfferId)
+                .catch(e => logger.error('workflow event trigger (offer.ordered) failed', { offerId: orderedOfferId, error: String(e) }));
+        }
     });
     /* ── GET /v1/agents/:name/tasks -- List tasks for an agent ──
      *
@@ -915,6 +926,9 @@ export function agentTasksRouter(config, storage, webhookDispatcher) {
         await recordTaskCompleted(storage, task.agentGaii, task.telemetry);
         res.json(success(config.nodeId, { task: updated }));
         emitChange('agent-tasks');
+        // If this task was dispatched by a workflow, advance that run (output check → next step).
+        getActiveWorkflowEngine()?.onTaskTerminal(task, 'done')
+            .catch(e => logger.error('workflow advance on task done failed', { taskId: id, error: String(e) }));
     });
     /* ── POST /v1/agents/:name/tasks/:id/fail -- Fail task (active -> failed) ── */
     router.post('/v1/agents/:name/tasks/:id/fail', requireAuth(), async (req, res) => {
@@ -953,6 +967,8 @@ export function agentTasksRouter(config, storage, webhookDispatcher) {
         await recordTaskFailed(storage, task.agentGaii);
         res.json(success(config.nodeId, { task: updated }));
         emitChange('agent-tasks');
+        getActiveWorkflowEngine()?.onTaskTerminal(task, 'failed')
+            .catch(e => logger.error('workflow advance on task fail failed', { taskId: id, error: String(e) }));
     });
     /* ── POST /v1/agents/:name/tasks/:id/rate -- Review a completed task's deliverable ──
      *
@@ -1160,6 +1176,39 @@ export function agentTasksRouter(config, storage, webhookDispatcher) {
             per_page: perPage,
         }));
     });
+    /* ── GET /v1/deliverables — the Offers "Inbox": everything that came back, across ALL agents ──
+     * Owner aggregate of non-draft tasks (queued/active/done/failed/…), newest first, with provenance
+     * (agent, status, timestamps), the deliverable key, the verification expectation, and any existing
+     * rating. The follow-up half of the Offers surface — check + rate without clicking through agents.
+     * Failures are included AS failures (status='failed'); rate the deliverable via the locked
+     * POST /v1/agents/:name/tasks/:id/rate. */
+    router.get('/v1/deliverables', requireAuth(), requireRole('owner'), async (req, res) => {
+        const owner = resolve(req);
+        const all = [];
+        for (let p = 1; p <= 10; p++) {
+            const r = await storage.listAgentTasksByOwner(owner, { page: p, perPage: 200 });
+            all.push(...r.tasks);
+            if (r.tasks.length < 200)
+                break;
+        }
+        const deliverables = all
+            .filter(t => t.status !== 'draft')
+            .sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)))
+            .slice(0, 100)
+            .map(t => ({
+            task_id: t.id,
+            agent: t.agentGaii.split('#')[0],
+            agent_gaii: t.agentGaii, // full GAII so the Inbox can read the agent's memory namespace
+            title: t.title,
+            status: t.status,
+            completed_at: t.completedAt ?? null,
+            updated_at: t.updatedAt,
+            deliverable_key: t.deliverableKey ?? null,
+            verification: t.verification?.userExpects ?? null,
+            rating: t.rating ?? null,
+        }));
+        res.json(success(config.nodeId, { deliverables, total: deliverables.length }));
+    });
     return router;
 }
 //# sourceMappingURL=agent-tasks.js.map