@nexalab/agent-sdk 0.1.5 → 0.1.7

package/dist/guided-flows/steps.js

@@ -0,0 +1,37 @@
+/**
+ * Resolves the active step for the current `state`: the first step (in
+ * declared order) whose `when` predicate passes (branches that don't apply
+ * are skipped, never entered) and that isn't already satisfied. This is a
+ * pure function of `state`, never a model decision.
+ */
+export function resolveActiveStep(config, state) {
+    for (const step of config.steps) {
+        if (step.when && !step.when({ state }))
+            continue;
+        if (isStepSatisfied(step, state))
+            continue;
+        return step;
+    }
+    return undefined;
+}
+export function isStepSatisfied(step, state) {
+    if (step.exit)
+        return Boolean(step.exit({ state }));
+    if (!step.collect || step.collect.length === 0)
+        return false;
+    return step.collect.every((field) => {
+        const value = state[String(field)];
+        return value !== undefined && value !== null && value !== "";
+    });
+}
+export function missingCollectFields(step, state) {
+    if (!step?.collect)
+        return [];
+    return step.collect
+        .map(String)
+        .filter((field) => {
+        const value = state[field];
+        return value === undefined || value === null || value === "";
+    });
+}
+//# sourceMappingURL=steps.js.map

package/dist/guided-flows/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/guided-flows/steps.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAqD,EACrD,KAA4B;IAE5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;YAAE,SAAS;QACjD,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,SAAS;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAS,IAA4B,EAAE,KAAa;IACjF,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,MAAM,KAAK,GAAI,KAAiC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAS,IAAwC,EAAE,KAAa;IAClG,IAAI,CAAC,IAAI,EAAE,OAAO;QAAE,OAAO,EAAE,CAAC;IAC9B,OAAO,IAAI,CAAC,OAAO;SAChB,GAAG,CAAC,MAAM,CAAC;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,MAAM,KAAK,GAAI,KAAiC,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/guided-flows/tool-policy.d.ts

@@ -0,0 +1,16 @@
+import type { AgentToolRegistration } from "../openai-agent.js";
+import type { StepToolPolicy } from "./types.js";
+/**
+ * Resolves the tool set offered to the model for the active step.
+ *
+ * Precedence (each layer may only narrow, never widen, the previous one):
+ *   1. global/security policy — out of scope for this module, enforced upstream;
+ *   2. agent permissions — already applied by `kernel.ts` before `baseTools` ever
+ *      reaches this function (`filterToolsByPermissions`);
+ *   3. step `denied`/`allowed` — applied here.
+ * A flow can therefore never expand what the agent itself was permitted to use.
+ */
+export declare function resolveStepTools(baseTools: AgentToolRegistration[], policy: StepToolPolicy | undefined): AgentToolRegistration[];
+export declare function missingRequiredTools(policy: StepToolPolicy | undefined, executedToolIds: string[]): string[];
+export declare function missingRequiredBeforeExitTools(policy: StepToolPolicy | undefined, executedToolIds: string[]): string[];
+//# sourceMappingURL=tool-policy.d.ts.map

package/dist/guided-flows/tool-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/guided-flows/tool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,qBAAqB,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,qBAAqB,EAAE,CAQhI;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAG5G;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGtH"}

package/dist/guided-flows/tool-policy.js

@@ -0,0 +1,33 @@
+/**
+ * Resolves the tool set offered to the model for the active step.
+ *
+ * Precedence (each layer may only narrow, never widen, the previous one):
+ *   1. global/security policy — out of scope for this module, enforced upstream;
+ *   2. agent permissions — already applied by `kernel.ts` before `baseTools` ever
+ *      reaches this function (`filterToolsByPermissions`);
+ *   3. step `denied`/`allowed` — applied here.
+ * A flow can therefore never expand what the agent itself was permitted to use.
+ */
+export function resolveStepTools(baseTools, policy) {
+    if (!policy)
+        return baseTools;
+    return baseTools.filter((registration) => {
+        const id = registration.tool.id;
+        if (policy.denied?.includes(id))
+            return false;
+        if (policy.allowed && !policy.allowed.includes(id))
+            return false;
+        return true;
+    });
+}
+export function missingRequiredTools(policy, executedToolIds) {
+    if (!policy?.required?.length)
+        return [];
+    return policy.required.filter((toolId) => !executedToolIds.includes(toolId));
+}
+export function missingRequiredBeforeExitTools(policy, executedToolIds) {
+    if (!policy?.requiredBeforeExit?.length)
+        return [];
+    return policy.requiredBeforeExit.filter((toolId) => !executedToolIds.includes(toolId));
+}
+//# sourceMappingURL=tool-policy.js.map

package/dist/guided-flows/tool-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.js","sourceRoot":"","sources":["../../src/guided-flows/tool-policy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkC,EAAE,MAAkC;IACrG,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE;QACvC,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkC,EAAE,eAAyB;IAChG,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IACzC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAkC,EAAE,eAAyB;IAC1G,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IACnD,OAAO,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/dist/guided-flows/types.d.ts

@@ -0,0 +1,141 @@
+import type { z } from "zod";
+import type { JsonObject, JsonValue } from "../types.js";
+import type { ToolExecutionResult } from "../tool-registry.js";
+/**
+ * Guided Flow lifecycle. Deliberately its own closed union — not the plan/step
+ * engine's `AgentTaskState` (types.ts) or `mission-runtime.ts`'s `MissionStatus`.
+ * Those model a planner-driven single run; a Guided Flow models a conversation
+ * that pauses across turns waiting on the user.
+ */
+export type GuidedFlowStatus = "idle" | "active" | "waiting_for_user" | "waiting_for_tool" | "waiting_for_approval" | "completed" | "cancelled" | "failed";
+export type FlowPatchSource = "user" | "model" | "tool" | "system";
+export type FlowStatePatch<TState> = {
+    set?: Partial<TState>;
+    unset?: Array<keyof TState>;
+    source: FlowPatchSource;
+};
+export type EvaluatedRequirement = {
+    id: string;
+    description: string;
+    satisfied: boolean;
+};
+export type GuidedFlowRequirement<TState> = {
+    id: string;
+    description: string;
+    satisfied: (input: {
+        state: TState;
+    }) => boolean;
+};
+export type StepToolPolicy = {
+    allowed?: string[];
+    denied?: string[];
+    required?: string[];
+    requiredBeforeExit?: string[];
+};
+export type GuidedFlowStep<TState> = {
+    id: string;
+    description?: string;
+    when?: (input: {
+        state: TState;
+    }) => boolean;
+    collect?: Array<keyof TState>;
+    instructions?: string;
+    skills?: string[];
+    tools?: StepToolPolicy;
+    exit?: (input: {
+        state: TState;
+    }) => boolean;
+};
+export type ToolResultBinding<TState> = {
+    applyResult: (input: {
+        result: ToolExecutionResult;
+        state: TState;
+    }) => FlowStatePatch<TState> | void;
+};
+export type GuidedFlowToolConfig<TState> = {
+    bindings?: Record<string, ToolResultBinding<TState>>;
+};
+export type GuidedFlowConfirmation<TState> = {
+    required: boolean;
+    stateField: keyof TState;
+    resetOnChange?: Array<keyof TState>;
+};
+export type GuidedFlowTriggers = {
+    intents?: string[];
+    examples?: string[];
+};
+export type GuidedFlowConfig<TStateSchema extends z.AnyZodObject = z.AnyZodObject, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny> = {
+    id: string;
+    version: number;
+    name: string;
+    description?: string;
+    goal: string;
+    stateSchema: TStateSchema;
+    initialState: Partial<z.infer<TStateSchema>>;
+    requirements: GuidedFlowRequirement<z.infer<TStateSchema>>[];
+    steps: GuidedFlowStep<z.infer<TStateSchema>>[];
+    confirmation?: GuidedFlowConfirmation<z.infer<TStateSchema>>;
+    protectedFields?: Partial<Record<keyof z.infer<TStateSchema>, FlowPatchSource[]>>;
+    tools?: GuidedFlowToolConfig<z.infer<TStateSchema>>;
+    triggers?: GuidedFlowTriggers;
+    completion: (input: {
+        state: z.infer<TStateSchema>;
+        requirements: EvaluatedRequirement[];
+    }) => boolean;
+    outputSchema: TOutputSchema;
+    mapOutput: (input: {
+        state: z.infer<TStateSchema>;
+    }) => z.infer<TOutputSchema>;
+};
+export type GuidedFlow<TStateSchema extends z.AnyZodObject = z.AnyZodObject, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny> = {
+    readonly config: GuidedFlowConfig<TStateSchema, TOutputSchema>;
+    readonly id: string;
+    readonly version: number;
+};
+export type GuidedFlowRunMeta = {
+    id: string;
+    version: number;
+    status: GuidedFlowStatus;
+    currentStepId?: string;
+    completedRequirementIds: string[];
+    missingRequirementIds: string[];
+    startedAt?: string;
+    updatedAt: string;
+    completedAt?: string;
+};
+export type GuidedFlowRunState<TState = JsonObject> = {
+    flowId: string;
+    flowVersion: number;
+    sessionId: string;
+    status: GuidedFlowStatus;
+    currentStepId?: string;
+    state: TState;
+    completedRequirementIds: string[];
+    missingRequirementIds: string[];
+    stepToolLog: Record<string, string[]>;
+    startedAt?: string;
+    updatedAt: string;
+    completedAt?: string;
+    cancelledAt?: string;
+    output?: JsonValue;
+};
+export type GuidedFlowRunResult<TState = JsonObject, TOutput = JsonValue> = {
+    text: string;
+    output?: TOutput;
+    state: TState;
+    flow: GuidedFlowRunMeta;
+};
+/**
+ * Optional declarative subset for documentation/authoring tooling only (e.g.
+ * describing a flow's shape from YAML). Never wired into `loadAgentManifest`'s
+ * runtime behavior — flows always attach as real `GuidedFlow` objects via
+ * `extend.flows`, since steps/requirements/schemas are callbacks and Zod
+ * schemas that cannot be safely expressed in YAML.
+ */
+export type GuidedFlowManifestDescriptor = {
+    id: string;
+    version: number;
+    goal: string;
+    required: string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/guided-flows/types.d.ts.map

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

package/dist/guided-flows/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/guided-flows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/guided-flows/types.ts"],"names":[],"mappings":""}

package/dist/hooks.d.ts

@@ -46,6 +46,58 @@ export type AgentHooks = {
         record: unknown;
         context: HookContext;
     }) => void | Promise<void>;
+    beforeFlowStart?: (input: {
+        flowId: string;
+        sessionId: string;
+        context: HookContext;
+    }) => void | Promise<void>;
+    afterFlowStart?: (input: {
+        flowId: string;
+        sessionId: string;
+        context: HookContext;
+    }) => void | Promise<void>;
+    beforeFlowStep?: (input: {
+        flowId: string;
+        sessionId: string;
+        stepId: string;
+        context: HookContext;
+    }) => void | Promise<void>;
+    afterFlowStep?: (input: {
+        flowId: string;
+        sessionId: string;
+        stepId: string;
+        context: HookContext;
+    }) => void | Promise<void>;
+    beforeFlowStatePatch?: (input: {
+        flowId: string;
+        sessionId: string;
+        patch: unknown;
+        context: HookContext;
+    }) => void | Promise<void>;
+    afterFlowStatePatch?: (input: {
+        flowId: string;
+        sessionId: string;
+        state: unknown;
+        context: HookContext;
+    }) => void | Promise<void>;
+    beforeFlowComplete?: (input: {
+        flowId: string;
+        sessionId: string;
+        state: unknown;
+        context: HookContext;
+    }) => void | Promise<void>;
+    afterFlowComplete?: (input: {
+        flowId: string;
+        sessionId: string;
+        output: unknown;
+        context: HookContext;
+    }) => void | Promise<void>;
+    onFlowError?: (input: {
+        flowId: string;
+        sessionId: string;
+        error: unknown;
+        context: HookContext;
+    }) => void | Promise<void>;
 };
 type HookName = keyof AgentHooks;
 export declare class HookDispatcher {

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F,CAAC;AAEF,KAAK,QAAQ,GAAG,MAAM,UAAU,CAAC;AAEjC,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,GAAE,UAAe;IAE7C,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKzG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,UAAe,GAAG,cAAc,CAE3E"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAoB,EAAE;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,KAAK,CAAC,IAAI,CAAqB,IAAO,EAAE,KAAgD;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAO,OAAoD,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAoB,EAAE;IACzD,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAoB,EAAE;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,KAAK,CAAC,IAAI,CAAqB,IAAO,EAAE,KAAgD;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAO,OAAoD,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAoB,EAAE;IACzD,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -55,4 +55,5 @@ export * from "./tenancy.js";
 export * from "./workspace.js";
 export * from "./kernel.js";
 export * from "./manifest.js";
+export * from "./guided-flows/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -55,4 +55,5 @@ export * from "./tenancy.js";
 export * from "./workspace.js";
 export * from "./kernel.js";
 export * from "./manifest.js";
+export * from "./guided-flows/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC"}

package/dist/kernel.d.ts

@@ -11,6 +11,7 @@ import type { NexaStorage } from "./storage.js";
 import type { NexaTelemetry } from "./telemetry.js";
 import type { ModelRouter } from "./model-router.js";
 import type { ToolRouter, ToolTraceEvent } from "./tool-orchestrator.js";
+import type { JsonObject } from "./types.js";
 import { type SkillDefinition } from "./skills.js";
 import { type Artifact } from "./artifacts.js";
 import type { McpConnection } from "./mcp.js";
@@ -19,6 +20,7 @@ import type { Cache } from "./cache.js";
 import { type TenantContext } from "./tenancy.js";
 import type { PermissionMatrix } from "./permissions.js";
 import type { ModelHarness } from "./model-harness.js";
+import { type FlowStatePatch, type GuidedFlow, type GuidedFlowRunMeta, type GuidedFlowRunState } from "./guided-flows/index.js";
 export declare function resolveModelString(modelString: string): {
     provider: OpenAICompatibleProviderConfig;
     model: string;
@@ -47,21 +49,48 @@ export type NexaAgentConfig = {
     cacheTtlMs?: number;
     permissions?: PermissionMatrix;
     harness?: ModelHarness;
+    flows?: GuidedFlow<any, any>[];
+    flowSelector?: (input: {
+        text: string;
+        flows: GuidedFlow<any, any>[];
+    }) => string | undefined | Promise<string | undefined>;
 };
 export type NexaAgentRunOptions<T = unknown> = {
     messages?: ChatMessage[];
     outputSchema?: z.ZodType<T>;
     tenant?: TenantContext;
+    /** Explicit Guided Flow selection for this turn (see `config.flows`). */
+    flow?: string;
+    /** Identifies the conversation a Guided Flow's state belongs to; defaults to `"default"` for direct `agent.run()` calls. `session()` sets this automatically. */
+    sessionId?: string;
+    /** Known facts to seed into a Guided Flow's state before its first turn — see `GuidedFlowTurnInput.initialState`. No effect outside a Guided Flow turn, and no effect once that flow run already exists (use `agent.flows.patchState()` for an in-progress flow). */
+    initialState?: JsonObject;
+    /** Propagated to the Guided Flow turn (extraction call + tool-scoped reply pass) so a caller can cancel an in-flight run. No effect outside a Guided Flow turn in this version. */
+    signal?: AbortSignal;
+    /** Turn-scoped Guided Flow event sink — see `GuidedFlowTurnInput.onEvent`. No effect when this turn isn't handled by a Guided Flow. */
+    onFlowEvent?: (event: import("./guided-flows/index.js").PublishFlowEventInput) => void;
 };
 export type NexaAgentRunResult<T = unknown> = AgentMessageResult & {
     output?: T;
     artifacts: Artifact[];
     handoffTo?: string;
+    /** Present only when a Guided Flow handled this turn. */
+    flow?: GuidedFlowRunMeta;
+    /** The Guided Flow's live state as plain JSON, alongside `flow`. */
+    state?: JsonObject;
+};
+export type NexaAgentFlows = {
+    cancel(sessionId: string, flowId?: string): Promise<void>;
+    resume(sessionId: string, flowId?: string): Promise<GuidedFlowRunState | undefined>;
+    reset(sessionId: string, flowId?: string): Promise<void>;
+    patchState(sessionId: string, flowId: string, patch: FlowStatePatch<Record<string, unknown>>): Promise<GuidedFlowRunState>;
+    getState(sessionId: string, flowId?: string): Promise<GuidedFlowRunState | undefined>;
 };
 export type NexaAgent = {
     name: string;
     underlying: OpenAICompatibleAgent;
     memory?: AdvancedMemoryStore;
+    flows?: NexaAgentFlows;
     run<T = unknown>(text: string, options?: NexaAgentRunOptions<T>): Promise<NexaAgentRunResult<T>>;
     session(id?: string): AgentSession;
     asTool(input?: {

package/dist/kernel.d.ts.map

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

package/dist/kernel.js

@@ -13,6 +13,7 @@ import { skillsToInstructions, skillsToToolRegistrations } from "./skills.js";
 import { artifactsFromRunResult } from "./artifacts.js";
 import { agentWorkerFromAgent, MultiAgentCoordinator } from "./multi-agent.js";
 import { filterToolsByPermissions, namespaceKey } from "./tenancy.js";
+import { GuidedFlowRuntime, resolveGuidedFlowStateStore } from "./guided-flows/index.js";
 const PROVIDER_FACTORIES = {
     openai: openaiProvider,
     openrouter: openRouterProvider,
@@ -89,6 +90,22 @@ export async function agent(config) {
         ...(config.modelRouter ? { modelRouter: config.modelRouter } : {}),
         ...(config.harness ? { harness: config.harness } : {})
     });
+    const flows = config.flows ?? [];
+    const flowRuntime = flows.length
+        ? new GuidedFlowRuntime({
+            flows,
+            client: underlying.client,
+            providerId: provider.id,
+            model: underlying.model,
+            toolRegistrations,
+            skills,
+            hooks,
+            events: underlying.sdk.events,
+            store: resolveGuidedFlowStateStore(config.storage),
+            ...(config.harness ? { harness: config.harness } : {}),
+            ...(config.flowSelector ? { flowSelector: config.flowSelector } : {})
+        })
+        : undefined;
     async function run(text, options = {}) {
         const runId = randomUUID();
         const taskId = runId;
@@ -98,6 +115,41 @@ export async function agent(config) {
             const guardedInput = guardrails.length
                 ? await runInputGuardrails(guardrails, { text, messages: options.messages ?? [], context: { taskId, runId } })
                 : { text, violations: [] };
+            const tenant = options.tenant ?? {};
+            if (flowRuntime) {
+                const priorNonSystem = (options.messages ?? []).filter((message) => message.role !== "system");
+                const outcome = await flowRuntime.runTurn({
+                    text: guardedInput.text,
+                    messages: priorNonSystem,
+                    sessionId: options.sessionId ?? "default",
+                    ...(tenant.tenantId || tenant.userId ? { tenant } : {}),
+                    ...(options.flow ? { explicitFlow: options.flow } : {}),
+                    ...(options.initialState ? { initialState: options.initialState } : {}),
+                    ...(options.signal ? { signal: options.signal } : {}),
+                    ...(options.onFlowEvent ? { onEvent: options.onFlowEvent } : {})
+                });
+                if (outcome.handled) {
+                    const guardedOutput = guardrails.length
+                        ? await runOutputGuardrails(guardrails, { text: outcome.text, messages: priorNonSystem, context: { taskId, runId } })
+                        : { text: outcome.text, violations: [] };
+                    const newMessages = [
+                        ...priorNonSystem,
+                        { role: "user", content: text },
+                        { role: "assistant", content: guardedOutput.text }
+                    ];
+                    const flowResult = {
+                        text: guardedOutput.text,
+                        messages: newMessages,
+                        toolTurn: { selectedTools: [], results: [], contextMessages: [] },
+                        artifacts: [],
+                        ...(outcome.output !== undefined ? { output: outcome.output } : {}),
+                        flow: outcome.flow,
+                        state: outcome.state
+                    };
+                    await hooks.fire("afterRun", { text, result: flowResult, context: hookContext });
+                    return flowResult;
+                }
+            }
             let messages = options.messages;
             if (contextEngine) {
                 const built = await contextEngine.build({ runId, taskId, text: guardedInput.text, ...(options.messages ? { conversation: options.messages } : {}) });
@@ -108,7 +160,6 @@ export async function agent(config) {
             }
             const outputSchema = options.outputSchema ?? config.outputSchema;
             const effectiveText = outputSchema ? `${guardedInput.text}\n\n${structuredOutputInstruction(outputSchema)}` : guardedInput.text;
-            const tenant = options.tenant ?? {};
             const cacheKey = config.cache ? JSON.stringify({ name: config.name, tenant, effectiveText, messages }) : undefined;
             if (cacheKey) {
                 const cached = config.cache?.get(cacheKey);
@@ -166,12 +217,18 @@ export async function agent(config) {
         }
     }
     function session(id) {
-        return createSession({
+        const created = createSession({
             ...(id ? { id } : {}),
             ...(instructions ? { systemPrompt: instructions } : {}),
             ...(sessionStore ? { store: sessionStore } : {}),
-            runner: async ({ text, messages }) => run(text, { messages })
+            runner: async ({ text, messages, options: runOptions }) => run(text, {
+                messages,
+                sessionId: created.id,
+                ...(runOptions?.flow ? { flow: runOptions.flow } : {}),
+                ...(runOptions?.initialState ? { initialState: runOptions.initialState } : {})
+            })
         });
+        return created;
     }
     function asTool(input = {}) {
         const id = input.id ?? `agent.${config.name}`;
@@ -193,7 +250,16 @@ export async function agent(config) {
             }
         };
     }
-    return { name: config.name, underlying, ...(memoryStore ? { memory: memoryStore } : {}), run, session, asTool };
+    const flowsApi = flowRuntime
+        ? {
+            cancel: (sessionId, flowId) => flowRuntime.cancel(sessionId, flowId),
+            resume: (sessionId, flowId) => flowRuntime.resume(sessionId, flowId),
+            reset: (sessionId, flowId) => flowRuntime.reset(sessionId, flowId),
+            patchState: (sessionId, flowId, patch) => flowRuntime.patchState(sessionId, flowId, patch),
+            getState: (sessionId, flowId) => flowRuntime.getState(sessionId, flowId)
+        }
+        : undefined;
+    return { name: config.name, underlying, ...(memoryStore ? { memory: memoryStore } : {}), ...(flowsApi ? { flows: flowsApi } : {}), run, session, asTool };
 }
 function resolveMemory(memory) {
     if (!memory)