@backendkit-labs/agent-enterprise 0.3.1 → 0.3.6

package/dist/flow/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Declarative flow definitions — business flows as data, not code.
+ *
+ * A FlowDefinition is loaded from YAML, validated, and executed on top of
+ * the core WorkflowRunner. Adding a new business flow for a company means
+ * writing a YAML file — zero platform code.
+ *
+ * Gate semantics (criteria/evaluator/evidence) are parsed and carried here
+ * so the YAML format is stable; their enforcement lands with ComplianceGate
+ * (design doc: diseno-multiagente-enterprise.md, fase 2).
+ */
+import { z } from '@backendkit-labs/agent-core';
+export declare const FlowTriggerSchema: z.ZodObject<{
+    /** How the flow is started. `manual` = invoked programmatically. */
+    type: z.ZodEnum<["queue", "webhook", "cron", "manual"]>;
+    /** Queue name — required when type is `queue`. */
+    queue: z.ZodOptional<z.ZodString>;
+    /** Route path — required when type is `webhook`. */
+    path: z.ZodOptional<z.ZodString>;
+    /** Cron expression — required when type is `cron`. */
+    schedule: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "queue" | "webhook" | "cron" | "manual";
+    path?: string | undefined;
+    queue?: string | undefined;
+    schedule?: string | undefined;
+}, {
+    type: "queue" | "webhook" | "cron" | "manual";
+    path?: string | undefined;
+    queue?: string | undefined;
+    schedule?: string | undefined;
+}>;
+export declare const FlowGateSchema: z.ZodObject<{
+    /** Verifiable completion criteria, evaluated one by one (ComplianceGate). */
+    criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Agent that evaluates the criteria. MUST differ from the executing agent. */
+    evaluator: z.ZodOptional<z.ZodString>;
+    /** Whether each criterion requires attached evidence to pass. */
+    evidence: z.ZodDefault<z.ZodEnum<["required", "optional"]>>;
+    /** `human` pauses the step until a human approves (core ApprovalGate). */
+    approval: z.ZodDefault<z.ZodEnum<["human", "none"]>>;
+}, "strip", z.ZodTypeAny, {
+    criteria: string[];
+    evidence: "required" | "optional";
+    approval: "human" | "none";
+    evaluator?: string | undefined;
+}, {
+    criteria?: string[] | undefined;
+    evaluator?: string | undefined;
+    evidence?: "required" | "optional" | undefined;
+    approval?: "human" | "none" | undefined;
+}>;
+export declare const FlowStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** Agent id that executes this step. */
+    agent: z.ZodString;
+    /** Prompt for the agent. Supports `{{payload}}` and `{{payload.path.to.field}}`. */
+    prompt: z.ZodString;
+    /** Tools the agent may use in this step (informational until engine-level scoping). */
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Step ids this step waits for. Steps with no `after` run in parallel. */
+    after: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    gate: z.ZodOptional<z.ZodObject<{
+        /** Verifiable completion criteria, evaluated one by one (ComplianceGate). */
+        criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Agent that evaluates the criteria. MUST differ from the executing agent. */
+        evaluator: z.ZodOptional<z.ZodString>;
+        /** Whether each criterion requires attached evidence to pass. */
+        evidence: z.ZodDefault<z.ZodEnum<["required", "optional"]>>;
+        /** `human` pauses the step until a human approves (core ApprovalGate). */
+        approval: z.ZodDefault<z.ZodEnum<["human", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        criteria: string[];
+        evidence: "required" | "optional";
+        approval: "human" | "none";
+        evaluator?: string | undefined;
+    }, {
+        criteria?: string[] | undefined;
+        evaluator?: string | undefined;
+        evidence?: "required" | "optional" | undefined;
+        approval?: "human" | "none" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    agent: string;
+    prompt: string;
+    after: string[];
+    tools?: string[] | undefined;
+    gate?: {
+        criteria: string[];
+        evidence: "required" | "optional";
+        approval: "human" | "none";
+        evaluator?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    agent: string;
+    prompt: string;
+    tools?: string[] | undefined;
+    after?: string[] | undefined;
+    gate?: {
+        criteria?: string[] | undefined;
+        evaluator?: string | undefined;
+        evidence?: "required" | "optional" | undefined;
+        approval?: "human" | "none" | undefined;
+    } | undefined;
+}>;
+export declare const FlowCompensationSchema: z.ZodObject<{
+    /** Failure selector: `<stepId>.failed`. */
+    on: z.ZodString;
+    agent: z.ZodString;
+    /** Prompt for the compensating agent. Supports payload interpolation. */
+    prompt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agent: string;
+    prompt: string;
+    on: string;
+}, {
+    agent: string;
+    prompt: string;
+    on: string;
+}>;
+export declare const FlowDefinitionSchema: z.ZodObject<{
+    flow: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    trigger: z.ZodObject<{
+        /** How the flow is started. `manual` = invoked programmatically. */
+        type: z.ZodEnum<["queue", "webhook", "cron", "manual"]>;
+        /** Queue name — required when type is `queue`. */
+        queue: z.ZodOptional<z.ZodString>;
+        /** Route path — required when type is `webhook`. */
+        path: z.ZodOptional<z.ZodString>;
+        /** Cron expression — required when type is `cron`. */
+        schedule: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "queue" | "webhook" | "cron" | "manual";
+        path?: string | undefined;
+        queue?: string | undefined;
+        schedule?: string | undefined;
+    }, {
+        type: "queue" | "webhook" | "cron" | "manual";
+        path?: string | undefined;
+        queue?: string | undefined;
+        schedule?: string | undefined;
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** Agent id that executes this step. */
+        agent: z.ZodString;
+        /** Prompt for the agent. Supports `{{payload}}` and `{{payload.path.to.field}}`. */
+        prompt: z.ZodString;
+        /** Tools the agent may use in this step (informational until engine-level scoping). */
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Step ids this step waits for. Steps with no `after` run in parallel. */
+        after: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        gate: z.ZodOptional<z.ZodObject<{
+            /** Verifiable completion criteria, evaluated one by one (ComplianceGate). */
+            criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            /** Agent that evaluates the criteria. MUST differ from the executing agent. */
+            evaluator: z.ZodOptional<z.ZodString>;
+            /** Whether each criterion requires attached evidence to pass. */
+            evidence: z.ZodDefault<z.ZodEnum<["required", "optional"]>>;
+            /** `human` pauses the step until a human approves (core ApprovalGate). */
+            approval: z.ZodDefault<z.ZodEnum<["human", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            criteria: string[];
+            evidence: "required" | "optional";
+            approval: "human" | "none";
+            evaluator?: string | undefined;
+        }, {
+            criteria?: string[] | undefined;
+            evaluator?: string | undefined;
+            evidence?: "required" | "optional" | undefined;
+            approval?: "human" | "none" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        agent: string;
+        prompt: string;
+        after: string[];
+        tools?: string[] | undefined;
+        gate?: {
+            criteria: string[];
+            evidence: "required" | "optional";
+            approval: "human" | "none";
+            evaluator?: string | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        agent: string;
+        prompt: string;
+        tools?: string[] | undefined;
+        after?: string[] | undefined;
+        gate?: {
+            criteria?: string[] | undefined;
+            evaluator?: string | undefined;
+            evidence?: "required" | "optional" | undefined;
+            approval?: "human" | "none" | undefined;
+        } | undefined;
+    }>, "many">;
+    compensation: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Failure selector: `<stepId>.failed`. */
+        on: z.ZodString;
+        agent: z.ZodString;
+        /** Prompt for the compensating agent. Supports payload interpolation. */
+        prompt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agent: string;
+        prompt: string;
+        on: string;
+    }, {
+        agent: string;
+        prompt: string;
+        on: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    flow: string;
+    version: number;
+    trigger: {
+        type: "queue" | "webhook" | "cron" | "manual";
+        path?: string | undefined;
+        queue?: string | undefined;
+        schedule?: string | undefined;
+    };
+    steps: {
+        id: string;
+        agent: string;
+        prompt: string;
+        after: string[];
+        tools?: string[] | undefined;
+        gate?: {
+            criteria: string[];
+            evidence: "required" | "optional";
+            approval: "human" | "none";
+            evaluator?: string | undefined;
+        } | undefined;
+    }[];
+    compensation: {
+        agent: string;
+        prompt: string;
+        on: string;
+    }[];
+}, {
+    flow: string;
+    trigger: {
+        type: "queue" | "webhook" | "cron" | "manual";
+        path?: string | undefined;
+        queue?: string | undefined;
+        schedule?: string | undefined;
+    };
+    steps: {
+        id: string;
+        agent: string;
+        prompt: string;
+        tools?: string[] | undefined;
+        after?: string[] | undefined;
+        gate?: {
+            criteria?: string[] | undefined;
+            evaluator?: string | undefined;
+            evidence?: "required" | "optional" | undefined;
+            approval?: "human" | "none" | undefined;
+        } | undefined;
+    }[];
+    version?: number | undefined;
+    compensation?: {
+        agent: string;
+        prompt: string;
+        on: string;
+    }[] | undefined;
+}>;
+export type FlowTrigger = z.infer<typeof FlowTriggerSchema>;
+export type FlowGate = z.infer<typeof FlowGateSchema>;
+export type FlowStep = z.infer<typeof FlowStepSchema>;
+export type FlowCompensation = z.infer<typeof FlowCompensationSchema>;
+export type FlowDefinition = z.infer<typeof FlowDefinitionSchema>;
+export type FlowTransitionEvent = 'started' | 'completed' | 'failed' | 'skipped' | 'rejected' | 'approval_requested' | 'gate_evaluation_started' | 'gate_passed' | 'gate_failed' | 'compensation_started' | 'compensation_completed' | 'compensation_failed';
+/** Append-only execution record — every state mutation produces one. */
+export interface FlowTransition {
+    at: string;
+    stepId: string;
+    event: FlowTransitionEvent;
+    detail?: string;
+}
+export interface FlowCompensationResult {
+    on: string;
+    agent: string;
+    status: 'completed' | 'failed';
+    content?: string;
+    error?: string;
+}
+export interface FlowStepResult {
+    stepId: string;
+    agentId: string;
+    content: string;
+    status: 'completed' | 'failed' | 'skipped' | 'rejected';
+    error?: string;
+}
+export interface FlowResult {
+    flow: string;
+    version: number;
+    status: 'completed' | 'failed' | 'rejected';
+    steps: Record<string, FlowStepResult>;
+    transitions: FlowTransition[];
+    compensations: FlowCompensationResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flow/types.d.ts.map

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

package/dist/flow/types.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Declarative flow definitions — business flows as data, not code.
+ *
+ * A FlowDefinition is loaded from YAML, validated, and executed on top of
+ * the core WorkflowRunner. Adding a new business flow for a company means
+ * writing a YAML file — zero platform code.
+ *
+ * Gate semantics (criteria/evaluator/evidence) are parsed and carried here
+ * so the YAML format is stable; their enforcement lands with ComplianceGate
+ * (design doc: diseno-multiagente-enterprise.md, fase 2).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowDefinitionSchema = exports.FlowCompensationSchema = exports.FlowStepSchema = exports.FlowGateSchema = exports.FlowTriggerSchema = void 0;
+const agent_core_1 = require("@backendkit-labs/agent-core");
+// ── Schemas ───────────────────────────────────────────────────────────────────
+exports.FlowTriggerSchema = agent_core_1.z.object({
+    /** How the flow is started. `manual` = invoked programmatically. */
+    type: agent_core_1.z.enum(['queue', 'webhook', 'cron', 'manual']),
+    /** Queue name — required when type is `queue`. */
+    queue: agent_core_1.z.string().optional(),
+    /** Route path — required when type is `webhook`. */
+    path: agent_core_1.z.string().optional(),
+    /** Cron expression — required when type is `cron`. */
+    schedule: agent_core_1.z.string().optional(),
+});
+exports.FlowGateSchema = agent_core_1.z.object({
+    /** Verifiable completion criteria, evaluated one by one (ComplianceGate). */
+    criteria: agent_core_1.z.array(agent_core_1.z.string()).default([]),
+    /** Agent that evaluates the criteria. MUST differ from the executing agent. */
+    evaluator: agent_core_1.z.string().optional(),
+    /** Whether each criterion requires attached evidence to pass. */
+    evidence: agent_core_1.z.enum(['required', 'optional']).default('optional'),
+    /** `human` pauses the step until a human approves (core ApprovalGate). */
+    approval: agent_core_1.z.enum(['human', 'none']).default('none'),
+});
+exports.FlowStepSchema = agent_core_1.z.object({
+    id: agent_core_1.z.string().min(1),
+    /** Agent id that executes this step. */
+    agent: agent_core_1.z.string().min(1),
+    /** Prompt for the agent. Supports `{{payload}}` and `{{payload.path.to.field}}`. */
+    prompt: agent_core_1.z.string().min(1),
+    /** Tools the agent may use in this step (informational until engine-level scoping). */
+    tools: agent_core_1.z.array(agent_core_1.z.string()).optional(),
+    /** Step ids this step waits for. Steps with no `after` run in parallel. */
+    after: agent_core_1.z.array(agent_core_1.z.string()).default([]),
+    gate: exports.FlowGateSchema.optional(),
+});
+exports.FlowCompensationSchema = agent_core_1.z.object({
+    /** Failure selector: `<stepId>.failed`. */
+    on: agent_core_1.z.string().regex(/^[\w-]+\.failed$/, 'must be "<stepId>.failed"'),
+    agent: agent_core_1.z.string().min(1),
+    /** Prompt for the compensating agent. Supports payload interpolation. */
+    prompt: agent_core_1.z.string().min(1),
+});
+exports.FlowDefinitionSchema = agent_core_1.z.object({
+    flow: agent_core_1.z.string().min(1),
+    version: agent_core_1.z.number().int().positive().default(1),
+    trigger: exports.FlowTriggerSchema,
+    steps: agent_core_1.z.array(exports.FlowStepSchema).min(1),
+    compensation: agent_core_1.z.array(exports.FlowCompensationSchema).default([]),
+});
+//# sourceMappingURL=types.js.map

package/dist/flow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/flow/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,4DAAgD;AAEhD,iFAAiF;AAEpE,QAAA,iBAAiB,GAAG,cAAC,CAAC,MAAM,CAAC;IACtC,oEAAoE;IACpE,IAAI,EAAE,cAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,kDAAkD;IAClD,KAAK,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,oDAAoD;IACpD,IAAI,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,cAAC,CAAC,MAAM,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,EAAE,cAAC,CAAC,KAAK,CAAC,cAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,+EAA+E;IAC/E,SAAS,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,iEAAiE;IACjE,QAAQ,EAAE,cAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC9D,0EAA0E;IAC1E,QAAQ,EAAE,cAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACtD,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,cAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,wCAAwC;IACxC,KAAK,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,oFAAoF;IACpF,MAAM,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,uFAAuF;IACvF,KAAK,EAAE,cAAC,CAAC,KAAK,CAAC,cAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,2EAA2E;IAC3E,KAAK,EAAE,cAAC,CAAC,KAAK,CAAC,cAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,IAAI,EAAE,sBAAc,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEU,QAAA,sBAAsB,GAAG,cAAC,CAAC,MAAM,CAAC;IAC3C,2CAA2C;IAC3C,EAAE,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,2BAA2B,CAAC;IACrE,KAAK,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,yEAAyE;IACzE,MAAM,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,cAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,OAAO,EAAE,yBAAiB;IAC1B,KAAK,EAAE,cAAC,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,YAAY,EAAE,cAAC,CAAC,KAAK,CAAC,8BAAsB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5D,CAAC,CAAC"}

package/dist/index.d.ts

@@ -10,6 +10,14 @@ export { VaultWriter } from './rag/VaultWriter';
 export type { VaultWriterOptions, WriteNoteParams } from './rag/VaultWriter';
 export { SimpleEmbedder } from './rag/SimpleEmbedder';
 export { GENERAL_PROFILE, SUPPORT_PROFILE, HR_PROFILE, SALES_PROFILE, FINANCE_PROFILE, OPS_PROFILE, ALL_ENTERPRISE_PROFILES, ENTERPRISE_TOOLS, VAULT_FOLDERS, } from './profiles';
+export { FlowTriggerSchema, FlowGateSchema, FlowStepSchema, FlowCompensationSchema, FlowDefinitionSchema, parseFlow, loadFlow, loadFlowsFromDir, FlowLoadError, FlowRunner, interpolate, ComplianceGate, ComplianceGateError, } from './flow';
+export type { FlowTrigger, FlowGate, FlowStep, FlowCompensation, FlowDefinition, FlowTransition, FlowTransitionEvent, FlowStepResult, FlowCompensationResult, FlowResult, FlowRunOptions, FlowAgentRunner, GateCriterion, GateLogEvent, GateLogEntry, GateRecord, ComplianceGateOptions, } from './flow';
+export { PolicySeeder } from './policies';
+export type { PolicySeederOptions } from './policies';
+export { EventPublisher, ReconciliationSweeper } from './events';
+export type { QueueLike, EventPublisherOptions, ReconciliationSweeperOptions, EventEnvelope, EventSchema, PublishOptions, OrphanedEvent, ReconciliationReport, } from './events';
+export { createN8nTriggerTool } from './integrations';
+export type { N8nTriggerOptions } from './integrations';
 export { createEnterpriseSetup } from './factory';
 export type { EnterpriseSetupOptions, EnterpriseSetup } from './factory';
 //# 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,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC7G,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,EACH,eAAe,EACf,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,GAChB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC7G,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,EACH,eAAe,EACf,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,GAChB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,mBAAmB,GACtB,MAAM,QAAQ,CAAC;AAChB,YAAY,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,qBAAqB,GACxB,MAAM,QAAQ,CAAC;AAIhB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjE,YAAY,EACR,SAAS,EACT,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,EACb,oBAAoB,GACvB,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createEnterpriseSetup = exports.VAULT_FOLDERS = exports.ENTERPRISE_TOOLS = exports.ALL_ENTERPRISE_PROFILES = exports.OPS_PROFILE = exports.FINANCE_PROFILE = exports.SALES_PROFILE = exports.HR_PROFILE = exports.SUPPORT_PROFILE = exports.GENERAL_PROFILE = exports.SimpleEmbedder = exports.VaultWriter = exports.VaultIndexer = exports.VectorStore = exports.OLLAMA_EMBED_DEFAULT_MODEL = exports.OLLAMA_EMBED_DEFAULT_HOST = exports.OllamaEmbedder = exports.ObsidianRAGProvider = void 0;
+exports.createEnterpriseSetup = exports.createN8nTriggerTool = exports.ReconciliationSweeper = exports.EventPublisher = exports.PolicySeeder = exports.ComplianceGateError = exports.ComplianceGate = exports.interpolate = exports.FlowRunner = exports.FlowLoadError = exports.loadFlowsFromDir = exports.loadFlow = exports.parseFlow = exports.FlowDefinitionSchema = exports.FlowCompensationSchema = exports.FlowStepSchema = exports.FlowGateSchema = exports.FlowTriggerSchema = exports.VAULT_FOLDERS = exports.ENTERPRISE_TOOLS = exports.ALL_ENTERPRISE_PROFILES = exports.OPS_PROFILE = exports.FINANCE_PROFILE = exports.SALES_PROFILE = exports.HR_PROFILE = exports.SUPPORT_PROFILE = exports.GENERAL_PROFILE = exports.SimpleEmbedder = exports.VaultWriter = exports.VaultIndexer = exports.VectorStore = exports.OLLAMA_EMBED_DEFAULT_MODEL = exports.OLLAMA_EMBED_DEFAULT_HOST = exports.OllamaEmbedder = exports.ObsidianRAGProvider = void 0;
 var ObsidianRAGProvider_1 = require("./rag/ObsidianRAGProvider");
 Object.defineProperty(exports, "ObsidianRAGProvider", { enumerable: true, get: function () { return ObsidianRAGProvider_1.ObsidianRAGProvider; } });
 var OllamaEmbedder_1 = require("./rag/OllamaEmbedder");
@@ -26,6 +26,31 @@ Object.defineProperty(exports, "OPS_PROFILE", { enumerable: true, get: function
 Object.defineProperty(exports, "ALL_ENTERPRISE_PROFILES", { enumerable: true, get: function () { return profiles_1.ALL_ENTERPRISE_PROFILES; } });
 Object.defineProperty(exports, "ENTERPRISE_TOOLS", { enumerable: true, get: function () { return profiles_1.ENTERPRISE_TOOLS; } });
 Object.defineProperty(exports, "VAULT_FOLDERS", { enumerable: true, get: function () { return profiles_1.VAULT_FOLDERS; } });
+// ── Declarative flows ─────────────────────────────────────────────────────────
+var flow_1 = require("./flow");
+Object.defineProperty(exports, "FlowTriggerSchema", { enumerable: true, get: function () { return flow_1.FlowTriggerSchema; } });
+Object.defineProperty(exports, "FlowGateSchema", { enumerable: true, get: function () { return flow_1.FlowGateSchema; } });
+Object.defineProperty(exports, "FlowStepSchema", { enumerable: true, get: function () { return flow_1.FlowStepSchema; } });
+Object.defineProperty(exports, "FlowCompensationSchema", { enumerable: true, get: function () { return flow_1.FlowCompensationSchema; } });
+Object.defineProperty(exports, "FlowDefinitionSchema", { enumerable: true, get: function () { return flow_1.FlowDefinitionSchema; } });
+Object.defineProperty(exports, "parseFlow", { enumerable: true, get: function () { return flow_1.parseFlow; } });
+Object.defineProperty(exports, "loadFlow", { enumerable: true, get: function () { return flow_1.loadFlow; } });
+Object.defineProperty(exports, "loadFlowsFromDir", { enumerable: true, get: function () { return flow_1.loadFlowsFromDir; } });
+Object.defineProperty(exports, "FlowLoadError", { enumerable: true, get: function () { return flow_1.FlowLoadError; } });
+Object.defineProperty(exports, "FlowRunner", { enumerable: true, get: function () { return flow_1.FlowRunner; } });
+Object.defineProperty(exports, "interpolate", { enumerable: true, get: function () { return flow_1.interpolate; } });
+Object.defineProperty(exports, "ComplianceGate", { enumerable: true, get: function () { return flow_1.ComplianceGate; } });
+Object.defineProperty(exports, "ComplianceGateError", { enumerable: true, get: function () { return flow_1.ComplianceGateError; } });
+// ── Policies-in-vault ─────────────────────────────────────────────────────────
+var policies_1 = require("./policies");
+Object.defineProperty(exports, "PolicySeeder", { enumerable: true, get: function () { return policies_1.PolicySeeder; } });
+// ── Events (broker + reconciliation) ─────────────────────────────────────────
+var events_1 = require("./events");
+Object.defineProperty(exports, "EventPublisher", { enumerable: true, get: function () { return events_1.EventPublisher; } });
+Object.defineProperty(exports, "ReconciliationSweeper", { enumerable: true, get: function () { return events_1.ReconciliationSweeper; } });
+// ── Integrations ──────────────────────────────────────────────────────────────
+var integrations_1 = require("./integrations");
+Object.defineProperty(exports, "createN8nTriggerTool", { enumerable: true, get: function () { return integrations_1.createN8nTriggerTool; } });
 // ── Factory ───────────────────────────────────────────────────────────────────
 var factory_1 = require("./factory");
 Object.defineProperty(exports, "createEnterpriseSetup", { enumerable: true, get: function () { return factory_1.createEnterpriseSetup; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,0HAAA,mBAAmB,OAAA;AAG5B,uDAA6G;AAApG,gHAAA,cAAc,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAG9E,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,mDAAkD;AAAzC,4GAAA,YAAY,OAAA;AAGrB,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,uDAAsD;AAA7C,gHAAA,cAAc,OAAA;AAEvB,iFAAiF;AAEjF,uCAUoB;AAThB,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,sGAAA,UAAU,OAAA;AACV,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,mHAAA,uBAAuB,OAAA;AACvB,4GAAA,gBAAgB,OAAA;AAChB,yGAAA,aAAa,OAAA;AAGjB,iFAAiF;AAEjF,qCAAkD;AAAzC,gHAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,0HAAA,mBAAmB,OAAA;AAG5B,uDAA6G;AAApG,gHAAA,cAAc,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAG9E,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,mDAAkD;AAAzC,4GAAA,YAAY,OAAA;AAGrB,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,uDAAsD;AAA7C,gHAAA,cAAc,OAAA;AAEvB,iFAAiF;AAEjF,uCAUoB;AAThB,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,sGAAA,UAAU,OAAA;AACV,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,mHAAA,uBAAuB,OAAA;AACvB,4GAAA,gBAAgB,OAAA;AAChB,yGAAA,aAAa,OAAA;AAGjB,iFAAiF;AAEjF,+BAcgB;AAbZ,yGAAA,iBAAiB,OAAA;AACjB,sGAAA,cAAc,OAAA;AACd,sGAAA,cAAc,OAAA;AACd,8GAAA,sBAAsB,OAAA;AACtB,4GAAA,oBAAoB,OAAA;AACpB,iGAAA,SAAS,OAAA;AACT,gGAAA,QAAQ,OAAA;AACR,wGAAA,gBAAgB,OAAA;AAChB,qGAAA,aAAa,OAAA;AACb,kGAAA,UAAU,OAAA;AACV,mGAAA,WAAW,OAAA;AACX,sGAAA,cAAc,OAAA;AACd,2GAAA,mBAAmB,OAAA;AAsBvB,iFAAiF;AAEjF,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAGrB,gFAAgF;AAEhF,mCAAiE;AAAxD,wGAAA,cAAc,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAY9C,iFAAiF;AAEjF,+CAAsD;AAA7C,oHAAA,oBAAoB,OAAA;AAG7B,iFAAiF;AAEjF,qCAAkD;AAAzC,gHAAA,qBAAqB,OAAA"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,3 @@
+export { createN8nTriggerTool } from './n8nTriggerTool';
+export type { N8nTriggerOptions } from './n8nTriggerTool';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createN8nTriggerTool = void 0;
+var n8nTriggerTool_1 = require("./n8nTriggerTool");
+Object.defineProperty(exports, "createN8nTriggerTool", { enumerable: true, get: function () { return n8nTriggerTool_1.createN8nTriggerTool; } });
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":";;;AAAA,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA"}

package/dist/integrations/n8nTriggerTool.d.ts

@@ -0,0 +1,12 @@
+import type { ToolDefinition } from '@backendkit-labs/agent-core';
+export interface N8nTriggerOptions {
+    /** n8n webhook URL. Falls back to the N8N_WEBHOOK_URL environment variable. */
+    webhookUrl?: string;
+}
+/**
+ * Creates the `n8n_trigger` tool.
+ * POST to the configured n8n webhook with `{ event, correlationId, ...payload }`.
+ * Throws if no URL is configured at construction time.
+ */
+export declare function createN8nTriggerTool(opts?: N8nTriggerOptions): ToolDefinition;
+//# sourceMappingURL=n8nTriggerTool.d.ts.map

package/dist/integrations/n8nTriggerTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8nTriggerTool.d.ts","sourceRoot":"","sources":["../../src/integrations/n8nTriggerTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,iBAAsB,GAAG,cAAc,CAyCjF"}

package/dist/integrations/n8nTriggerTool.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createN8nTriggerTool = createN8nTriggerTool;
+const node_crypto_1 = require("node:crypto");
+const agent_core_1 = require("@backendkit-labs/agent-core");
+/**
+ * Creates the `n8n_trigger` tool.
+ * POST to the configured n8n webhook with `{ event, correlationId, ...payload }`.
+ * Throws if no URL is configured at construction time.
+ */
+function createN8nTriggerTool(opts = {}) {
+    const url = opts.webhookUrl ?? process.env.N8N_WEBHOOK_URL;
+    if (!url) {
+        throw new Error('n8n_trigger requires opts.webhookUrl or the N8N_WEBHOOK_URL env var');
+    }
+    return (0, agent_core_1.defineTool)({
+        name: 'n8n_trigger',
+        description: 'Trigger an n8n workflow by POSTing an event payload to a webhook. ' +
+            'Returns the correlation ID so the workflow execution can be traced.',
+        input: agent_core_1.z.object({
+            event: agent_core_1.z.string().describe('Event type / workflow trigger name (e.g. "employee.onboarded", "invoice.approved")'),
+            payload: agent_core_1.z.record(agent_core_1.z.unknown()).describe('Arbitrary data forwarded to n8n as the request body alongside the event and correlationId'),
+            correlation_id: agent_core_1.z.string().optional().describe('Correlation ID for distributed tracing — auto-generated (UUID v4) when omitted'),
+        }),
+        execute: async ({ event, payload, correlation_id }) => {
+            const corrId = correlation_id ?? (0, node_crypto_1.randomUUID)();
+            const body = JSON.stringify({ event, correlationId: corrId, ...payload });
+            const res = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+            });
+            if (!res.ok) {
+                throw new Error(`n8n webhook failed (${res.status}): ${await res.text()}`);
+            }
+            const responseText = (await res.text()).slice(0, 500);
+            return [
+                `n8n workflow triggered — event: "${event}"`,
+                `correlationId: ${corrId}`,
+                ...(responseText ? [`n8n response: ${responseText}`] : []),
+            ].join('\n');
+        },
+    });
+}
+//# sourceMappingURL=n8nTriggerTool.js.map

package/dist/integrations/n8nTriggerTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8nTriggerTool.js","sourceRoot":"","sources":["../../src/integrations/n8nTriggerTool.ts"],"names":[],"mappings":";;AAcA,oDAyCC;AAvDD,6CAAyC;AACzC,4DAA4D;AAQ5D;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,OAA0B,EAAE;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,IAAA,uBAAU,EAAC;QACd,IAAI,EAAE,aAAa;QACnB,WAAW,EACP,oEAAoE;YACpE,qEAAqE;QACzE,KAAK,EAAE,cAAC,CAAC,MAAM,CAAC;YACZ,KAAK,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACtB,oFAAoF,CACvF;YACD,OAAO,EAAE,cAAC,CAAC,MAAM,CAAC,cAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CACnC,2FAA2F,CAC9F;YACD,cAAc,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,gFAAgF,CACnF;SACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,cAAc,IAAI,IAAA,wBAAU,GAAE,CAAC;YAC9C,MAAM,IAAI,GAAK,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;YAC5E,MAAM,GAAG,GAAM,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAG,MAAM;gBACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI;aACP,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACtD,OAAO;gBACH,oCAAoC,KAAK,GAAG;gBAC5C,kBAAkB,MAAM,EAAE;gBAC1B,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,iBAAiB,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;KACJ,CAAC,CAAC;AACP,CAAC"}

package/dist/policies/PolicySeeder.d.ts

@@ -0,0 +1,31 @@
+export interface PolicySeederOptions {
+    /**
+     * When true, overwrites existing policy files.
+     * Default: false — existing files are left untouched (preserves company edits).
+     */
+    overwrite?: boolean;
+}
+/**
+ * Seeds default business policy notes into the vault under /politicas/.
+ *
+ * Each policy lives at: {vaultPath}/politicas/{domain}/{slug}.md
+ *
+ * Policies contain the business rules that were previously hardcoded in agent
+ * system prompts (ADR-4). Agents retrieve them at runtime via their search tool,
+ * so editing a vault note changes agent behavior without any code deployment.
+ *
+ * By default, existing policy files are NOT overwritten — the company's edits
+ * always take precedence. Pass `overwrite: true` to reset to framework defaults.
+ */
+export declare class PolicySeeder {
+    private readonly vaultPath;
+    constructor(vaultPath: string);
+    /**
+     * Seeds all default policies. Returns the paths of files actually written.
+     * Skips files that already exist unless `overwrite: true`.
+     */
+    seed(opts?: PolicySeederOptions): Promise<string[]>;
+    /** Returns the absolute path where a policy note will be written. */
+    policyPath(domain: string, slug: string): string;
+}
+//# sourceMappingURL=PolicySeeder.d.ts.map

package/dist/policies/PolicySeeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicySeeder.d.ts","sourceRoot":"","sources":["../../src/policies/PolicySeeder.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAID;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE9C;;;OAGG;IACG,IAAI,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe7D,qEAAqE;IACrE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAGnD"}