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

package/dist/telemetry-CvdLBWuk.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{collectorOnlySubject as t,createBusNamespace as n}from"@makaio/framework/core";const r=e.union([e.string(),e.number(),e.boolean(),e.null(),e.array(e.string()),e.array(e.number()),e.array(e.boolean()),e.array(e.null())]),i=e.enum([`event`,`request`,`broadcast`]),a=e.enum([`local`,`outbound`,`inbound`]),o=e.object({factId:e.string().min(1),observedAt:e.number().int().nonnegative(),machineId:e.string().min(1).optional(),namespace:e.string().min(1),subject:e.string().min(1),messageType:i,direction:a,messageId:e.string().min(1),correlationId:e.string().min(1).optional(),attributes:e.record(e.string(),r)}).strict(),s={fact:t(o)},c=n(`subject-telemetry`,s),l=c.subjects;export{o as a,a as i,l as n,i as o,r,s,c as t};

package/dist/testing/drizzle-harness.d.mts

@@ -0,0 +1,130 @@
+import { SQL } from "drizzle-orm";
+import { MakaioDatabase } from "@makaio/framework/storage/drizzle";
+
+//#region packages/test-utils/src/drizzle-harness.d.ts
+interface TestDbContext {
+  /** Drizzle database instance */
+  db: MakaioDatabase;
+  /** Path to temp database file */
+  dbPath: string;
+  /** Close database connection and delete temp file */
+  close: () => void;
+  /** Combined cleanup: calls close (for convenience in afterEach/afterAll) */
+  cleanup: () => void;
+}
+/**
+ * Test database context with cleanup function included.
+ * Use this when your test setup creates the cleanup function.
+ */
+interface TestDbContextWithCleanup extends TestDbContext {
+  cleanup: () => void;
+}
+/**
+ * Suite-level test database context for plugin storage tests.
+ *
+ * Separates DB lifecycle (suite-level) from handler lifecycle (test-level).
+ * This prevents rapid client creation/destruction that causes Neon/Rust panics.
+ *
+ * **Usage pattern:**
+ * ```typescript
+ * let dbContext: PluginTestDbContext;
+ * let handlerCleanup: () => void;
+ *
+ * beforeAll(async () => {
+ *   dbContext = await createPluginTestDb({ ... });
+ * });
+ *
+ * beforeEach(async () => {
+ *   await dbContext.clearData();
+ *   handlerCleanup = dbContext.registerHandlers();
+ * });
+ *
+ * afterEach(() => {
+ *   handlerCleanup();
+ * });
+ *
+ * afterAll(async () => {
+ *   await dbContext.close();
+ * });
+ * ```
+ */
+interface PluginTestDbContext {
+  /** Drizzle database instance */
+  db: MakaioDatabase;
+  /** Path to temp database file */
+  dbPath: string;
+  /** Clear all table data (fast, for use in beforeEach) */
+  clearData: () => Promise<void>;
+  /** Register bus handlers, returns cleanup function */
+  registerHandlers: () => () => void;
+  /** Close database connection and delete temp file (for use in afterAll) */
+  close: () => Promise<void>;
+}
+/**
+ * Configuration for creating a plugin test database.
+ */
+interface PluginTestDbConfig {
+  /** Service name for temp file naming (e.g., 'artifacts', 'github-storage') */
+  name: string;
+  /** SQL statements to create tables and indices */
+  schemas: SQL[];
+  /** Table names to DELETE FROM during clearData (order matters for foreign keys) */
+  tables: string[];
+  /** Function to register bus handlers, returns cleanup function */
+  registerHandlers: (db: MakaioDatabase) => () => void;
+}
+/**
+ * Creates a temporary SQLite database for testing.
+ * @param name - Service name for temp file naming
+ * @returns Object with db, dbPath, close, and cleanup
+ */
+declare function createTempDb(name: string): Promise<TestDbContext>;
+/**
+ * Creates a suite-level test database for plugin storage tests.
+ *
+ * Generalizes the common pattern of creating a temp SQLite database,
+ * running schema SQL, and providing clearData/registerHandlers/close
+ * lifecycle methods.
+ * @param config - Plugin test database configuration
+ * @returns Plugin test database context with lifecycle methods
+ */
+declare function createPluginTestDb(config: PluginTestDbConfig): Promise<PluginTestDbContext>;
+/**
+ * Creates cleanup function for test database.
+ * @param handlerCleanup - Storage handler cleanup function
+ * @param close - Function to close the database connection
+ * @param dbPath - Path to temp database file
+ * @returns Cleanup function that closes connection and deletes temp file
+ */
+declare function createDbCleanup(handlerCleanup: () => void, close: () => void, dbPath: string): () => void;
+/**
+ * Result of {@link usePluginStorageTestLifecycle}.
+ *
+ * Provides lazy access to the database context that is initialized
+ * during `beforeAll`.
+ */
+interface PluginStorageTestContext {
+  /** Database context (available after `beforeAll`). */
+  get dbContext(): PluginTestDbContext;
+}
+/**
+ * Registers vitest lifecycle hooks for plugin storage handler tests.
+ *
+ * Must be called at describe scope (synchronously during test collection).
+ * Handles `createTestDb`, `clearData`, `registerHandlers`, cleanup and close.
+ *
+ * **Usage:**
+ * ```typescript
+ * const ctx = usePluginStorageTestLifecycle(() => createTestDb());
+ *
+ * it('should work', async () => {
+ *   // ctx.dbContext is available here
+ *   await MakaioBus.request(...);
+ * });
+ * ```
+ * @param createTestDbFn - Function that creates the test database context
+ * @returns Accessor for the initialized database context
+ */
+declare function usePluginStorageTestLifecycle(createTestDbFn: () => Promise<PluginTestDbContext>): PluginStorageTestContext;
+//#endregion
+export { PluginStorageTestContext, PluginTestDbConfig, PluginTestDbContext, TestDbContext, TestDbContextWithCleanup, createDbCleanup, createPluginTestDb, createTempDb, usePluginStorageTestLifecycle };

package/dist/testing/drizzle-harness.mjs

@@ -0,0 +1 @@
+import*as e from"node:path";import*as t from"node:fs";import{sql as n}from"drizzle-orm";import*as r from"node:os";import{afterAll as i,afterEach as a,beforeAll as o,beforeEach as s}from"vitest";import{createDatabaseClient as c}from"@makaio/framework/storage/drizzle/client";async function l(i){let a=e.join(r.tmpdir(),`makaio-${i}-test-${crypto.randomUUID()}.db`),{db:o,close:s}=await c({url:`file:${a}`});try{await o.run(n`SELECT 1`)}catch(e){s();try{t.unlinkSync(a)}catch{}throw e}return{db:o,dbPath:a,close:s,cleanup:d(()=>{},s,a)}}async function u(i){let a=e.join(r.tmpdir(),`makaio-${i.name}-test-${crypto.randomUUID()}.db`),{db:o,close:s}=await c({url:`file:${a}`});try{for(let e of i.schemas)await o.run(e)}catch(e){s();try{t.unlinkSync(a)}catch{}throw e}return{db:o,dbPath:a,clearData:async()=>{for(let e of i.tables)await o.run(n.raw(`DELETE FROM ${e}`))},registerHandlers:()=>i.registerHandlers(o),close:async()=>{s(),await Promise.resolve();try{t.unlinkSync(a)}catch{}}}}function d(e,n,r){return()=>{e(),n();try{t.unlinkSync(r)}catch{}}}function f(e){let t,n;return o(async()=>{t=await e()}),s(async()=>{if(!t)throw Error(`usePluginStorageTestLifecycle: createTestDbFn did not initialize db context`);await t.clearData(),n=t.registerHandlers()}),a(()=>{n?.(),n=void 0}),i(async()=>{t&&await t.close()}),{get dbContext(){return t}}}export{d as createDbCleanup,u as createPluginTestDb,l as createTempDb,f as usePluginStorageTestLifecycle};

package/dist/testing/index.d.mts

@@ -0,0 +1,106 @@
+import { IMakaioBus, ScopedBus } from "@makaio/framework/bus";
+import { ExtensionContext } from "@makaio/framework/contracts";
+import { Mock } from "vitest";
+
+//#region packages/test-utils/src/bus-test-harness.d.ts
+/**
+ * Mock bus return type with exposed mock functions for assertions.
+ */
+interface MockBusResult {
+  /** Type-safe IMakaioBus instance */
+  bus: IMakaioBus;
+  /** Mock for bus.request() - use for assertions and mockResolvedValue */
+  request: Mock;
+  /** Mock for bus.emit() */
+  emit: Mock;
+  /** Mock for bus.on() - returns cleanup function */
+  on: Mock;
+  /** Mock for bus.requestOptional() */
+  requestOptional: Mock;
+  /** Mock for bus.withFilter() */
+  withFilter: Mock;
+  /** Resolves or replaces the backing promise returned by the live bus.ready getter. */
+  setReady: (ready?: Promise<void>) => void;
+}
+/**
+ * Creates a mock bus for unit tests.
+ *
+ * Returns a partial mock with the most commonly used methods.
+ * Use this when you need to verify bus method calls without triggering real handlers.
+ * @returns Object containing typed bus and exposed mock functions
+ */
+declare function createMockBus(): MockBusResult;
+/**
+ * Mock global bus return type with additional methods for adapter tests.
+ */
+interface MockGlobalBusResult extends MockBusResult {
+  /** Mock for bus.once() */
+  once: Mock;
+  /** Mock for bus.scoped() */
+  scoped: Mock;
+  /** Mock for bus.__onAny() */
+  __onAny: Mock;
+  /** Mock for bus.getContext() */
+  getContext: Mock;
+  /** Mock for bus.registerNamespace() */
+  registerNamespace: Mock;
+  /** Mock for bus.registerNamespaces() */
+  registerNamespaces: Mock;
+  /** Mock for bus.getSchema() */
+  getSchema: Mock;
+}
+/**
+ * Creates a full mock global bus for adapter/agent tests.
+ *
+ * Includes additional methods like scoped(), __onAny(), registerNamespace().
+ * Use this when testing code that uses the full IMakaioBus interface.
+ * @param namespace - Optional namespace identifier (default: 'global')
+ * @returns Object containing typed bus and exposed mock functions
+ */
+declare function createMockGlobalBus(namespace?: string): MockGlobalBusResult;
+/**
+ * Mock scoped bus return type for adapter-internal tests.
+ */
+interface MockScopedBusResult {
+  /** Type-safe ScopedBus instance */
+  bus: ScopedBus<string>;
+  /** Mock for bus.request() */
+  request: Mock;
+  /** Mock for bus.emit() */
+  emit: Mock;
+  /** Mock for bus.on() */
+  on: Mock;
+  /** Mock for bus.once() */
+  once: Mock;
+  /** Mock for bus.withFilter() */
+  withFilter: Mock;
+}
+/**
+ * Creates a mock scoped bus for adapter-internal tests.
+ *
+ * Use this when testing code that receives a ScopedBus (e.g., AIAgent internals).
+ * @param namespace - Namespace identifier (default: 'test')
+ * @returns Object containing typed scoped bus and exposed mock functions
+ */
+declare function createMockScopedBus(namespace?: string): MockScopedBusResult;
+/**
+ * Creates a real bus instance for integration tests.
+ *
+ * Use this when you need schema validation and real handler execution.
+ * @returns Real IMakaioBus instance
+ */
+declare function createTestBusInstance(): IMakaioBus;
+//#endregion
+//#region packages/test-utils/src/stub-extension-context.d.ts
+/**
+ * Build a minimal {@link ExtensionContext} for invoking storage handler
+ * registration functions in tests.
+ *
+ * Only the structural fields required by the interface are populated with
+ * safe defaults. No real services are wired.
+ * @param bus - Bus instance to place on the context.
+ * @returns A stub context suitable for handler registration.
+ */
+declare function makeStubExtensionContext(bus: IMakaioBus): ExtensionContext;
+//#endregion
+export { type MockBusResult, type MockGlobalBusResult, type MockScopedBusResult, createMockBus, createMockGlobalBus, createMockScopedBus, createTestBusInstance, makeStubExtensionContext };

package/dist/testing/index.mjs

@@ -0,0 +1 @@
+import{createBusInstance as e}from"@makaio/framework/bus";import{vi as t}from"vitest";function n(){let e=!1,t;return{promise:new Promise(n=>{t=()=>{e||(e=!0,n())}}),resolve:t}}function r(){return{unregister:t.fn(),ready:Promise.resolve()}}function i(){let e=n();return{connect:t.fn().mockImplementation(async()=>e.promise),disconnect:t.fn().mockImplementation(()=>{e.resolve(),e=n()}),get currentReady(){return e.promise},resolveReady:()=>{e.resolve()},replaceReady:t=>{e.resolve(),e={promise:t,resolve:()=>void 0}}}}function a(e){return t=>{if(t!==void 0){e.replaceReady(t);return}e.resolveReady()}}function o(){let e=t.fn(),n=t.fn().mockResolvedValue(void 0),o=t.fn().mockReturnValue(()=>{}),s=t.fn(),c=t.fn().mockReturnThis(),l=i(),u=a(l);return{bus:{namespace:`mock`,request:e,emit:n,on:o,once:t.fn(),intercept:t.fn(),requestOptional:s,withFilter:c,broadcast:t.fn(),scoped:t.fn(),__onAny:t.fn(),getContext:t.fn(),registerNamespace:t.fn(),registerNamespaces:t.fn(),getSchema:t.fn(),extendSubject:t.fn().mockImplementation(e=>e),registerTransport:t.fn().mockImplementation(()=>r()),unregisterTransport:t.fn(),disconnect:l.disconnect,reconnect:t.fn().mockResolvedValue(void 0),connect:l.connect,observeMessages:t.fn().mockReturnValue(()=>void 0),get ready(){return l.currentReady}},request:e,emit:n,on:o,requestOptional:s,withFilter:c,setReady:u}}function s(e=`global`){let n=t.fn().mockResolvedValue({}),o=t.fn().mockResolvedValue(void 0),s=t.fn().mockReturnValue(()=>{}),c=t.fn().mockResolvedValue({ok:!0,value:{}}),l=t.fn().mockReturnThis(),u=t.fn().mockResolvedValue({}),d=t.fn(),f=t.fn().mockReturnValue(()=>{}),p=t.fn(),m=t.fn(),h=t.fn(),g=t.fn(),_=i(),v=a(_);return{bus:{namespace:e,request:n,emit:o,on:s,once:u,intercept:t.fn(),requestOptional:c,withFilter:l,broadcast:t.fn(),scoped:d,__onAny:f,getContext:p,registerNamespace:m,registerNamespaces:h,getSchema:g,extendSubject:t.fn().mockImplementation(e=>e),registerTransport:t.fn().mockImplementation(()=>r()),unregisterTransport:t.fn(),disconnect:_.disconnect,reconnect:t.fn().mockResolvedValue(void 0),connect:_.connect,observeMessages:t.fn().mockReturnValue(()=>void 0),get ready(){return _.currentReady}},request:n,emit:o,on:s,requestOptional:c,withFilter:l,setReady:v,once:u,scoped:d,__onAny:f,getContext:p,registerNamespace:m,registerNamespaces:h,getSchema:g}}function c(e=`test`){let n=t.fn().mockResolvedValue({}),r=t.fn().mockResolvedValue(void 0),i=t.fn().mockReturnValue(()=>{}),a=t.fn().mockResolvedValue({}),o=t.fn().mockReturnThis();return{bus:{namespace:e,request:n,emit:r,on:i,once:a,intercept:t.fn(),requestOptional:t.fn(),withFilter:o,getContext:t.fn()},request:n,emit:r,on:i,once:a,withFilter:o}}function l(){return e()}function u(){let e=typeof process>`u`?void 0:process,t=globalThis.crypto?.randomUUID?.()??`fallback-${Date.now()}-${Math.random().toString(36).slice(2)}`;return e?.platform===`win32`?`${(e.env?.TEMP??e.env?.TMP??`.`).replace(/[\\/]+$/,``)}\\makaio-test-${t}`:`${(e?.env?.TMPDIR??`/tmp`).replace(/\/+$/,``)}/makaio-test-${t}`}function d(e){return{bus:e,machineId:`test-machine-id`,dataDir:u(),identity:{extensionName:`test.stub`},getService:()=>void 0,tryImport:async()=>null,signal:new AbortController().signal,hasExtension:()=>!1}}export{o as createMockBus,s as createMockGlobalBus,c as createMockScopedBus,l as createTestBusInstance,d as makeStubExtensionContext};

package/dist/timeout-XsYIOKrc.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";const t=e.object({initialization:e.number().optional().describe(`Time allowed for adapter/session initialization (cold starts, auth). Defaults to 30000ms.`),acknowledgement:e.number().optional().describe(`Time allowed for acknowledgement that a message was received. Defaults to 30000ms.`),completion:e.number().optional().describe(`Time allowed for completion of complex reasoning operations. Defaults to 60000ms.`),toolApproval:e.number().optional().describe(`Time allowed for tool approval responses (user is waiting). Defaults to 5000ms.`),eventWait:e.number().optional().describe(`Default time for once() calls waiting for events. Defaults to 10000ms.`)});export{t};

package/dist/tool-approval-service-BvZWhYZp.mjs

@@ -0,0 +1 @@
+import{SessionStorageSubjects as e}from"./services/session/storage/namespace.mjs";import{F as t}from"./handlers-CkTsQLra.mjs";import"./session-BoldSdNZ2.mjs";import{AgentSubjects as n,ApprovalSubjects as r,HarnessSubjects as i,computeMetaTags as a}from"@makaio/framework/contracts";import{BaseService as o}from"@makaio/framework/service-base";import{extractToolFilePath as s}from"@makaio/framework/tools";const c={"full-access":0,"always-ask":1,reject:2};function l(){return`apr_${crypto.randomUUID()}`}function u(e){switch(e){case`allow`:return`full-access`;case`deny`:return`reject`;case`ask`:return`always-ask`}}function d(e){if(!e?.length)return`neutral`;let t=a(e);return t.includes(`destructive`)?`destructive`:t.includes(`read-only`)?`safe`:`neutral`}function f(e,t){if(e)return t&&e.toolApprovalOverrides?.[t]!==void 0?e.toolApprovalOverrides[t]:e.approvalPolicy}function p(e,t,n,r){let i=r[t];if(!i?.length)return e;let a=e;for(let e of i){let t=n[e];t&&c[t]>c[a]&&(a=t)}return a}function m(e,t,n){return n.handled?n.data.allowedDirectories??void 0:t?[]:void 0}function h(e,t,n){if(!n||!e?.cwd)return{};let r;return(e.personaId||e.profileId)&&t&&(r=m(e.personaId,e.profileId,t)),{cwd:e.cwd,...r&&{allowedDirectories:r}}}function g(e,t,n){if(!(!e&&!t))return!n||!n.handled?{policy:`always-ask`}:{policy:u(n.data.action),...n.data.personaName&&{personaName:n.data.personaName},...n.data.profileName&&{profileName:n.data.profileName}}}function _(e,t){let n=t.harness?.toolCapabilityMap&&e.toolName?t.harness.toolCapabilityMap[e.toolName]:void 0;return{requestId:l(),toolCallId:e.toolCallId,toolName:e.toolName,args:e.args,agentId:e.agentId,sessionId:e.sessionId,adapterName:t.resolvedAdapterName,...t.personaName&&{personaName:t.personaName},...t.profileName&&{profileName:t.profileName},capabilities:n,riskLevel:d(n),reasoning:e.reasoning,createdAt:Date.now()}}var v=class extends o{logger=console;options;constructor(e,t={}){super(e),this.options=t}async onInit(){this.registerHandler(n.toolApprove,async e=>{let t=await this.getAgentMetadata(e.payload.agentId,e.payload.sessionId),n=(t?.personaId||t?.profileId)&&e.payload.toolName?await this.fetchRawEnrichedPolicy(t?.personaId,t?.profileId,e.payload.toolName):void 0,r=h(t,n,this.options.fileAccessRuleProvider),i=await this.checkFileAccessDenyReason(e.payload,r);if(i){e.setResult({action:`deny`,message:i,shouldAbort:!1});return}let a=await this.resolveSessionOverride(e.payload.sessionId);if(a===`full-access`){e.setResult({action:`allow`});return}if(a===`reject`){e.setResult({action:`deny`,message:`Tool use rejected by session approval policy override`,shouldAbort:!1});return}let o=await this.resolvePolicyWithContext({adapterName:e.payload.adapterName,toolName:e.payload.toolName},t,n);switch(a===`always-ask`?`always-ask`:o.policy){case`full-access`:e.setResult({action:`allow`});return;case`reject`:e.setResult({action:`deny`,message:`Tool use rejected by approval policy`,shouldAbort:!1});return;case`always-ask`:await this.dispatchAlwaysAskApproval(e.payload,e.setResult.bind(e),o);return}})}async dispatchAlwaysAskApproval(e,t,i){let a=_(e,i),o=new AbortController,s=this.bus.on(n.session.closed,()=>{o.abort()},{filter:{agentId:a.agentId,adapterSessionId:e.adapterSessionId}});try{let e=await this.bus.requestOptional(r.request,a,{timeout:0,signal:o.signal});e.handled&&e.data.action===`allow`?t({action:`allow`,...e.data.updatedInput&&{updatedInput:e.data.updatedInput}}):t({action:`deny`,message:e.handled&&e.data.action===`deny`?e.data.message??`User denied tool execution`:`No approval handler available`,shouldAbort:!1})}catch{t({action:`deny`,message:o.signal.aborted?`Approval cancelled — agent session closed`:`Tool approval request failed`,shouldAbort:!1})}finally{s()}}async checkFileAccessDenyReason(e,t){if(!this.options.fileAccessRuleProvider||!t.cwd)return;let n=s(e.toolName,e.args,t.cwd);if(n)try{return(await this.options.fileAccessRuleProvider(t.cwd,t.allowedDirectories)).isDenied(n)?`Access denied: '${n}' is restricted by .makaioignore rules`:void 0}catch{return`Access denied: file access rules could not be evaluated`}}async fetchRawEnrichedPolicy(e,t,n){try{return await this.bus.requestOptional(r.resolveEnrichedPolicy,{toolName:n,personaId:e,profileId:t})}catch(r){return this.logger.error(`[ToolApprovalService] approval.resolveEnrichedPolicy failed; falling back to fail-closed`,{toolName:n,personaId:e,profileId:t,error:r}),{handled:!1}}}async resolvePolicyWithContext(e,t,n){let r=t?.adapterName??e.adapterName,i=g(t?.personaId,t?.profileId,n),a=await this.resolveHarnessPolicy(r,t?.harnessId,t?.clientId),o=f(a,e.toolName),s=i?.policy??o??`always-ask`,c=s;return a?.capabilityOverrides&&a.toolCapabilityMap&&e.toolName&&(c=p(s,e.toolName,a.capabilityOverrides,a.toolCapabilityMap)),{policy:c,harness:a,agent:t,resolvedAdapterName:r,...i?.personaName&&{personaName:i.personaName},...i?.profileName&&{profileName:i.profileName}}}async getAgentMetadata(e,n){try{if(n){let{agents:r}=await this.bus.request(t.listBySession,{sessionId:n});return r.find(t=>t.agentId===e)??null}let r=await this.bus.requestOptional(t.get,{agentId:e});return r.handled?r.data.agent:null}catch{return null}}async resolveSessionOverride(t){if(t)try{let n=await this.bus.requestOptional(e.get,{sessionId:t});return n.handled?n.data.session?.approvalPolicyOverride??void 0:void 0}catch{return}}async resolveHarnessPolicy(e,t,n){try{let r=await this.bus.request(i.resolve,{adapterName:e,...t&&{profileHarnessId:t},...n&&{clientId:n}});return{approvalPolicy:r.approvalPolicy,capabilityOverrides:r.capabilityOverrides,toolCapabilityMap:r.toolCapabilityMap,toolApprovalOverrides:r.toolApprovalOverrides}}catch{return}}};export{v as t};