zidane 1.0.2 → 1.2.0

package/dist/spawn-pP2grsVp.d.ts

@@ -0,0 +1,63 @@
+import { f as HarnessConfig, g as ToolDef } from './agent-DvZm8U14.js';
+import { a as AgentStats } from './types-4CFQ-6Qu.js';
+
+/**
+ * Spawn tool — create sub-agents from a parent agent.
+ *
+ * A static tool that reads provider and harness from ToolContext.
+ * Just add it to any harness's tools — no factory needed.
+ *
+ * Usage:
+ *   import { spawn } from 'zidane'
+ *
+ *   const harness = defineHarness({
+ *     name: 'orchestrator',
+ *     tools: { ...basicTools, spawn },
+ *   })
+ */
+
+interface ChildAgent {
+    id: string;
+    task: string;
+    startedAt: number;
+}
+interface SpawnToolState {
+    /** Currently running children */
+    readonly children: ReadonlyMap<string, ChildAgent>;
+    /** Aggregated stats from all completed children (returns a copy) */
+    readonly totalChildStats: Readonly<AgentStats>;
+}
+/**
+ * Static spawn tool — add directly to any harness.
+ *
+ * Reads provider and harness from ToolContext at execution time.
+ * Children get the same harness as the parent (including spawn),
+ * so sub-agents can spawn their own children.
+ */
+declare const spawn: ToolDef & SpawnToolState;
+interface SpawnToolOptions {
+    /** Maximum concurrent sub-agents (default: 3) */
+    maxConcurrent?: number;
+    /** Model override for child agents */
+    model?: string;
+    /** System prompt for child agents */
+    system?: string;
+    /** Thinking level for child agents */
+    thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
+    /** Override harness for children (defaults to parent's harness from ToolContext) */
+    harness?: HarnessConfig;
+    /** Called when a child agent starts */
+    onSpawn?: (child: ChildAgent) => void;
+    /** Called when a child agent completes */
+    onComplete?: (child: ChildAgent, stats: AgentStats) => void;
+}
+/**
+ * Create a configured spawn tool with custom options.
+ *
+ * For most cases, use the static `spawn` export directly.
+ * Use this factory when you need custom concurrency limits,
+ * model overrides, or lifecycle callbacks.
+ */
+declare function createSpawnTool(options?: SpawnToolOptions): ToolDef & SpawnToolState;
+
+export { type ChildAgent as C, type SpawnToolOptions as S, type SpawnToolState as a, createSpawnTool as c, spawn as s };

package/dist/tools.d.ts

@@ -0,0 +1,28 @@
+import { g as ToolDef } from './agent-DvZm8U14.js';
+export { C as ChildAgent, S as SpawnToolOptions, a as SpawnToolState, c as createSpawnTool, s as spawn } from './spawn-pP2grsVp.js';
+import 'hookable';
+import '@anthropic-ai/sdk';
+import './types-4CFQ-6Qu.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import './providers.js';
+import './session.js';
+
+declare const listFiles: ToolDef;
+
+declare const readFile: ToolDef;
+
+declare const shell: ToolDef;
+
+/**
+ * Simple tool argument validation against JSON Schema-style input_schema.
+ * Checks required fields are present; type coercion is left to the tools themselves.
+ */
+interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+declare function validateToolArgs(input: Record<string, unknown>, schema: Record<string, unknown>): ValidationResult;
+
+declare const writeFile: ToolDef;
+
+export { type ValidationResult, listFiles, readFile, shell, validateToolArgs, writeFile };

package/dist/tools.js

@@ -0,0 +1,20 @@
+import {
+  createSpawnTool,
+  listFiles,
+  readFile,
+  shell,
+  spawn,
+  validateToolArgs,
+  writeFile
+} from "./chunk-27EP7HB3.js";
+import "./chunk-26LIQARN.js";
+import "./chunk-PNKVD2UK.js";
+export {
+  createSpawnTool,
+  listFiles,
+  readFile,
+  shell,
+  spawn,
+  validateToolArgs,
+  writeFile
+};

package/dist/types-4CFQ-6Qu.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared types for the agent system.
+ */
+type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high';
+interface McpServerConfig {
+    /** Display name (used for tool namespacing) */
+    name: string;
+    /** Transport type */
+    transport: 'stdio' | 'sse' | 'streamable-http';
+    /** For stdio: command to run */
+    command?: string;
+    /** For stdio: command arguments */
+    args?: string[];
+    /** For stdio: environment variables */
+    env?: Record<string, string>;
+    /** For sse/streamable-http: server URL */
+    url?: string;
+    /** Optional headers for HTTP transports */
+    headers?: Record<string, string>;
+}
+type ToolExecutionMode = 'sequential' | 'parallel';
+interface ImageContent {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+type SessionContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    mediaType: string;
+    data: string;
+} | {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool_result';
+    callId: string;
+    output: string;
+    isError?: boolean;
+} | {
+    type: 'thinking';
+    text: string;
+};
+interface SessionMessage {
+    role: 'user' | 'assistant';
+    content: SessionContentBlock[];
+}
+interface AgentRunOptions {
+    model?: string;
+    prompt: string;
+    system?: string;
+    thinking?: ThinkingLevel;
+    images?: ImageContent[];
+    /** Abort signal — when triggered, the agent stops after the current turn */
+    signal?: AbortSignal;
+}
+interface TurnUsage {
+    input: number;
+    output: number;
+    /** Tokens written to cache (Anthropic) */
+    cacheCreation?: number;
+    /** Tokens read from cache (Anthropic) */
+    cacheRead?: number;
+    /** Thinking/reasoning tokens used */
+    thinking?: number;
+    /** Cost in USD as reported by the provider (OpenRouter) */
+    cost?: number;
+}
+interface AgentStats {
+    totalIn: number;
+    totalOut: number;
+    turns: number;
+    elapsed: number;
+    /** Per-turn usage breakdown */
+    turnUsage?: TurnUsage[];
+    /** Total cost in USD (sum of per-turn costs reported by provider) */
+    cost?: number;
+    /** Stats from child agents spawned during this run */
+    children?: ChildRunStats[];
+}
+interface ChildRunStats {
+    id: string;
+    task: string;
+    stats: AgentStats;
+}
+
+export type { AgentRunOptions as A, ChildRunStats as C, ImageContent as I, McpServerConfig as M, SessionContentBlock as S, ThinkingLevel as T, AgentStats as a, SessionMessage as b, ToolExecutionMode as c, TurnUsage as d };

package/package.json

@@ -1,11 +1,74 @@
 {
   "name": "zidane",
-  "version": "1.0.2",
-  "description": "ZidaneJS",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "1.2.0",
+  "description": "an agent that goes straight to the goal",
+  "type": "module",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Tahul/zidane"
   },
   "author": "Yaël GUILLOUX <yael.guilloux@gmail.com>",
-  "license": "ISC"
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Tahul/zidane/issues"
+  },
+  "homepage": "https://github.com/Tahul/zidane",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./providers": {
+      "import": "./dist/providers.js",
+      "types": "./dist/providers.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/tools.js",
+      "types": "./dist/tools.d.ts"
+    },
+    "./harnesses": {
+      "import": "./dist/harnesses.js",
+      "types": "./dist/harnesses.d.ts"
+    },
+    "./mcp": {
+      "import": "./dist/mcp.js",
+      "types": "./dist/mcp.d.ts"
+    },
+    "./session": {
+      "import": "./dist/session.js",
+      "types": "./dist/session.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "auth": "bun run src/auth.ts",
+    "start": "bun run src/start.ts",
+    "build": "tsup",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "bun test",
+    "release": "bumpp"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@yaelg/pi-ai": "^0.58.4",
+    "chalk": "^5.6.2",
+    "hookable": "^6.1.0",
+    "md4x": "^0.0.25"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^7.7.3",
+    "@types/bun": "^1.3.11",
+    "@types/dockerode": "^4.0.1",
+    "bumpp": "^11.0.1",
+    "eslint": "^10.0.3",
+    "jiti": "^2.6.1",
+    "tsup": "^8.5.1"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-export default () => console.log('1998')