@agntk/agent-harness 0.1.1

package/dist/agent-framework-K4GUIICH.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+
+import {
+  createHarness
+} from "./chunk-YIJY5DBV.js";
+import "./chunk-AGAAFJEO.js";
+import "./chunk-5H34JPMB.js";
+import "./chunk-DA7IKHC4.js";
+import "./chunk-UWQTZMNI.js";
+import "./chunk-UDZIS2AQ.js";
+import "./chunk-DTTXPHFW.js";
+import "./chunk-Z2PUCXTZ.js";
+import "./chunk-TAT6JU3X.js";
+import "./chunk-JKMGYWXB.js";
+import "./chunk-OC6YSTDX.js";
+import "./chunk-XTBKL5BI.js";
+import {
+  loadDirectory
+} from "./chunk-UPLBF4RZ.js";
+import {
+  log
+} from "./chunk-BSKDOFRT.js";
+import "./chunk-IZ6UZ3ZL.js";
+import "./chunk-CHJ5GNZC.js";
+import "./chunk-4CWAGBNS.js";
+import {
+  __require
+} from "./chunk-ZZJOFKAT.js";
+
+// src/runtime/agent-framework.ts
+import { existsSync } from "fs";
+import { join } from "path";
+function createAgent(definition) {
+  let booted = false;
+  const harnessHooks = {};
+  if (definition.hooks?.onBoot) harnessHooks.onBoot = definition.hooks.onBoot;
+  if (definition.hooks?.onSessionEnd) harnessHooks.onSessionEnd = definition.hooks.onSessionEnd;
+  if (definition.hooks?.onError) harnessHooks.onError = definition.hooks.onError;
+  if (definition.hooks?.onStateChange) harnessHooks.onStateChange = definition.hooks.onStateChange;
+  if (definition.hooks?.onShutdown) harnessHooks.onShutdown = definition.hooks.onShutdown;
+  const harnessOptions = {
+    dir: definition.dir,
+    model: definition.model,
+    provider: definition.provider,
+    apiKey: definition.apiKey,
+    config: definition.config,
+    hooks: harnessHooks
+  };
+  const harness = createHarness(harnessOptions);
+  const middleware = definition.middleware ?? [];
+  async function runWithPipeline(prompt, isStream) {
+    if (definition.hooks?.beforeRun) {
+      const hookResult = await definition.hooks.beforeRun({
+        agent: definedAgent,
+        prompt,
+        isStream
+      });
+      if (hookResult) {
+        if (hookResult.reject) {
+          throw new Error(`Run rejected: ${hookResult.reason || "beforeRun hook rejected"}`);
+        }
+        if (hookResult.prompt) {
+          prompt = hookResult.prompt;
+        }
+      }
+    }
+    if (definition.guardrails?.enforceRules) {
+      const violation = checkRuleViolation(definition.dir, prompt);
+      if (violation) {
+        throw new Error(`Guardrail violation: ${violation}`);
+      }
+    }
+    if (definition.approval?.requireApproval) {
+      const needsApproval = definition.approval.requireApproval(prompt);
+      if (needsApproval) {
+        if (definition.approval.onApprovalNeeded) {
+          const approved = await definition.approval.onApprovalNeeded(prompt);
+          if (!approved) {
+            throw new Error("Run requires approval but was not approved");
+          }
+        } else {
+          throw new Error("Run requires approval but no onApprovalNeeded handler is configured");
+        }
+      }
+    }
+    const execute = async () => {
+      return harness.run(prompt);
+    };
+    let result;
+    if (middleware.length > 0) {
+      result = await executeMiddleware(middleware, definedAgent, prompt, isStream, execute);
+    } else {
+      result = await execute();
+    }
+    if (definition.hooks?.afterRun) {
+      const transformed = await definition.hooks.afterRun({
+        agent: definedAgent,
+        prompt,
+        result
+      });
+      if (transformed) {
+        result = transformed;
+      }
+    }
+    return result;
+  }
+  const definedAgent = {
+    name: definition.name,
+    get config() {
+      return harness.config;
+    },
+    harness,
+    definition,
+    async boot() {
+      await harness.boot();
+      booted = true;
+    },
+    async run(prompt) {
+      if (!booted) await definedAgent.boot();
+      return runWithPipeline(prompt, false);
+    },
+    stream(prompt) {
+      let resolveResult;
+      let rejectResult;
+      const resultPromise = new Promise((res, rej) => {
+        resolveResult = res;
+        rejectResult = rej;
+      });
+      resultPromise.catch(() => {
+      });
+      async function* generateStream() {
+        if (!booted) await definedAgent.boot();
+        try {
+          if (definition.hooks?.beforeRun) {
+            const hookResult = await definition.hooks.beforeRun({
+              agent: definedAgent,
+              prompt,
+              isStream: true
+            });
+            if (hookResult?.reject) {
+              const error = new Error(`Stream rejected: ${hookResult.reason || "beforeRun hook rejected"}`);
+              rejectResult(error);
+              throw error;
+            }
+            if (hookResult?.prompt) {
+              prompt = hookResult.prompt;
+            }
+          }
+          if (definition.guardrails?.enforceRules) {
+            const violation = checkRuleViolation(definition.dir, prompt);
+            if (violation) {
+              const error = new Error(`Guardrail violation: ${violation}`);
+              rejectResult(error);
+              throw error;
+            }
+          }
+          if (definition.approval?.requireApproval) {
+            const needsApproval = definition.approval.requireApproval(prompt);
+            if (needsApproval) {
+              if (definition.approval.onApprovalNeeded) {
+                const approved = await definition.approval.onApprovalNeeded(prompt);
+                if (!approved) {
+                  const error = new Error("Stream requires approval but was not approved");
+                  rejectResult(error);
+                  throw error;
+                }
+              } else {
+                const error = new Error("Stream requires approval but no onApprovalNeeded handler is configured");
+                rejectResult(error);
+                throw error;
+              }
+            }
+          }
+        } catch (err) {
+          const error = err instanceof Error ? err : new Error(String(err));
+          rejectResult(error);
+          throw error;
+        }
+        const streamResult = harness.stream(prompt);
+        let fullText = "";
+        for await (const chunk of streamResult.textStream) {
+          fullText += chunk;
+          yield chunk;
+        }
+        let result = await streamResult.result;
+        if (definition.hooks?.afterRun) {
+          const transformed = await definition.hooks.afterRun({
+            agent: definedAgent,
+            prompt,
+            result
+          });
+          if (transformed) {
+            result = transformed;
+          }
+        }
+        resolveResult(result);
+      }
+      return {
+        textStream: generateStream(),
+        result: resultPromise
+      };
+    },
+    async shutdown() {
+      await harness.shutdown();
+      booted = false;
+    },
+    getState() {
+      return harness.getState();
+    },
+    getSystemPrompt() {
+      return harness.getSystemPrompt();
+    },
+    isBooted() {
+      return booted;
+    }
+  };
+  return definedAgent;
+}
+async function executeMiddleware(middlewares, agent, prompt, isStream, execute) {
+  let index = 0;
+  const next = async () => {
+    if (index >= middlewares.length) {
+      return execute();
+    }
+    const mw = middlewares[index++];
+    return mw({ agent, prompt, isStream }, next);
+  };
+  return next();
+}
+function checkRuleViolation(harnessDir, prompt, options) {
+  const rulesDir = join(harnessDir, "rules");
+  if (!existsSync(rulesDir)) return null;
+  const rules = loadDirectory(rulesDir);
+  const promptLower = prompt.toLowerCase();
+  for (const rule of rules) {
+    if (options?.ruleTags && options.ruleTags.length > 0) {
+      const hasTag = rule.frontmatter.tags.some(
+        (t) => options.ruleTags.includes(t.toLowerCase())
+      );
+      if (!hasTag) continue;
+    }
+    if (rule.frontmatter.status !== "active") continue;
+    const text = (rule.l0 + "\n" + rule.body).toLowerCase();
+    const forbiddenPatterns = extractForbiddenActions(text);
+    for (const forbidden of forbiddenPatterns) {
+      const keywords = forbidden.split(/\s+/).filter((w) => w.length > 3);
+      const matchCount = keywords.filter((k) => promptLower.includes(k)).length;
+      if (keywords.length > 0 && matchCount >= Math.ceil(keywords.length * 0.6)) {
+        return `Rule "${rule.frontmatter.id}" forbids: "${forbidden}"  prompt matches ${matchCount}/${keywords.length} keywords`;
+      }
+    }
+  }
+  return null;
+}
+function extractForbiddenActions(text) {
+  const actions = [];
+  const patterns = [
+    /never\s+(.+?)(?:\.|$)/gm,
+    /don'?t\s+(.+?)(?:\.|$)/gm,
+    /must not\s+(.+?)(?:\.|$)/gm,
+    /do not\s+(.+?)(?:\.|$)/gm,
+    /avoid\s+(.+?)(?:\.|$)/gm,
+    /prohibit(?:ed|s)?\s+(.+?)(?:\.|$)/gm,
+    /forbidden?:?\s+(.+?)(?:\.|$)/gm
+  ];
+  for (const pattern of patterns) {
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const action = match[1].trim();
+      if (action.length > 3 && action.length < 200) {
+        actions.push(action);
+      }
+    }
+  }
+  return actions;
+}
+function createCliApproval(options) {
+  const timeoutMs = options?.timeoutMs ?? 3e5;
+  return (prompt) => {
+    return new Promise((resolve) => {
+      const readline = __require("readline");
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+      const timer = setTimeout(() => {
+        log.warn("Approval timeout  rejecting");
+        rl.close();
+        resolve(false);
+      }, timeoutMs);
+      const preview = prompt.length > 100 ? prompt.slice(0, 100) + "..." : prompt;
+      rl.question(`
+[APPROVAL REQUIRED] "${preview}"
+Approve? (y/N): `, (answer) => {
+        clearTimeout(timer);
+        rl.close();
+        resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      });
+    });
+  };
+}
+function createWebhookApproval(options) {
+  const timeoutMs = options.timeoutMs ?? 3e5;
+  return async (prompt) => {
+    try {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), timeoutMs);
+      const response = await fetch(options.url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers
+        },
+        body: JSON.stringify({ prompt, timestamp: (/* @__PURE__ */ new Date()).toISOString() }),
+        signal: controller.signal
+      });
+      clearTimeout(timer);
+      if (!response.ok) {
+        log.warn(`Approval webhook returned ${response.status}`);
+        return false;
+      }
+      const body = await response.json();
+      return body.approved === true;
+    } catch (err) {
+      log.warn(`Approval webhook failed: ${err instanceof Error ? err.message : String(err)}`);
+      return false;
+    }
+  };
+}
+function checkAction(harnessDir, action, options) {
+  const violation = checkRuleViolation(harnessDir, action, options);
+  return {
+    allowed: violation === null,
+    reason: violation
+  };
+}
+export {
+  checkAction,
+  checkRuleViolation,
+  createAgent,
+  createCliApproval,
+  createWebhookApproval
+};
+//# sourceMappingURL=agent-framework-K4GUIICH.js.map

package/dist/agent-framework-K4GUIICH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/agent-framework.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { createHarness } from '../core/harness.js';\nimport { loadDirectory } from '../primitives/loader.js';\nimport { log } from '../core/logger.js';\nimport type {\n  CreateHarnessOptions,\n  HarnessAgent,\n  HarnessConfig,\n  HarnessHooks,\n  AgentRunResult,\n  AgentStreamResult,\n  AgentState,\n  DeepPartial,\n} from '../core/types.js';\n\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n// 1. defineAgent() \u0014 Declarative Agent Definition\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n\nexport interface AgentDefinition {\n  /** Agent name (used for logging and config resolution) */\n  name: string;\n  /** Harness directory path */\n  dir: string;\n  /** Model override */\n  model?: string;\n  /** Provider override */\n  provider?: string;\n  /** API key override */\n  apiKey?: string;\n  /** Config overrides */\n  config?: DeepPartial<HarnessConfig>;\n\n  /** Lifecycle hooks \u0014 called at various points in the agent lifecycle */\n  hooks?: AgentLifecycleHooks;\n\n  /** Pre-action rule enforcement configuration */\n  guardrails?: GuardrailEnforcementConfig;\n\n  /** Human-in-the-loop gate configuration */\n  approval?: ApprovalGateConfig;\n\n  /** Middleware functions that wrap each run/stream call */\n  middleware?: AgentMiddleware[];\n}\n\nexport interface AgentLifecycleHooks extends HarnessHooks {\n  /** Called before each run/stream \u0014 can modify prompt or reject */\n  beforeRun?: (ctx: BeforeRunContext) => Promise<BeforeRunResult | void>;\n  /** Called after each run/stream \u0014 can transform result */\n  afterRun?: (ctx: AfterRunContext) => Promise<AgentRunResult | void>;\n  /** Called periodically for health checks */\n  onHealthCheck?: (ctx: { agent: DefinedAgent }) => Promise<void>;\n}\n\nexport interface BeforeRunContext {\n  agent: DefinedAgent;\n  prompt: string;\n  isStream: boolean;\n}\n\nexport interface BeforeRunResult {\n  /** Modified prompt (if changed) */\n  prompt?: string;\n  /** Set to true to reject the run */\n  reject?: boolean;\n  /** Reason for rejection */\n  reason?: string;\n}\n\nexport interface AfterRunContext {\n  agent: DefinedAgent;\n  prompt: string;\n  result: AgentRunResult;\n}\n\nexport type AgentMiddleware = (\n  ctx: { agent: DefinedAgent; prompt: string; isStream: boolean },\n  next: () => Promise<AgentRunResult>,\n) => Promise<AgentRunResult>;\n\n/**\n * A defined agent wraps a HarnessAgent with additional capabilities:\n * - Middleware pipeline\n * - Pre-action guardrails\n * - Human-in-the-loop gates\n * - Extended lifecycle hooks\n */\nexport interface DefinedAgent {\n  name: string;\n  config: HarnessConfig;\n  /** The underlying harness agent */\n  harness: HarnessAgent;\n  /** Boot the agent */\n  boot(): Promise<void>;\n  /** Run with middleware, guardrails, and approval gates */\n  run(prompt: string): Promise<AgentRunResult>;\n  /** Stream with middleware, guardrails, and approval gates */\n  stream(prompt: string): AgentStreamResult;\n  /** Shutdown cleanly */\n  shutdown(): Promise<void>;\n  /** Get agent state */\n  getState(): AgentState;\n  /** Get system prompt */\n  getSystemPrompt(): string;\n  /** Check if agent is booted */\n  isBooted(): boolean;\n  /** Access the definition */\n  definition: AgentDefinition;\n}\n\n/**\n * Define an agent with declarative configuration.\n *\n * This is the high-level API for creating agents with:\n * - Lifecycle hooks (beforeRun, afterRun, onBoot, onSessionEnd, onError, onShutdown)\n * - Middleware pipeline (wrap each run with custom logic)\n * - Guardrail enforcement (check rules before actions)\n * - Human-in-the-loop gates (require approval for certain prompts)\n *\n * Usage:\n * ```typescript\n * const agent = createAgent({\n *   name: 'my-agent',\n *   dir: './my-harness',\n *   hooks: {\n *     beforeRun: async ({ prompt }) => {\n *       if (prompt.includes('delete')) return { reject: true, reason: 'Destructive action' };\n *     },\n *     onBoot: async () => console.log('Agent booted!'),\n *   },\n *   guardrails: { enforceRules: true },\n *   approval: { requireApproval: (prompt) => prompt.includes('deploy') },\n * });\n *\n * await agent.boot();\n * const result = await agent.run('Hello world');\n * ```\n */\nexport function createAgent(definition: AgentDefinition): DefinedAgent {\n  let booted = false;\n\n  // Build HarnessHooks from lifecycle hooks\n  const harnessHooks: HarnessHooks = {};\n  if (definition.hooks?.onBoot) harnessHooks.onBoot = definition.hooks.onBoot;\n  if (definition.hooks?.onSessionEnd) harnessHooks.onSessionEnd = definition.hooks.onSessionEnd;\n  if (definition.hooks?.onError) harnessHooks.onError = definition.hooks.onError;\n  if (definition.hooks?.onStateChange) harnessHooks.onStateChange = definition.hooks.onStateChange;\n  if (definition.hooks?.onShutdown) harnessHooks.onShutdown = definition.hooks.onShutdown;\n\n  // Create underlying harness\n  const harnessOptions: CreateHarnessOptions = {\n    dir: definition.dir,\n    model: definition.model,\n    provider: definition.provider,\n    apiKey: definition.apiKey,\n    config: definition.config,\n    hooks: harnessHooks,\n  };\n\n  const harness = createHarness(harnessOptions);\n\n  // Build middleware pipeline\n  const middleware = definition.middleware ?? [];\n\n  async function runWithPipeline(prompt: string, isStream: boolean): Promise<AgentRunResult> {\n    // 1. beforeRun hook\n    if (definition.hooks?.beforeRun) {\n      const hookResult = await definition.hooks.beforeRun({\n        agent: definedAgent,\n        prompt,\n        isStream,\n      });\n\n      if (hookResult) {\n        if (hookResult.reject) {\n          throw new Error(`Run rejected: ${hookResult.reason || 'beforeRun hook rejected'}`);\n        }\n        if (hookResult.prompt) {\n          prompt = hookResult.prompt;\n        }\n      }\n    }\n\n    // 2. Guardrail enforcement (check rules)\n    if (definition.guardrails?.enforceRules) {\n      const violation = checkRuleViolation(definition.dir, prompt);\n      if (violation) {\n        throw new Error(`Guardrail violation: ${violation}`);\n      }\n    }\n\n    // 3. Approval gate\n    if (definition.approval?.requireApproval) {\n      const needsApproval = definition.approval.requireApproval(prompt);\n      if (needsApproval) {\n        if (definition.approval.onApprovalNeeded) {\n          const approved = await definition.approval.onApprovalNeeded(prompt);\n          if (!approved) {\n            throw new Error('Run requires approval but was not approved');\n          }\n        } else {\n          // No approval handler \u0014 always reject\n          throw new Error('Run requires approval but no onApprovalNeeded handler is configured');\n        }\n      }\n    }\n\n    // 4. Run through middleware chain\n    const execute = async (): Promise<AgentRunResult> => {\n      return harness.run(prompt);\n    };\n\n    let result: AgentRunResult;\n    if (middleware.length > 0) {\n      result = await executeMiddleware(middleware, definedAgent, prompt, isStream, execute);\n    } else {\n      result = await execute();\n    }\n\n    // 5. afterRun hook\n    if (definition.hooks?.afterRun) {\n      const transformed = await definition.hooks.afterRun({\n        agent: definedAgent,\n        prompt,\n        result,\n      });\n      if (transformed) {\n        result = transformed;\n      }\n    }\n\n    return result;\n  }\n\n  const definedAgent: DefinedAgent = {\n    name: definition.name,\n    get config() { return harness.config; },\n    harness,\n    definition,\n\n    async boot() {\n      await harness.boot();\n      booted = true;\n    },\n\n    async run(prompt: string): Promise<AgentRunResult> {\n      if (!booted) await definedAgent.boot();\n      return runWithPipeline(prompt, false);\n    },\n\n    stream(prompt: string): AgentStreamResult {\n      // For stream, we wrap the textStream with pre-run checks\n      let resolveResult: (r: AgentRunResult) => void;\n      let rejectResult: (e: Error) => void;\n      const resultPromise = new Promise<AgentRunResult>((res, rej) => {\n        resolveResult = res;\n        rejectResult = rej;\n      });\n      resultPromise.catch(() => {}); // Prevent unhandled rejection\n\n      async function* generateStream(): AsyncIterable<string> {\n        if (!booted) await definedAgent.boot();\n\n        // Run pre-checks\n        try {\n          if (definition.hooks?.beforeRun) {\n            const hookResult = await definition.hooks.beforeRun({\n              agent: definedAgent,\n              prompt,\n              isStream: true,\n            });\n            if (hookResult?.reject) {\n              const error = new Error(`Stream rejected: ${hookResult.reason || 'beforeRun hook rejected'}`);\n              rejectResult(error);\n              throw error;\n            }\n            if (hookResult?.prompt) {\n              prompt = hookResult.prompt;\n            }\n          }\n\n          if (definition.guardrails?.enforceRules) {\n            const violation = checkRuleViolation(definition.dir, prompt);\n            if (violation) {\n              const error = new Error(`Guardrail violation: ${violation}`);\n              rejectResult(error);\n              throw error;\n            }\n          }\n\n          if (definition.approval?.requireApproval) {\n            const needsApproval = definition.approval.requireApproval(prompt);\n            if (needsApproval) {\n              if (definition.approval.onApprovalNeeded) {\n                const approved = await definition.approval.onApprovalNeeded(prompt);\n                if (!approved) {\n                  const error = new Error('Stream requires approval but was not approved');\n                  rejectResult(error);\n                  throw error;\n                }\n              } else {\n                const error = new Error('Stream requires approval but no onApprovalNeeded handler is configured');\n                rejectResult(error);\n                throw error;\n              }\n            }\n          }\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n          rejectResult(error);\n          throw error;\n        }\n\n        // Delegate to harness stream\n        const streamResult = harness.stream(prompt);\n        let fullText = '';\n\n        for await (const chunk of streamResult.textStream) {\n          fullText += chunk;\n          yield chunk;\n        }\n\n        // Await the result and apply afterRun hook\n        let result = await streamResult.result;\n\n        if (definition.hooks?.afterRun) {\n          const transformed = await definition.hooks.afterRun({\n            agent: definedAgent,\n            prompt,\n            result,\n          });\n          if (transformed) {\n            result = transformed;\n          }\n        }\n\n        resolveResult(result);\n      }\n\n      return {\n        textStream: generateStream(),\n        result: resultPromise,\n      };\n    },\n\n    async shutdown() {\n      await harness.shutdown();\n      booted = false;\n    },\n\n    getState() {\n      return harness.getState();\n    },\n\n    getSystemPrompt() {\n      return harness.getSystemPrompt();\n    },\n\n    isBooted() {\n      return booted;\n    },\n  };\n\n  return definedAgent;\n}\n\n/**\n * Execute middleware chain in order.\n */\nasync function executeMiddleware(\n  middlewares: AgentMiddleware[],\n  agent: DefinedAgent,\n  prompt: string,\n  isStream: boolean,\n  execute: () => Promise<AgentRunResult>,\n): Promise<AgentRunResult> {\n  let index = 0;\n\n  const next = async (): Promise<AgentRunResult> => {\n    if (index >= middlewares.length) {\n      return execute();\n    }\n    const mw = middlewares[index++];\n    return mw({ agent, prompt, isStream }, next);\n  };\n\n  return next();\n}\n\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n// 2. Guardrail Enforcement \u0014 Pre-action Rule Checking\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n\nexport interface GuardrailEnforcementConfig {\n  /** Enable rule-based pre-action checking (default: false) */\n  enforceRules?: boolean;\n  /** Custom check function (in addition to rule scanning) */\n  customCheck?: (prompt: string) => string | null;\n  /** Tags to filter rules (only check rules with these tags) */\n  ruleTags?: string[];\n}\n\nexport interface AgentRuleViolation {\n  ruleId: string;\n  rulePath: string;\n  violatedDirective: string;\n  prompt: string;\n}\n\n/**\n * Check if a prompt violates any rules in the harness.\n *\n * Rules are scanned for \"never\" / \"don't\" / \"must not\" / \"avoid\" directives.\n * If the prompt contains keywords that match a forbidden action,\n * a violation is returned.\n *\n * This is a heuristic check \u0014 not a semantic understanding of the prompt.\n * Returns null if no violation found, or a string describing the violation.\n */\nexport function checkRuleViolation(\n  harnessDir: string,\n  prompt: string,\n  options?: { ruleTags?: string[] },\n): string | null {\n  const rulesDir = join(harnessDir, 'rules');\n  if (!existsSync(rulesDir)) return null;\n\n  const rules = loadDirectory(rulesDir);\n  const promptLower = prompt.toLowerCase();\n\n  for (const rule of rules) {\n    // Filter by tags if specified\n    if (options?.ruleTags && options.ruleTags.length > 0) {\n      const hasTag = rule.frontmatter.tags.some((t) =>\n        options.ruleTags!.includes(t.toLowerCase()),\n      );\n      if (!hasTag) continue;\n    }\n\n    // Skip inactive rules\n    if (rule.frontmatter.status !== 'active') continue;\n\n    const text = (rule.l0 + '\\n' + rule.body).toLowerCase();\n\n    // Extract forbidden actions from rules\n    const forbiddenPatterns = extractForbiddenActions(text);\n\n    for (const forbidden of forbiddenPatterns) {\n      // Check if the prompt contains the forbidden action keywords\n      const keywords = forbidden.split(/\\s+/).filter((w) => w.length > 3);\n      const matchCount = keywords.filter((k) => promptLower.includes(k)).length;\n\n      // Need at least 60% keyword match to flag\n      if (keywords.length > 0 && matchCount >= Math.ceil(keywords.length * 0.6)) {\n        return `Rule \"${rule.frontmatter.id}\" forbids: \"${forbidden}\" \u0014 prompt matches ${matchCount}/${keywords.length} keywords`;\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Extract forbidden actions from rule text.\n * Looks for \"never X\", \"don't X\", \"must not X\", \"avoid X\" patterns.\n */\nfunction extractForbiddenActions(text: string): string[] {\n  const actions: string[] = [];\n\n  const patterns = [\n    /never\\s+(.+?)(?:\\.|$)/gm,\n    /don'?t\\s+(.+?)(?:\\.|$)/gm,\n    /must not\\s+(.+?)(?:\\.|$)/gm,\n    /do not\\s+(.+?)(?:\\.|$)/gm,\n    /avoid\\s+(.+?)(?:\\.|$)/gm,\n    /prohibit(?:ed|s)?\\s+(.+?)(?:\\.|$)/gm,\n    /forbidden?:?\\s+(.+?)(?:\\.|$)/gm,\n  ];\n\n  for (const pattern of patterns) {\n    let match;\n    while ((match = pattern.exec(text)) !== null) {\n      const action = match[1].trim();\n      if (action.length > 3 && action.length < 200) {\n        actions.push(action);\n      }\n    }\n  }\n\n  return actions;\n}\n\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n// 3. Human-in-the-Loop Gates\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n\nexport interface ApprovalGateConfig {\n  /**\n   * Function that decides if a prompt requires human approval.\n   * Return true to require approval, false to proceed.\n   */\n  requireApproval?: (prompt: string) => boolean;\n\n  /**\n   * Called when approval is needed.\n   * Should return true if approved, false if rejected.\n   * For CLI: prompt user with readline.\n   * For API: send webhook and await response.\n   */\n  onApprovalNeeded?: (prompt: string) => Promise<boolean>;\n\n  /**\n   * Timeout in ms for approval (default: 300000 = 5 minutes).\n   * If timeout is reached, the run is rejected.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Create a simple CLI-based approval handler.\n * Prompts the user on stdin for approval.\n *\n * Usage:\n * ```typescript\n * createAgent({\n *   ...\n *   approval: {\n *     requireApproval: (prompt) => prompt.includes('deploy'),\n *     onApprovalNeeded: createCliApproval(),\n *   },\n * });\n * ```\n */\nexport function createCliApproval(options?: { timeoutMs?: number }): (prompt: string) => Promise<boolean> {\n  const timeoutMs = options?.timeoutMs ?? 300000;\n\n  return (prompt: string): Promise<boolean> => {\n    return new Promise((resolve) => {\n      const readline = require('readline') as typeof import('readline');\n      const rl = readline.createInterface({\n        input: process.stdin,\n        output: process.stdout,\n      });\n\n      const timer = setTimeout(() => {\n        log.warn('Approval timeout \u0014 rejecting');\n        rl.close();\n        resolve(false);\n      }, timeoutMs);\n\n      const preview = prompt.length > 100 ? prompt.slice(0, 100) + '...' : prompt;\n      rl.question(`\\n[APPROVAL REQUIRED] \"${preview}\"\\nApprove? (y/N): `, (answer) => {\n        clearTimeout(timer);\n        rl.close();\n        resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');\n      });\n    });\n  };\n}\n\n/**\n * Create a webhook-based approval handler.\n * Sends a POST to the webhook URL and awaits response.\n */\nexport function createWebhookApproval(options: {\n  url: string;\n  timeoutMs?: number;\n  headers?: Record<string, string>;\n}): (prompt: string) => Promise<boolean> {\n  const timeoutMs = options.timeoutMs ?? 300000;\n\n  return async (prompt: string): Promise<boolean> => {\n    try {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n      const response = await fetch(options.url, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...options.headers,\n        },\n        body: JSON.stringify({ prompt, timestamp: new Date().toISOString() }),\n        signal: controller.signal,\n      });\n\n      clearTimeout(timer);\n\n      if (!response.ok) {\n        log.warn(`Approval webhook returned ${response.status}`);\n        return false;\n      }\n\n      const body = await response.json() as { approved?: boolean };\n      return body.approved === true;\n    } catch (err) {\n      log.warn(`Approval webhook failed: ${err instanceof Error ? err.message : String(err)}`);\n      return false;\n    }\n  };\n}\n\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n// 4. Utility: Rule-based Action Guards\n// \u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\n\n/**\n * Check if a specific action is allowed by the harness rules.\n * Returns { allowed: true } or { allowed: false, reason: string }.\n *\n * This is a lightweight version of checkRuleViolation for use outside defineAgent.\n */\nexport function checkAction(\n  harnessDir: string,\n  action: string,\n  options?: { ruleTags?: string[] },\n): { allowed: boolean; reason: string | null } {\n  const violation = checkRuleViolation(harnessDir, action, options);\n  return {\n    allowed: violation === null,\n    reason: violation,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/analytics-RPT73WNM.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+import {
+  getSessionAnalytics,
+  getSessionsInRange
+} from "./chunk-GNUSHD2Y.js";
+import "./chunk-ZZJOFKAT.js";
+export {
+  getSessionAnalytics,
+  getSessionsInRange
+};
+//# sourceMappingURL=analytics-RPT73WNM.js.map

package/dist/analytics-RPT73WNM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/auto-processor-OLE45UI3.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import {
+  autoProcessAll,
+  autoProcessFile
+} from "./chunk-M7NXUK55.js";
+import "./chunk-4CWAGBNS.js";
+import "./chunk-ZZJOFKAT.js";
+export {
+  autoProcessAll,
+  autoProcessFile
+};
+//# sourceMappingURL=auto-processor-OLE45UI3.js.map

package/dist/auto-processor-OLE45UI3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-274RV3YO.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+
+import {
+  loadDirectoryWithErrors
+} from "./chunk-UPLBF4RZ.js";
+import {
+  getPrimitiveDirs
+} from "./chunk-4CWAGBNS.js";
+
+// src/runtime/graph.ts
+import { existsSync } from "fs";
+import { join, relative } from "path";
+function buildDependencyGraph(harnessDir, config) {
+  const dirs = getPrimitiveDirs(config);
+  const nodes = [];
+  const edges = [];
+  const nodeIds = /* @__PURE__ */ new Set();
+  for (const dir of dirs) {
+    const fullPath = join(harnessDir, dir);
+    if (!existsSync(fullPath)) continue;
+    const { docs } = loadDirectoryWithErrors(fullPath);
+    for (const doc of docs) {
+      const id = doc.frontmatter.id;
+      nodeIds.add(id);
+      nodes.push({
+        id,
+        directory: dir,
+        path: relative(harnessDir, doc.path),
+        tags: doc.frontmatter.tags,
+        status: doc.frontmatter.status,
+        l0: doc.l0
+      });
+    }
+  }
+  for (const dir of dirs) {
+    const fullPath = join(harnessDir, dir);
+    if (!existsSync(fullPath)) continue;
+    const { docs } = loadDirectoryWithErrors(fullPath);
+    for (const doc of docs) {
+      const fromId = doc.frontmatter.id;
+      for (const ref of doc.frontmatter.related) {
+        const targetId = resolveRef(ref, nodeIds, harnessDir);
+        if (targetId) {
+          edges.push({ from: fromId, to: targetId, type: "related" });
+        }
+      }
+      if (doc.frontmatter.with) {
+        const withRef = doc.frontmatter.with;
+        const targetId = resolveRef(withRef, nodeIds, harnessDir);
+        if (targetId) {
+          edges.push({ from: fromId, to: targetId, type: "with" });
+        }
+      }
+    }
+  }
+  const connected = /* @__PURE__ */ new Set();
+  for (const edge of edges) {
+    connected.add(edge.from);
+    connected.add(edge.to);
+  }
+  const orphans = nodes.filter((n) => !connected.has(n.id)).map((n) => n.id);
+  const clusters = findClusters(nodes, edges);
+  return { nodes, edges, orphans, clusters };
+}
+function resolveRef(ref, knownIds, harnessDir) {
+  if (knownIds.has(ref)) return ref;
+  if (ref.includes("/")) {
+    const parts = ref.split("/");
+    const filename = parts[parts.length - 1].replace(/\.md$/, "");
+    if (knownIds.has(filename)) return filename;
+    const withDir = parts.join("-");
+    if (knownIds.has(withDir)) return withDir;
+  }
+  return null;
+}
+function findClusters(nodes, edges) {
+  const parent = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    parent.set(node.id, node.id);
+  }
+  function find(id) {
+    let root = id;
+    while (parent.get(root) !== root) {
+      root = parent.get(root);
+    }
+    let current = id;
+    while (current !== root) {
+      const next = parent.get(current);
+      parent.set(current, root);
+      current = next;
+    }
+    return root;
+  }
+  function union(a, b) {
+    const rootA = find(a);
+    const rootB = find(b);
+    if (rootA !== rootB) {
+      parent.set(rootA, rootB);
+    }
+  }
+  for (const edge of edges) {
+    if (parent.has(edge.from) && parent.has(edge.to)) {
+      union(edge.from, edge.to);
+    }
+  }
+  const groups = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const root = find(node.id);
+    if (!groups.has(root)) {
+      groups.set(root, []);
+    }
+    groups.get(root).push(node.id);
+  }
+  return Array.from(groups.values()).filter((g) => g.length > 1).sort((a, b) => b.length - a.length);
+}
+function getGraphStats(harnessDir, config) {
+  const graph = buildDependencyGraph(harnessDir, config);
+  const connectionCount = /* @__PURE__ */ new Map();
+  for (const node of graph.nodes) {
+    connectionCount.set(node.id, 0);
+  }
+  for (const edge of graph.edges) {
+    connectionCount.set(edge.from, (connectionCount.get(edge.from) ?? 0) + 1);
+    connectionCount.set(edge.to, (connectionCount.get(edge.to) ?? 0) + 1);
+  }
+  const mostConnected = Array.from(connectionCount.entries()).filter(([, count]) => count > 0).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([id, connections]) => ({ id, connections }));
+  const brokenRefs = [];
+  const nodeIds = new Set(graph.nodes.map((n) => n.id));
+  for (const dir of getPrimitiveDirs(config)) {
+    const fullPath = join(harnessDir, dir);
+    if (!existsSync(fullPath)) continue;
+    const { docs } = loadDirectoryWithErrors(fullPath);
+    for (const doc of docs) {
+      for (const ref of doc.frontmatter.related) {
+        const resolved = resolveRef(ref, nodeIds, harnessDir);
+        if (!resolved) {
+          brokenRefs.push({ from: doc.frontmatter.id, ref });
+        }
+      }
+      if (doc.frontmatter.with) {
+        const resolved = resolveRef(doc.frontmatter.with, nodeIds, harnessDir);
+        if (!resolved) {
+          brokenRefs.push({ from: doc.frontmatter.id, ref: doc.frontmatter.with });
+        }
+      }
+    }
+  }
+  return {
+    totalNodes: graph.nodes.length,
+    totalEdges: graph.edges.length,
+    orphanCount: graph.orphans.length,
+    clusterCount: graph.clusters.length,
+    mostConnected,
+    brokenRefs
+  };
+}
+
+export {
+  buildDependencyGraph,
+  getGraphStats
+};
+//# sourceMappingURL=chunk-274RV3YO.js.map

package/dist/chunk-274RV3YO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/graph.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport { join, relative, dirname, basename } from 'path';\nimport { loadDirectoryWithErrors } from '../primitives/loader.js';\nimport { getPrimitiveDirs } from '../core/types.js';\nimport type { HarnessConfig, HarnessDocument } from '../core/types.js';\n\nexport interface GraphNode {\n  id: string;\n  directory: string;\n  path: string;\n  tags: string[];\n  status: string;\n  l0: string;\n}\n\nexport interface GraphEdge {\n  from: string;\n  to: string;\n  type: 'related' | 'with';\n}\n\nexport interface DependencyGraph {\n  nodes: GraphNode[];\n  edges: GraphEdge[];\n  orphans: string[];\n  clusters: string[][];\n}\n\nexport interface GraphStats {\n  totalNodes: number;\n  totalEdges: number;\n  orphanCount: number;\n  clusterCount: number;\n  mostConnected: Array<{ id: string; connections: number }>;\n  brokenRefs: Array<{ from: string; ref: string }>;\n}\n\n/**\n * Build a dependency graph from all primitives in the harness.\n * Analyzes `related:` and `with:` frontmatter fields to create edges.\n */\nexport function buildDependencyGraph(harnessDir: string, config?: HarnessConfig): DependencyGraph {\n  const dirs = getPrimitiveDirs(config);\n  const nodes: GraphNode[] = [];\n  const edges: GraphEdge[] = [];\n  const nodeIds = new Set<string>();\n\n  // Load all primitives\n  for (const dir of dirs) {\n    const fullPath = join(harnessDir, dir);\n    if (!existsSync(fullPath)) continue;\n\n    const { docs } = loadDirectoryWithErrors(fullPath);\n    for (const doc of docs) {\n      const id = doc.frontmatter.id;\n      nodeIds.add(id);\n      nodes.push({\n        id,\n        directory: dir,\n        path: relative(harnessDir, doc.path),\n        tags: doc.frontmatter.tags,\n        status: doc.frontmatter.status,\n        l0: doc.l0,\n      });\n    }\n  }\n\n  // Build edges from related: and with: fields\n  for (const dir of dirs) {\n    const fullPath = join(harnessDir, dir);\n    if (!existsSync(fullPath)) continue;\n\n    const { docs } = loadDirectoryWithErrors(fullPath);\n    for (const doc of docs) {\n      const fromId = doc.frontmatter.id;\n\n      // related: field edges\n      for (const ref of doc.frontmatter.related) {\n        const targetId = resolveRef(ref, nodeIds, harnessDir);\n        if (targetId) {\n          edges.push({ from: fromId, to: targetId, type: 'related' });\n        }\n      }\n\n      // with: field edges (agent delegation reference)\n      if (doc.frontmatter.with) {\n        const withRef = doc.frontmatter.with;\n        const targetId = resolveRef(withRef, nodeIds, harnessDir);\n        if (targetId) {\n          edges.push({ from: fromId, to: targetId, type: 'with' });\n        }\n      }\n    }\n  }\n\n  // Find orphans (nodes with no edges in or out)\n  const connected = new Set<string>();\n  for (const edge of edges) {\n    connected.add(edge.from);\n    connected.add(edge.to);\n  }\n  const orphans = nodes\n    .filter((n) => !connected.has(n.id))\n    .map((n) => n.id);\n\n  // Find clusters (connected components)\n  const clusters = findClusters(nodes, edges);\n\n  return { nodes, edges, orphans, clusters };\n}\n\n/**\n * Resolve a reference to a node ID. Handles:\n * - Direct ID match (e.g., \"tool-github\")\n * - Path-style refs (e.g., \"skills/code-review\" or \"agents/reviewer\")\n */\nfunction resolveRef(ref: string, knownIds: Set<string>, harnessDir: string): string | null {\n  // Direct ID match\n  if (knownIds.has(ref)) return ref;\n\n  // Path-style ref: extract the filename part as potential ID\n  if (ref.includes('/')) {\n    const parts = ref.split('/');\n    const filename = parts[parts.length - 1].replace(/\\.md$/, '');\n    if (knownIds.has(filename)) return filename;\n\n    // Try with directory prefix as part of ID\n    const withDir = parts.join('-');\n    if (knownIds.has(withDir)) return withDir;\n  }\n\n  return null;\n}\n\n/**\n * Find connected components using union-find.\n */\nfunction findClusters(nodes: GraphNode[], edges: GraphEdge[]): string[][] {\n  const parent = new Map<string, string>();\n\n  for (const node of nodes) {\n    parent.set(node.id, node.id);\n  }\n\n  function find(id: string): string {\n    let root = id;\n    while (parent.get(root) !== root) {\n      root = parent.get(root)!;\n    }\n    // Path compression\n    let current = id;\n    while (current !== root) {\n      const next = parent.get(current)!;\n      parent.set(current, root);\n      current = next;\n    }\n    return root;\n  }\n\n  function union(a: string, b: string): void {\n    const rootA = find(a);\n    const rootB = find(b);\n    if (rootA !== rootB) {\n      parent.set(rootA, rootB);\n    }\n  }\n\n  for (const edge of edges) {\n    if (parent.has(edge.from) && parent.has(edge.to)) {\n      union(edge.from, edge.to);\n    }\n  }\n\n  // Group by root\n  const groups = new Map<string, string[]>();\n  for (const node of nodes) {\n    const root = find(node.id);\n    if (!groups.has(root)) {\n      groups.set(root, []);\n    }\n    groups.get(root)!.push(node.id);\n  }\n\n  // Return only clusters with more than 1 member (singletons are orphans)\n  return Array.from(groups.values())\n    .filter((g) => g.length > 1)\n    .sort((a, b) => b.length - a.length);\n}\n\n/**\n * Get statistics about the dependency graph.\n */\nexport function getGraphStats(harnessDir: string, config?: HarnessConfig): GraphStats {\n  const graph = buildDependencyGraph(harnessDir, config);\n\n  // Count connections per node\n  const connectionCount = new Map<string, number>();\n  for (const node of graph.nodes) {\n    connectionCount.set(node.id, 0);\n  }\n  for (const edge of graph.edges) {\n    connectionCount.set(edge.from, (connectionCount.get(edge.from) ?? 0) + 1);\n    connectionCount.set(edge.to, (connectionCount.get(edge.to) ?? 0) + 1);\n  }\n\n  const mostConnected = Array.from(connectionCount.entries())\n    .filter(([, count]) => count > 0)\n    .sort((a, b) => b[1] - a[1])\n    .slice(0, 5)\n    .map(([id, connections]) => ({ id, connections }));\n\n  // Find broken references (references that didn't resolve to known IDs)\n  const brokenRefs: Array<{ from: string; ref: string }> = [];\n  const nodeIds = new Set(graph.nodes.map((n) => n.id));\n\n  for (const dir of getPrimitiveDirs(config)) {\n    const fullPath = join(harnessDir, dir);\n    if (!existsSync(fullPath)) continue;\n\n    const { docs } = loadDirectoryWithErrors(fullPath);\n    for (const doc of docs) {\n      for (const ref of doc.frontmatter.related) {\n        const resolved = resolveRef(ref, nodeIds, harnessDir);\n        if (!resolved) {\n          brokenRefs.push({ from: doc.frontmatter.id, ref });\n        }\n      }\n      if (doc.frontmatter.with) {\n        const resolved = resolveRef(doc.frontmatter.with, nodeIds, harnessDir);\n        if (!resolved) {\n          brokenRefs.push({ from: doc.frontmatter.id, ref: doc.frontmatter.with });\n        }\n      }\n    }\n  }\n\n  return {\n    totalNodes: graph.nodes.length,\n    totalEdges: graph.edges.length,\n    orphanCount: graph.orphans.length,\n    clusterCount: graph.clusters.length,\n    mostConnected,\n    brokenRefs,\n  };\n}\n"],"mappings":"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","names":[]}