zidane 1.2.0 → 1.4.0

package/dist/tools.js

@@ -1,14 +1,17 @@
 import {
   createSpawnTool,
+  init_tools,
   listFiles,
   readFile,
   shell,
   spawn,
   validateToolArgs,
   writeFile
-} from "./chunk-27EP7HB3.js";
+} from "./chunk-YCH7G7YC.js";
 import "./chunk-26LIQARN.js";
+import "./chunk-PRNQ7DXE.js";
 import "./chunk-PNKVD2UK.js";
+init_tools();
 export {
   createSpawnTool,
   listFiles,

package/dist/{types-4CFQ-6Qu.d.ts → types-CLRMCak3.d.ts}

@@ -52,6 +52,16 @@ interface SessionMessage {
     role: 'user' | 'assistant';
     content: SessionContentBlock[];
 }
+interface SessionTurn {
+    /** UUID — generated by the store if it provides generateTurnId, else crypto.randomUUID() */
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: SessionContentBlock[];
+    /** Token usage — only present on assistant turns */
+    usage?: TurnUsage;
+    /** Unix timestamp (Date.now()) when the turn was created */
+    createdAt: number;
+}
 interface AgentRunOptions {
     model?: string;
     prompt: string;
@@ -91,4 +101,4 @@ interface ChildRunStats {
     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 };
+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, SessionTurn as c, ToolExecutionMode as d, TurnUsage as e };

package/dist/types-D8fzooXc.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Execution context types.
+ *
+ * An execution context defines *where* and *how* an agent's tools run.
+ * The agent loop and tools interact through this interface without knowing
+ * whether they're running in-process, in a Docker container, or in a
+ * remote sandbox.
+ */
+interface ContextCapabilities {
+    /** Can execute shell commands */
+    shell: boolean;
+    /** Can read/write files in a workspace */
+    filesystem: boolean;
+    /** Can make outbound network requests */
+    network: boolean;
+    /** Has GPU access */
+    gpu: boolean;
+}
+/** Opaque handle to a running execution context instance */
+interface ExecutionHandle {
+    id: string;
+    type: ContextType;
+    /** Working directory within the context */
+    cwd: string;
+}
+interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+interface SpawnConfig {
+    /** Working directory (created if it doesn't exist) */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Docker image (only for 'docker' context) */
+    image?: string;
+    /** Resource limits */
+    limits?: {
+        /** Memory limit in MB */
+        memory?: number;
+        /** CPU limit (e.g. '1.0' = 1 core) */
+        cpu?: string;
+        /** Timeout in seconds for the entire context lifetime */
+        timeout?: number;
+    };
+    /** Sandbox provider config (only for 'sandbox' context) */
+    sandbox?: {
+        provider: string;
+        apiKey?: string;
+        [key: string]: unknown;
+    };
+}
+type ContextType = 'process' | 'docker' | 'sandbox';
+interface ExecutionContext {
+    /** Context type identifier */
+    readonly type: ContextType;
+    /** What this context supports */
+    readonly capabilities: ContextCapabilities;
+    /** Spawn a new execution environment */
+    spawn: (config?: SpawnConfig) => Promise<ExecutionHandle>;
+    /** Execute a shell command in the context */
+    exec: (handle: ExecutionHandle, command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }) => Promise<ExecResult>;
+    /** Read a file from the context's filesystem */
+    readFile: (handle: ExecutionHandle, path: string) => Promise<string>;
+    /** Write a file to the context's filesystem */
+    writeFile: (handle: ExecutionHandle, path: string, content: string) => Promise<void>;
+    /** List files in a directory */
+    listFiles: (handle: ExecutionHandle, path: string) => Promise<string[]>;
+    /** Destroy the execution environment and clean up resources */
+    destroy: (handle: ExecutionHandle) => Promise<void>;
+}
+
+/**
+ * Types for the Agent Skills system.
+ *
+ * Follows the Agent Skills open standard (agentskills.io/specification).
+ */
+interface SkillResource {
+    /** Relative path from skill directory */
+    path: string;
+    /** Resource type inferred from directory */
+    type: 'script' | 'reference' | 'asset' | 'other';
+}
+interface SkillConfig {
+    /** Skill name: 1-64 chars, lowercase alphanumeric + hyphens */
+    name: string;
+    /** What the skill does and when to use it (1-1024 chars) */
+    description: string;
+    /** The SKILL.md body content (after YAML frontmatter) */
+    instructions: string;
+    /** Absolute path to SKILL.md (undefined for inline skills) */
+    location?: string;
+    /** Skill directory path for resolving relative references */
+    baseDir?: string;
+    /** License identifier or reference */
+    license?: string;
+    /** Environment requirements */
+    compatibility?: string;
+    /** Arbitrary key-value metadata */
+    metadata?: Record<string, string>;
+    /** Pre-approved tool names (experimental) */
+    allowedTools?: string[];
+    /** Bundled resource files discovered in the skill directory */
+    resources?: SkillResource[];
+    /** Model override when this skill is active */
+    model?: string;
+    /** Thinking/reasoning level override when this skill is active */
+    thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
+    /**
+     * Glob patterns that limit when this skill auto-activates.
+     * When set, the skill is only included in the catalog when
+     * the agent is working with files matching these patterns.
+     */
+    paths?: string[];
+}
+interface SkillsConfig {
+    /**
+     * Control which skills are active.
+     * - `true` (default): all discovered skills are enabled
+     * - `false` or `[]`: fully disable the skills system (no resolution, no catalog, no hooks)
+     * - `string[]`: allowlist — only skills with matching names are enabled
+     */
+    enabled?: boolean | string[];
+    /** Directories to scan for SKILL.md files */
+    scan?: string[];
+    /** Dynamic skills written to disk at agent start, then loaded normally */
+    write?: SkillConfig[];
+    /** Tool name the agent should use to read skill files (default: 'read_file') */
+    readToolName?: string;
+    /** Skill names to exclude from the catalog */
+    exclude?: string[];
+    /** Skip default scan paths (~/.agents/skills, .zidane/skills, etc.) */
+    skipDefaultPaths?: boolean;
+}
+
+export type { ContextCapabilities as C, ExecutionContext as E, SpawnConfig as S, ExecResult as a, ContextType as b, ExecutionHandle as c, SkillConfig as d, SkillResource as e, SkillsConfig as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,
@@ -38,6 +38,10 @@
     "./session": {
       "import": "./dist/session.js",
       "types": "./dist/session.d.ts"
+    },
+    "./skills": {
+      "import": "./dist/skills.js",
+      "types": "./dist/skills.d.ts"
     }
   },
   "main": "./dist/index.js",

package/dist/chunk-34KXKPNN.js

@@ -1,45 +0,0 @@
-import {
-  init_spawn,
-  listFiles,
-  readFile,
-  shell,
-  spawn_exports,
-  writeFile
-} from "./chunk-27EP7HB3.js";
-import {
-  __toCommonJS
-} from "./chunk-PNKVD2UK.js";
-
-// src/harnesses/basic.ts
-var basicTools = { shell, readFile, writeFile, listFiles };
-var _spawn;
-function getSpawn() {
-  if (!_spawn) {
-    _spawn = (init_spawn(), __toCommonJS(spawn_exports)).spawn;
-  }
-  return _spawn;
-}
-var spawnProxy = {
-  get spec() {
-    return getSpawn().spec;
-  },
-  execute(input, ctx) {
-    return getSpawn().execute(input, ctx);
-  }
-};
-var basic_default = defineHarness({
-  name: "basic",
-  system: "You are a helpful assistant with access to shell, file reading, file writing, directory listing, and sub-agent spawning tools. Use them to accomplish tasks in the project directory.",
-  tools: { ...basicTools, spawn: spawnProxy }
-});
-
-// src/harnesses/index.ts
-function defineHarness(config) {
-  return config;
-}
-
-export {
-  basicTools,
-  basic_default,
-  defineHarness
-};