principles-disciple 1.71.0 → 1.73.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.
- package/openclaw.plugin.json +10 -5
- package/package.json +17 -19
- package/scripts/acceptance-test.mjs +16 -73
- package/scripts/sync-plugin.mjs +382 -77
- package/src/commands/archive-impl.ts +2 -1
- package/src/commands/capabilities.ts +2 -2
- package/src/commands/context.ts +2 -2
- package/src/commands/disable-impl.ts +2 -1
- package/src/commands/evolution-status.ts +16 -16
- package/src/commands/export.ts +12 -67
- package/src/commands/pain.ts +91 -1
- package/src/commands/principle-rollback.ts +2 -1
- package/src/commands/promote-impl.ts +7 -43
- package/src/commands/rollback-impl.ts +2 -1
- package/src/commands/rollback.ts +2 -1
- package/src/commands/samples.ts +2 -1
- package/src/commands/thinking-os.ts +2 -1
- package/src/config/errors.ts +18 -2
- package/src/constants/diagnostician.ts +2 -2
- package/src/constants/tools.ts +2 -1
- package/src/core/__tests__/focus-history.test.ts +210 -0
- package/src/core/config.ts +1 -1
- package/src/core/confirm-first-gate.ts +255 -0
- package/src/core/correction-cue-learner.ts +2 -136
- package/src/core/correction-types.ts +16 -88
- package/src/core/dictionary.ts +19 -20
- package/src/core/empathy-keyword-matcher.ts +17 -289
- package/src/core/empathy-types.ts +18 -229
- package/src/core/event-log.ts +38 -132
- package/src/core/evolution-reducer.ts +21 -2
- package/src/core/evolution-types.ts +76 -464
- package/src/core/file-store.ts +80 -0
- package/src/core/focus-history.ts +228 -955
- package/src/core/local-worker-routing.ts +34 -314
- package/src/core/merge-gate-audit.ts +0 -195
- package/src/core/pain-diagnostic-gate.ts +154 -0
- package/src/core/pain-signal.ts +21 -138
- package/src/core/pain.ts +15 -88
- package/src/core/pd-task-reconciler.ts +26 -115
- package/src/core/pd-task-service.ts +9 -9
- package/src/core/pd-task-types.ts +23 -127
- package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +174 -0
- package/src/core/principle-compiler/code-validator.ts +15 -42
- package/src/core/principle-compiler/compiler.ts +100 -15
- package/src/core/principle-compiler/index.ts +5 -2
- package/src/core/principle-compiler/template-generator.ts +4 -104
- package/src/core/principle-injection.ts +10 -202
- package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +42 -0
- package/src/core/principle-internalization/lifecycle-read-model.ts +39 -242
- package/src/core/principle-internalization/principle-lifecycle-service.ts +12 -10
- package/src/core/principle-tree-ledger-adapter.ts +145 -0
- package/src/core/principle-tree-ledger.ts +8 -6
- package/src/core/reflection/reflection-context.ts +14 -109
- package/src/core/replay-engine.ts +8 -500
- package/src/core/rule-host-helpers.ts +5 -35
- package/src/core/rule-host-types.ts +10 -82
- package/src/core/rule-host.ts +6 -63
- package/src/core/runtime-v2-prompt-activation-reader.ts +231 -0
- package/src/core/session-tracker.ts +87 -101
- package/src/core/shadow-observation-registry.ts +19 -48
- package/src/core/trajectory.ts +3 -1
- package/src/core/workflow-funnel-loader.ts +62 -68
- package/src/core/workspace-context.ts +46 -0
- package/src/core/workspace-dir-service.ts +1 -1
- package/src/core/workspace-dir-validation.ts +18 -9
- package/src/hooks/AGENTS.md +1 -1
- package/src/hooks/gate-block-helper.ts +46 -44
- package/src/hooks/gate.ts +207 -7
- package/src/hooks/lifecycle.ts +30 -32
- package/src/hooks/llm.ts +60 -32
- package/src/hooks/pain.ts +297 -103
- package/src/hooks/prompt.ts +469 -339
- package/src/hooks/subagent.ts +2 -29
- package/src/i18n/commands.ts +2 -10
- package/src/index.ts +95 -85
- package/src/openclaw-sdk.ts +311 -0
- package/src/service/central-database.ts +8 -4
- package/src/service/evolution-queue-migration.ts +2 -1
- package/src/service/evolution-worker.ts +163 -1786
- package/src/service/internalization-trigger-adapter.ts +302 -0
- package/src/service/keyword-optimization-service.ts +4 -4
- package/src/service/monitoring-query-service.ts +1 -215
- package/src/service/queue-io.ts +60 -331
- package/src/service/runtime-summary-service.ts +115 -18
- package/src/service/subagent-workflow/index.ts +0 -41
- package/src/service/subagent-workflow/types.ts +9 -120
- package/src/service/subagent-workflow/workflow-store.ts +2 -119
- package/src/service/workflow-watchdog.ts +0 -43
- package/src/types/event-payload.ts +16 -74
- package/src/types/event-types.ts +39 -547
- package/src/types/hygiene-types.ts +7 -30
- package/src/types/principle-tree-schema.ts +20 -222
- package/src/types/queue.ts +15 -70
- package/src/types/runtime-summary.ts +5 -49
- package/src/utils/io.ts +10 -0
- package/src/utils/retry.ts +1 -1
- package/src/utils/shadow-fingerprint.ts +2 -2
- package/src/utils/workspace-resolver.ts +50 -0
- package/templates/langs/en/core/AGENTS.md +2 -2
- package/templates/langs/en/core/BOOT.md +1 -1
- package/templates/langs/en/core/HEARTBEAT.md +2 -2
- package/templates/langs/en/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
- package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
- package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
- package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
- package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
- package/templates/langs/en/skills/ai-sprint-orchestration/runtime/.gitignore +2 -2
- package/templates/langs/en/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
- package/templates/langs/en/skills/evolve-task/SKILL.md +1 -1
- package/templates/langs/en/skills/pd-cli-operator/SKILL.md +67 -0
- package/templates/langs/en/skills/pd-diagnostician/SKILL.md +1 -1
- package/templates/langs/en/skills/pd-mentor/SKILL.md +1 -1
- package/templates/langs/en/skills/pd-pain-signal/SKILL.md +17 -39
- package/templates/langs/en/skills/pd-runtime-v2/SKILL.md +61 -0
- package/templates/langs/zh/core/AGENTS.md +2 -2
- package/templates/langs/zh/core/BOOT.md +1 -1
- package/templates/langs/zh/core/HEARTBEAT.md +2 -2
- package/templates/langs/zh/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
- package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
- package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
- package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/nocturnal-trinity-quality-enhancement.json +8 -8
- package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
- package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
- package/templates/langs/zh/skills/ai-sprint-orchestration/runtime/.gitignore +2 -2
- package/templates/langs/zh/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
- package/templates/langs/zh/skills/ai-sprint-orchestration/test/run.test.mjs +21 -5
- package/templates/langs/zh/skills/evolve-task/SKILL.md +2 -2
- package/templates/langs/zh/skills/pd-cli-operator/SKILL.md +67 -0
- package/templates/langs/zh/skills/pd-diagnostician/SKILL.md +1 -1
- package/templates/langs/zh/skills/pd-mentor/SKILL.md +1 -1
- package/templates/langs/zh/skills/pd-pain-signal/SKILL.md +17 -38
- package/templates/langs/zh/skills/pd-runtime-v2/SKILL.md +61 -0
- package/tests/build-artifacts.test.ts +1 -3
- package/tests/commands/evolution-status.test.ts +0 -118
- package/tests/core/bootstrap-rules.test.ts +1 -1
- package/tests/core/config.test.ts +1 -1
- package/tests/core/event-log.test.ts +35 -0
- package/tests/core/evolution-engine.test.ts +610 -0
- package/tests/core/file-store.test.ts +102 -0
- package/tests/core/focus-history.test.ts +203 -11
- package/tests/core/merge-gate-audit.test.ts +2 -169
- package/tests/core/model-deployment-registry.test.ts +7 -1
- package/tests/core/model-training-registry.test.ts +19 -0
- package/tests/core/observability.test.ts +0 -1
- package/tests/core/pain-diagnostic-gate.test.ts +498 -0
- package/tests/core/pain.test.ts +0 -1
- package/tests/core/principle-internalization/deprecated-readiness.test.ts +2 -2
- package/tests/core/principle-internalization/lifecycle-metrics.test.ts +2 -2
- package/tests/core/principle-internalization/{internalization-routing-policy.test.ts → lifecycle-routing-policy.test.ts} +6 -6
- package/tests/core/principle-internalization/lineage-source-retired.test.ts +56 -0
- package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +1 -23
- package/tests/core/principle-tree-ledger-adapter.test.ts +253 -0
- package/tests/core/reflection-context.test.ts +0 -14
- package/tests/core/replay-engine.test.ts +127 -215
- package/tests/core/rule-host-helpers.test.ts +2 -2
- package/tests/core/rule-implementation-runtime.test.ts +0 -27
- package/tests/core/workflow-funnel-loader.test.ts +162 -0
- package/tests/core/workspace-dir-validation.test.ts +8 -1
- package/tests/core-anti-growth.test.ts +192 -0
- package/tests/hook-workspace-nextaction-contract.test.ts +42 -0
- package/tests/hooks/confirm-first-gate.test.ts +333 -0
- package/tests/hooks/gate-auto-correct-shadow.test.ts +310 -0
- package/tests/hooks/gate-auto-correct.test.ts +665 -0
- package/tests/hooks/gate-rule-host-pipeline.test.ts +2 -1
- package/tests/hooks/pain.test.ts +269 -12
- package/tests/hooks/prompt-characterization.test.ts +500 -0
- package/tests/hooks/prompt-size-guard.test.ts +329 -0
- package/tests/hooks/runtime-v2-prompt-activation.test.ts +869 -0
- package/tests/index.test.ts +94 -1
- package/tests/integration/auto-entry-gate.test.ts +248 -0
- package/tests/integration/internalization-trigger-guard.test.ts +69 -0
- package/tests/integration/m8-legacy-paths.test.ts +63 -0
- package/tests/integration/runtime-v2-pain-guard.test.ts +125 -0
- package/tests/plugin-config-resolution-cutover.test.ts +359 -0
- package/tests/runtime-v2-discovery-guard.test.ts +154 -0
- package/tests/service/central-database.test.ts +457 -0
- package/tests/service/evolution-worker.correction-observer.test.ts +173 -0
- package/tests/service/evolution-worker.timeout.test.ts +11 -129
- package/tests/service/internalization-trigger-adapter.test.ts +251 -0
- package/tests/service/monitoring-query-service.test.ts +1 -47
- package/tests/service/queue-io.test.ts +1 -62
- package/tests/service/runtime-summary-service.test.ts +184 -3
- package/tests/service/workflow-watchdog.test.ts +0 -91
- package/tests/utils/file-lock.test.ts +5 -3
- package/tests/utils/session-key.test.ts +52 -0
- package/tests/utils/subagent-probe.test.ts +48 -1
- package/vitest.config.ts +4 -11
- package/.planning/codebase/ARCHITECTURE.md +0 -157
- package/.planning/codebase/CONCERNS.md +0 -145
- package/.planning/codebase/CONVENTIONS.md +0 -148
- package/.planning/codebase/INTEGRATIONS.md +0 -81
- package/.planning/codebase/STACK.md +0 -87
- package/.planning/codebase/STRUCTURE.md +0 -193
- package/.planning/codebase/TESTING.md +0 -243
- package/.planning/phases/01-basic-visualization/01-GAP-CLOSURE-VERIFICATION.md +0 -113
- package/docs/COMMAND_REFERENCE.md +0 -76
- package/docs/COMMAND_REFERENCE_EN.md +0 -79
- package/scripts/build-web.mjs +0 -46
- package/scripts/diagnose-nocturnal.mjs +0 -537
- package/scripts/seed-nocturnal-scenarios.mjs +0 -384
- package/src/commands/nocturnal-review.ts +0 -322
- package/src/commands/nocturnal-rollout.ts +0 -790
- package/src/commands/nocturnal-train.ts +0 -986
- package/src/commands/pd-reflect.ts +0 -88
- package/src/core/adaptive-thresholds.ts +0 -478
- package/src/core/diagnostician-task-store.ts +0 -192
- package/src/core/nocturnal-arbiter.ts +0 -715
- package/src/core/nocturnal-artifact-lineage.ts +0 -116
- package/src/core/nocturnal-artificer.ts +0 -257
- package/src/core/nocturnal-candidate-scoring.ts +0 -530
- package/src/core/nocturnal-compliance.ts +0 -1146
- package/src/core/nocturnal-dataset.ts +0 -763
- package/src/core/nocturnal-executability.ts +0 -428
- package/src/core/nocturnal-export.ts +0 -499
- package/src/core/nocturnal-paths.ts +0 -240
- package/src/core/nocturnal-reasoning-deriver.ts +0 -343
- package/src/core/nocturnal-rule-implementation-validator.ts +0 -246
- package/src/core/nocturnal-snapshot-contract.ts +0 -99
- package/src/core/nocturnal-trajectory-extractor.ts +0 -512
- package/src/core/nocturnal-trinity-types.ts +0 -218
- package/src/core/nocturnal-trinity.ts +0 -2680
- package/src/core/principle-internalization/deprecated-readiness.ts +0 -93
- package/src/core/principle-internalization/internalization-routing-policy.ts +0 -208
- package/src/core/principle-internalization/lifecycle-metrics.ts +0 -152
- package/src/http/principles-console-route.ts +0 -709
- package/src/service/central-health-service.ts +0 -49
- package/src/service/central-overview-service.ts +0 -138
- package/src/service/control-ui-query-service.ts +0 -900
- package/src/service/cooldown-strategy.ts +0 -97
- package/src/service/evolution-pain-context.ts +0 -79
- package/src/service/evolution-query-service.ts +0 -407
- package/src/service/health-query-service.ts +0 -1038
- package/src/service/nocturnal-config.ts +0 -214
- package/src/service/nocturnal-runtime.ts +0 -734
- package/src/service/nocturnal-service.ts +0 -1605
- package/src/service/nocturnal-target-selector.ts +0 -545
- package/src/service/sleep-cycle.ts +0 -157
- package/src/service/startup-reconciler.ts +0 -112
- package/src/service/subagent-workflow/correction-observer-types.ts +0 -82
- package/src/service/subagent-workflow/correction-observer-workflow-manager.ts +0 -250
- package/src/service/subagent-workflow/deep-reflect-workflow-manager.ts +0 -1
- package/src/service/subagent-workflow/dynamic-timeout.ts +0 -30
- package/src/service/subagent-workflow/empathy-observer-workflow-manager.ts +0 -268
- package/src/service/subagent-workflow/nocturnal-workflow-manager.ts +0 -795
- package/src/service/subagent-workflow/runtime-direct-driver.ts +0 -268
- package/src/service/subagent-workflow/workflow-manager-base.ts +0 -580
- package/src/tools/write-pain-flag.ts +0 -215
- package/tests/commands/nocturnal-review.test.ts +0 -448
- package/tests/commands/nocturnal-train.test.ts +0 -97
- package/tests/commands/pd-reflect.test.ts +0 -49
- package/tests/core/adaptive-thresholds.test.ts +0 -261
- package/tests/core/nocturnal-arbiter.test.ts +0 -559
- package/tests/core/nocturnal-artifact-lineage.test.ts +0 -53
- package/tests/core/nocturnal-artificer.test.ts +0 -241
- package/tests/core/nocturnal-candidate-scoring.test.ts +0 -532
- package/tests/core/nocturnal-compliance-p-principles.test.ts +0 -133
- package/tests/core/nocturnal-compliance.test.ts +0 -646
- package/tests/core/nocturnal-dataset.test.ts +0 -892
- package/tests/core/nocturnal-e2e.test.ts +0 -234
- package/tests/core/nocturnal-executability.test.ts +0 -357
- package/tests/core/nocturnal-export.test.ts +0 -517
- package/tests/core/nocturnal-reasoning-deriver.test.ts +0 -372
- package/tests/core/nocturnal-reviewed-subset-comparison.test.ts +0 -428
- package/tests/core/nocturnal-rule-implementation-validator.test.ts +0 -127
- package/tests/core/nocturnal-snapshot-contract.test.ts +0 -121
- package/tests/core/nocturnal-trajectory-extractor.test.ts +0 -634
- package/tests/core/nocturnal-trinity.test.ts +0 -2053
- package/tests/core/pain-auto-repair.test.ts +0 -96
- package/tests/core/pain-integration.test.ts +0 -510
- package/tests/fixtures/nocturnal-reviewed-subset.json +0 -183
- package/tests/http/principles-console-route.test.ts +0 -162
- package/tests/integration/chaos-resilience.test.ts +0 -348
- package/tests/integration/empathy-workflow-integration.test.ts +0 -626
- package/tests/integration/pain-diagnostician-loop.e2e.test.ts +0 -380
- package/tests/service/control-ui-query-service.test.ts +0 -121
- package/tests/service/cooldown-strategy.test.ts +0 -164
- package/tests/service/data-endpoints-regression.test.ts +0 -834
- package/tests/service/empathy-observer-workflow-manager.test.ts +0 -175
- package/tests/service/evolution-worker.nocturnal.test.ts +0 -601
- package/tests/service/nocturnal-runtime-hardening.test.ts +0 -118
- package/tests/service/nocturnal-runtime.test.ts +0 -473
- package/tests/service/nocturnal-service-code-candidate.test.ts +0 -330
- package/tests/service/nocturnal-target-selector.test.ts +0 -615
- package/tests/service/startup-reconciler.test.ts +0 -148
- package/tests/tools/write-pain-flag.test.ts +0 -358
- package/ui/src/App.tsx +0 -45
- package/ui/src/api.ts +0 -220
- package/ui/src/charts.tsx +0 -955
- package/ui/src/components/ErrorState.tsx +0 -6
- package/ui/src/components/Loading.tsx +0 -13
- package/ui/src/components/ProtectedRoute.tsx +0 -12
- package/ui/src/components/Shell.tsx +0 -91
- package/ui/src/components/WorkspaceConfig.tsx +0 -178
- package/ui/src/components/index.ts +0 -5
- package/ui/src/context/auth.tsx +0 -80
- package/ui/src/context/theme.tsx +0 -66
- package/ui/src/hooks/useAutoRefresh.ts +0 -39
- package/ui/src/i18n/ui.ts +0 -473
- package/ui/src/main.tsx +0 -16
- package/ui/src/pages/EvolutionPage.tsx +0 -333
- package/ui/src/pages/FeedbackPage.tsx +0 -138
- package/ui/src/pages/GateMonitorPage.tsx +0 -136
- package/ui/src/pages/LoginPage.tsx +0 -89
- package/ui/src/pages/OverviewPage.tsx +0 -599
- package/ui/src/pages/SamplesPage.tsx +0 -174
- package/ui/src/pages/ThinkingModelsPage.tsx +0 -702
- package/ui/src/styles.css +0 -2020
- package/ui/src/types.ts +0 -384
- package/ui/src/utils/format.ts +0 -15
|
@@ -1,709 +0,0 @@
|
|
|
1
|
-
import * as crypto from 'crypto';
|
|
2
|
-
import fs from 'fs';
|
|
3
|
-
import path from 'path';
|
|
4
|
-
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
5
|
-
import type { OpenClawPluginApi, OpenClawPluginHttpRouteParams } from '../openclaw-sdk.js';
|
|
6
|
-
import { ControlUiQueryService } from '../service/control-ui-query-service.js';
|
|
7
|
-
import { getEvolutionQueryService } from '../service/evolution-query-service.js';
|
|
8
|
-
import { HealthQueryService } from '../service/health-query-service.js';
|
|
9
|
-
import { TrajectoryRegistry } from '../core/trajectory.js';
|
|
10
|
-
import { getCentralDatabase } from '../service/central-database.js';
|
|
11
|
-
import { CentralOverviewService } from '../service/central-overview-service.js';
|
|
12
|
-
import { CentralHealthService } from '../service/central-health-service.js';
|
|
13
|
-
import { resolveRequiredWorkspaceDir } from '../core/workspace-dir-service.js';
|
|
14
|
-
|
|
15
|
-
const ROUTE_PREFIX = '/plugins/principles';
|
|
16
|
-
const API_PREFIX = `${ROUTE_PREFIX}/api`;
|
|
17
|
-
const ASSETS_PREFIX = `${ROUTE_PREFIX}/assets`;
|
|
18
|
-
|
|
19
|
-
function json(res: ServerResponse, statusCode: number, payload: unknown): void {
|
|
20
|
-
const body = JSON.stringify(payload, null, 2);
|
|
21
|
-
res.statusCode = statusCode;
|
|
22
|
-
res.setHeader('Content-Type', 'application/json; charset=utf-8');
|
|
23
|
-
res.end(body);
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
function text(res: ServerResponse, statusCode: number, body: string): void {
|
|
27
|
-
res.statusCode = statusCode;
|
|
28
|
-
res.setHeader('Content-Type', 'text/plain; charset=utf-8');
|
|
29
|
-
res.end(body);
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function contentTypeFor(filePath: string): string {
|
|
33
|
-
const ext = path.extname(filePath).toLowerCase();
|
|
34
|
-
switch (ext) {
|
|
35
|
-
case '.html':
|
|
36
|
-
return 'text/html; charset=utf-8';
|
|
37
|
-
case '.css':
|
|
38
|
-
return 'text/css; charset=utf-8';
|
|
39
|
-
case '.js':
|
|
40
|
-
return 'application/javascript; charset=utf-8';
|
|
41
|
-
case '.json':
|
|
42
|
-
return 'application/json; charset=utf-8';
|
|
43
|
-
case '.svg':
|
|
44
|
-
return 'image/svg+xml';
|
|
45
|
-
default:
|
|
46
|
-
return 'application/octet-stream';
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
async function readJsonBody(req: IncomingMessage): Promise<Record<string, unknown>> {
|
|
51
|
-
const chunks: Buffer[] = [];
|
|
52
|
-
for await (const chunk of req) {
|
|
53
|
-
chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
|
|
54
|
-
}
|
|
55
|
-
if (chunks.length === 0) return {};
|
|
56
|
-
const body = Buffer.concat(chunks).toString('utf8');
|
|
57
|
-
try {
|
|
58
|
-
return JSON.parse(body) as Record<string, unknown>;
|
|
59
|
-
} catch {
|
|
60
|
-
throw new Error('invalid_json');
|
|
61
|
-
}
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
function safeStaticPath(rootDir: string, requestPath: string): string | null {
|
|
65
|
-
const relative = requestPath.startsWith(ASSETS_PREFIX)
|
|
66
|
-
? requestPath.slice(ASSETS_PREFIX.length).replace(/^\/+/, '')
|
|
67
|
-
: '';
|
|
68
|
-
const normalized = path.normalize(relative);
|
|
69
|
-
const webRoot = path.join(rootDir, 'dist', 'web');
|
|
70
|
-
const assetsRoot = path.join(webRoot, 'assets');
|
|
71
|
-
const target = path.join(assetsRoot, normalized);
|
|
72
|
-
const relativeTarget = path.relative(assetsRoot, target);
|
|
73
|
-
if (relativeTarget.startsWith('..') || path.isAbsolute(relativeTarget)) {
|
|
74
|
-
return null;
|
|
75
|
-
}
|
|
76
|
-
return target;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
function serveFile(res: ServerResponse, filePath: string): boolean {
|
|
80
|
-
if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
|
|
81
|
-
return false;
|
|
82
|
-
}
|
|
83
|
-
res.statusCode = 200;
|
|
84
|
-
res.setHeader('Content-Type', contentTypeFor(filePath));
|
|
85
|
-
const stream = fs.createReadStream(filePath);
|
|
86
|
-
stream.on('error', () => {
|
|
87
|
-
res.statusCode = 500;
|
|
88
|
-
res.end('Internal Server Error');
|
|
89
|
-
});
|
|
90
|
-
stream.pipe(res);
|
|
91
|
-
return true;
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
function createService(api: OpenClawPluginApi): ControlUiQueryService {
|
|
95
|
-
const workspaceDir = resolveRequiredWorkspaceDir(api, { agentId: 'main' }, { source: 'principles_console.control_ui', fallbackAgentId: 'main' });
|
|
96
|
-
return new ControlUiQueryService(workspaceDir);
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
function handleApiRoute(
|
|
102
|
-
api: OpenClawPluginApi,
|
|
103
|
-
pathname: string,
|
|
104
|
-
req: IncomingMessage,
|
|
105
|
-
res: ServerResponse,
|
|
106
|
-
): Promise<boolean> | boolean {
|
|
107
|
-
// Check authentication for API routes
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
if (!validateGatewayAuth(req)) {
|
|
111
|
-
json(res, 401, { error: 'unauthorized', message: 'Valid Gateway token required.' });
|
|
112
|
-
return true;
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
let service: ControlUiQueryService;
|
|
117
|
-
try {
|
|
118
|
-
service = createService(api);
|
|
119
|
-
} catch (error) {
|
|
120
|
-
api.logger.warn(`[PD:ControlUI] Failed to resolve workspace for ${pathname}: ${String(error)}`);
|
|
121
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
122
|
-
return true;
|
|
123
|
-
}
|
|
124
|
-
const url = new URL(req.url || pathname, 'http://127.0.0.1');
|
|
125
|
-
const method = (req.method || 'GET').toUpperCase();
|
|
126
|
-
|
|
127
|
-
const done = (fn: () => unknown): boolean => {
|
|
128
|
-
try {
|
|
129
|
-
const payload = fn();
|
|
130
|
-
json(res, 200, payload);
|
|
131
|
-
return true;
|
|
132
|
-
} catch (error) {
|
|
133
|
-
api.logger.warn(`[PD:ControlUI] API request failed for ${pathname}: ${String(error)}`);
|
|
134
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
135
|
-
return true;
|
|
136
|
-
} finally {
|
|
137
|
-
service.dispose();
|
|
138
|
-
}
|
|
139
|
-
};
|
|
140
|
-
|
|
141
|
-
// Helper to parse and clamp days parameter
|
|
142
|
-
const parseDays = (param: string | null): number => {
|
|
143
|
-
const value = param ? Number(param) : 30;
|
|
144
|
-
if (!Number.isFinite(value) || value < 1) return 30;
|
|
145
|
-
return Math.min(365, Math.max(1, Math.floor(value)));
|
|
146
|
-
};
|
|
147
|
-
|
|
148
|
-
if (pathname === `${API_PREFIX}/overview` && method === 'GET') {
|
|
149
|
-
const days = parseDays(url.searchParams.get('days'));
|
|
150
|
-
return done(() => service.getOverview(days));
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
if (pathname === `${API_PREFIX}/central/overview` && method === 'GET') {
|
|
154
|
-
const days = parseDays(url.searchParams.get('days'));
|
|
155
|
-
return done(() => {
|
|
156
|
-
const centralOverviewService = new CentralOverviewService();
|
|
157
|
-
try {
|
|
158
|
-
return centralOverviewService.getOverview(days);
|
|
159
|
-
} finally {
|
|
160
|
-
centralOverviewService.dispose();
|
|
161
|
-
}
|
|
162
|
-
});
|
|
163
|
-
}
|
|
164
|
-
|
|
165
|
-
if (pathname === `${API_PREFIX}/central/sync` && method === 'POST') {
|
|
166
|
-
return done(() => {
|
|
167
|
-
const centralDb = getCentralDatabase();
|
|
168
|
-
const results = centralDb.syncEnabled();
|
|
169
|
-
const summary: Record<string, number> = {};
|
|
170
|
-
results.forEach((count, name) => {
|
|
171
|
-
summary[name] = count;
|
|
172
|
-
});
|
|
173
|
-
return { synced: summary, timestamp: new Date().toISOString() };
|
|
174
|
-
});
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
if (pathname === `${API_PREFIX}/central/workspaces` && method === 'GET') {
|
|
178
|
-
return done(() => {
|
|
179
|
-
const centralDb = getCentralDatabase();
|
|
180
|
-
const configs = centralDb.getWorkspaceConfigs();
|
|
181
|
-
const workspaces = centralDb.getWorkspaces();
|
|
182
|
-
return {
|
|
183
|
-
configs,
|
|
184
|
-
workspaces: workspaces.map(ws => ({
|
|
185
|
-
name: ws.name,
|
|
186
|
-
path: ws.path,
|
|
187
|
-
lastSync: ws.lastSync,
|
|
188
|
-
config: configs.find(c => c.workspaceName === ws.name) ?? null,
|
|
189
|
-
})),
|
|
190
|
-
};
|
|
191
|
-
});
|
|
192
|
-
}
|
|
193
|
-
|
|
194
|
-
// === Central Health: per-workspace health indicators ===
|
|
195
|
-
if (pathname === `${API_PREFIX}/central/health` && method === 'GET') {
|
|
196
|
-
return done(() => {
|
|
197
|
-
return new CentralHealthService().getAllWorkspaceHealth();
|
|
198
|
-
});
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
const workspaceConfigMatch = /^\/plugins\/principles\/api\/central\/workspaces\/([^/]+)$/.exec(pathname);
|
|
202
|
-
if (workspaceConfigMatch && method === 'GET') {
|
|
203
|
-
return done(() => {
|
|
204
|
-
const centralDb = getCentralDatabase();
|
|
205
|
-
const workspaceName = decodeURIComponent(workspaceConfigMatch[1]);
|
|
206
|
-
const configs = centralDb.getWorkspaceConfigs();
|
|
207
|
-
const config = configs.find(c => c.workspaceName === workspaceName);
|
|
208
|
-
return config ?? { workspaceName, enabled: true, displayName: workspaceName, syncEnabled: true };
|
|
209
|
-
});
|
|
210
|
-
}
|
|
211
|
-
|
|
212
|
-
if (workspaceConfigMatch && method === 'PATCH') {
|
|
213
|
-
return (async () => {
|
|
214
|
-
try {
|
|
215
|
-
const body = await readJsonBody(req);
|
|
216
|
-
const centralDb = getCentralDatabase();
|
|
217
|
-
const workspaceName = decodeURIComponent(workspaceConfigMatch[1]);
|
|
218
|
-
centralDb.updateWorkspaceConfig(workspaceName, {
|
|
219
|
-
enabled: body.enabled as boolean | undefined,
|
|
220
|
-
displayName: body.displayName as string | null | undefined,
|
|
221
|
-
syncEnabled: body.syncEnabled as boolean | undefined,
|
|
222
|
-
});
|
|
223
|
-
const configs = centralDb.getWorkspaceConfigs();
|
|
224
|
-
json(res, 200, configs.find(c => c.workspaceName === workspaceName));
|
|
225
|
-
return true;
|
|
226
|
-
} catch (error) {
|
|
227
|
-
if (error instanceof Error && error.message === 'invalid_json') {
|
|
228
|
-
json(res, 400, { error: 'bad_request', message: 'Request body must be valid JSON.' });
|
|
229
|
-
return true;
|
|
230
|
-
}
|
|
231
|
-
api.logger.warn(`[PD:ControlUI] Workspace config update failed: ${String(error)}`);
|
|
232
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
233
|
-
return true;
|
|
234
|
-
}
|
|
235
|
-
})();
|
|
236
|
-
}
|
|
237
|
-
|
|
238
|
-
if (pathname === `${API_PREFIX}/central/workspaces` && method === 'POST') {
|
|
239
|
-
return (async () => {
|
|
240
|
-
try {
|
|
241
|
-
const body = await readJsonBody(req);
|
|
242
|
-
const name = typeof body.name === 'string' ? body.name : '';
|
|
243
|
-
const workspacePath = typeof body.path === 'string' ? body.path : '';
|
|
244
|
-
if (!name || !workspacePath) {
|
|
245
|
-
json(res, 400, { error: 'bad_request', message: 'name and path are required.' });
|
|
246
|
-
return true;
|
|
247
|
-
}
|
|
248
|
-
const centralDb = getCentralDatabase();
|
|
249
|
-
centralDb.addCustomWorkspace(name, workspacePath);
|
|
250
|
-
json(res, 201, { success: true, workspace: name });
|
|
251
|
-
return true;
|
|
252
|
-
} catch (error) {
|
|
253
|
-
if (error instanceof Error && error.message === 'invalid_json') {
|
|
254
|
-
json(res, 400, { error: 'bad_request', message: 'Request body must be valid JSON.' });
|
|
255
|
-
return true;
|
|
256
|
-
}
|
|
257
|
-
api.logger.warn(`[PD:ControlUI] Add workspace failed: ${String(error)}`);
|
|
258
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
259
|
-
return true;
|
|
260
|
-
}
|
|
261
|
-
})();
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
if (pathname === `${API_PREFIX}/samples` && method === 'GET') {
|
|
265
|
-
return done(() => service.listSamples({
|
|
266
|
-
status: url.searchParams.get('status') ?? undefined,
|
|
267
|
-
qualityMin: url.searchParams.has('qualityMin') ? Number(url.searchParams.get('qualityMin')) : undefined,
|
|
268
|
-
dateFrom: url.searchParams.get('dateFrom') ?? undefined,
|
|
269
|
-
dateTo: url.searchParams.get('dateTo') ?? undefined,
|
|
270
|
-
failureMode: url.searchParams.get('failureMode') ?? undefined,
|
|
271
|
-
page: url.searchParams.has('page') ? Number(url.searchParams.get('page')) : undefined,
|
|
272
|
-
pageSize: url.searchParams.has('pageSize') ? Number(url.searchParams.get('pageSize')) : undefined,
|
|
273
|
-
}));
|
|
274
|
-
}
|
|
275
|
-
|
|
276
|
-
const sampleDetailMatch = /^\/plugins\/principles\/api\/samples\/([^/]+)$/.exec(pathname);
|
|
277
|
-
if (sampleDetailMatch && method === 'GET') {
|
|
278
|
-
try {
|
|
279
|
-
const detail = service.getSampleDetail(decodeURIComponent(sampleDetailMatch[1]));
|
|
280
|
-
if (!detail) {
|
|
281
|
-
json(res, 404, { error: 'not_found', message: 'Sample not found.' });
|
|
282
|
-
return true;
|
|
283
|
-
}
|
|
284
|
-
json(res, 200, detail);
|
|
285
|
-
return true;
|
|
286
|
-
} catch (error) {
|
|
287
|
-
api.logger.warn(`[PD:ControlUI] API request failed for ${pathname}: ${String(error)}`);
|
|
288
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
289
|
-
return true;
|
|
290
|
-
} finally {
|
|
291
|
-
service.dispose();
|
|
292
|
-
}
|
|
293
|
-
}
|
|
294
|
-
|
|
295
|
-
const sampleReviewMatch = /^\/plugins\/principles\/api\/samples\/([^/]+)\/review$/.exec(pathname);
|
|
296
|
-
if (sampleReviewMatch && method === 'POST') {
|
|
297
|
-
return (async () => {
|
|
298
|
-
try {
|
|
299
|
-
const body = await readJsonBody(req);
|
|
300
|
-
const decision = body.decision === 'approved' || body.decision === 'rejected'
|
|
301
|
-
? body.decision
|
|
302
|
-
: null;
|
|
303
|
-
if (!decision) {
|
|
304
|
-
json(res, 400, { error: 'bad_request', message: 'decision must be approved or rejected' });
|
|
305
|
-
return true;
|
|
306
|
-
}
|
|
307
|
-
const record = service.reviewSample(
|
|
308
|
-
decodeURIComponent(sampleReviewMatch[1]),
|
|
309
|
-
decision,
|
|
310
|
-
typeof body.note === 'string' ? body.note : undefined,
|
|
311
|
-
);
|
|
312
|
-
json(res, 200, record);
|
|
313
|
-
return true;
|
|
314
|
-
} catch (error) {
|
|
315
|
-
if (error instanceof Error && error.message === 'invalid_json') {
|
|
316
|
-
json(res, 400, { error: 'bad_request', message: 'Request body must be valid JSON.' });
|
|
317
|
-
return true;
|
|
318
|
-
}
|
|
319
|
-
api.logger.warn(`[PD:ControlUI] Review request failed for ${pathname}: ${String(error)}`);
|
|
320
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
321
|
-
return true;
|
|
322
|
-
} finally {
|
|
323
|
-
service.dispose();
|
|
324
|
-
}
|
|
325
|
-
})();
|
|
326
|
-
}
|
|
327
|
-
|
|
328
|
-
if (pathname === `${API_PREFIX}/thinking` && method === 'GET') {
|
|
329
|
-
return done(() => service.getThinkingOverview());
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
const thinkingDetailMatch = /^\/plugins\/principles\/api\/thinking\/models\/([^/]+)$/.exec(pathname);
|
|
333
|
-
if (thinkingDetailMatch && method === 'GET') {
|
|
334
|
-
try {
|
|
335
|
-
const detail = service.getThinkingModelDetail(decodeURIComponent(thinkingDetailMatch[1]));
|
|
336
|
-
if (!detail) {
|
|
337
|
-
json(res, 404, { error: 'not_found', message: 'Thinking model not found.' });
|
|
338
|
-
return true;
|
|
339
|
-
}
|
|
340
|
-
json(res, 200, detail);
|
|
341
|
-
return true;
|
|
342
|
-
} catch (error) {
|
|
343
|
-
api.logger.warn(`[PD:ControlUI] API request failed for ${pathname}: ${String(error)}`);
|
|
344
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
345
|
-
return true;
|
|
346
|
-
} finally {
|
|
347
|
-
service.dispose();
|
|
348
|
-
}
|
|
349
|
-
}
|
|
350
|
-
|
|
351
|
-
// === Evolution API ===
|
|
352
|
-
const evolutionService = () => {
|
|
353
|
-
const workspaceDir = resolveRequiredWorkspaceDir(api, { agentId: 'main' }, { source: 'principles_console.evolution', fallbackAgentId: 'main' });
|
|
354
|
-
const trajectory = TrajectoryRegistry.get(workspaceDir);
|
|
355
|
-
return getEvolutionQueryService(trajectory);
|
|
356
|
-
};
|
|
357
|
-
|
|
358
|
-
if (pathname === `${API_PREFIX}/evolution/tasks` && method === 'GET') {
|
|
359
|
-
return done(() => {
|
|
360
|
-
const evoService = evolutionService();
|
|
361
|
-
return evoService.getTasks({
|
|
362
|
-
status: url.searchParams.get('status') ?? undefined,
|
|
363
|
-
dateFrom: url.searchParams.get('dateFrom') ?? undefined,
|
|
364
|
-
dateTo: url.searchParams.get('dateTo') ?? undefined,
|
|
365
|
-
page: url.searchParams.has('page') ? Number(url.searchParams.get('page')) : undefined,
|
|
366
|
-
pageSize: url.searchParams.has('pageSize') ? Number(url.searchParams.get('pageSize')) : undefined,
|
|
367
|
-
});
|
|
368
|
-
});
|
|
369
|
-
}
|
|
370
|
-
|
|
371
|
-
if (pathname === `${API_PREFIX}/evolution/events` && method === 'GET') {
|
|
372
|
-
return done(() => {
|
|
373
|
-
const evoService = evolutionService();
|
|
374
|
-
return evoService.getEvents({
|
|
375
|
-
traceId: url.searchParams.get('traceId') ?? undefined,
|
|
376
|
-
stage: url.searchParams.get('stage') ?? undefined,
|
|
377
|
-
limit: url.searchParams.has('limit') ? Number(url.searchParams.get('limit')) : undefined,
|
|
378
|
-
offset: url.searchParams.has('offset') ? Number(url.searchParams.get('offset')) : undefined,
|
|
379
|
-
});
|
|
380
|
-
});
|
|
381
|
-
}
|
|
382
|
-
|
|
383
|
-
if (pathname === `${API_PREFIX}/evolution/stats` && method === 'GET') {
|
|
384
|
-
const days = parseDays(url.searchParams.get('days'));
|
|
385
|
-
return done(() => {
|
|
386
|
-
const evoService = evolutionService();
|
|
387
|
-
return evoService.getStats(days);
|
|
388
|
-
});
|
|
389
|
-
}
|
|
390
|
-
|
|
391
|
-
const evolutionTraceMatch = /^\/plugins\/principles\/api\/evolution\/trace\/([^/]+)$/.exec(pathname);
|
|
392
|
-
if (evolutionTraceMatch && method === 'GET') {
|
|
393
|
-
const evoService = evolutionService();
|
|
394
|
-
try {
|
|
395
|
-
const trace = evoService.getTrace(decodeURIComponent(evolutionTraceMatch[1]));
|
|
396
|
-
if (!trace) {
|
|
397
|
-
json(res, 404, { error: 'not_found', message: 'Evolution trace not found.' });
|
|
398
|
-
return true;
|
|
399
|
-
}
|
|
400
|
-
json(res, 200, trace);
|
|
401
|
-
return true;
|
|
402
|
-
} catch (error) {
|
|
403
|
-
api.logger.warn(`[PD:ControlUI] Evolution trace request failed for ${pathname}: ${String(error)}`);
|
|
404
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
405
|
-
return true;
|
|
406
|
-
} finally {
|
|
407
|
-
evoService.dispose();
|
|
408
|
-
}
|
|
409
|
-
}
|
|
410
|
-
|
|
411
|
-
// === Health Query API (v1.1 new endpoints) ===
|
|
412
|
-
const healthService = () => {
|
|
413
|
-
const workspaceDir = resolveRequiredWorkspaceDir(api, { agentId: 'main' }, { source: 'principles_console.health', fallbackAgentId: 'main' });
|
|
414
|
-
return new HealthQueryService(workspaceDir);
|
|
415
|
-
};
|
|
416
|
-
|
|
417
|
-
if (pathname === `${API_PREFIX}/overview/health` && method === 'GET') {
|
|
418
|
-
const hs = healthService();
|
|
419
|
-
try {
|
|
420
|
-
json(res, 200, hs.getOverviewHealth());
|
|
421
|
-
return true;
|
|
422
|
-
} catch (error) {
|
|
423
|
-
api.logger.warn(`[PD:ControlUI] Health overview failed: ${String(error)}`);
|
|
424
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
425
|
-
return true;
|
|
426
|
-
} finally {
|
|
427
|
-
hs.dispose();
|
|
428
|
-
}
|
|
429
|
-
}
|
|
430
|
-
|
|
431
|
-
if (pathname === `${API_PREFIX}/evolution/principles` && method === 'GET') {
|
|
432
|
-
const hs = healthService();
|
|
433
|
-
try {
|
|
434
|
-
json(res, 200, hs.getEvolutionPrinciples());
|
|
435
|
-
return true;
|
|
436
|
-
} catch (error) {
|
|
437
|
-
api.logger.warn(`[PD:ControlUI] Evolution principles failed: ${String(error)}`);
|
|
438
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
439
|
-
return true;
|
|
440
|
-
} finally {
|
|
441
|
-
hs.dispose();
|
|
442
|
-
}
|
|
443
|
-
}
|
|
444
|
-
|
|
445
|
-
if (pathname === `${API_PREFIX}/feedback/gfi` && method === 'GET') {
|
|
446
|
-
const hs = healthService();
|
|
447
|
-
try {
|
|
448
|
-
json(res, 200, hs.getFeedbackGfi());
|
|
449
|
-
return true;
|
|
450
|
-
} catch (error) {
|
|
451
|
-
api.logger.warn(`[PD:ControlUI] Feedback GFI failed: ${String(error)}`);
|
|
452
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
453
|
-
return true;
|
|
454
|
-
} finally {
|
|
455
|
-
hs.dispose();
|
|
456
|
-
}
|
|
457
|
-
}
|
|
458
|
-
|
|
459
|
-
if (pathname === `${API_PREFIX}/feedback/empathy-events` && method === 'GET') {
|
|
460
|
-
const hs = healthService();
|
|
461
|
-
try {
|
|
462
|
-
const limit = url.searchParams.has('limit') ? Number(url.searchParams.get('limit')) : undefined;
|
|
463
|
-
json(res, 200, hs.getFeedbackEmpathyEvents(limit));
|
|
464
|
-
return true;
|
|
465
|
-
} catch (error) {
|
|
466
|
-
api.logger.warn(`[PD:ControlUI] Feedback empathy events failed: ${String(error)}`);
|
|
467
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
468
|
-
return true;
|
|
469
|
-
} finally {
|
|
470
|
-
hs.dispose();
|
|
471
|
-
}
|
|
472
|
-
}
|
|
473
|
-
|
|
474
|
-
if (pathname === `${API_PREFIX}/feedback/gate-blocks` && method === 'GET') {
|
|
475
|
-
const hs = healthService();
|
|
476
|
-
try {
|
|
477
|
-
const limit = url.searchParams.has('limit') ? Number(url.searchParams.get('limit')) : undefined;
|
|
478
|
-
json(res, 200, hs.getFeedbackGateBlocks(limit));
|
|
479
|
-
return true;
|
|
480
|
-
} catch (error) {
|
|
481
|
-
api.logger.warn(`[PD:ControlUI] Feedback gate blocks failed: ${String(error)}`);
|
|
482
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
483
|
-
return true;
|
|
484
|
-
} finally {
|
|
485
|
-
hs.dispose();
|
|
486
|
-
}
|
|
487
|
-
}
|
|
488
|
-
|
|
489
|
-
if (pathname === `${API_PREFIX}/gate/stats` && method === 'GET') {
|
|
490
|
-
const hs = healthService();
|
|
491
|
-
try {
|
|
492
|
-
json(res, 200, hs.getGateStats());
|
|
493
|
-
return true;
|
|
494
|
-
} catch (error) {
|
|
495
|
-
api.logger.warn(`[PD:ControlUI] Gate stats failed: ${String(error)}`);
|
|
496
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
497
|
-
return true;
|
|
498
|
-
} finally {
|
|
499
|
-
hs.dispose();
|
|
500
|
-
}
|
|
501
|
-
}
|
|
502
|
-
|
|
503
|
-
if (pathname === `${API_PREFIX}/gate/blocks` && method === 'GET') {
|
|
504
|
-
const hs = healthService();
|
|
505
|
-
try {
|
|
506
|
-
const limit = url.searchParams.has('limit') ? Number(url.searchParams.get('limit')) : undefined;
|
|
507
|
-
json(res, 200, hs.getGateBlocks(limit));
|
|
508
|
-
return true;
|
|
509
|
-
} catch (error) {
|
|
510
|
-
api.logger.warn(`[PD:ControlUI] Gate blocks failed: ${String(error)}`);
|
|
511
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
512
|
-
return true;
|
|
513
|
-
} finally {
|
|
514
|
-
hs.dispose();
|
|
515
|
-
}
|
|
516
|
-
}
|
|
517
|
-
|
|
518
|
-
if (pathname === `${API_PREFIX}/export/corrections` && method === 'GET') {
|
|
519
|
-
try {
|
|
520
|
-
const mode = url.searchParams.get('mode') === 'redacted' ? 'redacted' : 'raw';
|
|
521
|
-
const result = service.exportCorrections(mode);
|
|
522
|
-
if (!fs.existsSync(result.filePath)) {
|
|
523
|
-
json(res, 404, { error: 'not_found', message: 'Export file not found.' });
|
|
524
|
-
return true;
|
|
525
|
-
}
|
|
526
|
-
res.statusCode = 200;
|
|
527
|
-
res.setHeader('Content-Type', 'application/x-ndjson; charset=utf-8');
|
|
528
|
-
res.setHeader('Content-Disposition', `attachment; filename="${path.basename(result.filePath)}"`);
|
|
529
|
-
const stream = fs.createReadStream(result.filePath);
|
|
530
|
-
stream.on('error', () => {
|
|
531
|
-
res.statusCode = 500;
|
|
532
|
-
res.end('Internal Server Error');
|
|
533
|
-
});
|
|
534
|
-
stream.pipe(res);
|
|
535
|
-
return true;
|
|
536
|
-
} catch (error) {
|
|
537
|
-
api.logger.warn(`[PD:ControlUI] Export request failed for ${pathname}: ${String(error)}`);
|
|
538
|
-
json(res, 500, { error: 'internal_error', message: String(error) });
|
|
539
|
-
return true;
|
|
540
|
-
} finally {
|
|
541
|
-
service.dispose();
|
|
542
|
-
}
|
|
543
|
-
}
|
|
544
|
-
|
|
545
|
-
service.dispose();
|
|
546
|
-
json(res, 404, { error: 'not_found', message: 'Unknown Principles Console API route.' });
|
|
547
|
-
return true;
|
|
548
|
-
}
|
|
549
|
-
|
|
550
|
-
function getGatewayToken(): string | null {
|
|
551
|
-
try {
|
|
552
|
-
const configPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw.json');
|
|
553
|
-
if (!fs.existsSync(configPath)) return null;
|
|
554
|
-
const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
|
|
555
|
-
return config?.gateway?.auth?.token || null;
|
|
556
|
-
} catch {
|
|
557
|
-
return null;
|
|
558
|
-
}
|
|
559
|
-
}
|
|
560
|
-
|
|
561
|
-
function validateGatewayAuth(req: IncomingMessage): boolean {
|
|
562
|
-
const gatewayToken = getGatewayToken();
|
|
563
|
-
if (!gatewayToken) {
|
|
564
|
-
// No token configured, allow all requests
|
|
565
|
-
return true;
|
|
566
|
-
}
|
|
567
|
-
const authHeader = (req.headers?.authorization as string) || '';
|
|
568
|
-
const tokenMatch = /^Bearer\s+(.+)$/i.exec(authHeader);
|
|
569
|
-
const providedToken = tokenMatch?.[1];
|
|
570
|
-
|
|
571
|
-
if (!providedToken) {
|
|
572
|
-
return false;
|
|
573
|
-
}
|
|
574
|
-
|
|
575
|
-
// Constant-time comparison to prevent timing attacks (per D-07)
|
|
576
|
-
// Use Buffer comparison — both tokens must be same length for timingSafeEqual
|
|
577
|
-
const providedBuffer = Buffer.from(providedToken, 'utf8');
|
|
578
|
-
const expectedBuffer = Buffer.from(gatewayToken, 'utf8');
|
|
579
|
-
|
|
580
|
-
if (providedBuffer.length !== expectedBuffer.length) {
|
|
581
|
-
// Length mismatch — fail fast but without timing leak
|
|
582
|
-
// Return false immediately rather than letting timingSafeEqual throw
|
|
583
|
-
return false;
|
|
584
|
-
}
|
|
585
|
-
|
|
586
|
-
return crypto.timingSafeEqual(providedBuffer, expectedBuffer);
|
|
587
|
-
}
|
|
588
|
-
|
|
589
|
-
/**
|
|
590
|
-
* Create routes for Principles Console.
|
|
591
|
-
* Returns an array of routes:
|
|
592
|
-
* 1. Static files route (no auth required for HTML/CSS/JS)
|
|
593
|
-
* 2. API route (gateway auth required)
|
|
594
|
-
*/
|
|
595
|
-
export function createPrinciplesConsoleRoutes(api: OpenClawPluginApi): OpenClawPluginHttpRouteParams[] {
|
|
596
|
-
// Route 1: Static files (HTML, CSS, JS) - no auth check
|
|
597
|
-
const staticRoute: OpenClawPluginHttpRouteParams = {
|
|
598
|
-
path: ROUTE_PREFIX,
|
|
599
|
-
auth: 'plugin',
|
|
600
|
-
match: 'prefix',
|
|
601
|
-
|
|
602
|
-
async handler(req, res) {
|
|
603
|
-
if (!api.rootDir) { text(res, 500, 'Plugin rootDir not available'); return true; }
|
|
604
|
-
const url = new URL(req.url || ROUTE_PREFIX, 'http://127.0.0.1');
|
|
605
|
-
const {pathname} = url;
|
|
606
|
-
const method = (req.method || 'GET').toUpperCase();
|
|
607
|
-
|
|
608
|
-
// Skip API routes - they'll be handled by the API route
|
|
609
|
-
if (pathname.startsWith(API_PREFIX)) {
|
|
610
|
-
return false; // Let the API route handle this
|
|
611
|
-
}
|
|
612
|
-
|
|
613
|
-
// Serve assets
|
|
614
|
-
if (pathname.startsWith(ASSETS_PREFIX)) {
|
|
615
|
-
if (method !== 'GET' && method !== 'HEAD') {
|
|
616
|
-
text(res, 405, 'Method Not Allowed');
|
|
617
|
-
return true;
|
|
618
|
-
}
|
|
619
|
-
const assetPath = safeStaticPath(api.rootDir, pathname);
|
|
620
|
-
if (!assetPath || !serveFile(res, assetPath)) {
|
|
621
|
-
text(res, 404, 'Asset Not Found');
|
|
622
|
-
}
|
|
623
|
-
return true;
|
|
624
|
-
}
|
|
625
|
-
|
|
626
|
-
// Serve index.html for the main route
|
|
627
|
-
if (method !== 'GET' && method !== 'HEAD') {
|
|
628
|
-
text(res, 405, 'Method Not Allowed');
|
|
629
|
-
return true;
|
|
630
|
-
}
|
|
631
|
-
|
|
632
|
-
const indexPath = path.join(api.rootDir, 'dist', 'web', 'index.html');
|
|
633
|
-
if (!serveFile(res, indexPath)) {
|
|
634
|
-
text(res, 503, 'Principles Console UI is not built yet.');
|
|
635
|
-
}
|
|
636
|
-
return true;
|
|
637
|
-
},
|
|
638
|
-
};
|
|
639
|
-
|
|
640
|
-
// Route 2: API endpoints - gateway auth required
|
|
641
|
-
const apiRoute: OpenClawPluginHttpRouteParams = {
|
|
642
|
-
path: API_PREFIX,
|
|
643
|
-
auth: 'gateway',
|
|
644
|
-
match: 'prefix',
|
|
645
|
-
async handler(req, res) {
|
|
646
|
-
const url = new URL(req.url || API_PREFIX, 'http://127.0.0.1');
|
|
647
|
-
const {pathname} = url;
|
|
648
|
-
return handleApiRoute(api, pathname, req, res);
|
|
649
|
-
},
|
|
650
|
-
};
|
|
651
|
-
|
|
652
|
-
return [staticRoute, apiRoute];
|
|
653
|
-
}
|
|
654
|
-
|
|
655
|
-
// Legacy export for backwards compatibility
|
|
656
|
-
export function createPrinciplesConsoleRoute(api: OpenClawPluginApi): OpenClawPluginHttpRouteParams {
|
|
657
|
-
// Side effect: registers all console routes via createPrinciplesConsoleRoutes
|
|
658
|
-
createPrinciplesConsoleRoutes(api);
|
|
659
|
-
// Return the combined behavior - this will be called from index.ts
|
|
660
|
-
return {
|
|
661
|
-
path: ROUTE_PREFIX,
|
|
662
|
-
auth: 'plugin',
|
|
663
|
-
match: 'prefix',
|
|
664
|
-
|
|
665
|
-
async handler(req, res) {
|
|
666
|
-
if (!api.rootDir) { text(res, 500, 'Plugin rootDir not available'); return true; }
|
|
667
|
-
const url = new URL(req.url || ROUTE_PREFIX, 'http://127.0.0.1');
|
|
668
|
-
const {pathname} = url;
|
|
669
|
-
const method = (req.method || 'GET').toUpperCase();
|
|
670
|
-
|
|
671
|
-
if (!pathname.startsWith(ROUTE_PREFIX)) {
|
|
672
|
-
return false;
|
|
673
|
-
}
|
|
674
|
-
|
|
675
|
-
// For API routes, check auth manually
|
|
676
|
-
if (pathname.startsWith(API_PREFIX)) {
|
|
677
|
-
if (!validateGatewayAuth(req)) {
|
|
678
|
-
json(res, 401, { error: 'unauthorized', message: 'Valid Gateway token required.' });
|
|
679
|
-
return true;
|
|
680
|
-
}
|
|
681
|
-
return handleApiRoute(api, pathname, req, res);
|
|
682
|
-
}
|
|
683
|
-
|
|
684
|
-
// Static files - no auth required
|
|
685
|
-
if (pathname.startsWith(ASSETS_PREFIX)) {
|
|
686
|
-
if (method !== 'GET' && method !== 'HEAD') {
|
|
687
|
-
text(res, 405, 'Method Not Allowed');
|
|
688
|
-
return true;
|
|
689
|
-
}
|
|
690
|
-
const assetPath = safeStaticPath(api.rootDir, pathname);
|
|
691
|
-
if (!assetPath || !serveFile(res, assetPath)) {
|
|
692
|
-
text(res, 404, 'Asset Not Found');
|
|
693
|
-
}
|
|
694
|
-
return true;
|
|
695
|
-
}
|
|
696
|
-
|
|
697
|
-
if (method !== 'GET' && method !== 'HEAD') {
|
|
698
|
-
text(res, 405, 'Method Not Allowed');
|
|
699
|
-
return true;
|
|
700
|
-
}
|
|
701
|
-
|
|
702
|
-
const indexPath = path.join(api.rootDir, 'dist', 'web', 'index.html');
|
|
703
|
-
if (!serveFile(res, indexPath)) {
|
|
704
|
-
text(res, 503, 'Principles Console UI is not built yet.');
|
|
705
|
-
}
|
|
706
|
-
return true;
|
|
707
|
-
},
|
|
708
|
-
};
|
|
709
|
-
}
|