@agntk/agent-harness 0.1.1

package/dist/chunk-TAT6JU3X.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+
+import {
+  getSpending
+} from "./chunk-JKMGYWXB.js";
+
+// src/runtime/health.ts
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+var HEALTH_FILE = "health.json";
+function getHealthPath(harnessDir) {
+  return join(harnessDir, "memory", HEALTH_FILE);
+}
+function defaultMetrics() {
+  return {
+    lastSuccessfulRun: null,
+    lastFailedRun: null,
+    lastError: null,
+    consecutiveFailures: 0,
+    totalRuns: 0,
+    totalSuccesses: 0,
+    totalFailures: 0,
+    bootedAt: null,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function loadHealth(harnessDir) {
+  const healthPath = getHealthPath(harnessDir);
+  if (!existsSync(healthPath)) {
+    return defaultMetrics();
+  }
+  try {
+    const content = readFileSync(healthPath, "utf-8");
+    const parsed = JSON.parse(content);
+    if (typeof parsed === "object" && parsed !== null && "totalRuns" in parsed) {
+      return parsed;
+    }
+    return defaultMetrics();
+  } catch {
+    return defaultMetrics();
+  }
+}
+function saveHealth(harnessDir, metrics) {
+  const memoryDir = join(harnessDir, "memory");
+  if (!existsSync(memoryDir)) {
+    mkdirSync(memoryDir, { recursive: true });
+  }
+  metrics.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  writeFileSync(getHealthPath(harnessDir), JSON.stringify(metrics, null, 2), "utf-8");
+}
+function recordSuccess(harnessDir) {
+  const metrics = loadHealth(harnessDir);
+  metrics.totalRuns++;
+  metrics.totalSuccesses++;
+  metrics.consecutiveFailures = 0;
+  metrics.lastSuccessfulRun = (/* @__PURE__ */ new Date()).toISOString();
+  saveHealth(harnessDir, metrics);
+}
+function recordFailure(harnessDir, error) {
+  const metrics = loadHealth(harnessDir);
+  metrics.totalRuns++;
+  metrics.totalFailures++;
+  metrics.consecutiveFailures++;
+  metrics.lastFailedRun = (/* @__PURE__ */ new Date()).toISOString();
+  metrics.lastError = error ?? null;
+  saveHealth(harnessDir, metrics);
+}
+function recordBoot(harnessDir) {
+  const metrics = loadHealth(harnessDir);
+  metrics.bootedAt = (/* @__PURE__ */ new Date()).toISOString();
+  saveHealth(harnessDir, metrics);
+}
+function getHealthStatus(harnessDir) {
+  const metrics = loadHealth(harnessDir);
+  const checks = [];
+  const requiredFiles = ["CORE.md", "config.yaml", "state.md"];
+  const missingFiles = requiredFiles.filter((f) => !existsSync(join(harnessDir, f)));
+  if (missingFiles.length === 0) {
+    checks.push({ name: "core-files", status: "pass", message: "All core files present" });
+  } else {
+    checks.push({ name: "core-files", status: "fail", message: `Missing: ${missingFiles.join(", ")}` });
+  }
+  const memoryDir = join(harnessDir, "memory");
+  if (existsSync(memoryDir)) {
+    checks.push({ name: "memory-dir", status: "pass", message: "Memory directory exists" });
+  } else {
+    checks.push({ name: "memory-dir", status: "fail", message: "Memory directory missing" });
+  }
+  const apiKeys = [
+    { name: "OpenRouter", envVar: "OPENROUTER_API_KEY" },
+    { name: "Anthropic", envVar: "ANTHROPIC_API_KEY" },
+    { name: "OpenAI", envVar: "OPENAI_API_KEY" }
+  ];
+  const presentKeys = apiKeys.filter((k) => process.env[k.envVar]);
+  if (presentKeys.length > 0) {
+    checks.push({
+      name: "api-keys",
+      status: "pass",
+      message: `API keys: ${presentKeys.map((k) => k.name).join(", ")}`
+    });
+  } else {
+    checks.push({ name: "api-keys", status: "warn", message: "No API keys found in environment" });
+  }
+  if (metrics.consecutiveFailures === 0) {
+    checks.push({ name: "run-health", status: "pass", message: "No consecutive failures" });
+  } else if (metrics.consecutiveFailures < 3) {
+    checks.push({
+      name: "run-health",
+      status: "warn",
+      message: `${metrics.consecutiveFailures} consecutive failure(s)`
+    });
+  } else {
+    checks.push({
+      name: "run-health",
+      status: "fail",
+      message: `${metrics.consecutiveFailures} consecutive failures \u2014 last error: ${metrics.lastError ?? "unknown"}`
+    });
+  }
+  if (metrics.lastSuccessfulRun) {
+    const hoursSinceSuccess = (Date.now() - new Date(metrics.lastSuccessfulRun).getTime()) / 36e5;
+    if (hoursSinceSuccess < 24) {
+      checks.push({ name: "last-success", status: "pass", message: `Last success: ${metrics.lastSuccessfulRun}` });
+    } else {
+      checks.push({
+        name: "last-success",
+        status: "warn",
+        message: `Last success was ${Math.round(hoursSinceSuccess)}h ago`
+      });
+    }
+  } else if (metrics.totalRuns > 0) {
+    checks.push({ name: "last-success", status: "warn", message: "No successful runs recorded" });
+  }
+  let costToday = 0;
+  let costThisMonth = 0;
+  try {
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const monthStart = `${(/* @__PURE__ */ new Date()).getFullYear()}-${String((/* @__PURE__ */ new Date()).getMonth() + 1).padStart(2, "0")}-01`;
+    costToday = getSpending(harnessDir, today).total_cost_usd;
+    costThisMonth = getSpending(harnessDir, monthStart).total_cost_usd;
+  } catch {
+  }
+  const failCount = checks.filter((c) => c.status === "fail").length;
+  const warnCount = checks.filter((c) => c.status === "warn").length;
+  let status;
+  if (failCount > 0) {
+    status = "unhealthy";
+  } else if (warnCount > 0) {
+    status = "degraded";
+  } else {
+    status = "healthy";
+  }
+  return { status, checks, metrics, costToday, costThisMonth };
+}
+function resetHealth(harnessDir) {
+  saveHealth(harnessDir, defaultMetrics());
+}
+
+export {
+  loadHealth,
+  saveHealth,
+  recordSuccess,
+  recordFailure,
+  recordBoot,
+  getHealthStatus,
+  resetHealth
+};
+//# sourceMappingURL=chunk-TAT6JU3X.js.map

package/dist/chunk-TAT6JU3X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/health.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';\nimport { join } from 'path';\nimport { getSpending } from './cost-tracker.js';\n\n/** Individual health check result */\nexport interface HealthCheck {\n  name: string;\n  status: 'pass' | 'warn' | 'fail';\n  message: string;\n}\n\n/** Persisted health metrics */\nexport interface HealthMetrics {\n  lastSuccessfulRun: string | null;\n  lastFailedRun: string | null;\n  lastError: string | null;\n  consecutiveFailures: number;\n  totalRuns: number;\n  totalSuccesses: number;\n  totalFailures: number;\n  bootedAt: string | null;\n  updatedAt: string;\n}\n\n/** Overall health status */\nexport interface HealthStatus {\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  checks: HealthCheck[];\n  metrics: HealthMetrics;\n  costToday: number;\n  costThisMonth: number;\n}\n\nconst HEALTH_FILE = 'health.json';\n\nfunction getHealthPath(harnessDir: string): string {\n  return join(harnessDir, 'memory', HEALTH_FILE);\n}\n\nfunction defaultMetrics(): HealthMetrics {\n  return {\n    lastSuccessfulRun: null,\n    lastFailedRun: null,\n    lastError: null,\n    consecutiveFailures: 0,\n    totalRuns: 0,\n    totalSuccesses: 0,\n    totalFailures: 0,\n    bootedAt: null,\n    updatedAt: new Date().toISOString(),\n  };\n}\n\n/**\n * Load health metrics from disk.\n */\nexport function loadHealth(harnessDir: string): HealthMetrics {\n  const healthPath = getHealthPath(harnessDir);\n  if (!existsSync(healthPath)) {\n    return defaultMetrics();\n  }\n\n  try {\n    const content = readFileSync(healthPath, 'utf-8');\n    const parsed: unknown = JSON.parse(content);\n    if (\n      typeof parsed === 'object' &&\n      parsed !== null &&\n      'totalRuns' in parsed\n    ) {\n      return parsed as HealthMetrics;\n    }\n    return defaultMetrics();\n  } catch {\n    return defaultMetrics();\n  }\n}\n\n/**\n * Save health metrics to disk.\n */\nexport function saveHealth(harnessDir: string, metrics: HealthMetrics): void {\n  const memoryDir = join(harnessDir, 'memory');\n  if (!existsSync(memoryDir)) {\n    mkdirSync(memoryDir, { recursive: true });\n  }\n\n  metrics.updatedAt = new Date().toISOString();\n  writeFileSync(getHealthPath(harnessDir), JSON.stringify(metrics, null, 2), 'utf-8');\n}\n\n/**\n * Record a successful run.\n */\nexport function recordSuccess(harnessDir: string): void {\n  const metrics = loadHealth(harnessDir);\n  metrics.totalRuns++;\n  metrics.totalSuccesses++;\n  metrics.consecutiveFailures = 0;\n  metrics.lastSuccessfulRun = new Date().toISOString();\n  saveHealth(harnessDir, metrics);\n}\n\n/**\n * Record a failed run.\n */\nexport function recordFailure(harnessDir: string, error?: string): void {\n  const metrics = loadHealth(harnessDir);\n  metrics.totalRuns++;\n  metrics.totalFailures++;\n  metrics.consecutiveFailures++;\n  metrics.lastFailedRun = new Date().toISOString();\n  metrics.lastError = error ?? null;\n  saveHealth(harnessDir, metrics);\n}\n\n/**\n * Record boot time.\n */\nexport function recordBoot(harnessDir: string): void {\n  const metrics = loadHealth(harnessDir);\n  metrics.bootedAt = new Date().toISOString();\n  saveHealth(harnessDir, metrics);\n}\n\n/**\n * Run all health checks and return overall status.\n */\nexport function getHealthStatus(harnessDir: string): HealthStatus {\n  const metrics = loadHealth(harnessDir);\n  const checks: HealthCheck[] = [];\n\n  // Check 1: Required files exist\n  const requiredFiles = ['CORE.md', 'config.yaml', 'state.md'];\n  const missingFiles = requiredFiles.filter((f) => !existsSync(join(harnessDir, f)));\n  if (missingFiles.length === 0) {\n    checks.push({ name: 'core-files', status: 'pass', message: 'All core files present' });\n  } else {\n    checks.push({ name: 'core-files', status: 'fail', message: `Missing: ${missingFiles.join(', ')}` });\n  }\n\n  // Check 2: Memory directory exists\n  const memoryDir = join(harnessDir, 'memory');\n  if (existsSync(memoryDir)) {\n    checks.push({ name: 'memory-dir', status: 'pass', message: 'Memory directory exists' });\n  } else {\n    checks.push({ name: 'memory-dir', status: 'fail', message: 'Memory directory missing' });\n  }\n\n  // Check 3: API key availability\n  const apiKeys: Array<{ name: string; envVar: string }> = [\n    { name: 'OpenRouter', envVar: 'OPENROUTER_API_KEY' },\n    { name: 'Anthropic', envVar: 'ANTHROPIC_API_KEY' },\n    { name: 'OpenAI', envVar: 'OPENAI_API_KEY' },\n  ];\n  const presentKeys = apiKeys.filter((k) => process.env[k.envVar]);\n  if (presentKeys.length > 0) {\n    checks.push({\n      name: 'api-keys',\n      status: 'pass',\n      message: `API keys: ${presentKeys.map((k) => k.name).join(', ')}`,\n    });\n  } else {\n    checks.push({ name: 'api-keys', status: 'warn', message: 'No API keys found in environment' });\n  }\n\n  // Check 4: Consecutive failures\n  if (metrics.consecutiveFailures === 0) {\n    checks.push({ name: 'run-health', status: 'pass', message: 'No consecutive failures' });\n  } else if (metrics.consecutiveFailures < 3) {\n    checks.push({\n      name: 'run-health',\n      status: 'warn',\n      message: `${metrics.consecutiveFailures} consecutive failure(s)`,\n    });\n  } else {\n    checks.push({\n      name: 'run-health',\n      status: 'fail',\n      message: `${metrics.consecutiveFailures} consecutive failures — last error: ${metrics.lastError ?? 'unknown'}`,\n    });\n  }\n\n  // Check 5: Last run recency (warn if no successful run in 24h when there have been runs)\n  if (metrics.lastSuccessfulRun) {\n    const hoursSinceSuccess = (Date.now() - new Date(metrics.lastSuccessfulRun).getTime()) / 3600000;\n    if (hoursSinceSuccess < 24) {\n      checks.push({ name: 'last-success', status: 'pass', message: `Last success: ${metrics.lastSuccessfulRun}` });\n    } else {\n      checks.push({\n        name: 'last-success',\n        status: 'warn',\n        message: `Last success was ${Math.round(hoursSinceSuccess)}h ago`,\n      });\n    }\n  } else if (metrics.totalRuns > 0) {\n    checks.push({ name: 'last-success', status: 'warn', message: 'No successful runs recorded' });\n  }\n\n  // Cost checks\n  let costToday = 0;\n  let costThisMonth = 0;\n\n  try {\n    const today = new Date().toISOString().split('T')[0];\n    const monthStart = `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, '0')}-01`;\n    costToday = getSpending(harnessDir, today).total_cost_usd;\n    costThisMonth = getSpending(harnessDir, monthStart).total_cost_usd;\n  } catch {\n    // Cost data may not exist\n  }\n\n  // Determine overall status\n  const failCount = checks.filter((c) => c.status === 'fail').length;\n  const warnCount = checks.filter((c) => c.status === 'warn').length;\n\n  let status: HealthStatus['status'];\n  if (failCount > 0) {\n    status = 'unhealthy';\n  } else if (warnCount > 0) {\n    status = 'degraded';\n  } else {\n    status = 'healthy';\n  }\n\n  return { status, checks, metrics, costToday, costThisMonth };\n}\n\n/**\n * Reset health metrics (for testing or fresh start).\n */\nexport function resetHealth(harnessDir: string): void {\n  saveHealth(harnessDir, defaultMetrics());\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-UDZIS2AQ.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+import {
+  withFileLockSync
+} from "./chunk-Z2PUCXTZ.js";
+
+// src/runtime/state.ts
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+var DEFAULT_STATE = {
+  mode: "idle",
+  goals: [],
+  active_workflows: [],
+  last_interaction: (/* @__PURE__ */ new Date()).toISOString(),
+  unfinished_business: []
+};
+function loadState(harnessDir) {
+  const statePath = join(harnessDir, "state.md");
+  if (!existsSync(statePath)) {
+    return { ...DEFAULT_STATE };
+  }
+  const content = readFileSync(statePath, "utf-8");
+  return parseStateMd(content);
+}
+function saveState(harnessDir, state) {
+  const statePath = join(harnessDir, "state.md");
+  const content = renderStateMd(state);
+  withFileLockSync(harnessDir, statePath, () => {
+    writeFileSync(statePath, content, "utf-8");
+  });
+}
+function parseStateMd(content) {
+  const state = { ...DEFAULT_STATE };
+  const modeMatch = content.match(/## Mode\s*\n(.+)/);
+  if (modeMatch) state.mode = modeMatch[1].trim();
+  const goalsMatch = content.match(/## Goals\s*\n([\s\S]*?)(?=\n## |\n$|$)/);
+  if (goalsMatch) {
+    state.goals = goalsMatch[1].split("\n").filter((l) => l.startsWith("- ")).map((l) => l.replace(/^- /, "").trim());
+  }
+  const workflowsMatch = content.match(/## Active Workflows\s*\n([\s\S]*?)(?=\n## |\n$|$)/);
+  if (workflowsMatch) {
+    state.active_workflows = workflowsMatch[1].split("\n").filter((l) => l.startsWith("- ")).map((l) => l.replace(/^- /, "").trim());
+  }
+  const lastMatch = content.match(/## Last Interaction\s*\n(.+)/);
+  if (lastMatch) state.last_interaction = lastMatch[1].trim();
+  const unfinishedMatch = content.match(/## Unfinished Business\s*\n([\s\S]*?)(?=\n## |\n$|$)/);
+  if (unfinishedMatch) {
+    state.unfinished_business = unfinishedMatch[1].split("\n").filter((l) => l.startsWith("- ")).map((l) => l.replace(/^- /, "").trim());
+  }
+  return state;
+}
+function renderStateMd(state) {
+  const lines = [
+    "# Agent State",
+    "",
+    "## Mode",
+    state.mode,
+    "",
+    "## Goals",
+    ...state.goals.map((g) => `- ${g}`),
+    "",
+    "## Active Workflows",
+    ...state.active_workflows.map((w) => `- ${w}`),
+    "",
+    "## Last Interaction",
+    state.last_interaction,
+    "",
+    "## Unfinished Business",
+    ...state.unfinished_business.map((u) => `- ${u}`),
+    ""
+  ];
+  return lines.join("\n");
+}
+
+export {
+  loadState,
+  saveState
+};
+//# sourceMappingURL=chunk-UDZIS2AQ.js.map

package/dist/chunk-UDZIS2AQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/state.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync } from 'fs';\nimport { join } from 'path';\nimport type { AgentState } from '../core/types.js';\nimport { withFileLockSync } from './file-lock.js';\n\nconst DEFAULT_STATE: AgentState = {\n  mode: 'idle',\n  goals: [],\n  active_workflows: [],\n  last_interaction: new Date().toISOString(),\n  unfinished_business: [],\n};\n\nexport function loadState(harnessDir: string): AgentState {\n  const statePath = join(harnessDir, 'state.md');\n\n  if (!existsSync(statePath)) {\n    return { ...DEFAULT_STATE };\n  }\n\n  const content = readFileSync(statePath, 'utf-8');\n  return parseStateMd(content);\n}\n\nexport function saveState(harnessDir: string, state: AgentState): void {\n  const statePath = join(harnessDir, 'state.md');\n  const content = renderStateMd(state);\n  withFileLockSync(harnessDir, statePath, () => {\n    writeFileSync(statePath, content, 'utf-8');\n  });\n}\n\nfunction parseStateMd(content: string): AgentState {\n  const state = { ...DEFAULT_STATE };\n\n  const modeMatch = content.match(/## Mode\\s*\\n(.+)/);\n  if (modeMatch) state.mode = modeMatch[1].trim();\n\n  const goalsMatch = content.match(/## Goals\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/);\n  if (goalsMatch) {\n    state.goals = goalsMatch[1]\n      .split('\\n')\n      .filter(l => l.startsWith('- '))\n      .map(l => l.replace(/^- /, '').trim());\n  }\n\n  const workflowsMatch = content.match(/## Active Workflows\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/);\n  if (workflowsMatch) {\n    state.active_workflows = workflowsMatch[1]\n      .split('\\n')\n      .filter(l => l.startsWith('- '))\n      .map(l => l.replace(/^- /, '').trim());\n  }\n\n  const lastMatch = content.match(/## Last Interaction\\s*\\n(.+)/);\n  if (lastMatch) state.last_interaction = lastMatch[1].trim();\n\n  const unfinishedMatch = content.match(/## Unfinished Business\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/);\n  if (unfinishedMatch) {\n    state.unfinished_business = unfinishedMatch[1]\n      .split('\\n')\n      .filter(l => l.startsWith('- '))\n      .map(l => l.replace(/^- /, '').trim());\n  }\n\n  return state;\n}\n\nfunction renderStateMd(state: AgentState): string {\n  const lines: string[] = [\n    '# Agent State',\n    '',\n    '## Mode',\n    state.mode,\n    '',\n    '## Goals',\n    ...state.goals.map(g => `- ${g}`),\n    '',\n    '## Active Workflows',\n    ...state.active_workflows.map(w => `- ${w}`),\n    '',\n    '## Last Interaction',\n    state.last_interaction,\n    '',\n    '## Unfinished Business',\n    ...state.unfinished_business.map(u => `- ${u}`),\n    '',\n  ];\n\n  return lines.join('\\n');\n}\n"],"mappings":";;;;;;;AAAA,SAAS,cAAc,eAAe,kBAAkB;AACxD,SAAS,YAAY;AAIrB,IAAM,gBAA4B;AAAA,EAChC,MAAM;AAAA,EACN,OAAO,CAAC;AAAA,EACR,kBAAkB,CAAC;AAAA,EACnB,mBAAkB,oBAAI,KAAK,GAAE,YAAY;AAAA,EACzC,qBAAqB,CAAC;AACxB;AAEO,SAAS,UAAU,YAAgC;AACxD,QAAM,YAAY,KAAK,YAAY,UAAU;AAE7C,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,WAAO,EAAE,GAAG,cAAc;AAAA,EAC5B;AAEA,QAAM,UAAU,aAAa,WAAW,OAAO;AAC/C,SAAO,aAAa,OAAO;AAC7B;AAEO,SAAS,UAAU,YAAoB,OAAyB;AACrE,QAAM,YAAY,KAAK,YAAY,UAAU;AAC7C,QAAM,UAAU,cAAc,KAAK;AACnC,mBAAiB,YAAY,WAAW,MAAM;AAC5C,kBAAc,WAAW,SAAS,OAAO;AAAA,EAC3C,CAAC;AACH;AAEA,SAAS,aAAa,SAA6B;AACjD,QAAM,QAAQ,EAAE,GAAG,cAAc;AAEjC,QAAM,YAAY,QAAQ,MAAM,kBAAkB;AAClD,MAAI,UAAW,OAAM,OAAO,UAAU,CAAC,EAAE,KAAK;AAE9C,QAAM,aAAa,QAAQ,MAAM,wCAAwC;AACzE,MAAI,YAAY;AACd,UAAM,QAAQ,WAAW,CAAC,EACvB,MAAM,IAAI,EACV,OAAO,OAAK,EAAE,WAAW,IAAI,CAAC,EAC9B,IAAI,OAAK,EAAE,QAAQ,OAAO,EAAE,EAAE,KAAK,CAAC;AAAA,EACzC;AAEA,QAAM,iBAAiB,QAAQ,MAAM,mDAAmD;AACxF,MAAI,gBAAgB;AAClB,UAAM,mBAAmB,eAAe,CAAC,EACtC,MAAM,IAAI,EACV,OAAO,OAAK,EAAE,WAAW,IAAI,CAAC,EAC9B,IAAI,OAAK,EAAE,QAAQ,OAAO,EAAE,EAAE,KAAK,CAAC;AAAA,EACzC;AAEA,QAAM,YAAY,QAAQ,MAAM,8BAA8B;AAC9D,MAAI,UAAW,OAAM,mBAAmB,UAAU,CAAC,EAAE,KAAK;AAE1D,QAAM,kBAAkB,QAAQ,MAAM,sDAAsD;AAC5F,MAAI,iBAAiB;AACnB,UAAM,sBAAsB,gBAAgB,CAAC,EAC1C,MAAM,IAAI,EACV,OAAO,OAAK,EAAE,WAAW,IAAI,CAAC,EAC9B,IAAI,OAAK,EAAE,QAAQ,OAAO,EAAE,EAAE,KAAK,CAAC;AAAA,EACzC;AAEA,SAAO;AACT;AAEA,SAAS,cAAc,OAA2B;AAChD,QAAM,QAAkB;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA,GAAG,MAAM,MAAM,IAAI,OAAK,KAAK,CAAC,EAAE;AAAA,IAChC;AAAA,IACA;AAAA,IACA,GAAG,MAAM,iBAAiB,IAAI,OAAK,KAAK,CAAC,EAAE;AAAA,IAC3C;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA,GAAG,MAAM,oBAAoB,IAAI,OAAK,KAAK,CAAC,EAAE;AAAA,IAC9C;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/chunk-UPLBF4RZ.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+import {
+  CORE_PRIMITIVE_DIRS,
+  FrontmatterSchema
+} from "./chunk-4CWAGBNS.js";
+
+// src/primitives/loader.ts
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join, extname } from "path";
+import matter from "gray-matter";
+var L0_REGEX = /<!--\s*L0:\s*([\s\S]*?)\s*-->/;
+var L1_REGEX = /<!--\s*L1:\s*([\s\S]*?)\s*-->/;
+function parseHarnessDocument(filePath) {
+  const raw = readFileSync(filePath, "utf-8");
+  const { data, content } = matter(raw);
+  const normalized = { ...data };
+  for (const key of ["created", "updated"]) {
+    if (normalized[key] instanceof Date) {
+      normalized[key] = normalized[key].toISOString().split("T")[0];
+    }
+  }
+  let frontmatter;
+  try {
+    frontmatter = FrontmatterSchema.parse(normalized);
+  } catch {
+    const id = filePath.split("/").pop()?.replace(".md", "") || "unknown";
+    frontmatter = FrontmatterSchema.parse({ id });
+  }
+  const l0Match = content.match(L0_REGEX);
+  const l1Match = content.match(L1_REGEX);
+  const l0 = l0Match ? l0Match[1].trim() : "";
+  const l1 = l1Match ? l1Match[1].trim() : "";
+  const body = content.replace(L0_REGEX, "").replace(L1_REGEX, "").trim();
+  return {
+    path: filePath,
+    frontmatter,
+    l0,
+    l1,
+    body,
+    raw
+  };
+}
+function loadDirectory(dirPath) {
+  return loadDirectoryWithErrors(dirPath).docs;
+}
+function loadDirectoryWithErrors(dirPath) {
+  if (!existsSync(dirPath)) return { docs: [], errors: [] };
+  const files = readdirSync(dirPath);
+  const docs = [];
+  const errors = [];
+  for (const file of files) {
+    if (extname(file) !== ".md") continue;
+    if (file.startsWith("_")) continue;
+    if (file.startsWith(".")) continue;
+    const filePath = join(dirPath, file);
+    try {
+      const doc = parseHarnessDocument(filePath);
+      if (doc.frontmatter.status !== "archived" && doc.frontmatter.status !== "deprecated") {
+        docs.push(doc);
+      }
+    } catch (err) {
+      errors.push({
+        path: filePath,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return { docs, errors };
+}
+function loadAllPrimitives(harnessDir, extraDirs) {
+  return loadAllPrimitivesWithErrors(harnessDir, extraDirs).primitives;
+}
+function loadAllPrimitivesWithErrors(harnessDir, extraDirs) {
+  const primitives = /* @__PURE__ */ new Map();
+  const allErrors = [];
+  const directories = [...CORE_PRIMITIVE_DIRS];
+  if (extraDirs) {
+    for (const dir of extraDirs) {
+      if (!directories.includes(dir)) {
+        directories.push(dir);
+      }
+    }
+  }
+  for (const dir of directories) {
+    const { docs, errors } = loadDirectoryWithErrors(join(harnessDir, dir));
+    primitives.set(dir, docs);
+    allErrors.push(...errors);
+  }
+  return { primitives, errors: allErrors };
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function getAtLevel(doc, level) {
+  switch (level) {
+    case 0:
+      return doc.l0 || doc.frontmatter.id;
+    case 1:
+      return doc.l1 || doc.l0 || doc.body.slice(0, 400);
+    case 2:
+      return doc.body;
+  }
+}
+
+export {
+  parseHarnessDocument,
+  loadDirectory,
+  loadDirectoryWithErrors,
+  loadAllPrimitives,
+  loadAllPrimitivesWithErrors,
+  estimateTokens,
+  getAtLevel
+};
+//# sourceMappingURL=chunk-UPLBF4RZ.js.map

package/dist/chunk-UPLBF4RZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/loader.ts"],"sourcesContent":["import { readFileSync, readdirSync, existsSync } from 'fs';\nimport { join, extname } from 'path';\nimport matter from 'gray-matter';\nimport { FrontmatterSchema, CORE_PRIMITIVE_DIRS, type HarnessDocument, type Frontmatter } from '../core/types.js';\n\nexport interface ParseError {\n  path: string;\n  error: string;\n}\n\nexport interface LoadResult {\n  docs: HarnessDocument[];\n  errors: ParseError[];\n}\n\n// Extract L0 and L1 from HTML comments at the top of the markdown body\n// Format: <!-- L0: one-line summary -->\n//         <!-- L1: paragraph summary -->\nconst L0_REGEX = /<!--\\s*L0:\\s*([\\s\\S]*?)\\s*-->/;\nconst L1_REGEX = /<!--\\s*L1:\\s*([\\s\\S]*?)\\s*-->/;\n\nexport function parseHarnessDocument(filePath: string): HarnessDocument {\n  const raw = readFileSync(filePath, 'utf-8');\n  const { data, content } = matter(raw);\n\n  // Parse frontmatter with defaults\n  // Normalize dates: gray-matter converts date strings to Date objects\n  const normalized = { ...data };\n  for (const key of ['created', 'updated']) {\n    if (normalized[key] instanceof Date) {\n      normalized[key] = (normalized[key] as Date).toISOString().split('T')[0];\n    }\n  }\n\n  let frontmatter: Frontmatter;\n  try {\n    frontmatter = FrontmatterSchema.parse(normalized);\n  } catch {\n    // Fallback: create minimal frontmatter from filename\n    const id = filePath.split('/').pop()?.replace('.md', '') || 'unknown';\n    frontmatter = FrontmatterSchema.parse({ id });\n  }\n\n  // Extract L0 and L1 from content\n  const l0Match = content.match(L0_REGEX);\n  const l1Match = content.match(L1_REGEX);\n\n  const l0 = l0Match ? l0Match[1].trim() : '';\n  const l1 = l1Match ? l1Match[1].trim() : '';\n\n  // Body is the content without L0/L1 comments\n  const body = content\n    .replace(L0_REGEX, '')\n    .replace(L1_REGEX, '')\n    .trim();\n\n  return {\n    path: filePath,\n    frontmatter,\n    l0,\n    l1,\n    body,\n    raw,\n  };\n}\n\nexport function loadDirectory(dirPath: string): HarnessDocument[] {\n  return loadDirectoryWithErrors(dirPath).docs;\n}\n\nexport function loadDirectoryWithErrors(dirPath: string): LoadResult {\n  if (!existsSync(dirPath)) return { docs: [], errors: [] };\n\n  const files = readdirSync(dirPath);\n  const docs: HarnessDocument[] = [];\n  const errors: ParseError[] = [];\n\n  for (const file of files) {\n    if (extname(file) !== '.md') continue;\n    if (file.startsWith('_')) continue; // Skip index files\n    if (file.startsWith('.')) continue; // Skip hidden files\n\n    const filePath = join(dirPath, file);\n    try {\n      const doc = parseHarnessDocument(filePath);\n      if (doc.frontmatter.status !== 'archived' && doc.frontmatter.status !== 'deprecated') {\n        docs.push(doc);\n      }\n    } catch (err) {\n      errors.push({\n        path: filePath,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  return { docs, errors };\n}\n\nexport interface LoadAllResult {\n  primitives: Map<string, HarnessDocument[]>;\n  errors: ParseError[];\n}\n\nexport function loadAllPrimitives(harnessDir: string, extraDirs?: string[]): Map<string, HarnessDocument[]> {\n  return loadAllPrimitivesWithErrors(harnessDir, extraDirs).primitives;\n}\n\nexport function loadAllPrimitivesWithErrors(harnessDir: string, extraDirs?: string[]): LoadAllResult {\n  const primitives = new Map<string, HarnessDocument[]>();\n  const allErrors: ParseError[] = [];\n\n  const directories: string[] = [...CORE_PRIMITIVE_DIRS];\n  if (extraDirs) {\n    for (const dir of extraDirs) {\n      if (!directories.includes(dir)) {\n        directories.push(dir);\n      }\n    }\n  }\n\n  for (const dir of directories) {\n    const { docs, errors } = loadDirectoryWithErrors(join(harnessDir, dir));\n    primitives.set(dir, docs);\n    allErrors.push(...errors);\n  }\n\n  return { primitives, errors: allErrors };\n}\n\n// Estimate token count (rough: 1 token ≈ 4 chars)\nexport function estimateTokens(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n\n// Load a file at a specific disclosure level\nexport function getAtLevel(doc: HarnessDocument, level: 0 | 1 | 2): string {\n  switch (level) {\n    case 0:\n      return doc.l0 || doc.frontmatter.id;\n    case 1:\n      return doc.l1 || doc.l0 || doc.body.slice(0, 400);\n    case 2:\n      return doc.body;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-UWQTZMNI.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+
+import {
+  estimateTokens,
+  getAtLevel,
+  loadAllPrimitivesWithErrors
+} from "./chunk-UPLBF4RZ.js";
+import {
+  log
+} from "./chunk-BSKDOFRT.js";
+
+// src/runtime/context-loader.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+function buildSystemPrompt(harnessDir, config) {
+  const maxTokens = config.model.max_tokens;
+  const budget = {
+    max_tokens: maxTokens,
+    used_tokens: 0,
+    remaining: maxTokens,
+    loaded_files: []
+  };
+  const warnings = [];
+  const sections = [];
+  const corePath = join(harnessDir, "CORE.md");
+  if (existsSync(corePath)) {
+    const core = readFileSync(corePath, "utf-8");
+    sections.push(`# CORE IDENTITY
+
+${core}`);
+    budget.used_tokens += estimateTokens(core);
+    budget.loaded_files.push("CORE.md");
+  }
+  const statePath = join(harnessDir, "state.md");
+  if (existsSync(statePath)) {
+    const state = readFileSync(statePath, "utf-8");
+    sections.push(`# CURRENT STATE
+
+${state}`);
+    budget.used_tokens += estimateTokens(state);
+    budget.loaded_files.push("state.md");
+  }
+  const systemPath = join(harnessDir, "SYSTEM.md");
+  if (existsSync(systemPath)) {
+    const system = readFileSync(systemPath, "utf-8");
+    sections.push(`# SYSTEM
+
+${system}`);
+    budget.used_tokens += estimateTokens(system);
+    budget.loaded_files.push("SYSTEM.md");
+  }
+  const extDirs = config.extensions?.directories ?? [];
+  const { primitives, errors: parseErrors } = loadAllPrimitivesWithErrors(harnessDir, extDirs);
+  if (parseErrors.length > 0) {
+    for (const pe of parseErrors) {
+      log.warn(`Failed to parse primitive: ${pe.path} \u2014 ${pe.error}`);
+    }
+    warnings.push(`${parseErrors.length} primitive file(s) failed to parse`);
+  }
+  const targetBudget = maxTokens * 0.15;
+  const priorityOrder = ["rules", "instincts", "skills", "playbooks", "tools", "workflows", "agents"];
+  for (const dir of extDirs) {
+    if (!priorityOrder.includes(dir)) {
+      priorityOrder.push(dir);
+    }
+  }
+  const allDocs = [];
+  for (const category of priorityOrder) {
+    const docs = primitives.get(category);
+    if (!docs || docs.length === 0) continue;
+    for (const doc of docs) {
+      allDocs.push({ category, doc });
+    }
+  }
+  if (allDocs.length === 0) {
+    warnings.push("No primitives found \u2014 add rules, instincts, or skills to improve agent behavior");
+  }
+  const primitiveBudget = targetBudget - budget.used_tokens;
+  let totalL2Demand = 0;
+  for (const { doc } of allDocs) {
+    totalL2Demand += estimateTokens(getAtLevel(doc, 2));
+  }
+  let globalLevel;
+  if (totalL2Demand <= primitiveBudget) {
+    globalLevel = 2;
+  } else {
+    let totalL1Demand = 0;
+    for (const { doc } of allDocs) {
+      totalL1Demand += estimateTokens(getAtLevel(doc, 1));
+    }
+    globalLevel = totalL1Demand <= primitiveBudget ? 1 : 0;
+  }
+  for (const category of priorityOrder) {
+    const docs = primitives.get(category);
+    if (!docs || docs.length === 0) continue;
+    const categoryLabel = category.toUpperCase();
+    const categoryDocs = [];
+    for (const doc of docs) {
+      let level = globalLevel;
+      let content = getAtLevel(doc, level);
+      let tokens = estimateTokens(content);
+      while (budget.used_tokens + tokens > targetBudget && level > 0) {
+        level = level - 1;
+        content = getAtLevel(doc, level);
+        tokens = estimateTokens(content);
+      }
+      categoryDocs.push(`### ${doc.frontmatter.id}
+${content}`);
+      budget.used_tokens += tokens;
+      budget.loaded_files.push(doc.path);
+    }
+    if (categoryDocs.length > 0) {
+      sections.push(`# ${categoryLabel}
+
+${categoryDocs.join("\n\n")}`);
+    }
+  }
+  const scratchPath = join(harnessDir, "memory", "scratch.md");
+  if (existsSync(scratchPath)) {
+    const scratch = readFileSync(scratchPath, "utf-8");
+    if (scratch.trim()) {
+      sections.push(`# SCRATCH (Current Working Memory)
+
+${scratch}`);
+      budget.used_tokens += estimateTokens(scratch);
+      budget.loaded_files.push("memory/scratch.md");
+    }
+  }
+  budget.remaining = maxTokens - budget.used_tokens;
+  const usagePercent = budget.used_tokens / maxTokens * 100;
+  if (usagePercent > 12) {
+    warnings.push(
+      `System prompt using ${usagePercent.toFixed(1)}% of total context (${budget.used_tokens}/${maxTokens} tokens) \u2014 some primitives may be truncated`
+    );
+    log.warn(
+      `Context budget high: ${budget.used_tokens}/${maxTokens} tokens (${usagePercent.toFixed(1)}%), ${budget.loaded_files.length} files loaded`
+    );
+  }
+  if (globalLevel < 2) {
+    const levelName = globalLevel === 0 ? "L0 (summary only)" : "L1 (paragraph summary)";
+    warnings.push(`Primitives loaded at ${levelName} due to budget constraints`);
+  }
+  return {
+    systemPrompt: sections.join("\n\n---\n\n"),
+    budget,
+    parseErrors,
+    warnings
+  };
+}
+
+export {
+  buildSystemPrompt
+};
+//# sourceMappingURL=chunk-UWQTZMNI.js.map

package/dist/chunk-UWQTZMNI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/context-loader.ts"],"sourcesContent":["import { readFileSync, existsSync } from 'fs';\nimport { join } from 'path';\nimport { loadAllPrimitivesWithErrors, estimateTokens, getAtLevel } from '../primitives/loader.js';\nimport type { ParseError } from '../primitives/loader.js';\nimport type { HarnessConfig, HarnessDocument, ContextBudget } from '../core/types.js';\nimport { log } from '../core/logger.js';\n\nexport interface LoadedContext {\n  systemPrompt: string;\n  budget: ContextBudget;\n  parseErrors: ParseError[];\n  warnings: string[];\n}\n\nexport function buildSystemPrompt(harnessDir: string, config: HarnessConfig): LoadedContext {\n  const maxTokens = config.model.max_tokens;\n  const budget: ContextBudget = {\n    max_tokens: maxTokens,\n    used_tokens: 0,\n    remaining: maxTokens,\n    loaded_files: [],\n  };\n\n  const warnings: string[] = [];\n  const sections: string[] = [];\n\n  // --- Step 1: Load CORE.md (always, full content) ---\n  const corePath = join(harnessDir, 'CORE.md');\n  if (existsSync(corePath)) {\n    const core = readFileSync(corePath, 'utf-8');\n    sections.push(`# CORE IDENTITY\\n\\n${core}`);\n    budget.used_tokens += estimateTokens(core);\n    budget.loaded_files.push('CORE.md');\n  }\n\n  // --- Step 2: Load state.md ---\n  const statePath = join(harnessDir, 'state.md');\n  if (existsSync(statePath)) {\n    const state = readFileSync(statePath, 'utf-8');\n    sections.push(`# CURRENT STATE\\n\\n${state}`);\n    budget.used_tokens += estimateTokens(state);\n    budget.loaded_files.push('state.md');\n  }\n\n  // --- Step 3: Load SYSTEM.md (boot instructions) ---\n  const systemPath = join(harnessDir, 'SYSTEM.md');\n  if (existsSync(systemPath)) {\n    const system = readFileSync(systemPath, 'utf-8');\n    sections.push(`# SYSTEM\\n\\n${system}`);\n    budget.used_tokens += estimateTokens(system);\n    budget.loaded_files.push('SYSTEM.md');\n  }\n\n  // --- Step 4: Load all primitives at appropriate level ---\n  const extDirs = config.extensions?.directories ?? [];\n  const { primitives, errors: parseErrors } = loadAllPrimitivesWithErrors(harnessDir, extDirs);\n\n  // Report parse errors\n  if (parseErrors.length > 0) {\n    for (const pe of parseErrors) {\n      log.warn(`Failed to parse primitive: ${pe.path} — ${pe.error}`);\n    }\n    warnings.push(`${parseErrors.length} primitive file(s) failed to parse`);\n  }\n\n  const targetBudget = maxTokens * 0.15; // Use 15% of context for harness\n\n  // Priority order for loading primitives (core dirs first, extensions appended)\n  const priorityOrder = ['rules', 'instincts', 'skills', 'playbooks', 'tools', 'workflows', 'agents'];\n  for (const dir of extDirs) {\n    if (!priorityOrder.includes(dir)) {\n      priorityOrder.push(dir);\n    }\n  }\n\n  // Collect all docs to estimate total demand before deciding levels\n  const allDocs: { category: string; doc: HarnessDocument }[] = [];\n  for (const category of priorityOrder) {\n    const docs = primitives.get(category);\n    if (!docs || docs.length === 0) continue;\n    for (const doc of docs) {\n      allDocs.push({ category, doc });\n    }\n  }\n\n  if (allDocs.length === 0) {\n    warnings.push('No primitives found — add rules, instincts, or skills to improve agent behavior');\n  }\n\n  // Estimate total L2 demand vs available budget for primitives\n  const primitiveBudget = targetBudget - budget.used_tokens;\n  let totalL2Demand = 0;\n  for (const { doc } of allDocs) {\n    totalL2Demand += estimateTokens(getAtLevel(doc, 2));\n  }\n\n  // Choose a global disclosure level based on how much fits\n  let globalLevel: 0 | 1 | 2;\n  if (totalL2Demand <= primitiveBudget) {\n    globalLevel = 2; // Everything fits at full\n  } else {\n    // Estimate L1 demand\n    let totalL1Demand = 0;\n    for (const { doc } of allDocs) {\n      totalL1Demand += estimateTokens(getAtLevel(doc, 1));\n    }\n    globalLevel = totalL1Demand <= primitiveBudget ? 1 : 0;\n  }\n\n  for (const category of priorityOrder) {\n    const docs = primitives.get(category);\n    if (!docs || docs.length === 0) continue;\n\n    const categoryLabel = category.toUpperCase();\n    const categoryDocs: string[] = [];\n\n    for (const doc of docs) {\n      // Start from global level, fall back if this doc would exceed budget\n      let level = globalLevel;\n      let content = getAtLevel(doc, level);\n      let tokens = estimateTokens(content);\n\n      while (budget.used_tokens + tokens > targetBudget && level > 0) {\n        level = (level - 1) as 0 | 1;\n        content = getAtLevel(doc, level);\n        tokens = estimateTokens(content);\n      }\n\n      categoryDocs.push(`### ${doc.frontmatter.id}\\n${content}`);\n      budget.used_tokens += tokens;\n      budget.loaded_files.push(doc.path);\n    }\n\n    if (categoryDocs.length > 0) {\n      sections.push(`# ${categoryLabel}\\n\\n${categoryDocs.join('\\n\\n')}`);\n    }\n  }\n\n  // --- Step 5: Load scratch.md if exists ---\n  const scratchPath = join(harnessDir, 'memory', 'scratch.md');\n  if (existsSync(scratchPath)) {\n    const scratch = readFileSync(scratchPath, 'utf-8');\n    if (scratch.trim()) {\n      sections.push(`# SCRATCH (Current Working Memory)\\n\\n${scratch}`);\n      budget.used_tokens += estimateTokens(scratch);\n      budget.loaded_files.push('memory/scratch.md');\n    }\n  }\n\n  budget.remaining = maxTokens - budget.used_tokens;\n\n  // --- Step 6: Budget warnings ---\n  const usagePercent = (budget.used_tokens / maxTokens) * 100;\n  if (usagePercent > 12) {\n    // System prompt using more than 80% of its 15% allocation\n    warnings.push(\n      `System prompt using ${usagePercent.toFixed(1)}% of total context ` +\n      `(${budget.used_tokens}/${maxTokens} tokens) — some primitives may be truncated`,\n    );\n    log.warn(\n      `Context budget high: ${budget.used_tokens}/${maxTokens} tokens ` +\n      `(${usagePercent.toFixed(1)}%), ${budget.loaded_files.length} files loaded`,\n    );\n  }\n\n  if (globalLevel < 2) {\n    const levelName = globalLevel === 0 ? 'L0 (summary only)' : 'L1 (paragraph summary)';\n    warnings.push(`Primitives loaded at ${levelName} due to budget constraints`);\n  }\n\n  return {\n    systemPrompt: sections.join('\\n\\n---\\n\\n'),\n    budget,\n    parseErrors,\n    warnings,\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,cAAc,kBAAkB;AACzC,SAAS,YAAY;AAad,SAAS,kBAAkB,YAAoB,QAAsC;AAC1F,QAAM,YAAY,OAAO,MAAM;AAC/B,QAAM,SAAwB;AAAA,IAC5B,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,WAAW;AAAA,IACX,cAAc,CAAC;AAAA,EACjB;AAEA,QAAM,WAAqB,CAAC;AAC5B,QAAM,WAAqB,CAAC;AAG5B,QAAM,WAAW,KAAK,YAAY,SAAS;AAC3C,MAAI,WAAW,QAAQ,GAAG;AACxB,UAAM,OAAO,aAAa,UAAU,OAAO;AAC3C,aAAS,KAAK;AAAA;AAAA,EAAsB,IAAI,EAAE;AAC1C,WAAO,eAAe,eAAe,IAAI;AACzC,WAAO,aAAa,KAAK,SAAS;AAAA,EACpC;AAGA,QAAM,YAAY,KAAK,YAAY,UAAU;AAC7C,MAAI,WAAW,SAAS,GAAG;AACzB,UAAM,QAAQ,aAAa,WAAW,OAAO;AAC7C,aAAS,KAAK;AAAA;AAAA,EAAsB,KAAK,EAAE;AAC3C,WAAO,eAAe,eAAe,KAAK;AAC1C,WAAO,aAAa,KAAK,UAAU;AAAA,EACrC;AAGA,QAAM,aAAa,KAAK,YAAY,WAAW;AAC/C,MAAI,WAAW,UAAU,GAAG;AAC1B,UAAM,SAAS,aAAa,YAAY,OAAO;AAC/C,aAAS,KAAK;AAAA;AAAA,EAAe,MAAM,EAAE;AACrC,WAAO,eAAe,eAAe,MAAM;AAC3C,WAAO,aAAa,KAAK,WAAW;AAAA,EACtC;AAGA,QAAM,UAAU,OAAO,YAAY,eAAe,CAAC;AACnD,QAAM,EAAE,YAAY,QAAQ,YAAY,IAAI,4BAA4B,YAAY,OAAO;AAG3F,MAAI,YAAY,SAAS,GAAG;AAC1B,eAAW,MAAM,aAAa;AAC5B,UAAI,KAAK,8BAA8B,GAAG,IAAI,WAAM,GAAG,KAAK,EAAE;AAAA,IAChE;AACA,aAAS,KAAK,GAAG,YAAY,MAAM,oCAAoC;AAAA,EACzE;AAEA,QAAM,eAAe,YAAY;AAGjC,QAAM,gBAAgB,CAAC,SAAS,aAAa,UAAU,aAAa,SAAS,aAAa,QAAQ;AAClG,aAAW,OAAO,SAAS;AACzB,QAAI,CAAC,cAAc,SAAS,GAAG,GAAG;AAChC,oBAAc,KAAK,GAAG;AAAA,IACxB;AAAA,EACF;AAGA,QAAM,UAAwD,CAAC;AAC/D,aAAW,YAAY,eAAe;AACpC,UAAM,OAAO,WAAW,IAAI,QAAQ;AACpC,QAAI,CAAC,QAAQ,KAAK,WAAW,EAAG;AAChC,eAAW,OAAO,MAAM;AACtB,cAAQ,KAAK,EAAE,UAAU,IAAI,CAAC;AAAA,IAChC;AAAA,EACF;AAEA,MAAI,QAAQ,WAAW,GAAG;AACxB,aAAS,KAAK,sFAAiF;AAAA,EACjG;AAGA,QAAM,kBAAkB,eAAe,OAAO;AAC9C,MAAI,gBAAgB;AACpB,aAAW,EAAE,IAAI,KAAK,SAAS;AAC7B,qBAAiB,eAAe,WAAW,KAAK,CAAC,CAAC;AAAA,EACpD;AAGA,MAAI;AACJ,MAAI,iBAAiB,iBAAiB;AACpC,kBAAc;AAAA,EAChB,OAAO;AAEL,QAAI,gBAAgB;AACpB,eAAW,EAAE,IAAI,KAAK,SAAS;AAC7B,uBAAiB,eAAe,WAAW,KAAK,CAAC,CAAC;AAAA,IACpD;AACA,kBAAc,iBAAiB,kBAAkB,IAAI;AAAA,EACvD;AAEA,aAAW,YAAY,eAAe;AACpC,UAAM,OAAO,WAAW,IAAI,QAAQ;AACpC,QAAI,CAAC,QAAQ,KAAK,WAAW,EAAG;AAEhC,UAAM,gBAAgB,SAAS,YAAY;AAC3C,UAAM,eAAyB,CAAC;AAEhC,eAAW,OAAO,MAAM;AAEtB,UAAI,QAAQ;AACZ,UAAI,UAAU,WAAW,KAAK,KAAK;AACnC,UAAI,SAAS,eAAe,OAAO;AAEnC,aAAO,OAAO,cAAc,SAAS,gBAAgB,QAAQ,GAAG;AAC9D,gBAAS,QAAQ;AACjB,kBAAU,WAAW,KAAK,KAAK;AAC/B,iBAAS,eAAe,OAAO;AAAA,MACjC;AAEA,mBAAa,KAAK,OAAO,IAAI,YAAY,EAAE;AAAA,EAAK,OAAO,EAAE;AACzD,aAAO,eAAe;AACtB,aAAO,aAAa,KAAK,IAAI,IAAI;AAAA,IACnC;AAEA,QAAI,aAAa,SAAS,GAAG;AAC3B,eAAS,KAAK,KAAK,aAAa;AAAA;AAAA,EAAO,aAAa,KAAK,MAAM,CAAC,EAAE;AAAA,IACpE;AAAA,EACF;AAGA,QAAM,cAAc,KAAK,YAAY,UAAU,YAAY;AAC3D,MAAI,WAAW,WAAW,GAAG;AAC3B,UAAM,UAAU,aAAa,aAAa,OAAO;AACjD,QAAI,QAAQ,KAAK,GAAG;AAClB,eAAS,KAAK;AAAA;AAAA,EAAyC,OAAO,EAAE;AAChE,aAAO,eAAe,eAAe,OAAO;AAC5C,aAAO,aAAa,KAAK,mBAAmB;AAAA,IAC9C;AAAA,EACF;AAEA,SAAO,YAAY,YAAY,OAAO;AAGtC,QAAM,eAAgB,OAAO,cAAc,YAAa;AACxD,MAAI,eAAe,IAAI;AAErB,aAAS;AAAA,MACP,uBAAuB,aAAa,QAAQ,CAAC,CAAC,uBAC1C,OAAO,WAAW,IAAI,SAAS;AAAA,IACrC;AACA,QAAI;AAAA,MACF,wBAAwB,OAAO,WAAW,IAAI,SAAS,YACnD,aAAa,QAAQ,CAAC,CAAC,OAAO,OAAO,aAAa,MAAM;AAAA,IAC9D;AAAA,EACF;AAEA,MAAI,cAAc,GAAG;AACnB,UAAM,YAAY,gBAAgB,IAAI,sBAAsB;AAC5D,aAAS,KAAK,wBAAwB,SAAS,4BAA4B;AAAA,EAC7E;AAEA,SAAO;AAAA,IACL,cAAc,SAAS,KAAK,aAAa;AAAA,IACzC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}