@backendkit-labs/agent-core 0.14.0

package/dist/workflow/WorkflowBuilder.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowBuilder = void 0;
+exports.workflow = workflow;
+exports.agent = agent;
+class WorkflowBuilder {
+    _name;
+    _steps = [];
+    constructor(_name) {
+        this._name = _name;
+    }
+    step(id, agentRef, opts) {
+        if (this._steps.some(s => s.id === id)) {
+            throw new Error(`Workflow "${this._name}": duplicate step id "${id}"`);
+        }
+        this._steps.push({
+            id,
+            agentId: agentRef.id,
+            input: opts.input,
+            dependsOn: opts.dependsOn ?? [],
+            requireApproval: opts.requireApproval ?? false,
+        });
+        return this;
+    }
+    build() {
+        this.validate();
+        return { name: this._name, steps: [...this._steps] };
+    }
+    validate() {
+        const ids = new Set(this._steps.map(s => s.id));
+        for (const step of this._steps) {
+            for (const dep of step.dependsOn) {
+                if (!ids.has(dep)) {
+                    throw new Error(`Workflow "${this._name}": step "${step.id}" depends on unknown step "${dep}"`);
+                }
+            }
+        }
+        // DFS cycle detection
+        const depMap = new Map(this._steps.map(s => [s.id, s.dependsOn]));
+        const visited = new Set();
+        const inStack = new Set();
+        const dfs = (id) => {
+            if (inStack.has(id)) {
+                throw new Error(`Workflow "${this._name}": dependency cycle detected at step "${id}"`);
+            }
+            if (visited.has(id))
+                return;
+            inStack.add(id);
+            for (const dep of depMap.get(id) ?? [])
+                dfs(dep);
+            inStack.delete(id);
+            visited.add(id);
+        };
+        for (const step of this._steps)
+            dfs(step.id);
+    }
+}
+exports.WorkflowBuilder = WorkflowBuilder;
+/** Creates a new workflow builder. */
+function workflow(name) {
+    return new WorkflowBuilder(name);
+}
+/** Creates an agent reference for use in workflow step definitions. */
+function agent(id) {
+    return { id };
+}
+//# sourceMappingURL=WorkflowBuilder.js.map

package/dist/workflow/WorkflowBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowBuilder.js","sourceRoot":"","sources":["../../src/workflow/WorkflowBuilder.ts"],"names":[],"mappings":";;;AAqEA,4BAEC;AAGD,sBAEC;AAjED,MAAa,eAAe;IAGK;IAFZ,MAAM,GAAsB,EAAE,CAAC;IAEhD,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C,IAAI,CAAC,EAAU,EAAE,QAAkB,EAAE,IAAiB;QAClD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACb,EAAE;YACF,OAAO,EAAE,QAAQ,CAAC,EAAE;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;SACjD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,CAAC;IAEO,QAAQ;QACZ,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEhD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CACX,aAAa,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,EAAE,8BAA8B,GAAG,GAAG,CACjF,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE;YACvB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,yCAAyC,EAAE,GAAG,CAAC,CAAC;YAC3F,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO;YAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;CACJ;AAvDD,0CAuDC;AAED,sCAAsC;AACtC,SAAgB,QAAQ,CAAC,IAAY;IACjC,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,uEAAuE;AACvE,SAAgB,KAAK,CAAC,EAAU;IAC5B,OAAO,EAAE,EAAE,EAAE,CAAC;AAClB,CAAC"}

package/dist/workflow/WorkflowRunner.d.ts

@@ -0,0 +1,22 @@
+import type { Transport } from '../transport/Transport';
+import type { WorkflowDef, WorkflowResult, WorkflowRunOptions } from './types';
+type AgentRunner = (agentId: string, input: string, context?: string) => Promise<{
+    content: string;
+}>;
+interface WorkflowRunnerOptions extends WorkflowRunOptions {
+    runAgent: AgentRunner;
+    transport: Transport;
+}
+export declare class WorkflowRunner {
+    private readonly def;
+    private readonly opts;
+    constructor(def: WorkflowDef, opts: WorkflowRunnerOptions);
+    run(): Promise<WorkflowResult>;
+    /** Execute one wave: approval steps sequentially after parallel steps. */
+    private executeWave;
+    private executeOne;
+    /** Collect outputs from completed direct dependencies. */
+    private collectOutputs;
+}
+export {};
+//# sourceMappingURL=WorkflowRunner.d.ts.map

package/dist/workflow/WorkflowRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowRunner.d.ts","sourceRoot":"","sources":["../../src/workflow/WorkflowRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACR,WAAW,EACX,cAAc,EACd,kBAAkB,EAGrB,MAAM,SAAS,CAAC;AAEjB,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtG,UAAU,qBAAsB,SAAQ,kBAAkB;IACtD,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED,qBAAa,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,qBAAqB;IAG1C,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC;IAmDpC,0EAA0E;YAC5D,WAAW;YAgBX,UAAU;IAqCxB,0DAA0D;IAC1D,OAAO,CAAC,cAAc;CAUzB"}

package/dist/workflow/WorkflowRunner.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowRunner = void 0;
+class WorkflowRunner {
+    def;
+    opts;
+    constructor(def, opts) {
+        this.def = def;
+        this.opts = opts;
+    }
+    async run() {
+        this.opts.transport.emit({ type: 'workflow_start', name: this.def.name });
+        const results = {};
+        const completed = new Set();
+        const failed = new Set();
+        const remaining = new Set(this.def.steps.map(s => s.id));
+        while (remaining.size > 0) {
+            // Steps whose dependencies are all satisfied and none failed
+            const runnable = this.def.steps.filter(s => remaining.has(s.id) &&
+                s.dependsOn.every(dep => completed.has(dep)) &&
+                !s.dependsOn.some(dep => failed.has(dep)));
+            // Steps that can never run because a dependency failed → skip them
+            const blocked = this.def.steps.filter(s => remaining.has(s.id) &&
+                s.dependsOn.some(dep => failed.has(dep)));
+            for (const step of blocked) {
+                results[step.id] = {
+                    stepId: step.id,
+                    agentId: step.agentId,
+                    content: '',
+                    status: 'skipped',
+                };
+                remaining.delete(step.id);
+            }
+            // Guard: cycle detection in builder should prevent this, but be safe
+            if (runnable.length === 0 && remaining.size > 0)
+                break;
+            // Remove from remaining before executing so the while condition is correct
+            for (const step of runnable)
+                remaining.delete(step.id);
+            await this.executeWave(runnable, results, completed, failed);
+        }
+        const anyRejected = Object.values(results).some(r => r.status === 'rejected');
+        const anyFailed = Object.values(results).some(r => r.status === 'failed');
+        const status = anyRejected ? 'rejected' : anyFailed ? 'failed' : 'completed';
+        this.opts.transport.emit({ type: 'workflow_complete', name: this.def.name, status });
+        return { name: this.def.name, status, steps: results };
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    /** Execute one wave: approval steps sequentially after parallel steps. */
+    async executeWave(steps, results, completed, failed) {
+        const parallel = steps.filter(s => !s.requireApproval);
+        const needApproval = steps.filter(s => s.requireApproval);
+        await Promise.all(parallel.map(s => this.executeOne(s, results, completed, failed)));
+        for (const step of needApproval) {
+            await this.executeOne(step, results, completed, failed);
+        }
+    }
+    async executeOne(step, results, completed, failed) {
+        const prevOutputs = this.collectOutputs(step, results);
+        if (step.requireApproval) {
+            this.opts.transport.emit({ type: 'workflow_approval_required', step: step.id });
+            const approved = await (this.opts.onApprovalRequired?.(step, prevOutputs) ?? Promise.resolve(true));
+            if (!approved) {
+                results[step.id] = { stepId: step.id, agentId: step.agentId, content: '', status: 'rejected' };
+                failed.add(step.id);
+                return;
+            }
+        }
+        this.opts.transport.emit({ type: 'workflow_step_start', step: step.id, agent: step.agentId });
+        const context = Object.keys(prevOutputs).length > 0
+            ? Object.entries(prevOutputs).map(([id, out]) => `[${id}]:\n${out}`).join('\n\n')
+            : undefined;
+        try {
+            const { content } = await this.opts.runAgent(step.agentId, step.input, context);
+            results[step.id] = { stepId: step.id, agentId: step.agentId, content, status: 'completed' };
+            completed.add(step.id);
+            this.opts.transport.emit({ type: 'workflow_step_complete', step: step.id, success: true });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            results[step.id] = { stepId: step.id, agentId: step.agentId, content: '', status: 'failed', error };
+            failed.add(step.id);
+            this.opts.transport.emit({ type: 'workflow_step_complete', step: step.id, success: false });
+        }
+    }
+    /** Collect outputs from completed direct dependencies. */
+    collectOutputs(step, results) {
+        const out = {};
+        for (const dep of step.dependsOn) {
+            if (results[dep]?.status === 'completed')
+                out[dep] = results[dep].content;
+        }
+        return out;
+    }
+}
+exports.WorkflowRunner = WorkflowRunner;
+//# sourceMappingURL=WorkflowRunner.js.map

package/dist/workflow/WorkflowRunner.js.map

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

package/dist/workflow/index.d.ts

@@ -0,0 +1,5 @@
+export { workflow, agent, WorkflowBuilder } from './WorkflowBuilder';
+export type { StepOptions } from './WorkflowBuilder';
+export { WorkflowRunner } from './WorkflowRunner';
+export type { AgentRef, WorkflowDef, WorkflowStepDef, WorkflowResult, WorkflowStepResult, WorkflowRunOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACR,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,SAAS,CAAC"}

package/dist/workflow/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowRunner = exports.WorkflowBuilder = exports.agent = exports.workflow = void 0;
+var WorkflowBuilder_1 = require("./WorkflowBuilder");
+Object.defineProperty(exports, "workflow", { enumerable: true, get: function () { return WorkflowBuilder_1.workflow; } });
+Object.defineProperty(exports, "agent", { enumerable: true, get: function () { return WorkflowBuilder_1.agent; } });
+Object.defineProperty(exports, "WorkflowBuilder", { enumerable: true, get: function () { return WorkflowBuilder_1.WorkflowBuilder; } });
+var WorkflowRunner_1 = require("./WorkflowRunner");
+Object.defineProperty(exports, "WorkflowRunner", { enumerable: true, get: function () { return WorkflowRunner_1.WorkflowRunner; } });
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":";;;AAAA,qDAAqE;AAA5D,2GAAA,QAAQ,OAAA;AAAE,wGAAA,KAAK,OAAA;AAAE,kHAAA,eAAe,OAAA;AAEzC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA"}

package/dist/workflow/types.d.ts

@@ -0,0 +1,35 @@
+export interface AgentRef {
+    readonly id: string;
+}
+export interface WorkflowStepDef {
+    id: string;
+    agentId: string;
+    input: string;
+    dependsOn: string[];
+    requireApproval: boolean;
+}
+export interface WorkflowDef {
+    name: string;
+    steps: WorkflowStepDef[];
+}
+export interface WorkflowStepResult {
+    stepId: string;
+    agentId: string;
+    content: string;
+    status: 'completed' | 'failed' | 'skipped' | 'rejected';
+    error?: string;
+}
+export interface WorkflowResult {
+    name: string;
+    status: 'completed' | 'failed' | 'rejected';
+    steps: Record<string, WorkflowStepResult>;
+}
+export interface WorkflowRunOptions {
+    /**
+     * Called before a step with requireApproval: true.
+     * Return true to proceed, false to reject (aborts the workflow).
+     * Defaults to auto-approve when not provided.
+     */
+    onApprovalRequired?: (step: WorkflowStepDef, previousOutputs: Record<string, string>) => Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CACjB,IAAI,EAAE,eAAe,EACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACtC,OAAO,CAAC,OAAO,CAAC,CAAC;CACzB"}

package/dist/workflow/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/workflow/types.js.map

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

package/dist/workspace/index.d.ts

@@ -0,0 +1,55 @@
+export interface WorkspaceProject {
+    name: string;
+    cwd: string;
+}
+export interface WorkspaceEntry {
+    projects: WorkspaceProject[];
+    /** Name of the currently active project within this workspace. */
+    active?: string;
+}
+export type WorkspacesConfig = Record<string, WorkspaceEntry>;
+export declare function loadWorkspaces(appName: string): Promise<WorkspacesConfig>;
+export declare function saveWorkspaces(appName: string, config: WorkspacesConfig): Promise<void>;
+/**
+ * Infers a project name from its filesystem path.
+ * Uses the last non-empty path segment.
+ *
+ * @example deriveProjectName('/home/user/projects/my-app') → 'my-app'
+ */
+export declare function deriveProjectName(cwd: string): string;
+export declare function createWorkspace(config: WorkspacesConfig, name: string): WorkspacesConfig;
+/**
+ * Adds a project to a workspace.
+ * Silently skips if a project with the same cwd already exists.
+ * Throws if workspace and project share the same name (would cause ambiguity in commands).
+ */
+export declare function addProject(config: WorkspacesConfig, workspaceName: string, project: WorkspaceProject): WorkspacesConfig;
+/**
+ * Like addProject but auto-creates the workspace if it doesn't exist.
+ * Useful for onboarding scenarios where the workspace may not exist yet.
+ */
+export declare function importProject(config: WorkspacesConfig, workspaceName: string, project: WorkspaceProject): WorkspacesConfig;
+/**
+ * Removes a project from a workspace.
+ * Throws if it is the only project — deleting the workspace is required instead.
+ */
+export declare function removeProject(config: WorkspacesConfig, workspaceName: string, projectName: string): WorkspacesConfig;
+export declare function deleteWorkspace(config: WorkspacesConfig, name: string): WorkspacesConfig;
+export declare function setActiveProject(config: WorkspacesConfig, workspaceName: string, projectName: string): WorkspacesConfig;
+/**
+ * One-time migration for apps that stored a single `cwd` without workspaces.
+ * If workspaces.json already exists (non-empty), this is a no-op.
+ * Otherwise creates a default workspace with one project derived from `cwd`.
+ *
+ * @param appName   Framework app name (e.g. 'backendkit-agent')
+ * @param cwd       The legacy working directory
+ * @param wsName    Optional workspace name — defaults to the project folder name
+ */
+export declare function migrateFromLegacy(appName: string, cwd: string, wsName?: string): Promise<WorkspacesConfig>;
+/**
+ * Builds a context string for injection into the agent's system prompt.
+ * Reads memory/contexto-proyecto.md and memory/session.md from each project's
+ * data directory and includes them as structured context.
+ */
+export declare function buildWorkspaceContext(name: string, entry: WorkspaceEntry, appName: string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAM9D,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ/E;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAGxF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACtB,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,gBAAgB,GAC1B,gBAAgB,CAWlB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,gBAAgB,GAC1B,gBAAgB,CAGlB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GACpB,gBAAgB,CAYlB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAGxF;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GACpB,gBAAgB,CAIlB;AAID;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAID;;;;GAIG;AACH,wBAAsB,qBAAqB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/dist/workspace/index.js

@@ -0,0 +1,189 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWorkspaces = loadWorkspaces;
+exports.saveWorkspaces = saveWorkspaces;
+exports.deriveProjectName = deriveProjectName;
+exports.createWorkspace = createWorkspace;
+exports.addProject = addProject;
+exports.importProject = importProject;
+exports.removeProject = removeProject;
+exports.deleteWorkspace = deleteWorkspace;
+exports.setActiveProject = setActiveProject;
+exports.migrateFromLegacy = migrateFromLegacy;
+exports.buildWorkspaceContext = buildWorkspaceContext;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const project_key_1 = require("../shared/utils/project-key");
+// ── Persistence ───────────────────────────────────────────────────────────────
+const WORKSPACES_FILE = 'workspaces.json';
+async function loadWorkspaces(appName) {
+    const filePath = path.join((0, project_key_1.getFrameworkDir)(appName), WORKSPACES_FILE);
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function saveWorkspaces(appName, config) {
+    const dir = (0, project_key_1.getFrameworkDir)(appName);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(path.join(dir, WORKSPACES_FILE), JSON.stringify(config, null, 2), 'utf-8');
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/**
+ * Infers a project name from its filesystem path.
+ * Uses the last non-empty path segment.
+ *
+ * @example deriveProjectName('/home/user/projects/my-app') → 'my-app'
+ */
+function deriveProjectName(cwd) {
+    return cwd.replace(/[/\\]+$/, '').split(/[/\\]/).filter(Boolean).pop() ?? 'project';
+}
+// ── Immutable CRUD ────────────────────────────────────────────────────────────
+function createWorkspace(config, name) {
+    if (config[name])
+        return config;
+    return { ...config, [name]: { projects: [] } };
+}
+/**
+ * Adds a project to a workspace.
+ * Silently skips if a project with the same cwd already exists.
+ * Throws if workspace and project share the same name (would cause ambiguity in commands).
+ */
+function addProject(config, workspaceName, project) {
+    if (workspaceName === project.name) {
+        throw new Error(`Workspace and project cannot have the same name ("${workspaceName}")`);
+    }
+    const ws = config[workspaceName] ?? { projects: [] };
+    if (ws.projects.some(p => p.cwd === project.cwd))
+        return config;
+    const updated = {
+        projects: [...ws.projects, project],
+        active: ws.active ?? project.name,
+    };
+    return { ...config, [workspaceName]: updated };
+}
+/**
+ * Like addProject but auto-creates the workspace if it doesn't exist.
+ * Useful for onboarding scenarios where the workspace may not exist yet.
+ */
+function importProject(config, workspaceName, project) {
+    const withWs = config[workspaceName] ? config : createWorkspace(config, workspaceName);
+    return addProject(withWs, workspaceName, project);
+}
+/**
+ * Removes a project from a workspace.
+ * Throws if it is the only project — deleting the workspace is required instead.
+ */
+function removeProject(config, workspaceName, projectName) {
+    const ws = config[workspaceName];
+    if (!ws)
+        return config;
+    if (ws.projects.length <= 1) {
+        throw new Error(`Cannot remove the only project in workspace "${workspaceName}". ` +
+            `Delete the workspace instead: /workspace delete ${workspaceName}`);
+    }
+    const projects = ws.projects.filter(p => p.name !== projectName);
+    const active = ws.active === projectName ? (projects[0]?.name ?? undefined) : ws.active;
+    return { ...config, [workspaceName]: { projects, active } };
+}
+function deleteWorkspace(config, name) {
+    const { [name]: _removed, ...rest } = config;
+    return rest;
+}
+function setActiveProject(config, workspaceName, projectName) {
+    const ws = config[workspaceName];
+    if (!ws)
+        return config;
+    return { ...config, [workspaceName]: { ...ws, active: projectName } };
+}
+// ── Migration ─────────────────────────────────────────────────────────────────
+/**
+ * One-time migration for apps that stored a single `cwd` without workspaces.
+ * If workspaces.json already exists (non-empty), this is a no-op.
+ * Otherwise creates a default workspace with one project derived from `cwd`.
+ *
+ * @param appName   Framework app name (e.g. 'backendkit-agent')
+ * @param cwd       The legacy working directory
+ * @param wsName    Optional workspace name — defaults to the project folder name
+ */
+async function migrateFromLegacy(appName, cwd, wsName) {
+    const existing = await loadWorkspaces(appName);
+    if (Object.keys(existing).length > 0)
+        return existing;
+    const projectName = deriveProjectName(cwd);
+    const workspaceName = wsName ?? projectName;
+    const migrated = importProject({}, workspaceName, { name: projectName, cwd });
+    await saveWorkspaces(appName, migrated);
+    return migrated;
+}
+// ── Context builder ───────────────────────────────────────────────────────────
+/**
+ * Builds a context string for injection into the agent's system prompt.
+ * Reads memory/contexto-proyecto.md and memory/session.md from each project's
+ * data directory and includes them as structured context.
+ */
+async function buildWorkspaceContext(name, entry, appName) {
+    const projectList = entry.projects
+        .map(p => `- **${p.name}**${p.name === entry.active ? ' *(active)*' : ''} — \`${p.cwd}\``)
+        .join('\n');
+    const parts = [`## Workspace: ${name}\n${projectList}`];
+    for (const project of entry.projects) {
+        const projectDir = (0, project_key_1.getProjectDir)(appName, project.cwd);
+        const projectParts = [];
+        const contextPath = path.join(projectDir, 'memory', 'contexto-proyecto.md');
+        try {
+            const content = (await fs.readFile(contextPath, 'utf-8')).trim();
+            if (content)
+                projectParts.push(`**Context:**\n${content}`);
+        }
+        catch { /* no context yet */ }
+        const sessionPath = path.join(projectDir, 'memory', 'session.md');
+        try {
+            const session = (await fs.readFile(sessionPath, 'utf-8')).trim();
+            if (session)
+                projectParts.push(`**Session:**\n${session}`);
+        }
+        catch { /* no session yet */ }
+        if (projectParts.length > 0) {
+            parts.push(`### ${project.name}\n${projectParts.join('\n\n')}`);
+        }
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

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

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@backendkit-labs/agent-core",
+  "version": "0.14.0",
+  "description": "Generic multi-agent engine — model-agnostic, transport-agnostic",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./orchestration": {
+      "types": "./dist/orchestration/index.d.ts",
+      "default": "./dist/orchestration/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "default": "./dist/mcp/index.js"
+    },
+    "./workflow": {
+      "types": "./dist/workflow/index.d.ts",
+      "default": "./dist/workflow/index.js"
+    },
+    "./triggers": {
+      "types": "./dist/triggers/index.d.ts",
+      "default": "./dist/triggers/index.js"
+    },
+    "./observability": {
+      "types": "./dist/observability/index.d.ts",
+      "default": "./dist/observability/index.js"
+    },
+    "./memory": {
+      "types": "./dist/agent-memory/index.d.ts",
+      "default": "./dist/agent-memory/index.js"
+    },
+    "./discovery": {
+      "types": "./dist/agent-discovery/index.d.ts",
+      "default": "./dist/agent-discovery/index.js"
+    },
+    "./reflection": {
+      "types": "./dist/reflection/index.d.ts",
+      "default": "./dist/reflection/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "default": "./dist/context/index.js"
+    },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "default": "./dist/skills/index.js"
+    }
+  },
+  "files": ["dist/", "README.md"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BackendKit-labs/backendkit-agent-framework.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": { "access": "public" },
+  "engines": { "node": ">=20.0.0" },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@backendkit-labs/bulkhead": "^0.2.1",
+    "@backendkit-labs/circuit-breaker": "^0.3.1",
+    "@backendkit-labs/pipeline": "^0.3.2",
+    "@backendkit-labs/result": "^0.2.1",
+    "@backendkit-labs/retry": "^0.1.2",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "node-cron": "^4.2.1",
+    "yaml": "^2.4.0",
+    "zod": "^3.25.0",
+    "zod-to-json-schema": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.4.0"
+  }
+}