npm - @tea-agent/loop-agent - Versions diffs - 0.4.0 → 0.6.0 - Mend

@tea-agent/loop-agent 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

package/AGENTS.md +2 -2
package/CHANGELOG.md +48 -38
package/README.md +3 -3
package/dist/application/dag/args.js +9 -1
package/dist/application/dag/run-dag.js +16 -2
package/dist/application/dag/validate-dag.js +14 -1
package/dist/cli/command-definitions.js +22 -4
package/dist/cli/help.js +3 -2
package/dist/cli/program.js +7 -5
package/dist/commands/import-prd.js +76 -0
package/dist/commands/init.js +230 -32
package/dist/commands/instructions.js +90 -58
package/dist/executors/config-core.js +3 -2
package/dist/executors/dag-pi-executor.js +1 -0
package/dist/executors/model-routing.js +43 -0
package/dist/executors/pi-sdk-executor.js +63 -1
package/dist/governance/manifest-types.js +9 -1
package/dist/shared/preview.js +39 -0
package/dist/task/source-references.js +221 -0
package/dist/worker/cli.js +62 -1
package/dist/worker/loop-agent/loop-agent-client.js +97 -5
package/dist/worker/materialize/harness-task-materializer.js +162 -5
package/dist/worker/observability/event-store.js +82 -0
package/dist/worker/observability/events.js +79 -0
package/dist/worker/observability/progress-composite.js +33 -0
package/dist/worker/observability/read-model.js +1013 -0
package/dist/worker/observability/snapshot-store.js +43 -0
package/dist/worker/observability/types.js +1 -0
package/dist/worker/observe/paths.js +64 -0
package/dist/worker/observe/routes.js +423 -0
package/dist/worker/observe/server.js +61 -0
package/dist/worker/observe/static/app.js +1419 -0
package/dist/worker/observe/static/index.html +63 -0
package/dist/worker/observe/static/styles.css +613 -0
package/dist/worker/pool/failure-routing.js +41 -6
package/dist/worker/pool/run-store.js +59 -1
package/dist/worker/progress-reporter.js +0 -18
package/dist/worker/run-task/run-task.js +327 -92
package/dist/worker/runner/run-ready.js +112 -4
package/dist/workflows/dag/event-observer.js +132 -0
package/dist/workflows/dag/init-hybrid.js +150 -26
package/dist/workflows/dag/observer-compose.js +52 -0
package/dist/workflows/dag/skill-instructions.js +4 -0
package/dist/workflows/dag/types.js +1 -1
package/dist/workflows/dag/validate.js +3 -2
package/docs/README.md +2 -0
package/docs/architecture/runtime-boundaries.md +18 -3
package/docs/design/README.md +22 -9
package/docs/exec-plans/active/README.md +6 -1
package/docs/exec-plans/completed/README.md +12 -0
package/docs/init-surface.manifest.json +32 -2
package/docs/loop-agent-harness.md +13 -0
package/docs/reports/README.md +4 -0
package/docs/templates/agent-dag.base.json +1 -1
package/docs/templates/agent-dag.final-verification.json +1 -1
package/docs/templates/agent-dag.supervised-implementation.json +1 -1
package/docs/templates/hybrid-dag.json +1 -1
package/docs/templates/worker-dogfood-evidence.md +52 -0
package/docs/templates/worker-dogfood-setup.md +48 -0
package/examples/example-dag.json +1 -1
package/examples/hybrid-loop-agent-dag.json +1 -1
package/harness.json +5 -29
package/package.json +6 -6
package/skills/loop-agent/SKILL.md +5 -3
package/skills/loop-agent/references/command-reference.md +12 -3
package/skills/loop-agent/references/harness-policy.md +7 -3
package/skills/loop-agent/references/task-workflow.md +8 -3

package/dist/worker/observe/static/index.html ADDED Viewed

@@ -0,0 +1,63 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>loop-agent 可观测</title>
+  <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+  <div id="app">
+    <header class="site-header">
+      <a href="#/" class="logo">loop-agent 可观测</a>
+      <nav class="top-nav">
+        <a href="#/" class="nav-link">总览</a>
+        <a href="#/dags" class="nav-link">DAG</a>
+        <a href="#/failures" class="nav-link">失败箱</a>
+      </nav>
+      <span id="header-refresh" class="header-refresh"></span>
+      <nav id="breadcrumb" class="breadcrumb"></nav>
+    </header>
+    <section data-view="dashboard" id="view-dashboard">
+      <h2>总览</h2>
+      <div id="dashboard-kpi" class="kpi-grid panel"></div>
+      <div id="dashboard-active-dags" class="panel"></div>
+      <div id="dashboard-dags" class="panel"></div>
+      <div id="dashboard-batches" class="panel"></div>
+    </section>
+    <section data-view="batch" id="view-batch" hidden>
+      <h2>批次详情</h2>
+      <div id="batch-meta" class="panel"></div>
+      <div id="batch-tasks" class="panel"></div>
+    </section>
+    <section data-view="run" id="view-run" hidden>
+      <h2>运行详情</h2>
+      <div id="run-meta" class="panel"></div>
+      <div id="run-dag-progress" class="panel"></div>
+      <div id="run-steps" class="panel"></div>
+      <div id="run-command" class="panel"></div>
+      <div id="run-output" class="panel"></div>
+      <div id="run-artifacts" class="panel"></div>
+    </section>
+    <section data-view="dag" id="view-dag" hidden>
+      <h2>DAG 详情</h2>
+      <div id="dag-meta" class="panel"></div>
+      <div id="dag-ranks" class="panel"></div>
+      <div id="dag-nodes" class="panel"></div>
+      <div id="dag-timeline" class="panel"></div>
+      <div id="dag-output" class="panel"></div>
+    </section>
+    <section data-view="failures" id="view-failures" hidden>
+      <h2>失败箱</h2>
+      <div id="failures-empty" class="panel" hidden>暂无失败或阻塞的任务。</div>
+      <div id="failures-list" class="panel"></div>
+    </section>
+  </div>
+  <script type="module" src="/app.js"></script>
+</body>
+</html>

package/dist/worker/observe/static/styles.css ADDED Viewed

@@ -0,0 +1,613 @@
+:root {
+  --bg: #0d1117;
+  --surface: #161b22;
+  --border: #30363d;
+  --text: #c9d1d9;
+  --muted: #8b949e;
+  --link: #58a6ff;
+  --green: #3fb950;
+  --red: #f85149;
+  --yellow: #d29922;
+  --blue: #58a6ff;
+  --gray-red: #8b3a3a;
+}
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
+  font-size: 13px;
+  line-height: 1.5;
+  background: var(--bg);
+  color: var(--text);
+}
+#app {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 1rem 1.5rem 2rem;
+}
+.site-header {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 1rem 1.5rem;
+  margin-bottom: 1.5rem;
+  padding-bottom: 0.75rem;
+  border-bottom: 1px solid var(--border);
+}
+.logo {
+  color: var(--text);
+  text-decoration: none;
+  font-weight: 600;
+}
+.logo:hover {
+  color: var(--link);
+}
+.top-nav {
+  display: flex;
+  gap: 1rem;
+}
+.nav-link {
+  color: var(--muted);
+  text-decoration: none;
+  font-size: 12px;
+}
+.nav-link:hover {
+  color: var(--link);
+}
+.header-refresh {
+  margin-left: auto;
+  color: var(--muted);
+  font-size: 11px;
+}
+.breadcrumb {
+  flex-basis: 100%;
+  color: var(--muted);
+  font-size: 12px;
+}
+.breadcrumb a {
+  color: var(--link);
+  text-decoration: none;
+}
+.breadcrumb a:hover {
+  text-decoration: underline;
+}
+h2 {
+  margin: 0 0 0.75rem;
+  font-size: 1.1rem;
+  font-weight: 600;
+}
+h3,
+.section-heading {
+  margin: 0 0 0.5rem;
+  font-size: 0.95rem;
+  font-weight: 600;
+}
+.panel {
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 0.75rem 1rem;
+  margin-bottom: 1rem;
+}
+.kpi-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(120px, 1fr));
+  gap: 0.75rem;
+  padding: 0.75rem;
+}
+.kpi-card {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 0.6rem 0.75rem;
+  text-align: center;
+}
+.kpi-card.kpi-highlight {
+  border-color: var(--yellow);
+  background: rgba(210, 153, 34, 0.08);
+}
+.kpi-card.kpi-danger {
+  border-color: var(--red);
+}
+.kpi-label {
+  color: var(--muted);
+  font-size: 10px;
+  text-transform: uppercase;
+  margin-bottom: 0.25rem;
+}
+.kpi-value {
+  font-size: 1.4rem;
+  font-weight: 700;
+}
+.active-dag-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+.active-dag-card {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 0.75rem 1rem;
+}
+.active-dag-card-running {
+  border-color: var(--yellow);
+  box-shadow: 0 0 0 1px rgba(210, 153, 34, 0.25);
+  animation: pulse-border 2s ease-in-out infinite;
+}
+@keyframes pulse-border {
+  0%,
+  100% {
+    border-color: var(--yellow);
+  }
+  50% {
+    border-color: rgba(210, 153, 34, 0.5);
+  }
+}
+.active-dag-header {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 0.35rem;
+}
+.active-dag-title {
+  font-weight: 600;
+  flex: 1;
+}
+.active-dag-meta {
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+  color: var(--muted);
+  font-size: 12px;
+  margin-bottom: 0.5rem;
+}
+.active-dag-link {
+  color: var(--link);
+  text-decoration: none;
+  font-size: 12px;
+}
+.active-dag-link:hover {
+  text-decoration: underline;
+}
+.dashboard-footer {
+  margin-top: 0.75rem;
+  color: var(--muted);
+  font-size: 12px;
+}
+.meta-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 0.5rem 1.5rem;
+}
+.meta-item dt {
+  color: var(--muted);
+  font-size: 11px;
+  text-transform: uppercase;
+  margin: 0;
+}
+.meta-item dd {
+  margin: 0.15rem 0 0;
+}
+table {
+  width: 100%;
+  border-collapse: collapse;
+}
+th,
+td {
+  text-align: left;
+  padding: 0.4rem 0.6rem;
+  border-bottom: 1px solid var(--border);
+}
+th {
+  color: var(--muted);
+  font-size: 11px;
+  text-transform: uppercase;
+  font-weight: 600;
+}
+tbody tr:hover {
+  background: rgba(255, 255, 255, 0.03);
+}
+tbody tr.clickable {
+  cursor: pointer;
+}
+tbody tr.dag-node-selected {
+  background: rgba(88, 166, 255, 0.12);
+}
+.timeline-node-label {
+  color: var(--muted);
+  font-size: 12px;
+  margin: 0 0 0.5rem;
+}
+.process-timeline-scroll {
+  max-height: 320px;
+  overflow-y: auto;
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  background: var(--bg);
+}
+.process-timeline {
+  list-style: none;
+  margin: 0;
+  padding: 0.25rem 0;
+}
+.process-timeline-item {
+  display: flex;
+  gap: 0.75rem;
+  padding: 0.35rem 0.75rem;
+  border-bottom: 1px solid var(--border);
+  font-size: 12px;
+}
+.process-timeline-item:last-child {
+  border-bottom: none;
+}
+.process-timeline-time {
+  flex: 0 0 4.5rem;
+  color: var(--muted);
+  font-variant-numeric: tabular-nums;
+}
+.process-timeline-label {
+  flex: 1;
+  word-break: break-word;
+}
+tbody tr.active-task {
+  background: rgba(210, 153, 34, 0.12);
+}
+.badge {
+  display: inline-block;
+  padding: 0.1rem 0.45rem;
+  border-radius: 4px;
+  font-size: 11px;
+  font-weight: 600;
+}
+.badge-succeeded,
+.badge-finished,
+.badge-completed,
+.badge-done {
+  background: rgba(63, 185, 80, 0.2);
+  color: var(--green);
+}
+.badge-failed,
+.badge-error {
+  background: rgba(248, 81, 73, 0.2);
+  color: var(--red);
+}
+.badge-partial-failed {
+  background: rgba(248, 81, 73, 0.15);
+  color: #ff9a8b;
+  border: 1px solid rgba(248, 81, 73, 0.35);
+}
+.badge-running,
+.badge-started {
+  background: rgba(210, 153, 34, 0.2);
+  color: var(--yellow);
+}
+.badge-skipped {
+  background: rgba(139, 148, 158, 0.15);
+  color: var(--muted);
+}
+.badge-stale {
+  background: rgba(139, 58, 58, 0.3);
+  color: #e06c75;
+}
+.badge-reused {
+  background: rgba(88, 166, 255, 0.2);
+  color: var(--blue);
+}
+.badge-pending,
+.badge-blocked,
+.badge-unknown,
+.badge-queued {
+  background: rgba(139, 148, 158, 0.15);
+  color: var(--muted);
+}
+.liveness-active {
+  background: rgba(63, 185, 80, 0.2);
+  color: var(--green);
+}
+.liveness-quiet {
+  background: rgba(210, 153, 34, 0.2);
+  color: var(--yellow);
+}
+.liveness-stale {
+  background: rgba(139, 58, 58, 0.3);
+  color: #e06c75;
+}
+.liveness-timeout-risk {
+  background: rgba(248, 81, 73, 0.25);
+  color: var(--red);
+}
+.rank-lanes {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+.rank-lane {
+  border-left: 3px solid var(--border);
+  padding-left: 0.75rem;
+}
+.rank-lane-label {
+  color: var(--muted);
+  font-size: 11px;
+  font-weight: 600;
+  margin-bottom: 0.35rem;
+}
+.rank-lane-nodes {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+.rank-node-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 0.25rem 0.5rem;
+  font-size: 12px;
+}
+.rank-node-active {
+  border-color: var(--yellow);
+  background: rgba(210, 153, 34, 0.12);
+}
+.rank-node-error {
+  border-color: var(--red);
+  background: rgba(248, 81, 73, 0.1);
+}
+.rank-node-id {
+  font-weight: 600;
+}
+.rank-node-dur {
+  color: var(--muted);
+  font-size: 10px;
+}
+.step-timeline {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+.step-timeline li {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 0.35rem 0;
+  border-bottom: 1px solid var(--border);
+}
+.step-timeline li:last-child {
+  border-bottom: none;
+}
+.step-marker {
+  width: 1.5rem;
+  text-align: center;
+  font-weight: 700;
+}
+.step-marker.succeeded {
+  color: var(--green);
+}
+.step-marker.running {
+  color: var(--yellow);
+}
+.step-marker.pending {
+  color: var(--muted);
+}
+.step-marker.failed {
+  color: var(--red);
+}
+.step-name {
+  flex: 1;
+}
+.step-duration {
+  color: var(--muted);
+  font-size: 11px;
+}
+.output-block {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 0.5rem 0.75rem;
+  white-space: pre-wrap;
+  word-break: break-all;
+  max-height: 240px;
+  overflow-y: auto;
+  font-size: 12px;
+}
+.output-preview {
+  margin: 0.5rem 0;
+}
+.output-preview summary {
+  cursor: pointer;
+  color: var(--link);
+  font-size: 12px;
+  margin-bottom: 0.25rem;
+}
+.error-preview summary {
+  color: var(--red);
+}
+.artifact-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+.artifact-list li {
+  padding: 0.25rem 0;
+}
+.artifact-list a {
+  color: var(--link);
+  text-decoration: none;
+}
+.artifact-list a:hover {
+  text-decoration: underline;
+}
+.empty {
+  color: var(--muted);
+  font-style: italic;
+}
+.link {
+  color: var(--link);
+  text-decoration: none;
+}
+.link:hover {
+  text-decoration: underline;
+}
+[hidden] {
+  display: none !important;
+}
+.dag-active-node {
+  background: rgba(210, 153, 34, 0.18);
+}
+.dag-error-node {
+  background: rgba(248, 81, 73, 0.12);
+}
+tbody tr.dag-active-node:hover {
+  background: rgba(210, 153, 34, 0.25);
+}
+tbody tr.dag-error-node:hover {
+  background: rgba(248, 81, 73, 0.18);
+}
+.dag-output-node {
+  margin: 0.5rem 0 0.25rem;
+  font-size: 12px;
+  color: var(--muted);
+}
+.step-link {
+  margin-left: 0.5rem;
+  color: var(--link);
+  text-decoration: none;
+  font-size: 11px;
+}
+.step-link:hover {
+  text-decoration: underline;
+}
+.inbox-link,
+.artifact-link {
+  color: var(--link);
+  text-decoration: none;
+  font-size: 11px;
+}
+.inbox-link:hover,
+.artifact-link:hover {
+  text-decoration: underline;
+}
+.artifact-links {
+  display: inline-flex;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+.artifact-links .muted {
+  color: var(--muted);
+}
+#failures-list .row-failed {
+  border-left: 3px solid var(--red, #e06c75);
+}
+#failures-list .row-blocked {
+  border-left: 3px solid var(--yellow, #d19a66);
+}