zidane 2.0.1 → 2.2.0

package/dist/{chunk-LN4LLLHA.js → chunk-S3FCOMRI.js}

@@ -1,10 +1,17 @@
 import {
   matchesContextExceeded
-} from "./chunk-7JTBBZ2U.js";
+} from "./chunk-LNN5UTS2.js";
 
 // src/providers/openai-compat.ts
 var TOOL_RESULTS_TAG = "__zidane_tool_results__";
 var ASSISTANT_TOOL_CALLS_TAG = "__zidane_assistant_tc__";
+var SSE_MAX_BUFFER_BYTES = 8 * 1024 * 1024;
+var OpenAICompatStreamError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OpenAICompatStreamError";
+  }
+};
 async function consumeSSE(response, callbacks, signal) {
   const reader = response.body.getReader();
   const decoder = new TextDecoder();
@@ -22,6 +29,11 @@ async function consumeSSE(response, callbacks, signal) {
       if (done)
         break;
       buffer += decoder.decode(value, { stream: true });
+      if (buffer.length > SSE_MAX_BUFFER_BYTES) {
+        throw new OpenAICompatStreamError(
+          `SSE buffer exceeded ${SSE_MAX_BUFFER_BYTES} bytes without a line boundary \u2014 upstream may be streaming non-SSE data.`
+        );
+      }
       const lines = buffer.split("\n");
       buffer = lines.pop() || "";
       for (const line of lines) {
@@ -36,22 +48,27 @@ async function consumeSSE(response, callbacks, signal) {
         } catch {
           continue;
         }
-        const choice = chunk.choices?.[0];
+        const choices = chunk.choices;
+        const choice = choices?.[0];
         if (!choice)
           continue;
-        if (choice.finish_reason)
-          finishReason = choice.finish_reason;
-        const thinkingDelta = choice.delta?.reasoning_content ?? choice.delta?.reasoning;
+        const fr = choice.finish_reason;
+        if (fr)
+          finishReason = fr;
+        const delta = choice.delta;
+        const thinkingDelta = delta?.reasoning_content ?? delta?.reasoning;
         if (thinkingDelta) {
           thinking += thinkingDelta;
           callbacks.onThinking?.(thinkingDelta);
         }
-        if (choice.delta?.content) {
-          text += choice.delta.content;
-          callbacks.onText(choice.delta.content);
+        const contentDelta = delta?.content;
+        if (contentDelta) {
+          text += contentDelta;
+          callbacks.onText(contentDelta);
         }
-        if (choice.delta?.tool_calls) {
-          for (const tc of choice.delta.tool_calls) {
+        const toolCallsDelta = delta?.tool_calls;
+        if (toolCallsDelta) {
+          for (const tc of toolCallsDelta) {
             const existing = tcMap.get(tc.index);
             if (existing) {
               if (tc.function?.arguments)
@@ -65,11 +82,12 @@ async function consumeSSE(response, callbacks, signal) {
             }
           }
         }
-        if (chunk.usage) {
+        const chunkUsage = chunk.usage;
+        if (chunkUsage) {
           usage = {
-            input: chunk.usage.prompt_tokens,
-            output: chunk.usage.completion_tokens,
-            cost: chunk.usage.total_cost ?? void 0
+            input: chunkUsage.prompt_tokens ?? 0,
+            output: chunkUsage.completion_tokens ?? 0,
+            cost: chunkUsage.total_cost ?? void 0
           };
         }
       }
@@ -77,11 +95,20 @@ async function consumeSSE(response, callbacks, signal) {
   } finally {
     reader.releaseLock();
   }
-  const toolCalls = Array.from(tcMap.values()).map((tc) => ({
-    id: tc.id,
-    name: tc.name,
-    input: tc.args ? JSON.parse(tc.args) : {}
-  }));
+  const toolCalls = [];
+  for (const tc of tcMap.values()) {
+    if (!tc.args) {
+      toolCalls.push({ id: tc.id, name: tc.name, input: {} });
+      continue;
+    }
+    try {
+      toolCalls.push({ id: tc.id, name: tc.name, input: JSON.parse(tc.args) });
+    } catch (err) {
+      throw new OpenAICompatStreamError(
+        `Tool call "${tc.name}" (${tc.id}) arguments were truncated or malformed: ${err.message}`
+      );
+    }
+  }
   return { text, thinking, toolCalls, finishReason, usage };
 }
 function toImageUrlPart(img) {
@@ -249,6 +276,14 @@ function classifyOpenAICompatError(err) {
     return null;
   if (err.name === "AbortError")
     return { kind: "aborted" };
+  if (err instanceof OpenAICompatStreamError) {
+    return {
+      kind: "provider_error",
+      providerCode: "stream_error",
+      message: err.message,
+      retryable: true
+    };
+  }
   if (!(err instanceof OpenAICompatHttpError))
     return null;
   const code = err.providerCode;
@@ -263,9 +298,17 @@ function classifyOpenAICompatError(err) {
   return {
     kind: "provider_error",
     providerCode: code ?? String(err.status),
-    message: msg
+    message: msg,
+    retryable: isRetryableHttpStatus(err.status)
   };
 }
+function isRetryableHttpStatus(status) {
+  if (status === 429)
+    return true;
+  if (status >= 500 && status !== 501)
+    return true;
+  return false;
+}
 function mapOAIFinishReason(reason) {
   if (!reason)
     return void 0;

package/dist/{chunk-OVQ4N64O.js → chunk-SP5NA6WF.js}

@@ -4,29 +4,23 @@ import {
   shell,
   spawn,
   writeFile
-} from "./chunk-PASFWG7S.js";
+} from "./chunk-F5UBXERT.js";
 
-// src/harnesses/basic.ts
+// src/presets/basic.ts
 var basicTools = { shell, readFile, writeFile, listFiles };
-var basic_default = defineHarness({
+var basic_default = definePreset({
   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 }
 });
 
-// src/harnesses/index.ts
-function defineHarness(config) {
+// src/presets/index.ts
+function definePreset(config) {
   return config;
 }
-var noTools = defineHarness({
-  name: "none",
-  system: "You are a helpful assistant.",
-  tools: {}
-});
 
 export {
   basicTools,
   basic_default,
-  defineHarness,
-  noTools
+  definePreset
 };

package/dist/{chunk-BCXXXJ3G.js → chunk-TPXPVEH6.js}

@@ -1,6 +1,6 @@
 import {
   AgentToolNotAllowedError
-} from "./chunk-7JTBBZ2U.js";
+} from "./chunk-LNN5UTS2.js";
 
 // src/skills/activation.ts
 function createSkillActivationState(options = {}) {
@@ -328,10 +328,12 @@ function escapeXml(str) {
 import { existsSync, readdirSync, readFileSync, statSync } from "fs";
 import { homedir } from "os";
 import { basename as basename2, dirname, join, resolve } from "path";
-var FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+var FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
 var INDENT_RE = /^[ \t]{2,}/;
 var KV_RE = /^([^:]+):(.*)$/;
-var QUOTE_RE = /^(['"])(.*)\1$/;
+var DOUBLE_QUOTED_RE = /^"((?:\\.|[^"\\])*)"$/;
+var SINGLE_QUOTED_RE = /^'((?:''|[^'])*)'$/;
+var DQ_ESCAPE_RE = /\\(["\\/bfnrt])/g;
 var WHITESPACE_SPLIT_RE = /\s+/;
 var PARAGRAPH_SPLIT_RE = /\n\n/;
 var COMMA_OR_SPACE_RE = /[,\s]+/;
@@ -390,11 +392,54 @@ function matchFirstColon(line) {
   return { key, value };
 }
 function unquoteYaml(val) {
-  const m = val.match(QUOTE_RE);
-  if (m)
-    return m[2];
+  const dq = val.match(DOUBLE_QUOTED_RE);
+  if (dq) {
+    return dq[1].replace(DQ_ESCAPE_RE, (_, ch) => {
+      switch (ch) {
+        case '"':
+          return '"';
+        case "\\":
+          return "\\";
+        case "/":
+          return "/";
+        case "b":
+          return "\b";
+        case "f":
+          return "\f";
+        case "n":
+          return "\n";
+        case "r":
+          return "\r";
+        case "t":
+          return "	";
+        default:
+          return ch;
+      }
+    });
+  }
+  const sq = val.match(SINGLE_QUOTED_RE);
+  if (sq) {
+    return sq[1].replace(/''/g, "'");
+  }
+  const hashIdx = val.indexOf(" #");
+  if (hashIdx >= 0)
+    return val.slice(0, hashIdx).trimEnd();
   return val;
 }
+function takeString(frontmatter, key, diagnostics) {
+  const raw = frontmatter[key];
+  if (raw === void 0 || raw === null)
+    return void 0;
+  if (typeof raw === "string")
+    return raw;
+  diagnostics.push({
+    severity: "warning",
+    code: "invalid-field-type",
+    message: `Frontmatter field "${key}" expected string, got ${typeof raw}. Coerced.`,
+    field: key
+  });
+  return String(raw);
+}
 var RESOURCE_DIRS = {
   scripts: "script",
   references: "reference",
@@ -409,9 +454,10 @@ function enumerateResources(baseDir) {
     try {
       const files = readdirSync(dirPath, { recursive: true });
       for (const file of files) {
-        const fullPath = join(dirPath, file);
+        const rel = typeof file === "string" ? file : file.toString("utf-8");
+        const fullPath = join(dirPath, rel);
         if (statSync(fullPath).isFile()) {
-          resources.push({ path: join(dir, file), type });
+          resources.push({ path: join(dir, rel), type });
         }
       }
     } catch {
@@ -436,7 +482,7 @@ async function parseSkillFile(filePath, options = {}) {
     return null;
   const content = readFileSync(absPath, "utf-8");
   const { frontmatter, body, diagnostics } = parseFrontmatter(content);
-  let description = frontmatter.description;
+  let description = takeString(frontmatter, "description", diagnostics);
   if (!description && body) {
     const firstParagraph = body.split(PARAGRAPH_SPLIT_RE)[0]?.trim();
     if (firstParagraph)
@@ -454,12 +500,13 @@ async function parseSkillFile(filePath, options = {}) {
   }
   const baseDir = dirname(absPath);
   const dirName = basename2(baseDir);
-  const name = frontmatter.name || dirName;
-  if (frontmatter.name && frontmatter.name !== dirName) {
+  const frontmatterName = takeString(frontmatter, "name", diagnostics);
+  const name = frontmatterName || dirName;
+  if (frontmatterName && frontmatterName !== dirName) {
     diagnostics.push({
       severity: "warning",
       code: "name-mismatch-directory",
-      message: `Skill name "${frontmatter.name}" does not match parent directory "${dirName}". Loading anyway.`,
+      message: `Skill name "${frontmatterName}" does not match parent directory "${dirName}". Loading anyway.`,
       field: "name"
     });
   }
@@ -488,23 +535,25 @@ async function parseSkillFile(filePath, options = {}) {
     baseDir,
     resources: enumerateResources(baseDir)
   };
-  if (frontmatter.license)
-    config.license = frontmatter.license;
-  if (frontmatter.compatibility) {
-    const comp = frontmatter.compatibility;
-    if (comp.length > 500) {
+  const license = takeString(frontmatter, "license", diagnostics);
+  if (license)
+    config.license = license;
+  const compatibility = takeString(frontmatter, "compatibility", diagnostics);
+  if (compatibility) {
+    if (compatibility.length > 500) {
       diagnostics.push({
         severity: "warning",
         code: "compatibility-too-long",
-        message: `Compatibility exceeds spec limit of 500 characters (got ${comp.length}). Loading anyway.`,
+        message: `Compatibility exceeds spec limit of 500 characters (got ${compatibility.length}). Loading anyway.`,
         field: "compatibility"
       });
     }
-    config.compatibility = comp;
+    config.compatibility = compatibility;
   }
   const metadata = {};
-  if (frontmatter.metadata && typeof frontmatter.metadata === "object") {
-    for (const [k, v] of Object.entries(frontmatter.metadata)) {
+  const rawMetadata = frontmatter.metadata;
+  if (rawMetadata && typeof rawMetadata === "object" && !Array.isArray(rawMetadata)) {
+    for (const [k, v] of Object.entries(rawMetadata)) {
       if (typeof v !== "string") {
         diagnostics.push({
           severity: "warning",
@@ -517,11 +566,17 @@ async function parseSkillFile(filePath, options = {}) {
       }
       metadata[k] = v;
     }
+  } else if (rawMetadata !== void 0) {
+    diagnostics.push({
+      severity: "warning",
+      code: "invalid-metadata-shape",
+      message: `Frontmatter "metadata" expected a map, got ${Array.isArray(rawMetadata) ? "array" : typeof rawMetadata}. Ignored.`,
+      field: "metadata"
+    });
   }
-  if (frontmatter.paths) {
-    const raw = frontmatter.paths;
-    const normalized = raw.split(COMMA_OR_SPACE_RE).filter(Boolean).join(",");
-    metadata["zidane.paths"] = normalized;
+  const pathsField = takeString(frontmatter, "paths", diagnostics);
+  if (pathsField) {
+    metadata["zidane.paths"] = pathsField.split(COMMA_OR_SPACE_RE).filter(Boolean).join(",");
     diagnostics.push({
       severity: "warning",
       code: "deprecated-top-level-field",
@@ -529,8 +584,9 @@ async function parseSkillFile(filePath, options = {}) {
       field: "paths"
     });
   }
-  if (frontmatter.model) {
-    metadata["zidane.model"] = frontmatter.model;
+  const modelField = takeString(frontmatter, "model", diagnostics);
+  if (modelField) {
+    metadata["zidane.model"] = modelField;
     diagnostics.push({
       severity: "warning",
       code: "deprecated-top-level-field",
@@ -538,20 +594,23 @@ async function parseSkillFile(filePath, options = {}) {
       field: "model"
     });
   }
-  const legacyThinking = frontmatter.thinking ?? frontmatter.effort;
+  const thinkingField = takeString(frontmatter, "thinking", diagnostics);
+  const effortField = thinkingField ? void 0 : takeString(frontmatter, "effort", diagnostics);
+  const legacyThinking = thinkingField ?? effortField;
   if (legacyThinking) {
     metadata["zidane.thinking"] = legacyThinking;
     diagnostics.push({
       severity: "warning",
       code: "deprecated-top-level-field",
-      message: `\`${frontmatter.thinking ? "thinking" : "effort"}\` is not a spec field and is deprecated \u2014 moved to \`metadata["zidane.thinking"]\`.`,
-      field: frontmatter.thinking ? "thinking" : "effort"
+      message: `\`${thinkingField ? "thinking" : "effort"}\` is not a spec field and is deprecated \u2014 moved to \`metadata["zidane.thinking"]\`.`,
+      field: thinkingField ? "thinking" : "effort"
     });
   }
   if (Object.keys(metadata).length > 0)
     config.metadata = metadata;
-  if (frontmatter["allowed-tools"]) {
-    config.allowedTools = frontmatter["allowed-tools"].split(WHITESPACE_SPLIT_RE).filter(Boolean);
+  const allowedTools = takeString(frontmatter, "allowed-tools", diagnostics);
+  if (allowedTools) {
+    config.allowedTools = allowedTools.split(WHITESPACE_SPLIT_RE).filter(Boolean);
   }
   if (diagnostics.length > 0)
     config.diagnostics = diagnostics;
@@ -627,6 +686,7 @@ import { join as join2 } from "path";
 var YAML_RESERVED_RE = /[:#&*!|>%@`]/;
 var YAML_EDGE_OR_QUOTE_RE = /^\s|\s$|["']/;
 var DQUOTE_RE = /"/g;
+var LEADING_NEWLINES_RE = /^\n+/;
 function yamlEscape(value) {
   if (YAML_RESERVED_RE.test(value) || YAML_EDGE_OR_QUOTE_RE.test(value) || value === "")
     return `"${value.replace(DQUOTE_RE, '\\"')}"`;
@@ -661,10 +721,11 @@ ${summary}`);
   const skillDir = join2(targetDir, skill.name);
   mkdirSync(skillDir, { recursive: true });
   const frontmatter = serializeFrontmatter(skill);
-  const body = skill.instructions ? `
-${skill.instructions}` : "";
-  const content = `${frontmatter}
-${body}
+  const bodyTrimmed = skill.instructions ? skill.instructions.replace(LEADING_NEWLINES_RE, "") : "";
+  const content = bodyTrimmed ? `${frontmatter}
+
+${bodyTrimmed}
+` : `${frontmatter}
 `;
   const skillPath = join2(skillDir, "SKILL.md");
   writeFileSync(skillPath, content);
@@ -707,26 +768,6 @@ async function resolveSkills(config) {
   }
   return filtered;
 }
-function mergeSkillsConfig(harness, agent) {
-  if (!harness && !agent)
-    return void 0;
-  if (!harness)
-    return agent;
-  if (!agent)
-    return harness;
-  return {
-    // Agent-level takes precedence when explicitly set
-    enabled: agent.enabled !== void 0 ? agent.enabled : harness.enabled,
-    scan: [...harness.scan ?? [], ...agent.scan ?? []],
-    write: [...harness.write ?? [], ...agent.write ?? []],
-    exclude: [.../* @__PURE__ */ new Set([...harness.exclude ?? [], ...agent.exclude ?? []])],
-    skipDefaultPaths: agent.skipDefaultPaths ?? harness.skipDefaultPaths,
-    tool: agent.tool ?? harness.tool,
-    maxActive: agent.maxActive ?? harness.maxActive,
-    scriptTimeoutMs: agent.scriptTimeoutMs ?? harness.scriptTimeoutMs,
-    trustProjectSkills: agent.trustProjectSkills ?? harness.trustProjectSkills
-  };
-}
 
 // src/skills/interpolate.ts
 var SHELL_INTERPOLATION_RE = /!`([^`]+)`/g;
@@ -744,7 +785,8 @@ async function interpolateShellCommands(instructions, execution, handle) {
       const output = result2.exitCode === 0 ? result2.stdout.trim() : `[command failed (exit ${result2.exitCode}): ${result2.stderr.trim() || result2.stdout.trim()}]`;
       replacements.push({ index, length, output });
     } catch (err) {
-      replacements.push({ index, length, output: `[command error: ${err.message}]` });
+      const message = err instanceof Error ? err.message : String(err);
+      replacements.push({ index, length, output: `[command error: ${message}]` });
     }
   }
   let result = instructions;
@@ -774,6 +816,5 @@ export {
   writeSkillToDisk,
   writeSkillsToDisk,
   resolveSkills,
-  mergeSkillsConfig,
   interpolateShellCommands
 };

package/dist/contexts.js

@@ -2,7 +2,7 @@ import {
   createDockerContext,
   createProcessContext,
   createSandboxContext
-} from "./chunk-SZA4FKW5.js";
+} from "./chunk-2EQT4EHD.js";
 export {
   createDockerContext,
   createProcessContext,

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-import { d as AgentHooks } from './agent-D-ZFMbSd.js';
-export { ad as ActivationVia, ae as ActiveSkill, A as Agent, a as AgentAbortedError, b as AgentBehavior, c as AgentContextExceededError, e as AgentOptions, f as AgentProviderError, g as AgentRunOptions, h as AgentStats, i as AgentToolNotAllowedError, j as AnthropicParams, C as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, k as CerebrasParams, m as ClassifiedError, n as ClassifiedErrorKind, o as CreateSessionOptions, af as DeactivationReason, ag as FileMapAdapter, ah as FileMapStoreOptions, H as Harness, p as HarnessConfig, I as ImageContent, M as McpConnection, q as McpServerConfig, r as McpToolHookContext, O as OAuthRefreshHookContext, ai as OpenAICompatAuthHeader, aj as OpenAICompatHttpError, ak as OpenAICompatParams, s as OpenAIParams, t as OpenRouterParams, P as PromptDocumentPart, u as PromptImagePart, v as PromptPart, w as PromptTextPart, x as Provider, y as ProviderCapabilities, R as RemoteStoreOptions, z as RunHookMap, S as Session, B as SessionContentBlock, D as SessionData, E as SessionEndStatus, F as SessionHookContext, G as SessionMessage, J as SessionRun, K as SessionStore, L as SessionTurn, al as SkillActivationState, am as SkillActivationStateOptions, N as SkillConfig, an as SkillDiagnostic, Q as SkillResource, ao as SkillSource, T as SkillsConfig, U as SpawnHookContext, V as StreamCallbacks, W as StreamHookContext, X as StreamOptions, Y as ThinkingLevel, Z as ToolCall, _ as ToolContext, $ as ToolDef, a0 as ToolExecutionMode, a1 as ToolHookContext, a2 as ToolMap, a3 as ToolResult, a4 as ToolResultContent, a5 as ToolResultImageContent, a6 as ToolResultTextContent, a7 as ToolSpec, a8 as TurnFinishReason, a9 as TurnResult, aa as TurnUsage, ap as anthropic, aq as autoDetectAndConvert, ar as cerebras, as as classifyOpenAICompatError, at as connectMcpServers, au as createAgent, av as createFileMapStore, aw as createMemoryStore, ax as createRemoteStore, ay as createSession, az as createSkillActivationState, aA as defineHarness, aB as fromAnthropic, aC as fromOpenAI, aD as loadSession, aE as mapOAIFinishReason, ab as matchesContextExceeded, aF as noTools, aG as normalizeMcpBlocks, aH as normalizeMcpServers, aI as openai, aJ as openaiCompat, aK as openrouter, aL as resultToString, aM as toAnthropic, aN as toOpenAI, aO as toTypedError, ac as toolResultToText } from './agent-D-ZFMbSd.js';
+import { d as AgentHooks } from './agent-vPBFXnu-.js';
+export { ab as ActivationVia, ac as ActiveSkill, A as Agent, a as AgentAbortedError, b as AgentBehavior, c as AgentContextExceededError, e as AgentOptions, f as AgentProviderError, g as AgentRunOptions, h as AgentStats, i as AgentToolNotAllowedError, j as AnthropicParams, C as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, k as CerebrasParams, m as ClassifiedError, n as ClassifiedErrorKind, o as CreateSessionOptions, ad as DeactivationReason, ae as FileMapAdapter, af as FileMapStoreOptions, I as ImageContent, M as McpConnection, p as McpServerConfig, q as McpToolHookContext, O as OAuthRefreshHookContext, ag as OpenAICompatAuthHeader, ah as OpenAICompatHttpError, ai as OpenAICompatParams, r as OpenAIParams, s as OpenRouterParams, P as PromptDocumentPart, t as PromptImagePart, u as PromptPart, v as PromptTextPart, w as Provider, x as ProviderCapabilities, R as RemoteStoreOptions, y as RunHookMap, S as Session, z as SessionContentBlock, B as SessionData, D as SessionEndStatus, E as SessionHookContext, F as SessionMessage, G as SessionRun, H as SessionStore, J as SessionTurn, aj as SkillActivationState, ak as SkillActivationStateOptions, K as SkillConfig, al as SkillDiagnostic, L as SkillResource, am as SkillSource, N as SkillsConfig, Q as SpawnHookContext, T as StreamCallbacks, U as StreamHookContext, V as StreamOptions, W as ThinkingLevel, X as ToolCall, Y as ToolContext, Z as ToolDef, _ as ToolExecutionMode, $ as ToolHookContext, a0 as ToolMap, a1 as ToolResult, a2 as ToolResultContent, a3 as ToolResultImageContent, a4 as ToolResultTextContent, a5 as ToolSpec, a6 as TurnFinishReason, a7 as TurnResult, a8 as TurnUsage, an as anthropic, ao as autoDetectAndConvert, ap as cerebras, aq as classifyOpenAICompatError, ar as connectMcpServers, as as createAgent, at as createFileMapStore, au as createMemoryStore, av as createRemoteStore, aw as createSession, ax as createSkillActivationState, ay as fromAnthropic, az as fromOpenAI, aA as loadSession, aB as mapOAIFinishReason, a9 as matchesContextExceeded, aC as normalizeMcpBlocks, aD as normalizeMcpServers, aE as openai, aF as openaiCompat, aG as openrouter, aH as resultToString, aI as toAnthropic, aJ as toOpenAI, aK as toTypedError, aa as toolResultToText } from './agent-vPBFXnu-.js';
 export { createDockerContext, createProcessContext } from './contexts.js';
 export { S as SandboxProvider, c as createSandboxContext } from './sandbox-CW72eLDP.js';
 export { C as ContextCapabilities, a as ContextType, E as ExecResult, b as ExecutionContext, c as ExecutionHandle, S as SpawnConfig } from './types-BpvTmawk.js';
-export { IMPLICITLY_ALLOWED_SKILL_TOOLS, SkillValidationIssue, SkillValidationResult, SourcedScanPath, buildCatalog, defineSkill, discoverSkills, installAllowedToolsGate, interpolateShellCommands, isToolAllowedByUnion, matchesAllowedTool, mergeSkillsConfig, parseAllowedToolPattern, parseSkillFile, resolveSkills, validateResourcePath, validateSkillForWrite, validateSkillName, writeSkillToDisk, writeSkillsToDisk } from './skills.js';
-export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, g as glob } from './skills-use-C4KFVla0.js';
-export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, c as createInteractionTool, b as createSpawnTool, s as spawn } from './spawn-RoqpjYLZ.js';
+export { Preset, basic, basicTools, definePreset } from './presets.js';
+export { IMPLICITLY_ALLOWED_SKILL_TOOLS, SkillValidationIssue, SkillValidationResult, SourcedScanPath, buildCatalog, defineSkill, discoverSkills, installAllowedToolsGate, interpolateShellCommands, isToolAllowedByUnion, matchesAllowedTool, parseAllowedToolPattern, parseSkillFile, resolveSkills, validateResourcePath, validateSkillForWrite, validateSkillName, writeSkillToDisk, writeSkillsToDisk } from './skills.js';
+export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, g as glob } from './skills-use-39cCsA7_.js';
+export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, c as createInteractionTool, b as createSpawnTool, s as spawn } from './spawn-Czx3owjX.js';
 import { Hookable } from 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';
 

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   defineSkill
-} from "./chunk-LVC7NQUZ.js";
+} from "./chunk-BW3WTFIR.js";
 import {
   toolResultToText
 } from "./chunk-MYWDHD7C.js";
@@ -9,11 +9,12 @@ import {
   cerebras,
   openai,
   openrouter
-} from "./chunk-FRNFVKWW.js";
+} from "./chunk-CDRXC7A7.js";
 import {
-  defineHarness,
-  noTools
-} from "./chunk-OVQ4N64O.js";
+  basicTools,
+  basic_default,
+  definePreset
+} from "./chunk-SP5NA6WF.js";
 import {
   createAgent,
   createInteractionTool,
@@ -23,7 +24,7 @@ import {
   createSpawnTool,
   glob,
   spawn
-} from "./chunk-PASFWG7S.js";
+} from "./chunk-F5UBXERT.js";
 import {
   IMPLICITLY_ALLOWED_SKILL_TOOLS,
   buildCatalog,
@@ -33,7 +34,6 @@ import {
   interpolateShellCommands,
   isToolAllowedByUnion,
   matchesAllowedTool,
-  mergeSkillsConfig,
   parseAllowedToolPattern,
   parseSkillFile,
   resolveSkills,
@@ -42,25 +42,25 @@ import {
   validateSkillName,
   writeSkillToDisk,
   writeSkillsToDisk
-} from "./chunk-BCXXXJ3G.js";
+} from "./chunk-TPXPVEH6.js";
 import {
   createDockerContext,
   createProcessContext,
   createSandboxContext
-} from "./chunk-SZA4FKW5.js";
+} from "./chunk-2EQT4EHD.js";
 import {
   connectMcpServers,
   normalizeMcpBlocks,
   normalizeMcpServers,
   resultToString
-} from "./chunk-PJUUYBKF.js";
+} from "./chunk-37GD7NL3.js";
 import {
   createFileMapStore,
   createMemoryStore,
   createRemoteStore,
   createSession,
   loadSession
-} from "./chunk-VG2E6YK3.js";
+} from "./chunk-PMCQOMV4.js";
 import {
   OpenAICompatHttpError,
   autoDetectAndConvert,
@@ -71,7 +71,7 @@ import {
   openaiCompat,
   toAnthropic,
   toOpenAI
-} from "./chunk-LN4LLLHA.js";
+} from "./chunk-S3FCOMRI.js";
 import {
   AgentAbortedError,
   AgentContextExceededError,
@@ -80,7 +80,7 @@ import {
   CONTEXT_EXCEEDED_MESSAGE_PATTERNS,
   matchesContextExceeded,
   toTypedError
-} from "./chunk-7JTBBZ2U.js";
+} from "./chunk-LNN5UTS2.js";
 
 // src/tracing.ts
 function createTracingHooks(options) {
@@ -204,6 +204,8 @@ export {
   OpenAICompatHttpError,
   anthropic,
   autoDetectAndConvert,
+  basic_default as basic,
+  basicTools,
   buildCatalog,
   cerebras,
   classifyOpenAICompatError,
@@ -223,7 +225,7 @@ export {
   createSkillsUseTool,
   createSpawnTool,
   createTracingHooks,
-  defineHarness,
+  definePreset,
   defineSkill,
   discoverSkills,
   fromAnthropic,
@@ -236,8 +238,6 @@ export {
   mapOAIFinishReason,
   matchesAllowedTool,
   matchesContextExceeded,
-  mergeSkillsConfig,
-  noTools,
   normalizeMcpBlocks,
   normalizeMcpServers,
   openai,

package/dist/mcp.d.ts

@@ -1,4 +1,4 @@
 import 'hookable';
-export { M as McpConnection, q as McpServerConfig, at as connectMcpServers, aG as normalizeMcpBlocks, aH as normalizeMcpServers, aL as resultToString } from './agent-D-ZFMbSd.js';
+export { M as McpConnection, p as McpServerConfig, ar as connectMcpServers, aC as normalizeMcpBlocks, aD as normalizeMcpServers, aH as resultToString } from './agent-vPBFXnu-.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import './types-BpvTmawk.js';

package/dist/mcp.js

@@ -3,7 +3,7 @@ import {
   normalizeMcpBlocks,
   normalizeMcpServers,
   resultToString
-} from "./chunk-PJUUYBKF.js";
+} from "./chunk-37GD7NL3.js";
 export {
   connectMcpServers,
   normalizeMcpBlocks,

package/dist/presets.d.ts

@@ -0,0 +1,33 @@
+import { Z as ToolDef, e as AgentOptions } from './agent-vPBFXnu-.js';
+import 'hookable';
+import './types-BpvTmawk.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+
+/** Core tools available in every basic preset (without spawn) */
+declare const basicTools: {
+    shell: ToolDef;
+    readFile: ToolDef;
+    writeFile: ToolDef;
+    listFiles: ToolDef;
+};
+declare const _default: Preset;
+
+/**
+ * A preset is a reusable slice of `AgentOptions` — spread it into `createAgent()`
+ * to configure tools, a default system prompt, aliases, and behavior defaults.
+ *
+ * `provider`, `execution`, `session`, and internal fields are excluded so presets
+ * remain shareable and composable.
+ *
+ * ```ts
+ * import { basic } from 'zidane/presets'
+ * createAgent({ ...basic, provider })
+ * ```
+ */
+type Preset = Omit<Partial<AgentOptions>, 'provider' | 'execution' | 'session' | '_mcpConnector'>;
+/**
+ * Identity helper for type inference when defining a preset.
+ */
+declare function definePreset(config: Preset): Preset;
+
+export { type Preset, _default as basic, basicTools, definePreset };