@agntk/agent-harness 0.1.1

package/dist/chunk-YUFNYN2H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/delegate.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { loadDirectory, estimateTokens, getAtLevel } from '../primitives/loader.js';\nimport { loadConfig } from '../core/config.js';\nimport { log } from '../core/logger.js';\nimport { getModel, generate, streamGenerateWithDetails } from '../llm/provider.js';\nimport { buildToolSet, type AIToolSet } from './tool-executor.js';\nimport { createSessionId, writeSession, type SessionRecord } from './sessions.js';\nimport type { HarnessDocument, HarnessConfig } from '../core/types.js';\n\n// --- Types ---\n\nexport interface DelegationResult {\n  agentId: string;\n  text: string;\n  usage: { inputTokens: number; outputTokens: number; totalTokens: number };\n  sessionId: string;\n}\n\nexport interface AgentInfo {\n  id: string;\n  l0: string;\n  l1: string;\n  path: string;\n  tags: string[];\n  status: string;\n}\n\n// --- Agent Discovery ---\n\n/**\n * Load all agent documents from the agents/ directory.\n */\nexport function loadAgentDocs(harnessDir: string): HarnessDocument[] {\n  return loadDirectory(join(harnessDir, 'agents'));\n}\n\n/**\n * Find an agent document by its frontmatter id.\n * Falls back to filename match if id doesn't match.\n */\nexport function findAgent(harnessDir: string, agentId: string): HarnessDocument | undefined {\n  const agents = loadAgentDocs(harnessDir);\n\n  // Exact id match\n  const byId = agents.find((a) => a.frontmatter.id === agentId);\n  if (byId) return byId;\n\n  // Try with \"agent-\" prefix\n  const prefixed = agents.find((a) => a.frontmatter.id === `agent-${agentId}`);\n  if (prefixed) return prefixed;\n\n  // Filename match (e.g., \"evaluator\" matches \"evaluator.md\")\n  const byFilename = agents.find((a) => {\n    const filename = a.path.split('/').pop()?.replace('.md', '') || '';\n    return filename === agentId || filename === `agent-${agentId}`;\n  });\n\n  return byFilename;\n}\n\n/**\n * List all available agents with summary info.\n */\nexport function listAgents(harnessDir: string): AgentInfo[] {\n  return loadAgentDocs(harnessDir).map((doc) => ({\n    id: doc.frontmatter.id,\n    l0: doc.l0,\n    l1: doc.l1,\n    path: doc.path,\n    tags: doc.frontmatter.tags,\n    status: doc.frontmatter.status,\n  }));\n}\n\n// --- System Prompt Assembly ---\n\n/**\n * Build a minimal system prompt for a delegated agent.\n * Sub-agents are stateless — they get:\n * 1. The agent's own body (L2) as primary instructions\n * 2. CORE.md identity (so they know who they serve)\n * 3. Active rules (at L1 level — compressed for efficiency)\n */\nexport function buildAgentPrompt(harnessDir: string, agentDoc: HarnessDocument, config: HarnessConfig): string {\n  const sections: string[] = [];\n  const maxTokens = config.model.max_tokens;\n  const targetBudget = maxTokens * 0.10; // Sub-agents get 10% context budget\n  let usedTokens = 0;\n\n  // 1. Agent identity and instructions (always full L2)\n  const agentBody = agentDoc.body;\n  sections.push(`# AGENT: ${agentDoc.frontmatter.id}\\n\\n${agentBody}`);\n  usedTokens += estimateTokens(agentBody);\n\n  // 2. Primary agent identity from CORE.md (brief context)\n  const corePath = join(harnessDir, 'CORE.md');\n  if (existsSync(corePath)) {\n    const core = readFileSync(corePath, 'utf-8');\n    const coreTokens = estimateTokens(core);\n    if (usedTokens + coreTokens <= targetBudget) {\n      sections.push(`# PRIMARY AGENT CONTEXT\\n\\n${core}`);\n      usedTokens += coreTokens;\n    }\n  }\n\n  // 3. Rules (at appropriate disclosure level based on remaining budget)\n  const rulesDir = join(harnessDir, 'rules');\n  if (existsSync(rulesDir)) {\n    const rules = loadDirectory(rulesDir);\n    if (rules.length > 0) {\n      const ruleDocs: string[] = [];\n      for (const rule of rules) {\n        // Estimate how much room is left\n        const remaining = targetBudget - usedTokens;\n        if (remaining < 50) break;\n\n        // Try L1 first, fall back to L0\n        let level: 0 | 1 | 2 = 1;\n        let content = getAtLevel(rule, level);\n        let tokens = estimateTokens(content);\n\n        if (usedTokens + tokens > targetBudget) {\n          level = 0;\n          content = getAtLevel(rule, 0);\n          tokens = estimateTokens(content);\n        }\n\n        if (usedTokens + tokens <= targetBudget) {\n          ruleDocs.push(`### ${rule.frontmatter.id}\\n${content}`);\n          usedTokens += tokens;\n        }\n      }\n      if (ruleDocs.length > 0) {\n        sections.push(`# RULES\\n\\n${ruleDocs.join('\\n\\n')}`);\n      }\n    }\n  }\n\n  return sections.join('\\n\\n---\\n\\n');\n}\n\n// --- Delegation ---\n\nexport interface DelegateOptions {\n  harnessDir: string;\n  agentId: string;\n  prompt: string;\n  apiKey?: string;\n  modelOverride?: string;\n}\n\nfunction prepareDelegation(opts: DelegateOptions) {\n  const { harnessDir, agentId, apiKey } = opts;\n\n  if (!agentId || !agentId.trim()) {\n    throw new Error('agentId is required');\n  }\n  if (!opts.prompt || !opts.prompt.trim()) {\n    throw new Error('prompt cannot be empty');\n  }\n\n  const agentDoc = findAgent(harnessDir, agentId);\n  if (!agentDoc) {\n    const available = listAgents(harnessDir);\n    const agentList = available.length > 0\n      ? available.map((a) => `  - ${a.id}: ${a.l0}`).join('\\n')\n      : '  (none)';\n    throw new Error(\n      `Agent \"${agentId}\" not found.\\n\\nAvailable agents:\\n${agentList}`\n    );\n  }\n\n  const config = loadConfig(harnessDir, opts.modelOverride\n    ? { model: { id: opts.modelOverride } }\n    : undefined);\n\n  const systemPrompt = buildAgentPrompt(harnessDir, agentDoc, config);\n  const model = getModel(config, apiKey);\n\n  // Load tools from the harness so sub-agents can use them\n  const toolSet = buildToolSet(harnessDir);\n  const hasTools = Object.keys(toolSet).length > 0;\n\n  return { agentDoc, config, systemPrompt, model, toolSet, hasTools };\n}\n\n/**\n * Delegate a prompt to a sub-agent.\n * Sub-agents are stateless single-turn executors. They:\n * - Receive their own body as system prompt + rules + CORE.md\n * - Execute a single prompt\n * - Record a session (tagged with the agent id)\n * - Return the result\n *\n * They do NOT have persistent state, memory, or learning.\n */\nexport async function delegateTo(opts: DelegateOptions): Promise<DelegationResult> {\n  const { harnessDir, prompt } = opts;\n  const { agentDoc, config, systemPrompt, model, toolSet, hasTools } = prepareDelegation(opts);\n\n  const sessionId = createSessionId();\n  const started = new Date().toISOString();\n\n  const result = await generate({\n    model,\n    system: systemPrompt,\n    prompt,\n    maxRetries: config.model.max_retries,\n    timeoutMs: config.model.timeout_ms,\n    ...(hasTools ? { tools: toolSet, maxToolSteps: 5 } : {}),\n  });\n\n  const ended = new Date().toISOString();\n\n  const session: SessionRecord = {\n    id: sessionId,\n    started,\n    ended,\n    prompt,\n    summary: result.text.slice(0, 200),\n    tokens_used: result.usage.totalTokens,\n    model_id: config.model.id,\n    delegated_to: agentDoc.frontmatter.id,\n    steps: result.steps,\n    tool_calls: result.toolCalls.length > 0 ? result.toolCalls : undefined,\n  };\n\n  try {\n    writeSession(harnessDir, session);\n  } catch (err) {\n    log.warn(`Failed to write delegation session ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);\n  }\n\n  return {\n    agentId: agentDoc.frontmatter.id,\n    text: result.text,\n    usage: result.usage,\n    sessionId,\n  };\n}\n\nexport interface DelegateStreamResult {\n  agentId: string;\n  sessionId: string;\n  textStream: AsyncIterable<string>;\n}\n\n/**\n * Stream-delegate a prompt to a sub-agent.\n * Returns an async iterable of text chunks. Session is recorded after\n * the stream is fully consumed.\n */\nexport function delegateStream(opts: DelegateOptions): DelegateStreamResult {\n  const { harnessDir, prompt } = opts;\n\n  // prepareDelegation() is called eagerly so callers get immediate errors\n  // (e.g., agent not found) before consuming the stream.\n  const { agentDoc, config, systemPrompt, model, toolSet, hasTools } = prepareDelegation(opts);\n\n  const sessionId = createSessionId();\n  const started = new Date().toISOString();\n\n  const result = streamGenerateWithDetails({\n    model,\n    system: systemPrompt,\n    prompt,\n    maxRetries: config.model.max_retries,\n    timeoutMs: config.model.timeout_ms,\n    ...(hasTools ? { tools: toolSet, maxToolSteps: 5 } : {}),\n  });\n\n  async function* wrappedStream(): AsyncIterable<string> {\n    let fullText = '';\n    try {\n      for await (const chunk of result.textStream) {\n        fullText += chunk;\n        yield chunk;\n      }\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      log.warn(`Delegation stream error for agent \"${agentDoc.frontmatter.id}\": ${error.message}`);\n      throw error;\n    }\n\n    // Await post-stream metadata — wrapped so failures don't crash the generator\n    let usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };\n    let steps = 1;\n    let toolCalls: Array<{ toolName: string; args: Record<string, unknown>; result: unknown }> = [];\n    try {\n      [usage, steps, toolCalls] = await Promise.all([\n        result.usage,\n        result.steps,\n        result.toolCalls,\n      ]);\n    } catch (err) {\n      log.warn(`Failed to resolve delegation post-stream metadata: ${err instanceof Error ? err.message : String(err)}`);\n    }\n\n    const ended = new Date().toISOString();\n\n    const session: SessionRecord = {\n      id: sessionId,\n      started,\n      ended,\n      prompt,\n      summary: fullText.slice(0, 200),\n      tokens_used: usage.totalTokens,\n      model_id: config.model.id,\n      delegated_to: agentDoc.frontmatter.id,\n      steps,\n      tool_calls: toolCalls.length > 0 ? toolCalls : undefined,\n    };\n\n    try {\n      writeSession(harnessDir, session);\n    } catch (err) {\n      log.warn(`Failed to write delegation session ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  return {\n    agentId: agentDoc.frontmatter.id,\n    sessionId,\n    textStream: wrappedStream(),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-Z2PUCXTZ.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+
+// src/runtime/file-lock.ts
+import { writeFileSync, unlinkSync, readFileSync, existsSync, mkdirSync } from "fs";
+import { join, basename } from "path";
+var DEFAULT_STALE_MS = 3e4;
+function getLockDir(harnessDir) {
+  return join(harnessDir, "memory");
+}
+function getLockPath(harnessDir, filePath) {
+  const lockDir = getLockDir(harnessDir);
+  const lockName = basename(filePath).replace(/\.[^.]+$/, "") + ".lock";
+  return join(lockDir, lockName);
+}
+function readLockInfo(lockPath) {
+  if (!existsSync(lockPath)) return null;
+  try {
+    const content = readFileSync(lockPath, "utf-8");
+    const parsed = JSON.parse(content);
+    if (typeof parsed === "object" && parsed !== null && "pid" in parsed && "acquired" in parsed) {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function isStale(info, staleMs) {
+  const age = Date.now() - new Date(info.acquired).getTime();
+  if (age > staleMs) return true;
+  try {
+    process.kill(info.pid, 0);
+    return false;
+  } catch {
+    return true;
+  }
+}
+function tryLock(harnessDir, filePath, options) {
+  const staleMs = options?.staleMs ?? DEFAULT_STALE_MS;
+  const lockPath = getLockPath(harnessDir, filePath);
+  const lockDir = getLockDir(harnessDir);
+  if (!existsSync(lockDir)) {
+    mkdirSync(lockDir, { recursive: true });
+  }
+  const existing = readLockInfo(lockPath);
+  if (existing) {
+    if (isStale(existing, staleMs)) {
+      try {
+        unlinkSync(lockPath);
+      } catch {
+      }
+    } else {
+      return false;
+    }
+  }
+  const info = {
+    pid: process.pid,
+    acquired: (/* @__PURE__ */ new Date()).toISOString(),
+    file: filePath
+  };
+  try {
+    writeFileSync(lockPath, JSON.stringify(info), { flag: "wx" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function releaseLock(harnessDir, filePath) {
+  const lockPath = getLockPath(harnessDir, filePath);
+  if (!existsSync(lockPath)) return;
+  const info = readLockInfo(lockPath);
+  if (info && info.pid === process.pid) {
+    try {
+      unlinkSync(lockPath);
+    } catch {
+    }
+  }
+}
+function withFileLockSync(harnessDir, filePath, fn, options) {
+  const acquired = tryLock(harnessDir, filePath, options);
+  try {
+    return fn();
+  } finally {
+    if (acquired) {
+      releaseLock(harnessDir, filePath);
+    }
+  }
+}
+
+export {
+  withFileLockSync
+};
+//# sourceMappingURL=chunk-Z2PUCXTZ.js.map

package/dist/chunk-Z2PUCXTZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/file-lock.ts"],"sourcesContent":["import { writeFileSync, unlinkSync, readFileSync, existsSync, mkdirSync } from 'fs';\nimport { join, basename } from 'path';\n\nexport interface LockInfo {\n  pid: number;\n  acquired: string;\n  file: string;\n}\n\nexport interface LockOptions {\n  /** Stale lock timeout in ms (default: 30000 = 30s) */\n  staleMs?: number;\n  /** How often to retry in ms (default: 50) */\n  retryIntervalMs?: number;\n  /** Max time to wait for lock in ms (default: 5000 = 5s) */\n  waitMs?: number;\n}\n\nconst DEFAULT_STALE_MS = 30000;\nconst DEFAULT_RETRY_MS = 50;\nconst DEFAULT_WAIT_MS = 5000;\n\nfunction getLockDir(harnessDir: string): string {\n  return join(harnessDir, 'memory');\n}\n\nfunction getLockPath(harnessDir: string, filePath: string): string {\n  const lockDir = getLockDir(harnessDir);\n  const lockName = basename(filePath).replace(/\\.[^.]+$/, '') + '.lock';\n  return join(lockDir, lockName);\n}\n\n/**\n * Read lock info from a lock file. Returns null if missing or corrupt.\n */\nfunction readLockInfo(lockPath: string): LockInfo | null {\n  if (!existsSync(lockPath)) return null;\n  try {\n    const content = readFileSync(lockPath, 'utf-8');\n    const parsed: unknown = JSON.parse(content);\n    if (\n      typeof parsed === 'object' &&\n      parsed !== null &&\n      'pid' in parsed &&\n      'acquired' in parsed\n    ) {\n      return parsed as LockInfo;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check if a lock is stale (older than staleMs or held by dead process).\n */\nfunction isStale(info: LockInfo, staleMs: number): boolean {\n  const age = Date.now() - new Date(info.acquired).getTime();\n  if (age > staleMs) return true;\n\n  // Check if the process that holds the lock is still alive\n  try {\n    process.kill(info.pid, 0);\n    return false; // Process exists\n  } catch {\n    return true; // Process is dead\n  }\n}\n\n/**\n * Try to acquire a file lock. Non-blocking — returns immediately.\n * Returns true if lock was acquired, false if already held.\n */\nexport function tryLock(harnessDir: string, filePath: string, options?: LockOptions): boolean {\n  const staleMs = options?.staleMs ?? DEFAULT_STALE_MS;\n  const lockPath = getLockPath(harnessDir, filePath);\n\n  // Ensure lock directory exists\n  const lockDir = getLockDir(harnessDir);\n  if (!existsSync(lockDir)) {\n    mkdirSync(lockDir, { recursive: true });\n  }\n\n  // Check existing lock\n  const existing = readLockInfo(lockPath);\n  if (existing) {\n    if (isStale(existing, staleMs)) {\n      // Stale lock — remove it\n      try {\n        unlinkSync(lockPath);\n      } catch {\n        // Another process may have already cleaned it up\n      }\n    } else {\n      // Lock is valid and held by another process\n      return false;\n    }\n  }\n\n  // Write our lock file\n  const info: LockInfo = {\n    pid: process.pid,\n    acquired: new Date().toISOString(),\n    file: filePath,\n  };\n\n  try {\n    // Use wx flag — fails if file already exists (atomic-ish on most systems)\n    writeFileSync(lockPath, JSON.stringify(info), { flag: 'wx' });\n    return true;\n  } catch {\n    // Another process got the lock between our check and write\n    return false;\n  }\n}\n\n/**\n * Release a file lock. Safe to call even if we don't hold it.\n */\nexport function releaseLock(harnessDir: string, filePath: string): void {\n  const lockPath = getLockPath(harnessDir, filePath);\n\n  if (!existsSync(lockPath)) return;\n\n  // Only release if we own it\n  const info = readLockInfo(lockPath);\n  if (info && info.pid === process.pid) {\n    try {\n      unlinkSync(lockPath);\n    } catch {\n      // Already cleaned up\n    }\n  }\n}\n\n/**\n * Wait to acquire a file lock with timeout.\n * Polls at retryIntervalMs until lock is acquired or waitMs expires.\n */\nexport async function acquireLock(\n  harnessDir: string,\n  filePath: string,\n  options?: LockOptions,\n): Promise<boolean> {\n  const retryMs = options?.retryIntervalMs ?? DEFAULT_RETRY_MS;\n  const waitMs = options?.waitMs ?? DEFAULT_WAIT_MS;\n  const deadline = Date.now() + waitMs;\n\n  while (Date.now() < deadline) {\n    if (tryLock(harnessDir, filePath, options)) {\n      return true;\n    }\n    await new Promise((resolve) => setTimeout(resolve, retryMs));\n  }\n\n  return false;\n}\n\n/**\n * Execute a function while holding a file lock.\n * Acquires lock, runs fn, releases lock (even on error).\n * If lock cannot be acquired within waitMs, runs fn anyway (fail-open).\n */\nexport async function withFileLock<T>(\n  harnessDir: string,\n  filePath: string,\n  fn: () => T | Promise<T>,\n  options?: LockOptions,\n): Promise<T> {\n  const acquired = await acquireLock(harnessDir, filePath, options);\n\n  try {\n    return await fn();\n  } finally {\n    if (acquired) {\n      releaseLock(harnessDir, filePath);\n    }\n  }\n}\n\n/**\n * Synchronous version of withFileLock for use in sync code paths.\n * Tries lock once — if fails, proceeds anyway (fail-open).\n */\nexport function withFileLockSync<T>(\n  harnessDir: string,\n  filePath: string,\n  fn: () => T,\n  options?: LockOptions,\n): T {\n  const acquired = tryLock(harnessDir, filePath, options);\n\n  try {\n    return fn();\n  } finally {\n    if (acquired) {\n      releaseLock(harnessDir, filePath);\n    }\n  }\n}\n\n/**\n * Check if a file is currently locked (by any process).\n */\nexport function isLocked(harnessDir: string, filePath: string, options?: LockOptions): boolean {\n  const staleMs = options?.staleMs ?? DEFAULT_STALE_MS;\n  const lockPath = getLockPath(harnessDir, filePath);\n  const info = readLockInfo(lockPath);\n  if (!info) return false;\n  return !isStale(info, staleMs);\n}\n\n/**\n * Force-remove a lock regardless of who owns it.\n * Use only for manual cleanup via CLI.\n */\nexport function breakLock(harnessDir: string, filePath: string): boolean {\n  const lockPath = getLockPath(harnessDir, filePath);\n  if (!existsSync(lockPath)) return false;\n  try {\n    unlinkSync(lockPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;AAAA,SAAS,eAAe,YAAY,cAAc,YAAY,iBAAiB;AAC/E,SAAS,MAAM,gBAAgB;AAiB/B,IAAM,mBAAmB;AAIzB,SAAS,WAAW,YAA4B;AAC9C,SAAO,KAAK,YAAY,QAAQ;AAClC;AAEA,SAAS,YAAY,YAAoB,UAA0B;AACjE,QAAM,UAAU,WAAW,UAAU;AACrC,QAAM,WAAW,SAAS,QAAQ,EAAE,QAAQ,YAAY,EAAE,IAAI;AAC9D,SAAO,KAAK,SAAS,QAAQ;AAC/B;AAKA,SAAS,aAAa,UAAmC;AACvD,MAAI,CAAC,WAAW,QAAQ,EAAG,QAAO;AAClC,MAAI;AACF,UAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,UAAM,SAAkB,KAAK,MAAM,OAAO;AAC1C,QACE,OAAO,WAAW,YAClB,WAAW,QACX,SAAS,UACT,cAAc,QACd;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,SAAS,QAAQ,MAAgB,SAA0B;AACzD,QAAM,MAAM,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,QAAQ,EAAE,QAAQ;AACzD,MAAI,MAAM,QAAS,QAAO;AAG1B,MAAI;AACF,YAAQ,KAAK,KAAK,KAAK,CAAC;AACxB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMO,SAAS,QAAQ,YAAoB,UAAkB,SAAgC;AAC5F,QAAM,UAAU,SAAS,WAAW;AACpC,QAAM,WAAW,YAAY,YAAY,QAAQ;AAGjD,QAAM,UAAU,WAAW,UAAU;AACrC,MAAI,CAAC,WAAW,OAAO,GAAG;AACxB,cAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA,EACxC;AAGA,QAAM,WAAW,aAAa,QAAQ;AACtC,MAAI,UAAU;AACZ,QAAI,QAAQ,UAAU,OAAO,GAAG;AAE9B,UAAI;AACF,mBAAW,QAAQ;AAAA,MACrB,QAAQ;AAAA,MAER;AAAA,IACF,OAAO;AAEL,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,OAAiB;AAAA,IACrB,KAAK,QAAQ;AAAA,IACb,WAAU,oBAAI,KAAK,GAAE,YAAY;AAAA,IACjC,MAAM;AAAA,EACR;AAEA,MAAI;AAEF,kBAAc,UAAU,KAAK,UAAU,IAAI,GAAG,EAAE,MAAM,KAAK,CAAC;AAC5D,WAAO;AAAA,EACT,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,YAAY,YAAoB,UAAwB;AACtE,QAAM,WAAW,YAAY,YAAY,QAAQ;AAEjD,MAAI,CAAC,WAAW,QAAQ,EAAG;AAG3B,QAAM,OAAO,aAAa,QAAQ;AAClC,MAAI,QAAQ,KAAK,QAAQ,QAAQ,KAAK;AACpC,QAAI;AACF,iBAAW,QAAQ;AAAA,IACrB,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAmDO,SAAS,iBACd,YACA,UACA,IACA,SACG;AACH,QAAM,WAAW,QAAQ,YAAY,UAAU,OAAO;AAEtD,MAAI;AACF,WAAO,GAAG;AAAA,EACZ,UAAE;AACA,QAAI,UAAU;AACZ,kBAAY,YAAY,QAAQ;AAAA,IAClC;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-ZZJOFKAT.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};
+//# sourceMappingURL=chunk-ZZJOFKAT.js.map

package/dist/chunk-ZZJOFKAT.js.map

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