@makaio/framework 1.0.0-dev-1779048017991 → 1.0.0-dev-1781022866275

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026-present Makaio GmbH
+Copyright (c) Makaio GmbH
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@makaio/framework",
-  "version": "1.0.0-dev-1779048017991",
+  "version": "1.0.0-dev-1781022866275",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/makaio-ai/makaio-framework.git",
+    "directory": "packages/framework"
+  },
   "description": "Typed, bus-centric framework for building and orchestrating AI agents with tools, sessions, and events",
   "license": "MIT",
   "type": "module",
@@ -46,6 +51,10 @@
       "types": "./dist/contracts/adapter/index.d.mts",
       "default": "./dist/contracts/adapter/index.mjs"
     },
+    "./contracts/artifact": {
+      "types": "./dist/contracts/artifact/index.d.mts",
+      "default": "./dist/contracts/artifact/index.mjs"
+    },
     "./contracts/adapter/schemas/session-lineage": {
       "types": "./dist/contracts/adapter/schemas/session-lineage.d.mts",
       "default": "./dist/contracts/adapter/schemas/session-lineage.mjs"
@@ -66,6 +75,14 @@
       "types": "./dist/contracts/extension/index.d.mts",
       "default": "./dist/contracts/extension/index.mjs"
     },
+    "./contracts/facet": {
+      "types": "./dist/contracts/facet/index.d.mts",
+      "default": "./dist/contracts/facet/index.mjs"
+    },
+    "./contracts/materialization": {
+      "types": "./dist/contracts/materialization/index.d.mts",
+      "default": "./dist/contracts/materialization/index.mjs"
+    },
     "./contracts/model-registry": {
       "types": "./dist/contracts/model-registry/index.d.mts",
       "default": "./dist/contracts/model-registry/index.mjs"
@@ -90,6 +107,10 @@
       "types": "./dist/contracts/toast/index.d.mts",
       "default": "./dist/contracts/toast/index.mjs"
     },
+    "./contracts/timeout": {
+      "types": "./dist/contracts/timeout/index.d.mts",
+      "default": "./dist/contracts/timeout/index.mjs"
+    },
     "./contracts/variant": {
       "types": "./dist/contracts/variant/index.d.mts",
       "default": "./dist/contracts/variant/index.mjs"
@@ -130,6 +151,10 @@
       "types": "./dist/clients/index.d.mts",
       "default": "./dist/clients/index.mjs"
     },
+    "./git": {
+      "types": "./dist/git/index.d.mts",
+      "default": "./dist/git/index.mjs"
+    },
     "./services": {
       "types": "./dist/services/index.d.mts",
       "default": "./dist/services/index.mjs"
@@ -178,6 +203,10 @@
       "types": "./dist/services/session/storage/namespace.d.mts",
       "default": "./dist/services/session/storage/namespace.mjs"
     },
+    "./services/subagent": {
+      "types": "./dist/services/subagent/index.d.mts",
+      "default": "./dist/services/subagent/index.mjs"
+    },
     "./services/tool-approval": {
       "types": "./dist/services/tool-approval/index.d.mts",
       "default": "./dist/services/tool-approval/index.mjs"
@@ -186,6 +215,26 @@
       "types": "./dist/services/cli-detection/namespace.d.mts",
       "default": "./dist/services/cli-detection/namespace.mjs"
     },
+    "./services/filesystem": {
+      "types": "./dist/services/filesystem/index.d.mts",
+      "default": "./dist/services/filesystem/index.mjs"
+    },
+    "./services/filesystem/namespace": {
+      "types": "./dist/services/filesystem/namespace.d.mts",
+      "default": "./dist/services/filesystem/namespace.mjs"
+    },
+    "./services/filesystem/schemas": {
+      "types": "./dist/services/filesystem/schemas.d.mts",
+      "default": "./dist/services/filesystem/schemas.mjs"
+    },
+    "./services/git/namespace": {
+      "types": "./dist/services/git/namespace.d.mts",
+      "default": "./dist/services/git/namespace.mjs"
+    },
+    "./services/git/schemas": {
+      "types": "./dist/services/git/schemas.d.mts",
+      "default": "./dist/services/git/schemas.mjs"
+    },
     "./services/log-import": {
       "types": "./dist/services/log-import/index.d.mts",
       "default": "./dist/services/log-import/index.mjs"
@@ -338,9 +387,17 @@
       "types": "./dist/utils/health-probe.d.mts",
       "default": "./dist/utils/health-probe.mjs"
     },
+    "./utils/project-manifest": {
+      "types": "./dist/utils/project-manifest.d.mts",
+      "default": "./dist/utils/project-manifest.mjs"
+    },
+    "./utils/workspace-packages": {
+      "types": "./dist/utils/workspace-packages.d.mts",
+      "default": "./dist/utils/workspace-packages.mjs"
+    },
     "./utils/workspace-root": {
       "types": "./dist/utils/workspace-root.d.mts",
       "default": "./dist/utils/workspace-root.mjs"
     }
   }
-}
+}

package/dist/account-identity-Ce1Bwrqi.mjs

@@ -1 +0,0 @@
-import{m as e}from"./shared-DxHLl9UP.mjs";import{m as t,p as n}from"./profile-4StaDQW0.mjs";import{n as r}from"./version-CjS20oXi.mjs";import{z as i}from"zod";const a=i.enum([`strong`,`alias`]),o=i.object({scheme:t,value:t,strength:a}),s=i.object({key:t,label:i.string(),usedPercentage:i.number().finite().min(0).max(100),resetsAt:n.optional()}),c=i.object({windows:i.array(s)}),l=i.record(i.string(),i.unknown()).optional(),u=i.object({clientId:t,found:i.boolean(),version:i.string().optional(),warningMessage:i.string().optional()}),d=i.object({clientId:t,binaryName:t,supportedVersions:r.optional()}),f=i.object({clientAccountId:t,clientId:t,observedAt:n,source:t,displayLabel:i.string().optional(),usage:c,metadata:l}),p=i.discriminatedUnion(`kind`,[i.object({kind:i.literal(`session`),sessionId:t}),i.object({kind:i.literal(`adapter-session`),adapterSessionId:t}),i.object({kind:i.literal(`both`),sessionId:t,adapterSessionId:t})]),m=i.object({clientId:i.string(),source:i.string(),kind:i.string(),observedAt:n,payload:e}),h={request:i.object({clientId:t,observedAt:n.optional(),displayLabel:i.string().optional(),identifiers:i.array(o).min(1),metadata:l}),response:i.object({clientAccountId:t,displayLabel:i.string().optional()})},g={request:m.extend({locator:p}),response:i.object({handled:i.boolean(),sessionId:t.nullable(),clientAccountId:t.nullable(),changed:i.boolean()})},_={request:i.object({clientId:t,observedAt:n,source:t,account:i.object({displayLabel:i.string().optional(),identifiers:i.array(o).min(1)}),usage:c,metadata:l}),response:i.object({clientAccountId:t,snapshot:f})};export{l as a,g as c,f as d,s as f,m as i,p as l,h as n,u as o,c as p,a as r,d as s,o as t,_ as u};

package/dist/adapter-CbyjCE2d.mjs

@@ -1 +0,0 @@
-import{_ as e,b as t,c as n,d as r,f as i,g as a,h as o,i as s,l as c,m as l,ot as u,p as d,r as f,s as p,t as m,u as h,v as g,x as _,y as v}from"./schemas-BXstpWVp.mjs";import"./contracts/adapter/schemas/session-lineage.mjs";import{createBusNamespace as y}from"@makaio/framework/core";const b={getCapabilities:u,startAgent:_,infer:t,listAgents:v,getAgent:g,stopAgent:e,rehydrateAgent:a,getConfigSchema:o,"agent.created":l,"session.created":d,"session.discovered":s,"session.linked":f,"session.statusChanged":m,"session.usage":i,"session.closed":r,log:h,error:c,initialized:n,quota:p},x=y(`adapter`,b),S=x.subjects;export{S as n,b as r,x as t};

package/dist/adapters/acp-client/index.d.mts

@@ -1,209 +0,0 @@
-import * as acp from "@agentclientprotocol/sdk";
-import { Client, CreateTerminalRequest, CreateTerminalResponse, KillTerminalRequest, KillTerminalResponse, ReadTextFileRequest, ReadTextFileResponse, ReleaseTerminalRequest, ReleaseTerminalResponse, RequestPermissionRequest, RequestPermissionResponse, SessionNotification, TerminalOutputRequest, TerminalOutputResponse, WaitForTerminalExitRequest, WaitForTerminalExitResponse, WriteTextFileRequest, WriteTextFileResponse } from "@agentclientprotocol/sdk";
-
-//#region adapters/shared/acp-client/src/terminal-manager.d.ts
-/**
- * Manages stateful terminal lifecycles for ACP agents.
- *
- * ACP's terminal protocol is stateful (create → output → wait_for_exit → kill → release),
- * which does not map cleanly to a single request/response. This manager handles direct
- * child_process lifecycle with bounded output buffering.
- */
-declare class TerminalManager {
-  private readonly terminals;
-  private nextId;
-  /**
-   * Creates a new terminal subprocess.
-   * @param params - ACP create terminal request
-   * @returns Terminal ID for subsequent operations
-   */
-  createTerminal(params: acp.CreateTerminalRequest): Promise<acp.CreateTerminalResponse>;
-  /**
-   * Gets the current output of a terminal without waiting for it to exit.
-   * @param params - ACP terminal output request
-   * @returns Current buffered output and truncation status
-   */
-  getOutput(params: acp.TerminalOutputRequest): Promise<acp.TerminalOutputResponse>;
-  /**
-   * Waits for a terminal process to exit.
-   * @param params - ACP wait for exit request
-   * @returns Exit code and terminating signal
-   */
-  waitForExit(params: acp.WaitForTerminalExitRequest): Promise<acp.WaitForTerminalExitResponse>;
-  /**
-   * Kills a terminal process without releasing it.
-   *
-   * The terminal remains valid after this call, allowing callers to retrieve
-   * final output before releasing.
-   * @param params - ACP kill terminal request
-   * @returns Empty response object
-   */
-  killTerminal(params: acp.KillTerminalRequest): Promise<acp.KillTerminalResponse>;
-  /**
-   * Releases a terminal, killing the process and freeing all associated resources.
-   *
-   * After this call the terminal ID is no longer valid.
-   * @param params - ACP release terminal request
-   * @returns Empty response object
-   */
-  releaseTerminal(params: acp.ReleaseTerminalRequest): Promise<acp.ReleaseTerminalResponse>;
-  /**
-   * Kills and removes all managed terminals.
-   *
-   * Should be called during connector shutdown to prevent resource leaks.
-   */
-  releaseAll(): void;
-  /**
-   * Returns a managed terminal by ID, throwing if not found.
-   * @param terminalId - Terminal identifier assigned at creation time
-   * @returns The managed terminal state
-   */
-  private requireTerminal;
-}
-//#endregion
-//#region adapters/shared/acp-client/src/types.d.ts
-/**
- * Configuration for spawning an ACP agent subprocess.
- */
-interface AcpConnectionOptions {
-  /** Subprocess command (e.g., 'qwen') */
-  command: string;
-  /** CLI arguments (e.g., ['--acp', '--model', 'qwen3-coder']) */
-  args: string[];
-  /** Working directory for the subprocess */
-  cwd: string;
-  /** Environment variables passed to the subprocess */
-  env: Record<string, string>;
-  /** Callback for stderr output */
-  onStderr?: (data: string) => void;
-  /** Callback for subprocess spawn/runtime errors */
-  onError?: (error: Error) => void;
-  /** Callback for subprocess exit */
-  onExit?: (code: number | null) => void;
-}
-/**
- * Handle to a running ACP connection (subprocess + protocol layer).
- */
-interface AcpConnectionHandle {
-  /** The ACP client-side connection for sending requests to the agent */
-  connection: acp.ClientSideConnection;
-  /** Kill the subprocess with SIGTERM */
-  kill(): void;
-  /** Promise that resolves with the exit code when the subprocess exits */
-  exited: Promise<number | null>;
-}
-/**
- * Callbacks for routing ACP server requests to Makaio infrastructure.
- */
-interface MakaioAcpClientConfig {
-  /**
-   * Handle session update notifications (message chunks, tool calls, usage, etc.).
-   * @param notification - The session notification from the agent
-   */
-  onSessionUpdate: (notification: acp.SessionNotification) => Promise<void>;
-  /**
-   * Handle permission requests (tool approval).
-   * @param params - The permission request from the agent
-   */
-  onRequestPermission: (params: acp.RequestPermissionRequest) => Promise<acp.RequestPermissionResponse>;
-  /**
-   * Handle file read requests. Only required if fs.readTextFile capability is advertised.
-   * @param params - The read file request from the agent
-   */
-  onReadTextFile?: (params: acp.ReadTextFileRequest) => Promise<acp.ReadTextFileResponse>;
-  /**
-   * Handle file write requests. Only required if fs.writeTextFile capability is advertised.
-   * @param params - The write file request from the agent
-   */
-  onWriteTextFile?: (params: acp.WriteTextFileRequest) => Promise<acp.WriteTextFileResponse>;
-  /** Terminal lifecycle manager for stateful terminal operations */
-  terminalManager?: TerminalManager;
-}
-//#endregion
-//#region adapters/shared/acp-client/src/connection.d.ts
-/**
- * Spawns an ACP agent subprocess and establishes a protocol connection over stdio.
- *
- * The subprocess stdin/stdout are bridged to the ACP SDK via Web Streams using
- * `Readable.toWeb()` / `Writable.toWeb()` (Node.js 16+). The returned handle
- * exposes the {@link acp.ClientSideConnection} for issuing ACP requests along with
- * lifecycle controls.
- * @param clientFactory - Factory called with the negotiated {@link acp.Agent} proxy;
- *   must return the {@link acp.Client} implementation that handles incoming agent requests
- * @param options - Subprocess spawn configuration
- * @returns Handle containing the live connection, a kill function, and an exit promise
- */
-declare function createAcpConnection(clientFactory: (agent: acp.Agent) => acp.Client, options: AcpConnectionOptions): Promise<AcpConnectionHandle>;
-//#endregion
-//#region adapters/shared/acp-client/src/client.d.ts
-/**
- * ACP {@link Client} implementation that bridges agent requests to Makaio infrastructure.
- *
- * Routes session updates, permission requests, filesystem operations, and terminal
- * lifecycle events to the connector-provided callbacks and optional terminal manager.
- * All optional Client methods throw a descriptive error when the corresponding
- * capability has not been configured.
- */
-declare class MakaioAcpClient implements Client {
-  private readonly config;
-  /**
-   * @param config - Callbacks and optional managers for each ACP client capability
-   */
-  constructor(config: MakaioAcpClientConfig);
-  /**
-   * Forwards session update notifications to the connector.
-   * @param params - Session notification from the agent
-   * @returns Void promise resolving after the notification is processed
-   */
-  sessionUpdate(params: SessionNotification): Promise<void>;
-  /**
-   * Forwards permission requests to the connector approval handler.
-   * @param params - Permission request from the agent
-   * @returns The user's permission decision
-   */
-  requestPermission(params: RequestPermissionRequest): Promise<RequestPermissionResponse>;
-  /**
-   * Forwards file read requests to the optional handler.
-   * @param params - Read file request from the agent
-   * @returns File contents
-   */
-  readTextFile(params: ReadTextFileRequest): Promise<ReadTextFileResponse>;
-  /**
-   * Forwards file write requests to the optional handler.
-   * @param params - Write file request from the agent
-   * @returns Write confirmation
-   */
-  writeTextFile(params: WriteTextFileRequest): Promise<WriteTextFileResponse>;
-  /**
-   * Creates a new terminal process via the terminal manager.
-   * @param params - Terminal creation parameters from the agent
-   * @returns Terminal ID for subsequent operations
-   */
-  createTerminal(params: CreateTerminalRequest): Promise<CreateTerminalResponse>;
-  /**
-   * Retrieves the current output of a managed terminal.
-   * @param params - Terminal output request from the agent
-   * @returns Current buffered output and truncation status
-   */
-  terminalOutput(params: TerminalOutputRequest): Promise<TerminalOutputResponse>;
-  /**
-   * Waits for a managed terminal to exit.
-   * @param params - Wait for exit request from the agent
-   * @returns Exit code and terminating signal
-   */
-  waitForTerminalExit(params: WaitForTerminalExitRequest): Promise<WaitForTerminalExitResponse>;
-  /**
-   * Kills a managed terminal process without releasing it.
-   * @param params - Kill terminal request from the agent
-   * @returns Empty kill response
-   */
-  killTerminal(params: KillTerminalRequest): Promise<KillTerminalResponse>;
-  /**
-   * Releases a managed terminal and frees all associated resources.
-   * @param params - Release terminal request from the agent
-   * @returns Empty release response
-   */
-  releaseTerminal(params: ReleaseTerminalRequest): Promise<ReleaseTerminalResponse>;
-}
-//#endregion
-export { type AcpConnectionHandle, type AcpConnectionOptions, MakaioAcpClient, type MakaioAcpClientConfig, TerminalManager, createAcpConnection };

package/dist/adapters/acp-client/index.mjs

@@ -1 +0,0 @@
-import{spawn as e}from"node:child_process";import{Readable as t,Writable as n}from"node:stream";import*as r from"@agentclientprotocol/sdk";function i(e){return new Promise((t,n)=>{let r=()=>{e.off(`error`,i),t()},i=t=>{e.off(`spawn`,r),n(t)};e.once(`spawn`,r),e.once(`error`,i)})}async function a(e){e.stdin?.destroy(),e.stdout?.destroy(),e.stderr?.destroy(),e.kill(`SIGTERM`),await new Promise(t=>{e.once(`exit`,()=>t()),e.once(`close`,()=>t()),setTimeout(t,100)})}function o(e){return e}function s(e){return e}async function c(c,l){let u=e(l.command,l.args,{cwd:l.cwd,env:l.env,stdio:[`pipe`,`pipe`,`pipe`]});try{await i(u)}catch(e){throw l.onError?.(e),e}l.onStderr&&u.stderr&&u.stderr.on(`data`,e=>{l.onStderr(e.toString(`utf-8`))});let d=new Promise(e=>{u.once(`exit`,t=>{l.onExit?.(t),e(t)})});u.on(`error`,e=>{l.onError?.(e)});let f;try{let e=t.toWeb(u.stdout),i=n.toWeb(u.stdin),a=r.ndJsonStream(s(i),o(e));f=new r.ClientSideConnection(c,a)}catch(e){throw await a(u),e}return{connection:f,kill:()=>u.kill(`SIGTERM`),exited:d}}var l=class{config;constructor(e){this.config=e}async sessionUpdate(e){await this.config.onSessionUpdate(e)}async requestPermission(e){return this.config.onRequestPermission(e)}async readTextFile(e){if(!this.config.onReadTextFile)throw Error(`readTextFile not supported: no handler configured`);return this.config.onReadTextFile(e)}async writeTextFile(e){if(!this.config.onWriteTextFile)throw Error(`writeTextFile not supported: no handler configured`);return this.config.onWriteTextFile(e)}async createTerminal(e){if(!this.config.terminalManager)throw Error(`createTerminal not supported: no terminal manager configured`);return this.config.terminalManager.createTerminal(e)}async terminalOutput(e){if(!this.config.terminalManager)throw Error(`terminalOutput not supported: no terminal manager configured`);return this.config.terminalManager.getOutput(e)}async waitForTerminalExit(e){if(!this.config.terminalManager)throw Error(`waitForTerminalExit not supported: no terminal manager configured`);return this.config.terminalManager.waitForExit(e)}async killTerminal(e){if(!this.config.terminalManager)throw Error(`killTerminal not supported: no terminal manager configured`);return this.config.terminalManager.killTerminal(e)}async releaseTerminal(e){if(!this.config.terminalManager)throw Error(`releaseTerminal not supported: no terminal manager configured`);return this.config.terminalManager.releaseTerminal(e)}},u=class{terminals=new Map;nextId=0;async createTerminal(t){let n=`terminal-${(++this.nextId).toString()}`,r=t.outputByteLimit??1024*1024,o={...process.env};if(t.env)for(let e of t.env)o[e.name]=e.value;let s=e(t.command,t.args??[],{cwd:t.cwd??void 0,env:o,stdio:[`pipe`,`pipe`,`pipe`]});try{await i(s)}catch(e){throw await a(s),e}let c={process:s,output:``,outputByteLimit:r,truncated:!1,exitCode:void 0,signal:void 0,hasExited:!1,exitPromise:new Promise(e=>{s.on(`exit`,(e,t)=>{c.exitCode=e,c.signal=t??null}),s.on(`close`,()=>{c.hasExited=!0,e({exitCode:c.exitCode??null,signal:c.signal??null})})})},l=e=>{if(c.output+=e.toString(`utf-8`),Buffer.byteLength(c.output,`utf-8`)>c.outputByteLimit){let e=Buffer.from(c.output,`utf-8`),t=e.length-c.outputByteLimit;for(;t<e.length&&(e[t]&192)==128;)t+=1;c.output=e.subarray(t).toString(`utf-8`),c.truncated=!0}};return s.stdout?.on(`data`,l),s.stderr?.on(`data`,l),this.terminals.set(n,c),{terminalId:n}}async getOutput(e){let t=this.requireTerminal(e.terminalId);return{output:t.output,truncated:t.truncated,...t.hasExited&&{exitStatus:{exitCode:t.exitCode??null,signal:t.signal??null}}}}async waitForExit(e){let{exitCode:t,signal:n}=await this.requireTerminal(e.terminalId).exitPromise;return{exitCode:t??void 0,signal:n??void 0}}async killTerminal(e){return this.requireTerminal(e.terminalId).process.kill(`SIGTERM`),{}}async releaseTerminal(e){let t=this.terminals.get(e.terminalId);return t&&(t.process.kill(`SIGKILL`),this.terminals.delete(e.terminalId)),{}}releaseAll(){for(let[e,t]of this.terminals)t.process.kill(`SIGKILL`),this.terminals.delete(e)}requireTerminal(e){let t=this.terminals.get(e);if(!t)throw Error(`Terminal not found: ${e}`);return t}};export{l as MakaioAcpClient,u as TerminalManager,c as createAcpConnection};