@bjoernrochel/sevro 1.0.0 → 1.1.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/CONTRIBUTING.md +34 -4
- package/README.md +7 -6
- package/dist/examples/basic/graded.json +13 -0
- package/dist/examples/basic/host.js +9 -0
- package/dist/examples/basic/host.js.map +1 -0
- package/dist/examples/basic/prompt-only.json +7 -0
- package/dist/examples/recipes/candidate.js +23 -0
- package/dist/examples/recipes/candidate.js.map +1 -0
- package/dist/examples/recipes/cases/coding-change.json +21 -0
- package/dist/examples/recipes/cases/host-tools.json +21 -0
- package/dist/examples/recipes/cases/mise.json +21 -0
- package/dist/examples/recipes/cases/node.json +21 -0
- package/dist/examples/recipes/cases/python-uv.json +21 -0
- package/dist/examples/recipes/cases/semantic.json +17 -0
- package/dist/examples/recipes/coding-change/check.js +16 -0
- package/dist/examples/recipes/coding-change/check.js.map +1 -0
- package/dist/examples/recipes/executable.js +20 -0
- package/dist/examples/recipes/executable.js.map +1 -0
- package/dist/examples/recipes/extension-artifacts.js +56 -0
- package/dist/examples/recipes/extension-artifacts.js.map +1 -0
- package/dist/examples/recipes/extension-methods.js +167 -0
- package/dist/examples/recipes/extension-methods.js.map +1 -0
- package/dist/examples/recipes/extension.js +28 -0
- package/dist/examples/recipes/extension.js.map +1 -0
- package/dist/examples/recipes/modules.js +9 -0
- package/dist/examples/recipes/modules.js.map +1 -0
- package/dist/examples/recipes/repository-skill/.agents/skills/startup-guide/SKILL.md +7 -0
- package/dist/examples/recipes/repository-skill/.claude/skills/startup-guide/SKILL.md +7 -0
- package/dist/examples/recipes/repository-skill/README.md +3 -0
- package/dist/examples/recipes/run-inputs.js +144 -0
- package/dist/examples/recipes/run-inputs.js.map +1 -0
- package/dist/examples/recipes/run-options.js +103 -0
- package/dist/examples/recipes/run-options.js.map +1 -0
- package/dist/examples/recipes/run.js +62 -0
- package/dist/examples/recipes/run.js.map +1 -0
- package/dist/examples/recipes/runtime/empty.json +1 -0
- package/dist/examples/recipes/runtime/goals.json +1 -0
- package/dist/examples/recipes/runtime/mise.json +6 -0
- package/dist/examples/recipes/runtime/path.json +1 -0
- package/dist/examples/recipes/runtime/plugins.json +4 -0
- package/dist/examples/recipes/runtime/python-uv.json +10 -0
- package/dist/examples/recipes/semantic-judge.js +27 -0
- package/dist/examples/recipes/semantic-judge.js.map +1 -0
- package/dist/examples/templates/coding/adapter.js +14 -0
- package/dist/examples/templates/coding/adapter.js.map +1 -0
- package/dist/examples/templates/coding/case.json +15 -0
- package/dist/examples/templates/repository-skill/.agents/skills/startup-guide/SKILL.md +6 -0
- package/dist/examples/templates/repository-skill/extension-data.js +61 -0
- package/dist/examples/templates/repository-skill/extension-data.js.map +1 -0
- package/dist/examples/templates/repository-skill/extension.js +29 -0
- package/dist/examples/templates/repository-skill/extension.js.map +1 -0
- package/dist/examples/templates/response/adapter.js +13 -0
- package/dist/examples/templates/response/adapter.js.map +1 -0
- package/dist/examples/templates/response/case.json +13 -0
- package/dist/src/advisory.js +86 -0
- package/dist/src/advisory.js.map +1 -0
- package/dist/src/candidate-artifacts.js +139 -0
- package/dist/src/candidate-artifacts.js.map +1 -0
- package/dist/src/candidate-codex-state.js +110 -0
- package/dist/src/candidate-codex-state.js.map +1 -0
- package/dist/src/case-validation.js +92 -0
- package/dist/src/case-validation.js.map +1 -0
- package/dist/src/cli/cancellation.js +21 -0
- package/dist/src/cli/cancellation.js.map +1 -0
- package/dist/src/cli/command.js +60 -0
- package/dist/src/cli/command.js.map +1 -0
- package/dist/src/cli/completion.js +14 -0
- package/dist/src/cli/completion.js.map +1 -0
- package/dist/src/cli/demo.js +45 -0
- package/dist/src/cli/demo.js.map +1 -0
- package/dist/src/cli/evaluation.js +40 -0
- package/dist/src/cli/evaluation.js.map +1 -0
- package/dist/src/cli/extension.js +54 -0
- package/dist/src/cli/extension.js.map +1 -0
- package/dist/src/cli/help.js +190 -0
- package/dist/src/cli/help.js.map +1 -0
- package/dist/src/cli/hosts.js +33 -0
- package/dist/src/cli/hosts.js.map +1 -0
- package/dist/src/cli/init-settings.js +29 -0
- package/dist/src/cli/init-settings.js.map +1 -0
- package/dist/src/cli/init.js +82 -0
- package/dist/src/cli/init.js.map +1 -0
- package/dist/src/cli/invocation.js +431 -0
- package/dist/src/cli/invocation.js.map +1 -0
- package/dist/src/cli/loading.js +110 -0
- package/dist/src/cli/loading.js.map +1 -0
- package/dist/src/cli/preparation.js +88 -0
- package/dist/src/cli/preparation.js.map +1 -0
- package/dist/src/cli/presentation.js +61 -0
- package/dist/src/cli/presentation.js.map +1 -0
- package/dist/src/cli/progress.js +5 -0
- package/dist/src/cli/progress.js.map +1 -0
- package/dist/src/cli/run-manifest.js +108 -0
- package/dist/src/cli/run-manifest.js.map +1 -0
- package/dist/src/cli/run-options.js +367 -0
- package/dist/src/cli/run-options.js.map +1 -0
- package/dist/src/cli/run-overrides.js +51 -0
- package/dist/src/cli/run-overrides.js.map +1 -0
- package/dist/src/cli/settings.js +127 -0
- package/dist/src/cli/settings.js.map +1 -0
- package/dist/src/cli/summary.js +28 -0
- package/dist/src/cli/summary.js.map +1 -0
- package/dist/src/cli.js +20 -0
- package/dist/src/cli.js.map +1 -0
- package/dist/src/contract-types.js +2 -0
- package/dist/src/contract-types.js.map +1 -0
- package/dist/src/engine.js +4 -0
- package/dist/src/engine.js.map +1 -0
- package/dist/src/evaluation/advisory.js +85 -0
- package/dist/src/evaluation/advisory.js.map +1 -0
- package/dist/src/evaluation/check-plan.js +292 -0
- package/dist/src/evaluation/check-plan.js.map +1 -0
- package/dist/src/evaluation/collection.js +61 -0
- package/dist/src/evaluation/collection.js.map +1 -0
- package/dist/src/evaluation/context.js +2 -0
- package/dist/src/evaluation/context.js.map +1 -0
- package/dist/src/evaluation/grading-host.js +28 -0
- package/dist/src/evaluation/grading-host.js.map +1 -0
- package/dist/src/evaluation/grading.js +154 -0
- package/dist/src/evaluation/grading.js.map +1 -0
- package/dist/src/evaluation/invocation-plan.js +312 -0
- package/dist/src/evaluation/invocation-plan.js.map +1 -0
- package/dist/src/evaluation/plan.js +376 -0
- package/dist/src/evaluation/plan.js.map +1 -0
- package/dist/src/evaluation/progress.js +14 -0
- package/dist/src/evaluation/progress.js.map +1 -0
- package/dist/src/evaluation/resources.js +159 -0
- package/dist/src/evaluation/resources.js.map +1 -0
- package/dist/src/evaluation/run.js +148 -0
- package/dist/src/evaluation/run.js.map +1 -0
- package/dist/src/evaluation/scheduler.js +27 -0
- package/dist/src/evaluation/scheduler.js.map +1 -0
- package/dist/src/evaluation/semantic.js +183 -0
- package/dist/src/evaluation/semantic.js.map +1 -0
- package/dist/src/evaluation/trial.js +593 -0
- package/dist/src/evaluation/trial.js.map +1 -0
- package/dist/src/evaluation/types.js +20 -0
- package/dist/src/evaluation/types.js.map +1 -0
- package/dist/src/evidence/host-results.js +67 -0
- package/dist/src/evidence/host-results.js.map +1 -0
- package/dist/src/evidence/retained-artifacts.js +17 -0
- package/dist/src/evidence/retained-artifacts.js.map +1 -0
- package/dist/src/evidence/trial-writer.js +131 -0
- package/dist/src/evidence/trial-writer.js.map +1 -0
- package/dist/src/evidence/usage.js +14 -0
- package/dist/src/evidence/usage.js.map +1 -0
- package/dist/src/executable.js +20 -0
- package/dist/src/executable.js.map +1 -0
- package/dist/src/extension-client.js +212 -0
- package/dist/src/extension-client.js.map +1 -0
- package/dist/src/extension-session.js +236 -0
- package/dist/src/extension-session.js.map +1 -0
- package/dist/src/fixtures/advisory.js +206 -0
- package/dist/src/fixtures/advisory.js.map +1 -0
- package/dist/src/fixtures/bin.js +41 -0
- package/dist/src/fixtures/bin.js.map +1 -0
- package/dist/src/fixtures/cleanup.js +43 -0
- package/dist/src/fixtures/cleanup.js.map +1 -0
- package/dist/src/fixtures/create.js +94 -0
- package/dist/src/fixtures/create.js.map +1 -0
- package/dist/src/fixtures/generated.js +181 -0
- package/dist/src/fixtures/generated.js.map +1 -0
- package/dist/src/fixtures/git-hooks.js +16 -0
- package/dist/src/fixtures/git-hooks.js.map +1 -0
- package/dist/src/fixtures/preparation.js +201 -0
- package/dist/src/fixtures/preparation.js.map +1 -0
- package/dist/src/fixtures/repository.js +255 -0
- package/dist/src/fixtures/repository.js.map +1 -0
- package/dist/src/fixtures/setup.js +175 -0
- package/dist/src/fixtures/setup.js.map +1 -0
- package/dist/src/fixtures/tools.js +57 -0
- package/dist/src/fixtures/tools.js.map +1 -0
- package/dist/src/fixtures/workspace-state.js +155 -0
- package/dist/src/fixtures/workspace-state.js.map +1 -0
- package/dist/src/generated/cli-result.cjs +2 -0
- package/dist/src/generated/extension.cjs +2 -0
- package/dist/src/generated/report.cjs +2 -0
- package/dist/src/generated/run-evidence.cjs +2 -0
- package/dist/src/generated/runtime.cjs +2 -0
- package/dist/src/git.js +72 -0
- package/dist/src/git.js.map +1 -0
- package/dist/src/graders/artifact.js +68 -0
- package/dist/src/graders/artifact.js.map +1 -0
- package/dist/src/graders/git-head.js +112 -0
- package/dist/src/graders/git-head.js.map +1 -0
- package/dist/src/graders/output.js +345 -0
- package/dist/src/graders/output.js.map +1 -0
- package/dist/src/graders/semantic.js +132 -0
- package/dist/src/graders/semantic.js.map +1 -0
- package/dist/src/graders/shell.js +321 -0
- package/dist/src/graders/shell.js.map +1 -0
- package/dist/src/host-diagnostic-redaction.js +52 -0
- package/dist/src/host-diagnostic-redaction.js.map +1 -0
- package/dist/src/host-diagnostics.js +248 -0
- package/dist/src/host-diagnostics.js.map +1 -0
- package/dist/src/hosts/claude-continuation.js +89 -0
- package/dist/src/hosts/claude-continuation.js.map +1 -0
- package/dist/src/hosts/claude-credential.js +121 -0
- package/dist/src/hosts/claude-credential.js.map +1 -0
- package/dist/src/hosts/claude-events.js +136 -0
- package/dist/src/hosts/claude-events.js.map +1 -0
- package/dist/src/hosts/claude-keychain.js +100 -0
- package/dist/src/hosts/claude-keychain.js.map +1 -0
- package/dist/src/hosts/claude-login-recovery.js +67 -0
- package/dist/src/hosts/claude-login-recovery.js.map +1 -0
- package/dist/src/hosts/claude-login-refresh.js +146 -0
- package/dist/src/hosts/claude-login-refresh.js.map +1 -0
- package/dist/src/hosts/claude-login-store.js +124 -0
- package/dist/src/hosts/claude-login-store.js.map +1 -0
- package/dist/src/hosts/claude-login.js +74 -0
- package/dist/src/hosts/claude-login.js.map +1 -0
- package/dist/src/hosts/claude-native-goal.js +138 -0
- package/dist/src/hosts/claude-native-goal.js.map +1 -0
- package/dist/src/hosts/claude-process.js +10 -0
- package/dist/src/hosts/claude-process.js.map +1 -0
- package/dist/src/hosts/claude-refresh-lock.js +76 -0
- package/dist/src/hosts/claude-refresh-lock.js.map +1 -0
- package/dist/src/hosts/claude-repository-invocation.js +229 -0
- package/dist/src/hosts/claude-repository-invocation.js.map +1 -0
- package/dist/src/hosts/claude-settings.js +156 -0
- package/dist/src/hosts/claude-settings.js.map +1 -0
- package/dist/src/hosts/claude-skill-activations.js +131 -0
- package/dist/src/hosts/claude-skill-activations.js.map +1 -0
- package/dist/src/hosts/claude-state.js +237 -0
- package/dist/src/hosts/claude-state.js.map +1 -0
- package/dist/src/hosts/claude-tool-calls.js +150 -0
- package/dist/src/hosts/claude-tool-calls.js.map +1 -0
- package/dist/src/hosts/claude.js +373 -0
- package/dist/src/hosts/claude.js.map +1 -0
- package/dist/src/hosts/codex-app-server.js +764 -0
- package/dist/src/hosts/codex-app-server.js.map +1 -0
- package/dist/src/hosts/codex-configuration.js +91 -0
- package/dist/src/hosts/codex-configuration.js.map +1 -0
- package/dist/src/hosts/codex-events.js +104 -0
- package/dist/src/hosts/codex-events.js.map +1 -0
- package/dist/src/hosts/codex-exec-controls.js +434 -0
- package/dist/src/hosts/codex-exec-controls.js.map +1 -0
- package/dist/src/hosts/codex-invocation.js +54 -0
- package/dist/src/hosts/codex-invocation.js.map +1 -0
- package/dist/src/hosts/codex-marketplace.js +185 -0
- package/dist/src/hosts/codex-marketplace.js.map +1 -0
- package/dist/src/hosts/codex-native-calls.js +516 -0
- package/dist/src/hosts/codex-native-calls.js.map +1 -0
- package/dist/src/hosts/codex-process.js +10 -0
- package/dist/src/hosts/codex-process.js.map +1 -0
- package/dist/src/hosts/codex-profile.js +206 -0
- package/dist/src/hosts/codex-profile.js.map +1 -0
- package/dist/src/hosts/codex-session-files.js +89 -0
- package/dist/src/hosts/codex-session-files.js.map +1 -0
- package/dist/src/hosts/codex-state.js +310 -0
- package/dist/src/hosts/codex-state.js.map +1 -0
- package/dist/src/hosts/codex.js +527 -0
- package/dist/src/hosts/codex.js.map +1 -0
- package/dist/src/hosts/isolation-common.js +43 -0
- package/dist/src/hosts/isolation-common.js.map +1 -0
- package/dist/src/hosts/isolation-roots.js +64 -0
- package/dist/src/hosts/isolation-roots.js.map +1 -0
- package/dist/src/hosts/isolation.js +12 -0
- package/dist/src/hosts/isolation.js.map +1 -0
- package/dist/src/hosts/linux-sandbox.js +127 -0
- package/dist/src/hosts/linux-sandbox.js.map +1 -0
- package/dist/src/hosts/mac-sandbox.js +137 -0
- package/dist/src/hosts/mac-sandbox.js.map +1 -0
- package/dist/src/hosts/native-controls.js +151 -0
- package/dist/src/hosts/native-controls.js.map +1 -0
- package/dist/src/hosts/native-request.js +33 -0
- package/dist/src/hosts/native-request.js.map +1 -0
- package/dist/src/hosts/process-lifecycle.js +167 -0
- package/dist/src/hosts/process-lifecycle.js.map +1 -0
- package/dist/src/hosts/protected-worktrees.js +81 -0
- package/dist/src/hosts/protected-worktrees.js.map +1 -0
- package/dist/src/hosts/skill-hook-catalog.js +100 -0
- package/dist/src/hosts/skill-hook-catalog.js.map +1 -0
- package/dist/src/hosts/skill-hook-handler.js +228 -0
- package/dist/src/hosts/skill-hook-handler.js.map +1 -0
- package/dist/src/hosts/skill-hooks.js +423 -0
- package/dist/src/hosts/skill-hooks.js.map +1 -0
- package/dist/src/hosts/workspace-fingerprint.js +72 -0
- package/dist/src/hosts/workspace-fingerprint.js.map +1 -0
- package/dist/src/identity.js +167 -0
- package/dist/src/identity.js.map +1 -0
- package/dist/src/instrumentation.js +83 -0
- package/dist/src/instrumentation.js.map +1 -0
- package/dist/src/native-transcript-state.js +85 -0
- package/dist/src/native-transcript-state.js.map +1 -0
- package/dist/src/native-transcript-view.js +65 -0
- package/dist/src/native-transcript-view.js.map +1 -0
- package/dist/src/native-transcripts.js +208 -0
- package/dist/src/native-transcripts.js.map +1 -0
- package/dist/src/paths.js +13 -0
- package/dist/src/paths.js.map +1 -0
- package/dist/src/process-lifecycle.js +101 -0
- package/dist/src/process-lifecycle.js.map +1 -0
- package/dist/src/provenance.js +263 -0
- package/dist/src/provenance.js.map +1 -0
- package/dist/src/prune.js +228 -0
- package/dist/src/prune.js.map +1 -0
- package/dist/src/report.js +276 -0
- package/dist/src/report.js.map +1 -0
- package/dist/src/resolved-case.js +29 -0
- package/dist/src/resolved-case.js.map +1 -0
- package/dist/src/results-lock.js +40 -0
- package/dist/src/results-lock.js.map +1 -0
- package/dist/src/results.js +127 -0
- package/dist/src/results.js.map +1 -0
- package/dist/src/run-owner.js +283 -0
- package/dist/src/run-owner.js.map +1 -0
- package/dist/src/runner-paths.js +11 -0
- package/dist/src/runner-paths.js.map +1 -0
- package/dist/src/runtime/config.js +323 -0
- package/dist/src/runtime/config.js.map +1 -0
- package/dist/src/runtime/discovery-apple.js +65 -0
- package/dist/src/runtime/discovery-apple.js.map +1 -0
- package/dist/src/runtime/discovery-providers.js +37 -0
- package/dist/src/runtime/discovery-providers.js.map +1 -0
- package/dist/src/runtime/discovery.js +40 -0
- package/dist/src/runtime/discovery.js.map +1 -0
- package/dist/src/runtime/hook-processes.js +81 -0
- package/dist/src/runtime/hook-processes.js.map +1 -0
- package/dist/src/runtime/hooks.js +304 -0
- package/dist/src/runtime/hooks.js.map +1 -0
- package/dist/src/runtime/paths.js +244 -0
- package/dist/src/runtime/paths.js.map +1 -0
- package/dist/src/runtime/query.js +76 -0
- package/dist/src/runtime/query.js.map +1 -0
- package/dist/src/runtime/seeds.js +98 -0
- package/dist/src/runtime/seeds.js.map +1 -0
- package/dist/src/runtime/shared-cache.js +81 -0
- package/dist/src/runtime/shared-cache.js.map +1 -0
- package/dist/src/runtime/state.js +106 -0
- package/dist/src/runtime/state.js.map +1 -0
- package/dist/src/runtime-process.js +148 -0
- package/dist/src/runtime-process.js.map +1 -0
- package/dist/src/schema-types.js +2 -0
- package/dist/src/schema-types.js.map +1 -0
- package/dist/src/schema.js +16 -0
- package/dist/src/schema.js.map +1 -0
- package/dist/src/shell.js +5 -0
- package/dist/src/shell.js.map +1 -0
- package/dist/src/sqlite-lock.js +18 -0
- package/dist/src/sqlite-lock.js.map +1 -0
- package/dist/src/storage.js +21 -0
- package/dist/src/storage.js.map +1 -0
- package/dist/src/transcript-retention.js +109 -0
- package/dist/src/transcript-retention.js.map +1 -0
- package/dist/src/value-guards.js +26 -0
- package/dist/src/value-guards.js.map +1 -0
- package/docs/architecture.md +5 -2
- package/docs/creating-cases.md +2 -3
- package/docs/development-cli.md +12 -7
- package/docs/documentation-quality.md +4 -3
- package/docs/evaluation-workflow.md +8 -8
- package/docs/getting-started.md +7 -6
- package/docs/guide-evaluation.md +1 -1
- package/docs/identity-v1.md +4 -1
- package/docs/installing.md +31 -13
- package/docs/licensing.md +2 -2
- package/docs/native-hosts.md +1 -1
- package/docs/recipes.md +41 -40
- package/docs/releases.md +20 -4
- package/docs/run-settings-v1.md +3 -3
- package/docs/specs/repository-guide.md +1 -1
- package/docs/troubleshooting.md +1 -1
- package/docs/typescript-quality.md +18 -1
- package/examples/recipes/executable.ts +19 -0
- package/examples/recipes/extension-artifacts.ts +1 -1
- package/examples/recipes/extension.ts +2 -1
- package/examples/recipes/modules.ts +9 -0
- package/examples/recipes/run-inputs.ts +14 -19
- package/examples/recipes/run-options.ts +9 -8
- package/examples/recipes/run.ts +21 -7
- package/examples/templates/repository-skill/extension-data.ts +1 -1
- package/examples/templates/repository-skill/extension.ts +2 -1
- package/package.json +14 -6
- package/src/cli/demo.ts +3 -2
- package/src/cli/help.ts +4 -3
- package/src/cli/init-settings.ts +5 -4
- package/src/cli/init.ts +9 -8
- package/src/cli/invocation.ts +2 -1
- package/src/cli/preparation.ts +2 -2
- package/src/cli.ts +1 -1
- package/src/executable.ts +19 -0
- package/src/extension-client.ts +6 -12
- package/src/fixtures/setup.ts +3 -2
- package/src/git.ts +2 -1
- package/src/graders/git-head.ts +3 -2
- package/src/graders/shell.ts +4 -3
- package/src/hosts/claude-keychain.ts +3 -2
- package/src/hosts/claude-login-refresh.ts +3 -2
- package/src/hosts/claude-refresh-lock.ts +2 -1
- package/src/hosts/isolation-roots.ts +3 -2
- package/src/hosts/process-lifecycle.ts +4 -6
- package/src/hosts/protected-worktrees.ts +2 -1
- package/src/hosts/skill-hook-handler.ts +1 -1
- package/src/hosts/skill-hooks.ts +10 -2
- package/src/provenance.ts +7 -6
- package/src/results-lock.ts +4 -4
- package/src/run-owner.ts +15 -9
- package/src/runner-paths.ts +21 -0
- package/src/runtime/hook-processes.ts +2 -1
- package/src/runtime/hooks.ts +9 -7
- package/src/runtime-process.ts +194 -0
- package/src/sqlite-lock.ts +25 -0
|
@@ -0,0 +1,423 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { shellQuote as quote } from "../shell.js";
|
|
5
|
+
import { fileURLToPath } from "node:url";
|
|
6
|
+
import { isRecord, isUnknownArray } from "../value-guards.js";
|
|
7
|
+
import { skillHookCatalog } from "./skill-hook-catalog.js";
|
|
8
|
+
const MAX_EVENTS_BYTES = 8 * 1024 * 1024;
|
|
9
|
+
const MAX_RETAINED_CALLS = 128;
|
|
10
|
+
/** Install the runner's silent observer separately from authorized plugin hooks. */
|
|
11
|
+
export async function prepareSkillTracking(options) {
|
|
12
|
+
const root = join(options.privateRoot, "skill-tracking");
|
|
13
|
+
const receipts = join(root, "receipts");
|
|
14
|
+
await mkdir(receipts, { recursive: true, mode: 0o700 });
|
|
15
|
+
const configuration = {
|
|
16
|
+
host: options.host,
|
|
17
|
+
receipts,
|
|
18
|
+
...(await skillHookCatalog(options.roots ?? [])),
|
|
19
|
+
};
|
|
20
|
+
const configurationPath = join(root, "configuration.json");
|
|
21
|
+
await writeFile(configurationPath, JSON.stringify(configuration), {
|
|
22
|
+
flag: "wx",
|
|
23
|
+
mode: 0o600,
|
|
24
|
+
});
|
|
25
|
+
const command = [
|
|
26
|
+
"/usr/bin/env",
|
|
27
|
+
"-i",
|
|
28
|
+
"PATH=/usr/bin:/bin",
|
|
29
|
+
process.execPath,
|
|
30
|
+
fileURLToPath(new URL(import.meta.filename.endsWith(".ts")
|
|
31
|
+
? "./skill-hook-handler.ts"
|
|
32
|
+
: "./skill-hook-handler.js", import.meta.url)),
|
|
33
|
+
configurationPath,
|
|
34
|
+
]
|
|
35
|
+
.map(quote)
|
|
36
|
+
.join(" ");
|
|
37
|
+
return { configuration, command, hooks: hookDefinitions(command) };
|
|
38
|
+
}
|
|
39
|
+
function hookDefinitions(command) {
|
|
40
|
+
return Object.fromEntries(["SessionStart", "PreToolUse", "PostToolUse", "Stop"].map((event) => {
|
|
41
|
+
return [event, [{ hooks: [{ type: "command", command, timeout: 5 }] }]];
|
|
42
|
+
}));
|
|
43
|
+
}
|
|
44
|
+
function isReceipt(value, skills) {
|
|
45
|
+
if (!isRecord(value))
|
|
46
|
+
return false;
|
|
47
|
+
return (receiptLabels(value) &&
|
|
48
|
+
stringList(value.invocations) &&
|
|
49
|
+
stringList(value.ambiguousInvocations) &&
|
|
50
|
+
receiptPageFields(value, skills));
|
|
51
|
+
}
|
|
52
|
+
function receiptPageFields(value, skills) {
|
|
53
|
+
return (typeof value.partial === "boolean" &&
|
|
54
|
+
validBodyRanges(value.bodyRanges, skills));
|
|
55
|
+
}
|
|
56
|
+
function validOffset(value) {
|
|
57
|
+
return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
|
|
58
|
+
}
|
|
59
|
+
function validRange(value, length) {
|
|
60
|
+
if (!isOffsetRange(value))
|
|
61
|
+
return false;
|
|
62
|
+
const [start, end] = value;
|
|
63
|
+
return start < end && end <= length;
|
|
64
|
+
}
|
|
65
|
+
function isOffsetRange(value) {
|
|
66
|
+
return (isUnknownArray(value) && value.length === 2 && value.every(validOffset));
|
|
67
|
+
}
|
|
68
|
+
function validPage(value, skills) {
|
|
69
|
+
if (!isRecord(value) || !Array.isArray(value.ranges))
|
|
70
|
+
return false;
|
|
71
|
+
const skill = skills.find((item) => item.invocation === value.invocation && item.sha256 === value.sha256);
|
|
72
|
+
if (!skill)
|
|
73
|
+
return false;
|
|
74
|
+
return value.ranges.every((range) => validRange(range, skill.body.length));
|
|
75
|
+
}
|
|
76
|
+
function validBodyRanges(value, skills) {
|
|
77
|
+
if (value === undefined)
|
|
78
|
+
return true;
|
|
79
|
+
return (Array.isArray(value) &&
|
|
80
|
+
value.every((page) => validPage(page, skills)));
|
|
81
|
+
}
|
|
82
|
+
function stringList(value) {
|
|
83
|
+
return (Array.isArray(value) &&
|
|
84
|
+
value.every((item) => typeof item === "string"));
|
|
85
|
+
}
|
|
86
|
+
function receiptLabels(value) {
|
|
87
|
+
if (!["SessionStart", "PreToolUse", "PostToolUse", "Stop"].includes(String(value.event)))
|
|
88
|
+
return false;
|
|
89
|
+
return [value.sessionId, value.turnId, value.toolUseId, value.toolName].every((field) => field === null || typeof field === "string");
|
|
90
|
+
}
|
|
91
|
+
async function receipts(tracking) {
|
|
92
|
+
const root = tracking.configuration.receipts;
|
|
93
|
+
const result = { events: [], reasons: [] };
|
|
94
|
+
if (existsSync(join(root, "partial")))
|
|
95
|
+
result.reasons.push("observer_failure");
|
|
96
|
+
try {
|
|
97
|
+
const path = join(root, "events.jsonl");
|
|
98
|
+
if ((await stat(path)).size > MAX_EVENTS_BYTES)
|
|
99
|
+
return { ...result, reasons: [...result.reasons, "receipt_limit"] };
|
|
100
|
+
parseReceipts(await readFile(path, "utf8"), tracking.configuration.skills, result.events);
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
result.reasons.push(error instanceof SyntaxError
|
|
104
|
+
? "invalid_receipts"
|
|
105
|
+
: "receipts_unavailable");
|
|
106
|
+
}
|
|
107
|
+
return result;
|
|
108
|
+
}
|
|
109
|
+
function parseReceipts(text, skills, events) {
|
|
110
|
+
for (const line of text.trimEnd().split("\n")) {
|
|
111
|
+
const event = JSON.parse(line);
|
|
112
|
+
if (!isReceipt(event, skills))
|
|
113
|
+
throw new SyntaxError("invalid skill hook receipt");
|
|
114
|
+
events.push(event);
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
function hookKey(event) {
|
|
118
|
+
return JSON.stringify([event.sessionId, event.toolUseId]);
|
|
119
|
+
}
|
|
120
|
+
function collectionSummary(events, sessionId) {
|
|
121
|
+
const ledger = {
|
|
122
|
+
pending: new Set(),
|
|
123
|
+
finished: new Set(),
|
|
124
|
+
diagnosticKeys: new Set(),
|
|
125
|
+
duplicateToolCallCount: 0,
|
|
126
|
+
unmatchedPostToolUseCount: 0,
|
|
127
|
+
};
|
|
128
|
+
for (const event of events)
|
|
129
|
+
updatePending(event, ledger);
|
|
130
|
+
return {
|
|
131
|
+
diagnosticKeys: new Set([...ledger.diagnosticKeys, ...ledger.pending]),
|
|
132
|
+
eventCount: events.length,
|
|
133
|
+
preToolUseCount: events.filter((event) => event.event === "PreToolUse")
|
|
134
|
+
.length,
|
|
135
|
+
postToolUseCount: events.filter((event) => event.event === "PostToolUse")
|
|
136
|
+
.length,
|
|
137
|
+
pendingToolCallCount: ledger.pending.size,
|
|
138
|
+
duplicateToolCallCount: ledger.duplicateToolCallCount,
|
|
139
|
+
unmatchedPostToolUseCount: ledger.unmatchedPostToolUseCount,
|
|
140
|
+
partialEventCount: events.filter((event) => event.partial).length,
|
|
141
|
+
...lifecycleSummary(events, sessionId),
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
function lifecycleSummary(events, sessionId) {
|
|
145
|
+
const selected = events.filter((event) => event.sessionId === sessionId);
|
|
146
|
+
return {
|
|
147
|
+
sessionIdentified: sessionId !== null,
|
|
148
|
+
sessionStarted: selected.some((event) => event.event === "SessionStart"),
|
|
149
|
+
sessionStopped: selected.some((event) => event.event === "Stop"),
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
function updatePending(event, ledger) {
|
|
153
|
+
const key = hookKey(event);
|
|
154
|
+
if (event.event === "PreToolUse") {
|
|
155
|
+
if (duplicateCall(key, ledger)) {
|
|
156
|
+
ledger.duplicateToolCallCount++;
|
|
157
|
+
ledger.diagnosticKeys.add(key);
|
|
158
|
+
}
|
|
159
|
+
ledger.pending.add(key);
|
|
160
|
+
}
|
|
161
|
+
if (event.event === "PostToolUse") {
|
|
162
|
+
if (!ledger.pending.delete(key)) {
|
|
163
|
+
ledger.unmatchedPostToolUseCount++;
|
|
164
|
+
ledger.diagnosticKeys.add(key);
|
|
165
|
+
}
|
|
166
|
+
ledger.finished.add(key);
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
function duplicateCall(key, ledger) {
|
|
170
|
+
return ledger.pending.has(key) || ledger.finished.has(key);
|
|
171
|
+
}
|
|
172
|
+
function mergedRanges(ranges) {
|
|
173
|
+
const merged = [];
|
|
174
|
+
for (const [start, end] of ranges.sort((a, b) => a[0] - b[0])) {
|
|
175
|
+
const previous = merged.at(-1);
|
|
176
|
+
if (previous && start <= previous[1])
|
|
177
|
+
previous[1] = Math.max(previous[1], end);
|
|
178
|
+
else
|
|
179
|
+
merged.push([start, end]);
|
|
180
|
+
}
|
|
181
|
+
return merged;
|
|
182
|
+
}
|
|
183
|
+
function wholeBody(ranges, skill) {
|
|
184
|
+
const range = ranges[0];
|
|
185
|
+
return (ranges.length === 1 &&
|
|
186
|
+
range !== undefined &&
|
|
187
|
+
range[0] === 0 &&
|
|
188
|
+
range[1] === skill.body.length);
|
|
189
|
+
}
|
|
190
|
+
function completedPage(receipt, page, skills) {
|
|
191
|
+
const aliases = skills.filter((skill) => skill.sha256 === page.sha256);
|
|
192
|
+
if (aliases.some((skill) => skill.invocation !== page.invocation)) {
|
|
193
|
+
receipt.ambiguousInvocations = [
|
|
194
|
+
...new Set([
|
|
195
|
+
...receipt.ambiguousInvocations,
|
|
196
|
+
...aliases.map((skill) => skill.invocation),
|
|
197
|
+
]),
|
|
198
|
+
];
|
|
199
|
+
receipt.partial = true;
|
|
200
|
+
}
|
|
201
|
+
else
|
|
202
|
+
receipt.invocations = [
|
|
203
|
+
...new Set([...receipt.invocations, page.invocation]),
|
|
204
|
+
];
|
|
205
|
+
}
|
|
206
|
+
function accumulatePage(receipt, page, skills, coverage) {
|
|
207
|
+
const skill = skills.find((item) => item.invocation === page.invocation && item.sha256 === page.sha256);
|
|
208
|
+
if (!skill) {
|
|
209
|
+
receipt.partial = true;
|
|
210
|
+
return;
|
|
211
|
+
}
|
|
212
|
+
const key = JSON.stringify([
|
|
213
|
+
receipt.sessionId,
|
|
214
|
+
receipt.turnId,
|
|
215
|
+
page.invocation,
|
|
216
|
+
page.sha256,
|
|
217
|
+
]);
|
|
218
|
+
const ranges = mergedRanges([...(coverage.get(key) ?? []), ...page.ranges]);
|
|
219
|
+
coverage.set(key, ranges);
|
|
220
|
+
if (wholeBody(ranges, skill))
|
|
221
|
+
completedPage(receipt, page, skills);
|
|
222
|
+
}
|
|
223
|
+
function pagedEvents(events, skills) {
|
|
224
|
+
const coverage = new Map();
|
|
225
|
+
const settled = new Set();
|
|
226
|
+
return events.map((event) => {
|
|
227
|
+
const receipt = { ...event };
|
|
228
|
+
for (const page of event.bodyRanges ?? []) {
|
|
229
|
+
if (!settled.has(page.invocation))
|
|
230
|
+
accumulatePage(receipt, page, skills, coverage);
|
|
231
|
+
}
|
|
232
|
+
for (const invocation of receipt.invocations)
|
|
233
|
+
settled.add(invocation);
|
|
234
|
+
return receipt;
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
function publicReceipt(event) {
|
|
238
|
+
const receipt = { ...event };
|
|
239
|
+
delete receipt.bodyRanges;
|
|
240
|
+
return {
|
|
241
|
+
...receipt,
|
|
242
|
+
fragmentSkills: [
|
|
243
|
+
...new Set((event.bodyRanges ?? []).map((page) => page.invocation)),
|
|
244
|
+
],
|
|
245
|
+
};
|
|
246
|
+
}
|
|
247
|
+
function incompleteSkills(events) {
|
|
248
|
+
const settled = new Set(events.flatMap((event) => [
|
|
249
|
+
...event.invocations,
|
|
250
|
+
...event.ambiguousInvocations,
|
|
251
|
+
]));
|
|
252
|
+
const fragments = new Set(events.flatMap((event) => (event.bodyRanges ?? []).map((page) => page.invocation)));
|
|
253
|
+
return [...fragments].filter((invocation) => !settled.has(invocation));
|
|
254
|
+
}
|
|
255
|
+
function retainedCalls(events, diagnosticKeys) {
|
|
256
|
+
const calls = [];
|
|
257
|
+
let truncated = false;
|
|
258
|
+
for (const event of events.filter((event) => relevantCall(event, diagnosticKeys))) {
|
|
259
|
+
calls.push(publicReceipt(event));
|
|
260
|
+
if (calls.length > MAX_RETAINED_CALLS ||
|
|
261
|
+
Buffer.byteLength(JSON.stringify(calls)) > 24 * 1024) {
|
|
262
|
+
calls.pop();
|
|
263
|
+
truncated = true;
|
|
264
|
+
break;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
return { calls, truncated };
|
|
268
|
+
}
|
|
269
|
+
function relevantCall(event, diagnosticKeys) {
|
|
270
|
+
return [
|
|
271
|
+
event.invocations.length > 0,
|
|
272
|
+
event.ambiguousInvocations.length > 0,
|
|
273
|
+
(event.bodyRanges ?? []).length > 0,
|
|
274
|
+
event.partial,
|
|
275
|
+
diagnosticKeys.has(hookKey(event)),
|
|
276
|
+
].some(Boolean);
|
|
277
|
+
}
|
|
278
|
+
function primaryEvidence(events, reasons) {
|
|
279
|
+
const index = events.findIndex((event) => event.invocations.length > 0);
|
|
280
|
+
const first = events[index];
|
|
281
|
+
const complete = primarySelectionComplete(events, index, reasons);
|
|
282
|
+
if (!complete)
|
|
283
|
+
return { primarySkill: null, primarySkillCompleteness: "partial" };
|
|
284
|
+
return {
|
|
285
|
+
primarySkill: first?.invocations[0] ?? null,
|
|
286
|
+
primarySkillCompleteness: "complete",
|
|
287
|
+
};
|
|
288
|
+
}
|
|
289
|
+
function primarySelectionComplete(events, index, reasons) {
|
|
290
|
+
const matches = events[index]?.invocations.length ?? 0;
|
|
291
|
+
if (matches > 1)
|
|
292
|
+
return false;
|
|
293
|
+
if (reasons.length === 0)
|
|
294
|
+
return true;
|
|
295
|
+
return primaryBeforeGap(events, index, reasons);
|
|
296
|
+
}
|
|
297
|
+
function primaryBeforeGap(events, index, reasons) {
|
|
298
|
+
if (reasons.join(",") !== "pending_tool_calls")
|
|
299
|
+
return false;
|
|
300
|
+
if (events[index]?.invocations.length !== 1)
|
|
301
|
+
return false;
|
|
302
|
+
const prefix = collectionSummary(events.slice(0, index + 1), null);
|
|
303
|
+
return prefix.pendingToolCallCount === 0;
|
|
304
|
+
}
|
|
305
|
+
export function skillActivationClaims(observation) {
|
|
306
|
+
if (observation.completeness !== "partial")
|
|
307
|
+
return [];
|
|
308
|
+
if (observation.data.primarySkillCompleteness !== "complete")
|
|
309
|
+
return [];
|
|
310
|
+
return [
|
|
311
|
+
{
|
|
312
|
+
id: "sevro.host.skill-activation-claims",
|
|
313
|
+
completeness: "complete",
|
|
314
|
+
data: {
|
|
315
|
+
method: "tool_result_body_match",
|
|
316
|
+
scope: "primary_and_positive_presence",
|
|
317
|
+
collectionCompleteness: "partial",
|
|
318
|
+
primarySkill: observation.data.primarySkill,
|
|
319
|
+
presentSkills: observation.data.observedSkills,
|
|
320
|
+
},
|
|
321
|
+
},
|
|
322
|
+
];
|
|
323
|
+
}
|
|
324
|
+
export function skillExposureClaims(observation) {
|
|
325
|
+
const skillExposures = observation.data.skillExposures.filter((exposure) => exposure.status === "full" || exposure.status === "partial");
|
|
326
|
+
if (skillExposures.length === 0)
|
|
327
|
+
return [];
|
|
328
|
+
return [
|
|
329
|
+
{
|
|
330
|
+
id: "sevro.host.skill-exposure-claims",
|
|
331
|
+
completeness: "complete",
|
|
332
|
+
data: {
|
|
333
|
+
method: "tool_result_body_match",
|
|
334
|
+
scope: "positive_exposure",
|
|
335
|
+
collectionStatus: observation.data.collectionStatus,
|
|
336
|
+
skillExposures,
|
|
337
|
+
},
|
|
338
|
+
},
|
|
339
|
+
];
|
|
340
|
+
}
|
|
341
|
+
function exposureSummary(skills, events, collectionStatus) {
|
|
342
|
+
const exposure = {
|
|
343
|
+
full: new Set(events.flatMap((event) => event.invocations)),
|
|
344
|
+
partial: new Set(incompleteSkills(events)),
|
|
345
|
+
ambiguous: new Set(events.flatMap((event) => event.ambiguousInvocations)),
|
|
346
|
+
};
|
|
347
|
+
return skills.map(({ invocation: skill }) => ({
|
|
348
|
+
skill,
|
|
349
|
+
status: skillExposureStatus(skill, exposure, collectionStatus),
|
|
350
|
+
}));
|
|
351
|
+
}
|
|
352
|
+
function skillExposureStatus(skill, exposure, collectionStatus) {
|
|
353
|
+
if (exposure.full.has(skill))
|
|
354
|
+
return "full";
|
|
355
|
+
if (exposure.ambiguous.has(skill))
|
|
356
|
+
return "ambiguous";
|
|
357
|
+
if (exposure.partial.has(skill))
|
|
358
|
+
return "partial";
|
|
359
|
+
return collectionStatus === "complete"
|
|
360
|
+
? "none"
|
|
361
|
+
: "unknown";
|
|
362
|
+
}
|
|
363
|
+
function exposureCollectionStatus(reasons, eventCount) {
|
|
364
|
+
if (eventCount === 0)
|
|
365
|
+
return "unavailable";
|
|
366
|
+
return reasons.some((reason) => !["partial_skill_bodies", "ambiguous_skill_bodies"].includes(reason))
|
|
367
|
+
? "partial"
|
|
368
|
+
: "complete";
|
|
369
|
+
}
|
|
370
|
+
export async function skillTrackingObservation(tracking, sessionId, completed) {
|
|
371
|
+
const collected = await receipts(tracking);
|
|
372
|
+
const events = pagedEvents(collected.events, tracking.configuration.skills);
|
|
373
|
+
const partialSkills = incompleteSkills(events);
|
|
374
|
+
const { diagnosticKeys, ...collection } = collectionSummary(events, sessionId);
|
|
375
|
+
const { calls, truncated } = retainedCalls(events, diagnosticKeys);
|
|
376
|
+
const ambiguousSkills = [
|
|
377
|
+
...new Set(events.flatMap((event) => event.ambiguousInvocations)),
|
|
378
|
+
];
|
|
379
|
+
const conditions = [
|
|
380
|
+
["host_incomplete", !completed],
|
|
381
|
+
["catalog_incomplete", !tracking.configuration.catalogComplete],
|
|
382
|
+
["session_identity_missing", !collection.sessionIdentified],
|
|
383
|
+
["session_start_missing", !collection.sessionStarted],
|
|
384
|
+
["session_stop_missing", !collection.sessionStopped],
|
|
385
|
+
["pending_tool_calls", collection.pendingToolCallCount > 0],
|
|
386
|
+
["unmatched_post_tool_use", collection.unmatchedPostToolUseCount > 0],
|
|
387
|
+
["duplicate_tool_calls", collection.duplicateToolCallCount > 0],
|
|
388
|
+
[
|
|
389
|
+
"partial_hook_events",
|
|
390
|
+
events.some((event) => event.partial && event.ambiguousInvocations.length === 0),
|
|
391
|
+
],
|
|
392
|
+
["ambiguous_skill_bodies", ambiguousSkills.length > 0],
|
|
393
|
+
["partial_skill_bodies", partialSkills.length > 0],
|
|
394
|
+
["calls_truncated", truncated],
|
|
395
|
+
];
|
|
396
|
+
const incompleteReasons = [
|
|
397
|
+
...collected.reasons,
|
|
398
|
+
...conditions.filter(([, applies]) => applies).map(([reason]) => reason),
|
|
399
|
+
];
|
|
400
|
+
const complete = incompleteReasons.length === 0;
|
|
401
|
+
const collectionStatus = exposureCollectionStatus(incompleteReasons, events.length);
|
|
402
|
+
return {
|
|
403
|
+
id: "sevro.host.skill-activations",
|
|
404
|
+
completeness: complete ? "complete" : "partial",
|
|
405
|
+
data: {
|
|
406
|
+
method: "tool_result_body_match",
|
|
407
|
+
visibility: "tool_result",
|
|
408
|
+
scope: "prepared_skill_bodies",
|
|
409
|
+
catalogComplete: tracking.configuration.catalogComplete,
|
|
410
|
+
collectionStatus,
|
|
411
|
+
skillExposures: exposureSummary(tracking.configuration.skills, events, collectionStatus),
|
|
412
|
+
observedSkills: [...new Set(calls.flatMap((call) => call.invocations))],
|
|
413
|
+
...primaryEvidence(events, incompleteReasons),
|
|
414
|
+
partialSkills,
|
|
415
|
+
ambiguousSkills,
|
|
416
|
+
calls,
|
|
417
|
+
truncated,
|
|
418
|
+
incompleteReasons,
|
|
419
|
+
collection,
|
|
420
|
+
},
|
|
421
|
+
};
|
|
422
|
+
}
|
|
423
|
+
//# sourceMappingURL=skill-hooks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skill-hooks.js","sourceRoot":"","sources":["skill-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { mkdir, readFile, stat, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { shellQuote as quote } from \"../shell\";\nimport { fileURLToPath } from \"node:url\";\nimport { isRecord, isUnknownArray } from \"../value-guards\";\nimport { skillHookCatalog, type SkillCatalogRoot } from \"./skill-hook-catalog\";\nimport type {\n HookSkill,\n SkillBodyRanges,\n SkillHookConfiguration,\n SkillHookReceipt,\n} from \"./skill-hook-handler\";\n\nconst MAX_EVENTS_BYTES = 8 * 1024 * 1024;\nconst MAX_RETAINED_CALLS = 128;\nexport interface SkillTracking {\n configuration: SkillHookConfiguration;\n hooks: Record<string, unknown>;\n command: string;\n}\n\n/** Install the runner's silent observer separately from authorized plugin hooks. */\nexport async function prepareSkillTracking(options: {\n privateRoot: string;\n host: \"codex\";\n roots?: SkillCatalogRoot[];\n}): Promise<SkillTracking> {\n const root = join(options.privateRoot, \"skill-tracking\");\n const receipts = join(root, \"receipts\");\n await mkdir(receipts, { recursive: true, mode: 0o700 });\n const configuration: SkillHookConfiguration = {\n host: options.host,\n receipts,\n ...(await skillHookCatalog(options.roots ?? [])),\n };\n const configurationPath = join(root, \"configuration.json\");\n await writeFile(configurationPath, JSON.stringify(configuration), {\n flag: \"wx\",\n mode: 0o600,\n });\n const command = [\n \"/usr/bin/env\",\n \"-i\",\n \"PATH=/usr/bin:/bin\",\n process.execPath,\n fileURLToPath(\n new URL(\n import.meta.filename.endsWith(\".ts\")\n ? \"./skill-hook-handler.ts\"\n : \"./skill-hook-handler.js\",\n import.meta.url,\n ),\n ),\n configurationPath,\n ]\n .map(quote)\n .join(\" \");\n return { configuration, command, hooks: hookDefinitions(command) };\n}\n\nfunction hookDefinitions(command: string) {\n return Object.fromEntries(\n [\"SessionStart\", \"PreToolUse\", \"PostToolUse\", \"Stop\"].map((event) => {\n return [event, [{ hooks: [{ type: \"command\", command, timeout: 5 }] }]];\n }),\n );\n}\n\nfunction isReceipt(\n value: unknown,\n skills: HookSkill[],\n): value is SkillHookReceipt {\n if (!isRecord(value)) return false;\n return (\n receiptLabels(value) &&\n stringList(value.invocations) &&\n stringList(value.ambiguousInvocations) &&\n receiptPageFields(value, skills)\n );\n}\n\nfunction receiptPageFields(\n value: Record<string, unknown>,\n skills: HookSkill[],\n) {\n return (\n typeof value.partial === \"boolean\" &&\n validBodyRanges(value.bodyRanges, skills)\n );\n}\n\nfunction validOffset(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction validRange(value: unknown, length: number): boolean {\n if (!isOffsetRange(value)) return false;\n const [start, end] = value;\n return start < end && end <= length;\n}\n\nfunction isOffsetRange(value: unknown): value is [number, number] {\n return (\n isUnknownArray(value) && value.length === 2 && value.every(validOffset)\n );\n}\n\nfunction validPage(value: unknown, skills: HookSkill[]): boolean {\n if (!isRecord(value) || !Array.isArray(value.ranges)) return false;\n const skill = skills.find(\n (item) =>\n item.invocation === value.invocation && item.sha256 === value.sha256,\n );\n if (!skill) return false;\n return value.ranges.every((range: unknown) =>\n validRange(range, skill.body.length),\n );\n}\n\nfunction validBodyRanges(value: unknown, skills: HookSkill[]): boolean {\n if (value === undefined) return true;\n return (\n Array.isArray(value) &&\n value.every((page: unknown) => validPage(page, skills))\n );\n}\n\nfunction stringList(value: unknown): value is string[] {\n return (\n Array.isArray(value) &&\n value.every((item: unknown) => typeof item === \"string\")\n );\n}\n\nfunction receiptLabels(value: Record<string, unknown>): boolean {\n if (\n ![\"SessionStart\", \"PreToolUse\", \"PostToolUse\", \"Stop\"].includes(\n String(value.event),\n )\n )\n return false;\n return [value.sessionId, value.turnId, value.toolUseId, value.toolName].every(\n (field) => field === null || typeof field === \"string\",\n );\n}\n\nasync function receipts(tracking: SkillTracking) {\n const root = tracking.configuration.receipts;\n const result = { events: [] as SkillHookReceipt[], reasons: [] as string[] };\n if (existsSync(join(root, \"partial\")))\n result.reasons.push(\"observer_failure\");\n try {\n const path = join(root, \"events.jsonl\");\n if ((await stat(path)).size > MAX_EVENTS_BYTES)\n return { ...result, reasons: [...result.reasons, \"receipt_limit\"] };\n parseReceipts(\n await readFile(path, \"utf8\"),\n tracking.configuration.skills,\n result.events,\n );\n } catch (error) {\n result.reasons.push(\n error instanceof SyntaxError\n ? \"invalid_receipts\"\n : \"receipts_unavailable\",\n );\n }\n return result;\n}\n\nfunction parseReceipts(\n text: string,\n skills: HookSkill[],\n events: SkillHookReceipt[],\n) {\n for (const line of text.trimEnd().split(\"\\n\")) {\n const event: unknown = JSON.parse(line);\n if (!isReceipt(event, skills))\n throw new SyntaxError(\"invalid skill hook receipt\");\n events.push(event);\n }\n}\n\nfunction hookKey(event: SkillHookReceipt): string {\n return JSON.stringify([event.sessionId, event.toolUseId]);\n}\n\nfunction collectionSummary(\n events: SkillHookReceipt[],\n sessionId: string | null,\n) {\n const ledger = {\n pending: new Set<string>(),\n finished: new Set<string>(),\n diagnosticKeys: new Set<string>(),\n duplicateToolCallCount: 0,\n unmatchedPostToolUseCount: 0,\n };\n for (const event of events) updatePending(event, ledger);\n return {\n diagnosticKeys: new Set([...ledger.diagnosticKeys, ...ledger.pending]),\n eventCount: events.length,\n preToolUseCount: events.filter((event) => event.event === \"PreToolUse\")\n .length,\n postToolUseCount: events.filter((event) => event.event === \"PostToolUse\")\n .length,\n pendingToolCallCount: ledger.pending.size,\n duplicateToolCallCount: ledger.duplicateToolCallCount,\n unmatchedPostToolUseCount: ledger.unmatchedPostToolUseCount,\n partialEventCount: events.filter((event) => event.partial).length,\n ...lifecycleSummary(events, sessionId),\n };\n}\n\nfunction lifecycleSummary(\n events: SkillHookReceipt[],\n sessionId: string | null,\n) {\n const selected = events.filter((event) => event.sessionId === sessionId);\n return {\n sessionIdentified: sessionId !== null,\n sessionStarted: selected.some((event) => event.event === \"SessionStart\"),\n sessionStopped: selected.some((event) => event.event === \"Stop\"),\n };\n}\n\nfunction updatePending(\n event: SkillHookReceipt,\n ledger: {\n pending: Set<string>;\n finished: Set<string>;\n diagnosticKeys: Set<string>;\n duplicateToolCallCount: number;\n unmatchedPostToolUseCount: number;\n },\n) {\n const key = hookKey(event);\n if (event.event === \"PreToolUse\") {\n if (duplicateCall(key, ledger)) {\n ledger.duplicateToolCallCount++;\n ledger.diagnosticKeys.add(key);\n }\n ledger.pending.add(key);\n }\n if (event.event === \"PostToolUse\") {\n if (!ledger.pending.delete(key)) {\n ledger.unmatchedPostToolUseCount++;\n ledger.diagnosticKeys.add(key);\n }\n ledger.finished.add(key);\n }\n}\n\nfunction duplicateCall(\n key: string,\n ledger: { pending: Set<string>; finished: Set<string> },\n): boolean {\n return ledger.pending.has(key) || ledger.finished.has(key);\n}\n\nfunction mergedRanges(ranges: [number, number][]): [number, number][] {\n const merged: [number, number][] = [];\n for (const [start, end] of ranges.sort((a, b) => a[0] - b[0])) {\n const previous = merged.at(-1);\n if (previous && start <= previous[1])\n previous[1] = Math.max(previous[1], end);\n else merged.push([start, end]);\n }\n return merged;\n}\n\nfunction wholeBody(ranges: [number, number][], skill: HookSkill) {\n const range = ranges[0];\n return (\n ranges.length === 1 &&\n range !== undefined &&\n range[0] === 0 &&\n range[1] === skill.body.length\n );\n}\n\nfunction completedPage(\n receipt: SkillHookReceipt,\n page: SkillBodyRanges,\n skills: HookSkill[],\n) {\n const aliases = skills.filter((skill) => skill.sha256 === page.sha256);\n if (aliases.some((skill) => skill.invocation !== page.invocation)) {\n receipt.ambiguousInvocations = [\n ...new Set([\n ...receipt.ambiguousInvocations,\n ...aliases.map((skill) => skill.invocation),\n ]),\n ];\n receipt.partial = true;\n } else\n receipt.invocations = [\n ...new Set([...receipt.invocations, page.invocation]),\n ];\n}\n\nfunction accumulatePage(\n receipt: SkillHookReceipt,\n page: SkillBodyRanges,\n skills: HookSkill[],\n coverage: Map<string, [number, number][]>,\n) {\n const skill = skills.find(\n (item) =>\n item.invocation === page.invocation && item.sha256 === page.sha256,\n );\n if (!skill) {\n receipt.partial = true;\n return;\n }\n const key = JSON.stringify([\n receipt.sessionId,\n receipt.turnId,\n page.invocation,\n page.sha256,\n ]);\n const ranges = mergedRanges([...(coverage.get(key) ?? []), ...page.ranges]);\n coverage.set(key, ranges);\n if (wholeBody(ranges, skill)) completedPage(receipt, page, skills);\n}\n\nfunction pagedEvents(events: SkillHookReceipt[], skills: HookSkill[]) {\n const coverage = new Map<string, [number, number][]>();\n const settled = new Set<string>();\n return events.map((event) => {\n const receipt = { ...event };\n for (const page of event.bodyRanges ?? []) {\n if (!settled.has(page.invocation))\n accumulatePage(receipt, page, skills, coverage);\n }\n for (const invocation of receipt.invocations) settled.add(invocation);\n return receipt;\n });\n}\n\nfunction publicReceipt(event: SkillHookReceipt) {\n const receipt = { ...event };\n delete receipt.bodyRanges;\n return {\n ...receipt,\n fragmentSkills: [\n ...new Set((event.bodyRanges ?? []).map((page) => page.invocation)),\n ],\n };\n}\n\nfunction incompleteSkills(events: SkillHookReceipt[]) {\n const settled = new Set(\n events.flatMap((event) => [\n ...event.invocations,\n ...event.ambiguousInvocations,\n ]),\n );\n const fragments = new Set(\n events.flatMap((event) =>\n (event.bodyRanges ?? []).map((page) => page.invocation),\n ),\n );\n return [...fragments].filter((invocation) => !settled.has(invocation));\n}\n\nfunction retainedCalls(\n events: SkillHookReceipt[],\n diagnosticKeys: Set<string>,\n) {\n const calls: ReturnType<typeof publicReceipt>[] = [];\n let truncated = false;\n for (const event of events.filter((event) =>\n relevantCall(event, diagnosticKeys),\n )) {\n calls.push(publicReceipt(event));\n if (\n calls.length > MAX_RETAINED_CALLS ||\n Buffer.byteLength(JSON.stringify(calls)) > 24 * 1024\n ) {\n calls.pop();\n truncated = true;\n break;\n }\n }\n return { calls, truncated };\n}\n\nfunction relevantCall(\n event: SkillHookReceipt,\n diagnosticKeys: Set<string>,\n): boolean {\n return [\n event.invocations.length > 0,\n event.ambiguousInvocations.length > 0,\n (event.bodyRanges ?? []).length > 0,\n event.partial,\n diagnosticKeys.has(hookKey(event)),\n ].some(Boolean);\n}\n\nfunction primaryEvidence(events: SkillHookReceipt[], reasons: string[]) {\n const index = events.findIndex((event) => event.invocations.length > 0);\n const first = events[index];\n const complete = primarySelectionComplete(events, index, reasons);\n if (!complete)\n return { primarySkill: null, primarySkillCompleteness: \"partial\" as const };\n return {\n primarySkill: first?.invocations[0] ?? null,\n primarySkillCompleteness: \"complete\" as const,\n };\n}\n\nfunction primarySelectionComplete(\n events: SkillHookReceipt[],\n index: number,\n reasons: string[],\n) {\n const matches = events[index]?.invocations.length ?? 0;\n if (matches > 1) return false;\n if (reasons.length === 0) return true;\n return primaryBeforeGap(events, index, reasons);\n}\n\nfunction primaryBeforeGap(\n events: SkillHookReceipt[],\n index: number,\n reasons: string[],\n) {\n if (reasons.join(\",\") !== \"pending_tool_calls\") return false;\n if (events[index]?.invocations.length !== 1) return false;\n const prefix = collectionSummary(events.slice(0, index + 1), null);\n return prefix.pendingToolCallCount === 0;\n}\n\nexport function skillActivationClaims(\n observation: Awaited<ReturnType<typeof skillTrackingObservation>>,\n) {\n if (observation.completeness !== \"partial\") return [];\n if (observation.data.primarySkillCompleteness !== \"complete\") return [];\n return [\n {\n id: \"sevro.host.skill-activation-claims\",\n completeness: \"complete\" as const,\n data: {\n method: \"tool_result_body_match\",\n scope: \"primary_and_positive_presence\",\n collectionCompleteness: \"partial\",\n primarySkill: observation.data.primarySkill,\n presentSkills: observation.data.observedSkills,\n },\n },\n ];\n}\n\nexport function skillExposureClaims(\n observation: Awaited<ReturnType<typeof skillTrackingObservation>>,\n) {\n const skillExposures = observation.data.skillExposures.filter(\n (exposure) => exposure.status === \"full\" || exposure.status === \"partial\",\n );\n if (skillExposures.length === 0) return [];\n return [\n {\n id: \"sevro.host.skill-exposure-claims\",\n completeness: \"complete\" as const,\n data: {\n method: \"tool_result_body_match\",\n scope: \"positive_exposure\",\n collectionStatus: observation.data.collectionStatus,\n skillExposures,\n },\n },\n ];\n}\n\nfunction exposureSummary(\n skills: HookSkill[],\n events: SkillHookReceipt[],\n collectionStatus: string,\n) {\n const exposure = {\n full: new Set(events.flatMap((event) => event.invocations)),\n partial: new Set(incompleteSkills(events)),\n ambiguous: new Set(events.flatMap((event) => event.ambiguousInvocations)),\n };\n return skills.map(({ invocation: skill }) => ({\n skill,\n status: skillExposureStatus(skill, exposure, collectionStatus),\n }));\n}\n\nfunction skillExposureStatus(\n skill: string,\n exposure: { full: Set<string>; partial: Set<string>; ambiguous: Set<string> },\n collectionStatus: string,\n) {\n if (exposure.full.has(skill)) return \"full\" as const;\n if (exposure.ambiguous.has(skill)) return \"ambiguous\" as const;\n if (exposure.partial.has(skill)) return \"partial\" as const;\n return collectionStatus === \"complete\"\n ? (\"none\" as const)\n : (\"unknown\" as const);\n}\n\nfunction exposureCollectionStatus(reasons: string[], eventCount: number) {\n if (eventCount === 0) return \"unavailable\" as const;\n return reasons.some(\n (reason) =>\n ![\"partial_skill_bodies\", \"ambiguous_skill_bodies\"].includes(reason),\n )\n ? (\"partial\" as const)\n : (\"complete\" as const);\n}\n\nexport async function skillTrackingObservation(\n tracking: SkillTracking,\n sessionId: string | null,\n completed: boolean,\n) {\n const collected = await receipts(tracking);\n const events = pagedEvents(collected.events, tracking.configuration.skills);\n const partialSkills = incompleteSkills(events);\n const { diagnosticKeys, ...collection } = collectionSummary(\n events,\n sessionId,\n );\n const { calls, truncated } = retainedCalls(events, diagnosticKeys);\n const ambiguousSkills = [\n ...new Set(events.flatMap((event) => event.ambiguousInvocations)),\n ];\n const conditions: [string, boolean][] = [\n [\"host_incomplete\", !completed],\n [\"catalog_incomplete\", !tracking.configuration.catalogComplete],\n [\"session_identity_missing\", !collection.sessionIdentified],\n [\"session_start_missing\", !collection.sessionStarted],\n [\"session_stop_missing\", !collection.sessionStopped],\n [\"pending_tool_calls\", collection.pendingToolCallCount > 0],\n [\"unmatched_post_tool_use\", collection.unmatchedPostToolUseCount > 0],\n [\"duplicate_tool_calls\", collection.duplicateToolCallCount > 0],\n [\n \"partial_hook_events\",\n events.some(\n (event) => event.partial && event.ambiguousInvocations.length === 0,\n ),\n ],\n [\"ambiguous_skill_bodies\", ambiguousSkills.length > 0],\n [\"partial_skill_bodies\", partialSkills.length > 0],\n [\"calls_truncated\", truncated],\n ];\n const incompleteReasons = [\n ...collected.reasons,\n ...conditions.filter(([, applies]) => applies).map(([reason]) => reason),\n ];\n const complete = incompleteReasons.length === 0;\n const collectionStatus = exposureCollectionStatus(\n incompleteReasons,\n events.length,\n );\n return {\n id: \"sevro.host.skill-activations\",\n completeness: complete ? (\"complete\" as const) : (\"partial\" as const),\n data: {\n method: \"tool_result_body_match\",\n visibility: \"tool_result\",\n scope: \"prepared_skill_bodies\",\n catalogComplete: tracking.configuration.catalogComplete,\n collectionStatus,\n skillExposures: exposureSummary(\n tracking.configuration.skills,\n events,\n collectionStatus,\n ),\n observedSkills: [...new Set(calls.flatMap((call) => call.invocations))],\n ...primaryEvidence(events, incompleteReasons),\n partialSkills,\n ambiguousSkills,\n calls,\n truncated,\n incompleteReasons,\n collection,\n },\n };\n}\n"]}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { createReadStream } from "node:fs";
|
|
3
|
+
import { lstat, readdir, readlink } from "node:fs/promises";
|
|
4
|
+
import { join, relative, sep } from "node:path";
|
|
5
|
+
const MAX_ENTRIES = 10_000;
|
|
6
|
+
const MAX_FILE_BYTES = 128 * 1024 * 1024;
|
|
7
|
+
class WorkspaceFingerprint {
|
|
8
|
+
root;
|
|
9
|
+
identity = createHash("sha256");
|
|
10
|
+
entries = 0;
|
|
11
|
+
fileBytes = 0;
|
|
12
|
+
constructor(root) {
|
|
13
|
+
this.root = root;
|
|
14
|
+
}
|
|
15
|
+
async digest() {
|
|
16
|
+
for (const entry of (await readdir(this.root)).sort()) {
|
|
17
|
+
if (entry === ".git")
|
|
18
|
+
continue;
|
|
19
|
+
await this.visit(join(this.root, entry));
|
|
20
|
+
}
|
|
21
|
+
return this.identity.digest("hex");
|
|
22
|
+
}
|
|
23
|
+
async visit(path) {
|
|
24
|
+
this.entries++;
|
|
25
|
+
if (this.entries > MAX_ENTRIES)
|
|
26
|
+
throw new Error("workspace entry limit");
|
|
27
|
+
const name = relative(this.root, path).split(sep).join("/");
|
|
28
|
+
const info = await lstat(path);
|
|
29
|
+
if (info.isDirectory())
|
|
30
|
+
await this.directory(path, name);
|
|
31
|
+
else if (info.isSymbolicLink())
|
|
32
|
+
this.identity.update(`link\0${name}\0${await readlink(path)}\0`);
|
|
33
|
+
else
|
|
34
|
+
await this.file(path, name, info);
|
|
35
|
+
}
|
|
36
|
+
async directory(path, name) {
|
|
37
|
+
this.identity.update(`dir\0${name}\0`);
|
|
38
|
+
for (const child of (await readdir(path)).sort())
|
|
39
|
+
await this.visit(join(path, child));
|
|
40
|
+
}
|
|
41
|
+
async file(path, name, info) {
|
|
42
|
+
if (!info.isFile() || !Number.isSafeInteger(info.size))
|
|
43
|
+
throw new Error("unsupported workspace entry");
|
|
44
|
+
if (this.fileBytes + info.size > MAX_FILE_BYTES)
|
|
45
|
+
throw new Error("workspace byte limit");
|
|
46
|
+
const digest = await this.fileHash(path);
|
|
47
|
+
this.identity.update(`file\0${name}\0${info.mode & 0o111 ? "x" : "-"}\0${digest}\0`);
|
|
48
|
+
}
|
|
49
|
+
async fileHash(path) {
|
|
50
|
+
const content = createHash("sha256");
|
|
51
|
+
for await (const value of createReadStream(path)) {
|
|
52
|
+
const chunk = value;
|
|
53
|
+
if (!Buffer.isBuffer(chunk))
|
|
54
|
+
throw new Error("unsupported workspace entry");
|
|
55
|
+
this.fileBytes += chunk.byteLength;
|
|
56
|
+
if (this.fileBytes > MAX_FILE_BYTES)
|
|
57
|
+
throw new Error("workspace byte limit");
|
|
58
|
+
content.update(chunk);
|
|
59
|
+
}
|
|
60
|
+
return content.digest("hex");
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
/** Hash visible worktree contents without retaining paths or file data. */
|
|
64
|
+
export async function workspaceFingerprint(root) {
|
|
65
|
+
try {
|
|
66
|
+
return await new WorkspaceFingerprint(root).digest();
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
return null;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=workspace-fingerprint.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workspace-fingerprint.js","sourceRoot":"","sources":["workspace-fingerprint.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { createReadStream, type Stats } from \"node:fs\";\nimport { lstat, readdir, readlink } from \"node:fs/promises\";\nimport { join, relative, sep } from \"node:path\";\n\nconst MAX_ENTRIES = 10_000;\nconst MAX_FILE_BYTES = 128 * 1024 * 1024;\n\nclass WorkspaceFingerprint {\n private readonly identity = createHash(\"sha256\");\n private entries = 0;\n private fileBytes = 0;\n constructor(private readonly root: string) {}\n\n async digest(): Promise<string> {\n for (const entry of (await readdir(this.root)).sort()) {\n if (entry === \".git\") continue;\n await this.visit(join(this.root, entry));\n }\n return this.identity.digest(\"hex\");\n }\n\n private async visit(path: string): Promise<void> {\n this.entries++;\n if (this.entries > MAX_ENTRIES) throw new Error(\"workspace entry limit\");\n const name = relative(this.root, path).split(sep).join(\"/\");\n const info = await lstat(path);\n if (info.isDirectory()) await this.directory(path, name);\n else if (info.isSymbolicLink())\n this.identity.update(`link\\0${name}\\0${await readlink(path)}\\0`);\n else await this.file(path, name, info);\n }\n\n private async directory(path: string, name: string): Promise<void> {\n this.identity.update(`dir\\0${name}\\0`);\n for (const child of (await readdir(path)).sort())\n await this.visit(join(path, child));\n }\n\n private async file(path: string, name: string, info: Stats): Promise<void> {\n if (!info.isFile() || !Number.isSafeInteger(info.size))\n throw new Error(\"unsupported workspace entry\");\n if (this.fileBytes + info.size > MAX_FILE_BYTES)\n throw new Error(\"workspace byte limit\");\n const digest = await this.fileHash(path);\n this.identity.update(\n `file\\0${name}\\0${info.mode & 0o111 ? \"x\" : \"-\"}\\0${digest}\\0`,\n );\n }\n\n private async fileHash(path: string): Promise<string> {\n const content = createHash(\"sha256\");\n for await (const value of createReadStream(path)) {\n const chunk: unknown = value;\n if (!Buffer.isBuffer(chunk))\n throw new Error(\"unsupported workspace entry\");\n this.fileBytes += chunk.byteLength;\n if (this.fileBytes > MAX_FILE_BYTES)\n throw new Error(\"workspace byte limit\");\n content.update(chunk);\n }\n return content.digest(\"hex\");\n }\n}\n\n/** Hash visible worktree contents without retaining paths or file data. */\nexport async function workspaceFingerprint(\n root: string,\n): Promise<string | null> {\n try {\n return await new WorkspaceFingerprint(root).digest();\n } catch {\n return null;\n }\n}\n"]}
|