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

package/dist/tools/index.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import t from"node:path";const n={TOOL_NOT_FOUND:`TOOL_NOT_FOUND`,VALIDATION_FAILED:`VALIDATION_FAILED`,PERMISSION_DENIED:`PERMISSION_DENIED`,TIMEOUT:`TIMEOUT`,ABORTED:`ABORTED`,EXECUTION_ERROR:`EXECUTION_ERROR`,INVALID_OUTPUT:`INVALID_OUTPUT`,RESOURCE_NOT_FOUND:`RESOURCE_NOT_FOUND`,RESOURCE_EXHAUSTED:`RESOURCE_EXHAUSTED`,INTERNAL_ERROR:`INTERNAL_ERROR`};var r=class extends Error{code;details;constructor(e,t,n){super(t),this.code=e,this.details=n,this.name=`ToolExecutionError`}toToolError(){return{code:this.code,message:this.message,details:this.details}}};function i(e,t,n){return{success:!1,error:{code:e,message:t,details:n}}}function a(e){return{success:!0,data:e}}function o(e,t=n.EXECUTION_ERROR){return e instanceof r?{success:!1,error:e.toToolError()}:e instanceof Error?i(t,e.message,{name:e.name,stack:e.stack}):i(t,String(e))}function s(e){return{metadata:{name:e.name,description:e.description,annotations:e.annotations},inputSchema:e.inputSchema,outputSchema:e.outputSchema,execute:e.execute}}function c(e){if(!Array.isArray(e)&&!(`metadata`in e))return e;if(!Array.isArray(e)&&`metadata`in e){let t=e;return{[t.metadata.name]:t}}let t=e,n={};for(let e of t)n[e.metadata.name]=e;return n}function l(e){return{metadata:{name:e.name,description:e.description,version:e.version},tools:c(e.tools),configSchema:e.configSchema}}function u(e){if(e)return{readOnly:e.readOnly,destructive:e.destructive,idempotent:e.idempotent,openWorldHint:e.requiresApproval}}function d(t){let n=e.toJSONSchema(t.inputSchema);return{name:t.metadata.name,description:t.metadata.description,inputSchema:g(n),annotations:u(t.metadata.annotations)}}function f(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function p(e,t,n){let r=e[0].properties,i=f(r)&&f(r[t])?r[t]:void 0,a=typeof i?.description==`string`?i.description:void 0;return{...i?.type===void 0?{}:{type:i.type},enum:n,...a===void 0?{}:{description:a}}}function m(e){let t=new Map;for(let n of e){let e=n.properties;if(f(e)){for(let[n,r]of Object.entries(e))if(f(r)&&r.const!==void 0){let e=t.get(n)??[];e.push(r.const),t.set(n,e)}}}for(let[n,r]of t){let t=new Set(r.map(e=>JSON.stringify(e)));if(r.length===e.length&&t.size===e.length)return{field:n,values:r}}}function h(e){let t=e.oneOf??e.anyOf;if(!Array.isArray(t)||t.length===0||!t.every(e=>f(e)&&e.type===`object`))return e;let n={},r=m(t);for(let e of t){let t=e.properties;if(f(t))for(let[e,i]of Object.entries(t))f(i)&&e!==r?.field&&(n[e]||(n[e]={...i}))}return r&&(n[r.field]=p(t,r.field,r.values)),{type:`object`,properties:n,required:r?[r.field]:[]}}function g(e){if(!f(e))return{type:`object`};let t=h(e);return`type`in t&&t.type===`object`?t:`oneOf`in e||`anyOf`in e?{...e,type:`object`}:{type:`object`}}function _(t){return{name:t.metadata.name,description:t.metadata.description,parameters:e.toJSONSchema(t.inputSchema)}}function v(e){return Object.values(e.tools).map(e=>d(e))}function y(e){return Object.values(e.tools).map(e=>_(e))}var b=class{factory;sessions=new Map;constructor(e){this.factory=e}get(e,...t){let n=this.sessions.get(e);return n||(n=this.factory(e,...t),this.sessions.set(e,n)),n}has(e){return this.sessions.has(e)}delete(e){return this.sessions.delete(e)}entries(){return this.sessions.entries()}sessionIds(){return Array.from(this.sessions.keys())}get size(){return this.sessions.size}};function x(e,t=`entity`){return e.sessionId?{valid:!0,sessionId:e.sessionId}:{valid:!1,error:i(n.VALIDATION_FAILED,`sessionId is required in context for ${t} operations`)}}async function S(e,t,n){e.bus&&await e.bus.emit(t,n)}async function C(e,t,n,r){let i=x(t,n);if(!i.valid)return i.error;let{sessionId:a}=i,o=r[e.op];return o(e,a,t)}function w(e){return e}const T=`fileAccessRules`,E=new Map([[`read_file`,[`path`,`file_path`]],[`write_file`,[`path`,`file_path`]],[`delete_file`,[`path`]],[`list_directory`,[`path`]],[`Read`,[`path`,`file_path`]],[`Write`,[`path`,`file_path`]],[`Edit`,[`path`,`file_path`]],[`MultiEdit`,[`path`,`file_path`]],[`create_file`,[`path`,`file_path`]]]);function D(e,n,r){if(!e||!n)return null;let i=E.get(e);if(!i)return null;let a=i.map(e=>n[e]).find(e=>typeof e==`string`&&e.length>0);return a?t.resolve(r,a):null}export{T as FILE_ACCESS_RULES_KEY,b as MemoryStore,n as ToolErrorCodes,r as ToolExecutionError,s as defineTool,l as defineToolset,S as emitEvent,g as ensureMcpObjectSchema,o as errorToToolResult,C as executeCrudOperation,D as extractToolFilePath,d as toMcpTool,_ as toOpenAIFunction,i as toolError,a as toolSuccess,v as toolsetToMcpTools,y as toolsetToOpenAIFunctions,x as validateSessionId,w as widenTool};

package/dist/tools/testing/index.d.mts

@@ -0,0 +1,53 @@
+//#region core/tools-core/src/testing/index.d.ts
+/**
+ * Domain-specific operations for a working memory type.
+ *
+ * Each MemoryStore subclass holds a different kind of working memory
+ * (e.g. ArtifactWorkingMemory, TaskWorkingMemory). These callbacks
+ * let the shared suite create and list items without knowing the domain.
+ */
+interface MemoryStoreTestOps<T> {
+  /** Create a single item in the working memory instance. */
+  createItem: (memory: T) => void;
+  /** Return all items in the working memory instance. */
+  listItems: (memory: T) => unknown[];
+  /** Clear all items from the working memory instance. */
+  clearItems: (memory: T) => void;
+  /** Expected constructor class for `instanceof` checks. */
+  memoryClass: new (...args: never[]) => T;
+}
+/**
+ * Configuration for the shared memory store behavioral test suite.
+ */
+/**
+ * Minimal store interface used by the shared suite.
+ *
+ * Compatible with `MemoryStore<T, []>` and `MemoryStore<T, [optional?]>`
+ * since the suite only calls `get(sessionId)` with no extra args.
+ */
+interface MemoryStoreLike<T> {
+  get(sessionId: string): T;
+  has(sessionId: string): boolean;
+  delete(sessionId: string): boolean;
+}
+/**
+ * Configuration for the shared memory store behavioral test suite.
+ */
+interface MemoryStoreBehaviorConfig<T> {
+  /** Human-readable name for the describe block (e.g. 'ArtifactMemoryStore'). */
+  name: string;
+  /** Factory to create a fresh store instance per test. */
+  createStore: () => MemoryStoreLike<T>;
+  /** Domain-specific item operations. */
+  ops: MemoryStoreTestOps<T>;
+}
+/**
+ * Registers shared behavioral tests for any MemoryStore subclass.
+ *
+ * Call this at the top level of a test file. It creates its own
+ * `describe` block with the provided name.
+ * @param config - Test suite configuration
+ */
+declare function describeMemoryStoreBehavior<T>(config: MemoryStoreBehaviorConfig<T>): void;
+//#endregion
+export { MemoryStoreBehaviorConfig, MemoryStoreLike, MemoryStoreTestOps, describeMemoryStoreBehavior };

package/dist/tools/testing/index.mjs

@@ -0,0 +1 @@
+import{beforeEach as e,describe as t,expect as n,it as r}from"vitest";function i(i){let{name:a,createStore:o,ops:s}=i;t(a,()=>{let i;e(()=>{i=o()}),t(`get`,()=>{r(`should create new working memory for unknown session`,()=>{n(i.get(`session-1`)).toBeInstanceOf(s.memoryClass)}),r(`should return the same instance for the same session`,()=>{let e=i.get(`session-1`),t=i.get(`session-1`);n(e).toBe(t)}),r(`should return different instances for different sessions`,()=>{let e=i.get(`session-1`),t=i.get(`session-2`);n(e).not.toBe(t)}),r(`should preserve state across multiple get calls`,()=>{let e=i.get(`session-1`);s.createItem(e);let t=i.get(`session-1`);n(s.listItems(t)).toHaveLength(1)})}),t(`has`,()=>{r(`should return false for unknown session`,()=>{n(i.has(`nonexistent`)).toBe(!1)}),r(`should return true for known session`,()=>{i.get(`session-1`),n(i.has(`session-1`)).toBe(!0)}),r(`should return false for different session`,()=>{i.get(`session-1`),n(i.has(`session-2`)).toBe(!1)})}),t(`delete`,()=>{r(`should remove session memory`,()=>{i.get(`session-1`),n(i.delete(`session-1`)).toBe(!0),n(i.has(`session-1`)).toBe(!1)}),r(`should return false for unknown session`,()=>{n(i.delete(`nonexistent`)).toBe(!1)}),r(`should clear items when deleted and recreated`,()=>{let e=i.get(`session-1`);s.createItem(e),i.delete(`session-1`);let t=i.get(`session-1`);n(s.listItems(t)).toHaveLength(0),n(t).not.toBe(e)}),r(`should not affect other sessions`,()=>{let e=i.get(`session-1`);s.createItem(e);let t=i.get(`session-2`);s.createItem(t),i.delete(`session-1`),n(i.has(`session-2`)).toBe(!0),n(s.listItems(i.get(`session-2`))).toHaveLength(1)})}),t(`isolation`,()=>{r(`should isolate items between sessions`,()=>{let e=i.get(`session-1`),t=i.get(`session-2`);s.createItem(e),s.createItem(e),s.createItem(t),n(s.listItems(e)).toHaveLength(2),n(s.listItems(t)).toHaveLength(1),s.clearItems(e),n(s.listItems(e)).toHaveLength(0),n(s.listItems(t)).toHaveLength(1)})})})}export{i as describeMemoryStoreBehavior};