@agentick/kernel 0.0.1

package/dist/testing.js

@@ -0,0 +1,96 @@
+/**
+ * Kernel Testing Utilities
+ *
+ * Provides `createTestProcedure` — a lightweight Procedure stub for testing
+ * code that *consumes* procedures without needing real middleware, context
+ * propagation, or execution tracking.
+ *
+ * @example
+ * ```typescript
+ * import { createTestProcedure } from "@agentick/kernel/testing";
+ *
+ * const proc = createTestProcedure({ handler: async (x: number) => x * 2 });
+ * const result = await proc(5).result;  // 10
+ * expect(proc._callCount).toBe(1);
+ * expect(proc._lastArgs).toEqual([5]);
+ * ```
+ *
+ * @module @agentick/kernel/testing
+ */
+import { createProcedurePromise, PROCEDURE_SYMBOL } from "./procedure";
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Create a test procedure stub.
+ *
+ * Callable + branded with `PROCEDURE_SYMBOL` so `isProcedure()` returns true.
+ * Returns `ProcedurePromise` so `.result` chaining works.
+ *
+ * Chainable methods (`.use()`, `.withContext()`, etc.) are no-ops returning self.
+ * This is intentional — test procedures are for testing code that *calls*
+ * procedures, not for testing middleware.
+ */
+export function createTestProcedure(options = {}) {
+    const handler = options.handler ?? (() => undefined);
+    const calls = [];
+    let nextResponse = null;
+    let persistentResponse = null;
+    function resolveOverride(override) {
+        return typeof override === "function" ? override() : override;
+    }
+    const callable = (...args) => {
+        calls.push({ args, timestamp: Date.now() });
+        const promise = Promise.resolve().then(() => {
+            // One-shot override takes priority
+            if (nextResponse !== null) {
+                const override = nextResponse;
+                nextResponse = null;
+                return resolveOverride(override.value);
+            }
+            // Persistent override
+            if (persistentResponse !== null) {
+                return resolveOverride(persistentResponse.value);
+            }
+            // Default handler
+            return handler(...args);
+        });
+        return createProcedurePromise(promise);
+    };
+    // Attach Procedure interface methods as no-ops
+    callable.exec = callable;
+    callable.use = () => callable;
+    callable.withContext = () => callable;
+    callable.withMiddleware = () => callable;
+    callable.withTimeout = () => callable;
+    callable.withMetadata = () => callable;
+    callable.pipe = () => callable;
+    // Brand
+    callable[PROCEDURE_SYMBOL] = true;
+    // Test-specific API
+    Object.defineProperty(callable, "_calls", {
+        get: () => calls,
+        enumerable: true,
+    });
+    Object.defineProperty(callable, "_callCount", {
+        get: () => calls.length,
+        enumerable: true,
+    });
+    Object.defineProperty(callable, "_lastArgs", {
+        get: () => calls.at(-1)?.args,
+        enumerable: true,
+    });
+    callable.respondWith = (value) => {
+        nextResponse = { value };
+    };
+    callable.setResponse = (value) => {
+        persistentResponse = { value };
+    };
+    callable.reset = () => {
+        calls.length = 0;
+        nextResponse = null;
+        persistentResponse = null;
+    };
+    return callable;
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@agentick/kernel",
+  "version": "0.0.1",
+  "description": "Kernel for Agentick",
+  "keywords": [
+    "agent",
+    "ai"
+  ],
+  "license": "ISC",
+  "author": "Ryan Lindgren",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "pino": "^9.6.0",
+    "zod": "^4.2.1",
+    "zod-to-json-schema": "^3.25.1",
+    "@agentick/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "pino-pretty": "^13.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Tests run from workspace root\"",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "types": "./dist/index.d.ts"
+}