@bobobowis/jev-kit 0.0.0-stage → 0.1.0

package/dist/tools/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A Jev tool, defined once for every harness: pi registers it, the MCP server lists it, the CLI
+ * runs it. The name, description, parameters, and payload are the same wherever it appears.
+ */
+import type { Decider } from "../events/index.ts";
+import type { CompactAction } from "../compact/should-compact.ts";
+import type { Evaluation, TurnInput } from "../compact/evaluate.ts";
+/** The subset of JSON Schema the tools use. */
+export interface JsonSchema {
+    type?: "object" | "string" | "boolean" | "array" | "number" | "integer";
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    additionalProperties?: boolean | JsonSchema;
+}
+export interface CompactionSource {
+    /** The session as the harness sees it, or null when it has no history to offer. */
+    input(): TurnInput | null | Promise<TurnInput | null>;
+    /** How the agent can act on a tier under this harness. */
+    action: CompactAction;
+    /** Told about every evaluation, so a harness can keep injecting the latest tier. */
+    onEvaluation?(evaluation: Evaluation): void;
+}
+export interface ToolContext {
+    /** The directory the agent works in. Paths resolve here and may not leave it. */
+    cwd: string;
+    harness: string;
+    decide: Decider;
+    report(kind: string, payload: Record<string, unknown>): void;
+    /** Level 7 only. */
+    compaction?: CompactionSource;
+}
+export interface ToolResult {
+    /** What the agent reads. */
+    text: string;
+    /** The structured result, when the call succeeded. */
+    payload?: unknown;
+    isError?: boolean;
+}
+export interface JevTool {
+    name: string;
+    label: string;
+    description: string;
+    parameters: JsonSchema;
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+export declare const ok: (payload: unknown) => ToolResult;
+export declare const fail: (text: string) => ToolResult;
+export declare const object: (properties: Record<string, JsonSchema>, required?: string[]) => JsonSchema;
+export declare const str: (description?: string) => JsonSchema;

package/dist/tools/types.js

@@ -0,0 +1,4 @@
+export const ok = (payload) => ({ text: JSON.stringify(payload, null, 2), payload });
+export const fail = (text) => ({ text, isError: true });
+export const object = (properties, required = Object.keys(properties)) => ({ type: "object", properties, required });
+export const str = (description) => (description ? { type: "string", description } : { type: "string" });

package/package.json

@@ -1,6 +1,99 @@
 {
   "name": "@bobobowis/jev-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Jev, TypeSafe AI's System One decision model, as a typed client, guards, file reads, agent tools, hooks, an MCP server, and a CLI. Zero runtime dependencies.",
+  "type": "module",
+  "license": "MIT",
+  "author": "bobobowis",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bobobowis/ten-levels-of-jev.git",
+    "directory": "packages/jev-kit"
+  },
+  "homepage": "https://github.com/bobobowis/ten-levels-of-jev/tree/main/packages/jev-kit#readme",
+  "bugs": "https://github.com/bobobowis/ten-levels-of-jev/issues",
+  "keywords": [
+    "jev",
+    "typesafe",
+    "llm",
+    "classifier",
+    "decision",
+    "guardrails",
+    "claude-code",
+    "codex",
+    "mcp",
+    "hooks",
+    "agents"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./policy": {
+      "types": "./dist/policy/index.d.ts",
+      "default": "./dist/policy/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "default": "./dist/events/index.js"
+    },
+    "./files": {
+      "types": "./dist/files/index.d.ts",
+      "default": "./dist/files/index.js"
+    },
+    "./ledger": {
+      "types": "./dist/ledger.d.ts",
+      "default": "./dist/ledger.js"
+    },
+    "./guards": {
+      "types": "./dist/guards/index.d.ts",
+      "default": "./dist/guards/index.js"
+    },
+    "./compact": {
+      "types": "./dist/compact/index.d.ts",
+      "default": "./dist/compact/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "default": "./dist/hooks/index.js"
+    },
+    "./setup": {
+      "types": "./dist/setup/index.d.ts",
+      "default": "./dist/setup/index.js"
+    },
+    "./capabilities": {
+      "types": "./dist/capabilities.d.ts",
+      "default": "./dist/capabilities.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "jev": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "~5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "pretest": "tsc -b tsconfig.build.json",
+    "test": "node --test \"tests/**/*.test.ts\"",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }