agentic-engineering-harness 0.6.27 → 0.6.29
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/README.md +3 -3
- package/dist/agents/permissions.js +12 -0
- package/dist/agents/permissions.js.map +1 -1
- package/dist/audit/run.js +2 -0
- package/dist/audit/run.js.map +1 -1
- package/dist/cli.js +12 -13
- package/dist/cli.js.map +1 -1
- package/dist/context/budget.d.ts +4 -0
- package/dist/context/budget.js +19 -0
- package/dist/context/budget.js.map +1 -0
- package/dist/context/classifier.d.ts +4 -0
- package/dist/context/classifier.js +14 -0
- package/dist/context/classifier.js.map +1 -0
- package/dist/context/compression/headroom.d.ts +18 -0
- package/dist/context/compression/headroom.js +53 -0
- package/dist/context/compression/headroom.js.map +1 -0
- package/dist/context/compression/index.d.ts +3 -0
- package/dist/context/compression/index.js +4 -0
- package/dist/context/compression/index.js.map +1 -0
- package/dist/context/compression/lifecycle.d.ts +20 -0
- package/dist/context/compression/lifecycle.js +70 -0
- package/dist/context/compression/lifecycle.js.map +1 -0
- package/dist/context/compression/types.d.ts +27 -0
- package/dist/context/compression/types.js +2 -0
- package/dist/context/compression/types.js.map +1 -0
- package/dist/context/envelope.d.ts +4 -0
- package/dist/context/envelope.js +20 -0
- package/dist/context/envelope.js.map +1 -0
- package/dist/context/estimator.d.ts +3 -0
- package/dist/context/estimator.js +10 -0
- package/dist/context/estimator.js.map +1 -0
- package/dist/context/eval.d.ts +19 -0
- package/dist/context/eval.js +12 -0
- package/dist/context/eval.js.map +1 -0
- package/dist/context/gateway.d.ts +22 -0
- package/dist/context/gateway.js +202 -0
- package/dist/context/gateway.js.map +1 -0
- package/dist/context/index.d.ts +15 -0
- package/dist/context/index.js +16 -0
- package/dist/context/index.js.map +1 -0
- package/dist/context/policy.d.ts +6 -0
- package/dist/context/policy.js +40 -0
- package/dist/context/policy.js.map +1 -0
- package/dist/context/preflight.d.ts +13 -0
- package/dist/context/preflight.js +25 -0
- package/dist/context/preflight.js.map +1 -0
- package/dist/context/projectors/audit.d.ts +2 -0
- package/dist/context/projectors/audit.js +30 -0
- package/dist/context/projectors/audit.js.map +1 -0
- package/dist/context/projectors/diff.d.ts +2 -0
- package/dist/context/projectors/diff.js +8 -0
- package/dist/context/projectors/diff.js.map +1 -0
- package/dist/context/projectors/explorer.d.ts +2 -0
- package/dist/context/projectors/explorer.js +5 -0
- package/dist/context/projectors/explorer.js.map +1 -0
- package/dist/context/projectors/index.d.ts +8 -0
- package/dist/context/projectors/index.js +9 -0
- package/dist/context/projectors/index.js.map +1 -0
- package/dist/context/projectors/operation.d.ts +3 -0
- package/dist/context/projectors/operation.js +26 -0
- package/dist/context/projectors/operation.js.map +1 -0
- package/dist/context/projectors/planner.d.ts +2 -0
- package/dist/context/projectors/planner.js +5 -0
- package/dist/context/projectors/planner.js.map +1 -0
- package/dist/context/projectors/source.d.ts +2 -0
- package/dist/context/projectors/source.js +5 -0
- package/dist/context/projectors/source.js.map +1 -0
- package/dist/context/projectors/structured.d.ts +2 -0
- package/dist/context/projectors/structured.js +24 -0
- package/dist/context/projectors/structured.js.map +1 -0
- package/dist/context/projectors/validation.d.ts +3 -0
- package/dist/context/projectors/validation.js +25 -0
- package/dist/context/projectors/validation.js.map +1 -0
- package/dist/context/provenance.d.ts +3 -0
- package/dist/context/provenance.js +13 -0
- package/dist/context/provenance.js.map +1 -0
- package/dist/context/repository/graphify.d.ts +3 -0
- package/dist/context/repository/graphify.js +7 -0
- package/dist/context/repository/graphify.js.map +1 -0
- package/dist/context/repository/index.d.ts +6 -0
- package/dist/context/repository/index.js +7 -0
- package/dist/context/repository/index.js.map +1 -0
- package/dist/context/repository/map.d.ts +6 -0
- package/dist/context/repository/map.js +34 -0
- package/dist/context/repository/map.js.map +1 -0
- package/dist/context/repository/rank.d.ts +3 -0
- package/dist/context/repository/rank.js +43 -0
- package/dist/context/repository/rank.js.map +1 -0
- package/dist/context/repository/render.d.ts +8 -0
- package/dist/context/repository/render.js +21 -0
- package/dist/context/repository/render.js.map +1 -0
- package/dist/context/repository/serena.d.ts +11 -0
- package/dist/context/repository/serena.js +26 -0
- package/dist/context/repository/serena.js.map +1 -0
- package/dist/context/repository/types.d.ts +34 -0
- package/dist/context/repository/types.js +2 -0
- package/dist/context/repository/types.js.map +1 -0
- package/dist/context/retrieval/authorization.d.ts +11 -0
- package/dist/context/retrieval/authorization.js +9 -0
- package/dist/context/retrieval/authorization.js.map +1 -0
- package/dist/context/retrieval/gateway.d.ts +33 -0
- package/dist/context/retrieval/gateway.js +69 -0
- package/dist/context/retrieval/gateway.js.map +1 -0
- package/dist/context/retrieval/index.d.ts +5 -0
- package/dist/context/retrieval/index.js +6 -0
- package/dist/context/retrieval/index.js.map +1 -0
- package/dist/context/retrieval/mcp.d.ts +3 -0
- package/dist/context/retrieval/mcp.js +8 -0
- package/dist/context/retrieval/mcp.js.map +1 -0
- package/dist/context/retrieval/persisted.d.ts +3 -0
- package/dist/context/retrieval/persisted.js +22 -0
- package/dist/context/retrieval/persisted.js.map +1 -0
- package/dist/context/retrieval/server.d.ts +1 -0
- package/dist/context/retrieval/server.js +52 -0
- package/dist/context/retrieval/server.js.map +1 -0
- package/dist/context/telemetry.d.ts +3 -0
- package/dist/context/telemetry.js +9 -0
- package/dist/context/telemetry.js.map +1 -0
- package/dist/context/types.d.ts +243 -0
- package/dist/context/types.js +29 -0
- package/dist/context/types.js.map +1 -0
- package/dist/core/config.js +19 -1
- package/dist/core/config.js.map +1 -1
- package/dist/core/doctor.js +23 -2
- package/dist/core/doctor.js.map +1 -1
- package/dist/core/run.js +35 -14
- package/dist/core/run.js.map +1 -1
- package/dist/core/types.d.ts +52 -0
- package/dist/core/verify.d.ts +2 -0
- package/dist/core/verify.js +1 -1
- package/dist/core/verify.js.map +1 -1
- package/dist/entry.js +30 -0
- package/dist/entry.js.map +1 -1
- package/dist/evals/fullStack.d.ts +17 -0
- package/dist/evals/fullStack.js +42 -0
- package/dist/evals/fullStack.js.map +1 -0
- package/dist/main.js +1 -0
- package/dist/main.js.map +1 -1
- package/dist/operations/change.js +2 -0
- package/dist/operations/change.js.map +1 -1
- package/dist/paseo/launchSpec.d.ts +3 -0
- package/dist/paseo/launchSpec.js +17 -0
- package/dist/paseo/launchSpec.js.map +1 -1
- package/dist/provenance/generate.d.ts +19 -0
- package/dist/provenance/generate.js +94 -8
- package/dist/provenance/generate.js.map +1 -1
- package/dist/providers/engram.d.ts +26 -1
- package/dist/providers/engram.js +110 -6
- package/dist/providers/engram.js.map +1 -1
- package/dist/providers/graphify.d.ts +9 -1
- package/dist/providers/graphify.js +34 -16
- package/dist/providers/graphify.js.map +1 -1
- package/dist/providers/graphifyModel.d.ts +23 -0
- package/dist/providers/graphifyModel.js +101 -0
- package/dist/providers/graphifyModel.js.map +1 -0
- package/dist/providers/headroom.d.ts +2 -0
- package/dist/providers/headroom.js +3 -0
- package/dist/providers/headroom.js.map +1 -0
- package/dist/providers/memory.d.ts +1 -0
- package/dist/providers/memory.js +2 -0
- package/dist/providers/memory.js.map +1 -0
- package/dist/providers/serena.d.ts +1 -0
- package/dist/providers/serena.js +2 -0
- package/dist/providers/serena.js.map +1 -0
- package/dist/providers/types.d.ts +25 -2
- package/dist/telemetry/events.d.ts +1 -0
- package/dist/telemetry/events.js +19 -2
- package/dist/telemetry/events.js.map +1 -1
- package/dist/telemetry/otlp.d.ts +6 -1
- package/dist/telemetry/otlp.js +2 -2
- package/dist/telemetry/otlp.js.map +1 -1
- package/dist/toolchain/config.js +10 -1
- package/dist/toolchain/config.js.map +1 -1
- package/dist/toolchain/resolve.js +8 -0
- package/dist/toolchain/resolve.js.map +1 -1
- package/dist/validators/external.js +24 -3
- package/dist/validators/external.js.map +1 -1
- package/dist/validators/graphify.js +5 -73
- package/dist/validators/graphify.js.map +1 -1
- package/dist/validators/opa.d.ts +14 -1
- package/dist/validators/opa.js +6 -2
- package/dist/validators/opa.js.map +1 -1
- package/dist/validators/toolEvidence.d.ts +29 -0
- package/dist/validators/toolEvidence.js +104 -0
- package/dist/validators/toolEvidence.js.map +1 -0
- package/dist/workers/agentPrompt.d.ts +9 -0
- package/dist/workers/agentPrompt.js +133 -4
- package/dist/workers/agentPrompt.js.map +1 -1
- package/docs/ARCHITECTURE.md +20 -1
- package/docs/COMPONENT_MATURITY.md +43 -0
- package/docs/CONTEXT_EFFICIENCY.md +48 -0
- package/docs/MEMORY.md +9 -0
- package/docs/OBSERVABILITY.md +6 -1
- package/docs/OSS_STACK.md +10 -2
- package/docs/SECURITY.md +12 -0
- package/package.json +2 -2
- package/policies/core/trust-boundary.rego +14 -4
- package/presets/agents/default.jsonc +4 -4
- package/presets/agents/orchestration.jsonc +2 -2
- package/schemas/project.schema.json +14 -0
- package/templates/project.yaml +42 -0
- package/templates/toolchain.yaml +34 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/context/compression/lifecycle.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { ContextFragment } from "../types.js";
|
|
2
|
+
export interface ProviderHealth {
|
|
3
|
+
ok: boolean;
|
|
4
|
+
message: string;
|
|
5
|
+
version?: string;
|
|
6
|
+
}
|
|
7
|
+
export interface ContextCompressionRequest {
|
|
8
|
+
operationId: string;
|
|
9
|
+
fragment: ContextFragment;
|
|
10
|
+
maxTokens?: number;
|
|
11
|
+
sourceSha256: string;
|
|
12
|
+
}
|
|
13
|
+
export interface ContextCompressionResult {
|
|
14
|
+
content: string;
|
|
15
|
+
provider: string;
|
|
16
|
+
providerVersion?: string;
|
|
17
|
+
reversible: boolean;
|
|
18
|
+
handle?: string;
|
|
19
|
+
originalTokens: number;
|
|
20
|
+
compressedTokens: number;
|
|
21
|
+
}
|
|
22
|
+
export interface ContextCompressionProvider {
|
|
23
|
+
readonly name: string;
|
|
24
|
+
doctor(root: string): Promise<ProviderHealth>;
|
|
25
|
+
compress(root: string, request: ContextCompressionRequest): Promise<ContextCompressionResult>;
|
|
26
|
+
}
|
|
27
|
+
export type { HeadroomRuntimeHandle, HeadroomRuntimeOptions } from "./lifecycle.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/context/compression/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { ContextEnvelope } from "./types.js";
|
|
2
|
+
export declare function buildContextEnvelope(input: Omit<ContextEnvelope, "provenance">): ContextEnvelope;
|
|
3
|
+
export declare function verifyContextEnvelope(envelope: ContextEnvelope): boolean;
|
|
4
|
+
export declare function renderContextEnvelope(envelope: ContextEnvelope): string;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { assertContextEnvelope } from "./types.js";
|
|
2
|
+
import { CONTEXT_PROJECTION_VERSION, sha256, stableJson } from "./provenance.js";
|
|
3
|
+
export function buildContextEnvelope(input) {
|
|
4
|
+
const base = { ...input, provenance: { sha256: "", createdAt: new Date().toISOString(), projectionVersion: CONTEXT_PROJECTION_VERSION } };
|
|
5
|
+
const digest = sha256(stableJson({ ...base, provenance: { ...base.provenance, sha256: undefined } }));
|
|
6
|
+
return assertContextEnvelope({ ...base, provenance: { ...base.provenance, sha256: digest } });
|
|
7
|
+
}
|
|
8
|
+
export function verifyContextEnvelope(envelope) {
|
|
9
|
+
const expected = sha256(stableJson({ ...envelope, provenance: { ...envelope.provenance, sha256: undefined } }));
|
|
10
|
+
return expected === envelope.provenance.sha256;
|
|
11
|
+
}
|
|
12
|
+
export function renderContextEnvelope(envelope) {
|
|
13
|
+
const sections = envelope.fragments.map((fragment) => {
|
|
14
|
+
const source = fragment.source?.artifact ? ` source=${fragment.source.artifact}` : "";
|
|
15
|
+
const mode = fragment.compressed ? "compressed" : fragment.projected ? "projected" : fragment.preservation.toLowerCase();
|
|
16
|
+
return `### ${fragment.kind}:${fragment.id} [${mode}, ${fragment.estimatedTokens} tokens]${source}\n${fragment.content}`;
|
|
17
|
+
});
|
|
18
|
+
return [`AEH ContextEnvelope v${envelope.version} operation=${envelope.operationId} agent=${envelope.logicalAgent} phase=${envelope.phase}`, ...sections, envelope.retrieval.available ? "AEH raw context is retrievable only through authorized fragment IDs." : "Raw context retrieval is not exposed by this transport; use the delivered bounded projections."].join("\n\n");
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=envelope.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/context/envelope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,UAAU,oBAAoB,CAAC,KAA0C;IAC7E,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,EAAE,CAAC;IAC1I,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtG,OAAO,qBAAqB,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAChH,OAAO,QAAQ,KAAK,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAmC,EAAE,EAAE;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QACzH,OAAO,OAAO,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI,KAAK,QAAQ,CAAC,eAAe,WAAW,MAAM,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3H,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,wBAAwB,QAAQ,CAAC,OAAO,cAAc,QAAQ,CAAC,WAAW,UAAU,QAAQ,CAAC,YAAY,UAAU,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,sEAAsE,CAAC,CAAC,CAAC,gGAAgG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnX,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/** Deterministic, dependency-free estimate used for selection. Provider token usage remains authoritative when available. */
|
|
2
|
+
export function estimateTokens(value) {
|
|
3
|
+
if (!value)
|
|
4
|
+
return 0;
|
|
5
|
+
return Math.max(1, Math.ceil(value.replace(/\r\n/g, "\n").length / 4));
|
|
6
|
+
}
|
|
7
|
+
export function estimateBytes(value) {
|
|
8
|
+
return Buffer.byteLength(value, "utf8");
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=estimator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"estimator.js","sourceRoot":"","sources":["../../src/context/estimator.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { ContextMetrics } from "./types.js";
|
|
2
|
+
export interface ContextEvaluationSample {
|
|
3
|
+
variant: "baseline" | "observe" | "enforce" | string;
|
|
4
|
+
success: boolean;
|
|
5
|
+
costUsd?: number;
|
|
6
|
+
metrics: ContextMetrics;
|
|
7
|
+
}
|
|
8
|
+
export interface ContextEvaluationSummary {
|
|
9
|
+
variant: string;
|
|
10
|
+
sampleSize: number;
|
|
11
|
+
successfulOperations: number;
|
|
12
|
+
successRate: number;
|
|
13
|
+
medianDeliveredTokenReduction: number;
|
|
14
|
+
uncachedInputReduction?: number;
|
|
15
|
+
costPerSuccessfulOperation?: number;
|
|
16
|
+
tokensPerSuccessfulOperation?: number;
|
|
17
|
+
projectionEscapeRate: number;
|
|
18
|
+
}
|
|
19
|
+
export declare function summarizeContextEvaluation(samples: ContextEvaluationSample[], variant: string): ContextEvaluationSummary;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export function summarizeContextEvaluation(samples, variant) {
|
|
2
|
+
const selected = samples.filter((sample) => sample.variant === variant);
|
|
3
|
+
const successful = selected.filter((sample) => sample.success);
|
|
4
|
+
const reductions = selected.map((sample) => sample.metrics.estimatedRawTokens ? 1 - sample.metrics.estimatedDeliveredTokens / sample.metrics.estimatedRawTokens : 0).sort((a, b) => a - b);
|
|
5
|
+
const costs = successful.map((sample) => sample.costUsd).filter((value) => value !== undefined);
|
|
6
|
+
const tokens = successful.map((sample) => sample.metrics.estimatedDeliveredTokens);
|
|
7
|
+
return { variant, sampleSize: selected.length, successfulOperations: successful.length, successRate: selected.length ? successful.length / selected.length : 0, medianDeliveredTokenReduction: median(reductions), uncachedInputReduction: selected.length ? average(selected.map((sample) => sample.metrics.estimatedRawTokens ? 1 - sample.metrics.estimatedDeliveredTokens / sample.metrics.estimatedRawTokens : 0)) : undefined, costPerSuccessfulOperation: costs.length && successful.length ? costs.reduce((sum, value) => sum + value, 0) / successful.length : undefined, tokensPerSuccessfulOperation: tokens.length ? tokens.reduce((sum, value) => sum + value, 0) / tokens.length : undefined, projectionEscapeRate: selected.length ? average(selected.map((sample) => sample.metrics.retrievedFragments ? sample.metrics.retrievalEscapes / sample.metrics.retrievedFragments : 0)) : 0 };
|
|
8
|
+
}
|
|
9
|
+
function median(values) { if (!values.length)
|
|
10
|
+
return 0; const middle = Math.floor(values.length / 2); return values.length % 2 ? values[middle] : (values[middle - 1] + values[middle]) / 2; }
|
|
11
|
+
function average(values) { return values.length ? values.reduce((sum, value) => sum + value, 0) / values.length : 0; }
|
|
12
|
+
//# sourceMappingURL=eval.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/context/eval.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { HarnessProjectConfig } from "../core/types.js";
|
|
2
|
+
import type { ContextCompressionProvider } from "./compression/types.js";
|
|
3
|
+
import type { ContextPreparationRequest, ContextPreparationResult } from "./types.js";
|
|
4
|
+
export interface ContextBudgetGatewayOptions {
|
|
5
|
+
compressor?: ContextCompressionProvider;
|
|
6
|
+
persist?: boolean;
|
|
7
|
+
telemetry?: boolean;
|
|
8
|
+
}
|
|
9
|
+
export declare class ContextBudgetGateway {
|
|
10
|
+
private readonly root;
|
|
11
|
+
private readonly config;
|
|
12
|
+
private readonly compressor?;
|
|
13
|
+
private readonly persist;
|
|
14
|
+
private readonly telemetry;
|
|
15
|
+
constructor(root: string, config: HarnessProjectConfig, options?: ContextBudgetGatewayOptions);
|
|
16
|
+
prepare(request: ContextPreparationRequest): Promise<ContextPreparationResult>;
|
|
17
|
+
private optimizeFragment;
|
|
18
|
+
private persistRawFragment;
|
|
19
|
+
private persistEnvelope;
|
|
20
|
+
private emitTelemetry;
|
|
21
|
+
}
|
|
22
|
+
export declare function prepareContext(root: string, config: HarnessProjectConfig, request: ContextPreparationRequest, options?: ContextBudgetGatewayOptions): Promise<ContextPreparationResult>;
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
import fs from "node:fs/promises";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { recordEvent } from "../telemetry/events.js";
|
|
4
|
+
import { resolveContextBudget } from "./budget.js";
|
|
5
|
+
import { canLossyCompress, classifyFragment, isRequired as isRequiredFragment } from "./classifier.js";
|
|
6
|
+
import { estimateBytes, estimateTokens } from "./estimator.js";
|
|
7
|
+
import { buildContextEnvelope, renderContextEnvelope } from "./envelope.js";
|
|
8
|
+
import { resolveContextPolicy } from "./policy.js";
|
|
9
|
+
import { sha256 } from "./provenance.js";
|
|
10
|
+
import { projectAudit, projectDiff, projectOperation, projectSource, projectValidation } from "./projectors/index.js";
|
|
11
|
+
import { authorizeRetrieval } from "./retrieval/authorization.js";
|
|
12
|
+
import { ContextRetrievalGateway } from "./retrieval/gateway.js";
|
|
13
|
+
import { HeadroomCompressionProvider } from "./compression/headroom.js";
|
|
14
|
+
import { recordContextMetrics } from "./telemetry.js";
|
|
15
|
+
export class ContextBudgetGateway {
|
|
16
|
+
root;
|
|
17
|
+
config;
|
|
18
|
+
compressor;
|
|
19
|
+
persist;
|
|
20
|
+
telemetry;
|
|
21
|
+
constructor(root, config, options = {}) {
|
|
22
|
+
this.root = root;
|
|
23
|
+
this.config = config;
|
|
24
|
+
const provider = config.context?.compression?.provider ?? "headroom";
|
|
25
|
+
this.compressor = options.compressor ?? (provider === "headroom" ? new HeadroomCompressionProvider(config.context?.compression?.command ? { command: config.context.compression.command } : {}) : undefined);
|
|
26
|
+
this.persist = options.persist ?? true;
|
|
27
|
+
this.telemetry = options.telemetry ?? true;
|
|
28
|
+
}
|
|
29
|
+
async prepare(request) {
|
|
30
|
+
const policy = resolveContextPolicy(this.config);
|
|
31
|
+
const budget = resolveContextBudget(this.config, request.role ?? request.logicalAgent, request.phase);
|
|
32
|
+
const durable = await Promise.all(request.fragments.map((fragment) => this.persistRawFragment(request.operationId, fragment)));
|
|
33
|
+
const rawBytes = durable.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
|
|
34
|
+
const rawTokens = durable.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
|
|
35
|
+
const candidates = [];
|
|
36
|
+
for (const fragment of durable) {
|
|
37
|
+
classifyFragment(fragment);
|
|
38
|
+
const optimized = await this.optimizeFragment(fragment, request.operationId, policy.compression.minTokens, request.capabilities?.authorizedRetrieval !== false);
|
|
39
|
+
candidates.push({ raw: fragment, optimized });
|
|
40
|
+
}
|
|
41
|
+
const enforced = policy.mode === "enforce";
|
|
42
|
+
const delivered = enforced ? selectWithinBudget(candidates.map((candidate) => candidate.optimized), budget.maxTokens - budget.reserved.response) : durable.map(projectSource);
|
|
43
|
+
const deliveredIds = new Set(delivered.map((fragment) => fragment.id));
|
|
44
|
+
const discarded = durable.filter((fragment) => !deliveredIds.has(fragment.id));
|
|
45
|
+
const retrievalAvailable = request.capabilities?.authorizedRetrieval !== false;
|
|
46
|
+
const envelope = buildContextEnvelope({ version: 1, operationId: request.operationId, logicalAgent: request.logicalAgent, phase: request.phase, budget: { maximum: budget.maxTokens, estimatedDelivered: delivered.reduce((sum, fragment) => sum + fragment.estimatedTokens, 0) }, fragments: delivered, retrieval: { available: retrievalAvailable, allowedFragmentIds: retrievalAvailable ? delivered.map((fragment) => fragment.id) : [] } });
|
|
47
|
+
if (this.persist)
|
|
48
|
+
await this.persistEnvelope(request.operationId, envelope);
|
|
49
|
+
const rendered = renderContextEnvelope(envelope);
|
|
50
|
+
const metrics = metricsFor(durable, candidates.map((candidate) => candidate.optimized), delivered, discarded);
|
|
51
|
+
const retrieval = new ContextRetrievalGateway(authorizeRetrieval({ root: this.root, operationId: request.operationId, logicalAgent: request.logicalAgent, allowedFragmentIds: retrievalAvailable ? delivered.map((fragment) => fragment.id) : [], fragments: durable }), policy.retrieval);
|
|
52
|
+
if (this.telemetry && this.config.telemetry?.enabled !== false)
|
|
53
|
+
await this.emitTelemetry(request, metrics, envelope);
|
|
54
|
+
return { envelope, rendered, metrics, retrieval: { root: this.root, operationId: request.operationId, logicalAgent: request.logicalAgent, allowedFragmentIds: [...envelope.retrieval.allowedFragmentIds] } };
|
|
55
|
+
}
|
|
56
|
+
async optimizeFragment(fragment, operationId, minCompressionTokens, authorizedRetrieval) {
|
|
57
|
+
const originalTokens = estimateTokens(fragment.content);
|
|
58
|
+
if (isRequiredFragment(fragment))
|
|
59
|
+
return projectSource(fragment);
|
|
60
|
+
if (fragment.preservation === "DISCARDABLE")
|
|
61
|
+
return { ...fragment, content: "", estimatedTokens: 0, originalTokens, projected: true };
|
|
62
|
+
if (fragment.preservation === "RETRIEVABLE" && authorizedRetrieval) {
|
|
63
|
+
const content = `[Retrievable ${fragment.kind} '${fragment.id}' (${originalTokens} tokens); use aeh_context_retrieve for the authorized raw artifact.]`;
|
|
64
|
+
return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens, projected: true };
|
|
65
|
+
}
|
|
66
|
+
// Direct Codex and hardened Podman do not necessarily expose the AEH MCP
|
|
67
|
+
// retrieval server. Deliver an equivalent bounded projection instead of
|
|
68
|
+
// advertising a tool the transport cannot call.
|
|
69
|
+
if (fragment.preservation === "RETRIEVABLE")
|
|
70
|
+
return genericProjection(fragment);
|
|
71
|
+
let projected;
|
|
72
|
+
switch (fragment.kind) {
|
|
73
|
+
case "validation":
|
|
74
|
+
projected = projectValidation(fragment);
|
|
75
|
+
break;
|
|
76
|
+
case "audit":
|
|
77
|
+
projected = projectAudit(fragment);
|
|
78
|
+
break;
|
|
79
|
+
case "operation":
|
|
80
|
+
projected = projectOperation(fragment);
|
|
81
|
+
break;
|
|
82
|
+
case "diff":
|
|
83
|
+
projected = projectDiff(fragment);
|
|
84
|
+
break;
|
|
85
|
+
case "source":
|
|
86
|
+
projected = projectSource(fragment);
|
|
87
|
+
break;
|
|
88
|
+
case "repository-map":
|
|
89
|
+
projected = projectSource(fragment);
|
|
90
|
+
break;
|
|
91
|
+
case "tool-output":
|
|
92
|
+
projected = genericProjection(fragment);
|
|
93
|
+
break;
|
|
94
|
+
case "memory":
|
|
95
|
+
projected = genericProjection(fragment);
|
|
96
|
+
break;
|
|
97
|
+
case "instruction":
|
|
98
|
+
case "execution-envelope":
|
|
99
|
+
case "agent-charter":
|
|
100
|
+
case "skill":
|
|
101
|
+
case "handoff":
|
|
102
|
+
case "delivery":
|
|
103
|
+
case "normative":
|
|
104
|
+
projected = projectSource(fragment);
|
|
105
|
+
break;
|
|
106
|
+
case "raw-evidence":
|
|
107
|
+
projected = genericProjection(fragment);
|
|
108
|
+
break;
|
|
109
|
+
default: projected = projectSource(fragment);
|
|
110
|
+
}
|
|
111
|
+
if (this.compressor && canLossyCompress(fragment) && originalTokens >= minCompressionTokens) {
|
|
112
|
+
try {
|
|
113
|
+
const compression = await this.compressor.compress(this.root, { operationId, fragment, maxTokens: Math.max(1, Math.floor(originalTokens * 0.7)), sourceSha256: fragment.source?.sha256 ?? sha256(fragment.content) });
|
|
114
|
+
if (compression.compressedTokens < projected.estimatedTokens)
|
|
115
|
+
return { ...projected, content: compression.content, estimatedTokens: compression.compressedTokens, compressed: true, compression: { provider: compression.provider, providerVersion: compression.providerVersion, reversible: compression.reversible, handle: compression.handle } };
|
|
116
|
+
}
|
|
117
|
+
catch (error) {
|
|
118
|
+
if (this.config.context?.compression?.required !== false)
|
|
119
|
+
throw error;
|
|
120
|
+
// Optional compression failure falls back to deterministic projection.
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
return projected;
|
|
124
|
+
}
|
|
125
|
+
async persistRawFragment(operationId, fragment) {
|
|
126
|
+
if (!this.persist)
|
|
127
|
+
return { ...fragment, source: { ...fragment.source, sha256: fragment.source?.sha256 ?? sha256(fragment.content) } };
|
|
128
|
+
const relative = fragment.source?.artifact ?? path.posix.join(".harness", "context", safeSegment(operationId), `${safeSegment(fragment.id)}.raw`);
|
|
129
|
+
const absolute = safePath(this.root, relative);
|
|
130
|
+
await fs.mkdir(path.dirname(absolute), { recursive: true });
|
|
131
|
+
let actual;
|
|
132
|
+
try {
|
|
133
|
+
const existing = await fs.readFile(absolute);
|
|
134
|
+
actual = sha256(existing);
|
|
135
|
+
if (fragment.source?.sha256 && fragment.source.sha256 !== actual)
|
|
136
|
+
throw new Error(`Context source hash mismatch for '${relative}'.`);
|
|
137
|
+
if (!fragment.source?.sha256 && existing.toString("utf8") !== fragment.content)
|
|
138
|
+
throw new Error(`Context source artifact '${relative}' does not match the supplied content.`);
|
|
139
|
+
}
|
|
140
|
+
catch (error) {
|
|
141
|
+
if (error instanceof Error && error.message.includes("Context source"))
|
|
142
|
+
throw error;
|
|
143
|
+
await fs.writeFile(absolute, fragment.content, { encoding: "utf8", flag: "wx" }).catch(async (writeError) => {
|
|
144
|
+
if (writeError.code !== "EEXIST")
|
|
145
|
+
throw writeError;
|
|
146
|
+
});
|
|
147
|
+
actual = sha256(fragment.content);
|
|
148
|
+
}
|
|
149
|
+
return { ...fragment, source: { ...fragment.source, artifact: relative, sha256: actual } };
|
|
150
|
+
}
|
|
151
|
+
async persistEnvelope(operationId, envelope) {
|
|
152
|
+
const file = safePath(this.root, path.posix.join(".harness", "context", safeSegment(operationId), "envelope.json"));
|
|
153
|
+
await fs.mkdir(path.dirname(file), { recursive: true });
|
|
154
|
+
await fs.writeFile(file, `${JSON.stringify(envelope, null, 2)}\n`, "utf8");
|
|
155
|
+
}
|
|
156
|
+
async emitTelemetry(request, metrics, envelope) {
|
|
157
|
+
const attributes = { operationId: request.operationId, logicalAgent: request.logicalAgent, phase: request.phase, envelopeSha256: envelope.provenance.sha256, rawBytes: metrics.rawBytes, projectedBytes: metrics.projectedBytes, deliveredBytes: metrics.deliveredBytes, estimatedRawTokens: metrics.estimatedRawTokens, estimatedDeliveredTokens: metrics.estimatedDeliveredTokens, deliveredFragments: metrics.deliveredFragments, compressedFragments: metrics.compressedFragments, discardedFragments: metrics.discardedFragments, projectionRatio: metrics.projectionRatio ?? 0, compressionRatio: metrics.compressionRatio ?? 0 };
|
|
158
|
+
await recordEvent(this.root, this.config, "harness.context.prepare", attributes);
|
|
159
|
+
await recordContextMetrics(this.root, this.config, envelope, metrics);
|
|
160
|
+
await recordEvent(this.root, this.config, "harness.context.deliver", { ...attributes, retrievalAvailable: envelope.retrieval.available });
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
export async function prepareContext(root, config, request, options = {}) {
|
|
164
|
+
return new ContextBudgetGateway(root, config, options).prepare(request);
|
|
165
|
+
}
|
|
166
|
+
function selectWithinBudget(fragments, maxTokens) {
|
|
167
|
+
const ordered = [...fragments].filter((fragment) => fragment.estimatedTokens > 0).sort((a, b) => Number(isRequiredProjection(b)) - Number(isRequiredProjection(a)) || b.priority - a.priority || a.id.localeCompare(b.id));
|
|
168
|
+
const selected = [];
|
|
169
|
+
let used = 0;
|
|
170
|
+
for (const fragment of ordered) {
|
|
171
|
+
if (used + fragment.estimatedTokens <= maxTokens) {
|
|
172
|
+
selected.push(fragment);
|
|
173
|
+
used += fragment.estimatedTokens;
|
|
174
|
+
continue;
|
|
175
|
+
}
|
|
176
|
+
if (isRequiredProjection(fragment))
|
|
177
|
+
throw new Error(`CONTEXT_BUDGET_EXCEEDED: required fragment '${fragment.id}' cannot be delivered without loss.`);
|
|
178
|
+
}
|
|
179
|
+
return selected;
|
|
180
|
+
}
|
|
181
|
+
function genericProjection(fragment) {
|
|
182
|
+
const lines = fragment.content.split(/\r?\n/);
|
|
183
|
+
const selected = lines.length <= 64 ? lines : [...lines.slice(0, 16), ...lines.filter((line) => /error|fail|warn|diagnostic|exception|stack/i.test(line)).slice(0, 32), ...lines.slice(-16)];
|
|
184
|
+
const content = [...new Set(selected)].join("\n") + (lines.length > selected.length ? "\n[non-authoritative repetitive lines projected; raw artifact is retrievable]" : "");
|
|
185
|
+
return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: lines.length > selected.length };
|
|
186
|
+
}
|
|
187
|
+
function metricsFor(raw, optimized, delivered, discarded) {
|
|
188
|
+
const rawTokens = raw.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
|
|
189
|
+
const projectedTokens = optimized.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
|
|
190
|
+
const deliveredTokens = delivered.reduce((sum, fragment) => sum + fragment.estimatedTokens, 0);
|
|
191
|
+
const rawBytes = raw.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
|
|
192
|
+
const projectedBytes = optimized.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
|
|
193
|
+
const deliveredBytes = delivered.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
|
|
194
|
+
const compressed = optimized.filter((fragment) => fragment.compressed).length;
|
|
195
|
+
return { rawBytes, projectedBytes, deliveredBytes, estimatedRawTokens: rawTokens, estimatedDeliveredTokens: deliveredTokens, retrievedFragments: 0, deliveredFragments: delivered.length, compressedFragments: compressed, discardedFragments: discarded.length, retrievalRequests: 0, retrievalRetries: 0, retrievalEscapes: 0, compressionRatio: rawTokens ? deliveredTokens / rawTokens : undefined, projectionRatio: rawTokens ? projectedTokens / rawTokens : undefined };
|
|
196
|
+
}
|
|
197
|
+
function safeSegment(value) { const sanitized = value.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, ""); return sanitized || "fragment"; }
|
|
198
|
+
function safePath(root, relative) { if (path.isAbsolute(relative))
|
|
199
|
+
throw new Error("Context artifact paths must be relative to the project root."); const absoluteRoot = path.resolve(root); const absolute = path.resolve(absoluteRoot, relative); if (absolute !== absoluteRoot && !absolute.startsWith(`${absoluteRoot}${path.sep}`))
|
|
200
|
+
throw new Error("Context artifact path escapes the project root."); return absolute; }
|
|
201
|
+
function isRequiredProjection(fragment) { return fragment.preservation === "VERBATIM" || fragment.kind === "normative"; }
|
|
202
|
+
//# sourceMappingURL=gateway.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/context/gateway.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export * from "./budget.js";
|
|
2
|
+
export * from "./classifier.js";
|
|
3
|
+
export * from "./compression/index.js";
|
|
4
|
+
export * from "./envelope.js";
|
|
5
|
+
export * from "./estimator.js";
|
|
6
|
+
export * from "./eval.js";
|
|
7
|
+
export * from "./gateway.js";
|
|
8
|
+
export * from "./policy.js";
|
|
9
|
+
export * from "./preflight.js";
|
|
10
|
+
export * from "./provenance.js";
|
|
11
|
+
export * from "./projectors/index.js";
|
|
12
|
+
export * from "./repository/index.js";
|
|
13
|
+
export * from "./retrieval/index.js";
|
|
14
|
+
export * from "./telemetry.js";
|
|
15
|
+
export * from "./types.js";
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export * from "./budget.js";
|
|
2
|
+
export * from "./classifier.js";
|
|
3
|
+
export * from "./compression/index.js";
|
|
4
|
+
export * from "./envelope.js";
|
|
5
|
+
export * from "./estimator.js";
|
|
6
|
+
export * from "./eval.js";
|
|
7
|
+
export * from "./gateway.js";
|
|
8
|
+
export * from "./policy.js";
|
|
9
|
+
export * from "./preflight.js";
|
|
10
|
+
export * from "./provenance.js";
|
|
11
|
+
export * from "./projectors/index.js";
|
|
12
|
+
export * from "./repository/index.js";
|
|
13
|
+
export * from "./retrieval/index.js";
|
|
14
|
+
export * from "./telemetry.js";
|
|
15
|
+
export * from "./types.js";
|
|
16
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { ContextConfiguration, HarnessProjectConfig } from "../core/types.js";
|
|
2
|
+
import type { ContextPolicy } from "./types.js";
|
|
3
|
+
export declare function resolveContextPolicy(config: HarnessProjectConfig | ContextConfiguration | undefined): ContextPolicy;
|
|
4
|
+
export declare function outputMode(policy: ContextPolicy, role: string | undefined): "terse" | "compact" | "normal";
|
|
5
|
+
export declare function isCompressionConfigured(policy: ContextPolicy): boolean;
|
|
6
|
+
export declare function outputPolicyInstruction(policy: ContextPolicy, role: string | undefined): string | undefined;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
const defaultModes = {
|
|
2
|
+
explorer: "terse",
|
|
3
|
+
planner: "compact",
|
|
4
|
+
"spec-manager": "compact",
|
|
5
|
+
implementer: "compact",
|
|
6
|
+
reviewer: "compact",
|
|
7
|
+
"operation-supervisor": "terse"
|
|
8
|
+
};
|
|
9
|
+
export function resolveContextPolicy(config) {
|
|
10
|
+
const value = "context" in (config ?? {}) ? config.context : config;
|
|
11
|
+
const compression = value?.compression;
|
|
12
|
+
return {
|
|
13
|
+
mode: value?.mode ?? "enforce",
|
|
14
|
+
defaultBudget: value?.budgets?.default ?? { inputTokens: 16_000 },
|
|
15
|
+
agentBudgets: value?.budgets?.agents ?? {},
|
|
16
|
+
phaseBudgets: value?.budgets?.phases ?? {},
|
|
17
|
+
repositoryMap: { enabled: value?.repositoryMap?.enabled ?? true, tokenBudget: value?.repositoryMap?.tokenBudget ?? 2_000, maxGraphHops: value?.repositoryMap?.maxGraphHops ?? 2 },
|
|
18
|
+
semanticRetrieval: { provider: value?.semanticRetrieval?.provider ?? "serena", required: value?.semanticRetrieval?.required ?? true, editing: value?.semanticRetrieval?.editing ?? false },
|
|
19
|
+
compression: { provider: compression?.provider ?? "headroom", required: compression?.required ?? true, minTokens: compression?.minTokens ?? 2_000, reversible: compression?.reversible ?? true, command: compression?.command },
|
|
20
|
+
retrieval: { maxRequestsPerTurn: value?.retrieval?.maxRequestsPerTurn ?? 8, maxTokensPerRequest: value?.retrieval?.maxTokensPerRequest ?? 6_000, maxTotalTokensPerTurn: value?.retrieval?.maxTotalTokensPerTurn ?? 20_000 },
|
|
21
|
+
outputPolicy: { enabled: value?.outputPolicy?.enabled ?? true, modes: { ...defaultModes, ...(value?.outputPolicy?.modes ?? {}) } }
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
export function outputMode(policy, role) {
|
|
25
|
+
return policy.outputPolicy.modes[role ?? ""] ?? "compact";
|
|
26
|
+
}
|
|
27
|
+
export function isCompressionConfigured(policy) {
|
|
28
|
+
return policy.compression.provider === "headroom";
|
|
29
|
+
}
|
|
30
|
+
export function outputPolicyInstruction(policy, role) {
|
|
31
|
+
if (!policy.outputPolicy.enabled)
|
|
32
|
+
return undefined;
|
|
33
|
+
const mode = outputMode(policy, role);
|
|
34
|
+
if (mode === "terse")
|
|
35
|
+
return "Output policy: terse. Do not restate the assignment or narrate trivial successful tool calls. Prefer durable artifact references; preserve evidence, uncertainty, blockers and exact structured-result contracts.";
|
|
36
|
+
if (mode === "compact")
|
|
37
|
+
return "Output policy: compact. Explain meaningful decisions and blockers, omit ceremony and repetitive summaries, and preserve everything required for safe implementation/review. Never shorten structured-result JSON.";
|
|
38
|
+
return "Output policy: normal. Be concise but complete; preserve exact evidence and structured-result contracts.";
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/context/policy.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { HarnessProjectConfig } from "../core/types.js";
|
|
2
|
+
export interface ContextReadiness {
|
|
3
|
+
ok: boolean;
|
|
4
|
+
checks: Array<{
|
|
5
|
+
component: string;
|
|
6
|
+
ok: boolean;
|
|
7
|
+
required: boolean;
|
|
8
|
+
message: string;
|
|
9
|
+
version?: string;
|
|
10
|
+
}>;
|
|
11
|
+
}
|
|
12
|
+
export declare function checkContextReadiness(root: string, config: HarnessProjectConfig): Promise<ContextReadiness>;
|
|
13
|
+
export declare function assertContextReadiness(root: string, config: HarnessProjectConfig): Promise<void>;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { HeadroomCompressionProvider } from "./compression/headroom.js";
|
|
2
|
+
import { SerenaSemanticProvider } from "./repository/serena.js";
|
|
3
|
+
export async function checkContextReadiness(root, config) {
|
|
4
|
+
if (!config.context)
|
|
5
|
+
return { ok: true, checks: [] };
|
|
6
|
+
const checks = [];
|
|
7
|
+
const semanticProvider = config.context.semanticRetrieval?.provider ?? "serena";
|
|
8
|
+
if (semanticProvider !== "none") {
|
|
9
|
+
const semantic = await new SerenaSemanticProvider().doctor(root);
|
|
10
|
+
checks.push({ component: "serena", required: config.context.semanticRetrieval?.required ?? true, ...semantic });
|
|
11
|
+
}
|
|
12
|
+
const compressionProvider = config.context.compression?.provider ?? "headroom";
|
|
13
|
+
if (compressionProvider !== "none") {
|
|
14
|
+
const compression = await new HeadroomCompressionProvider({ command: config.context.compression?.command }).doctor(root);
|
|
15
|
+
checks.push({ component: "headroom", required: config.context.compression?.required ?? true, ...compression });
|
|
16
|
+
}
|
|
17
|
+
return { ok: checks.every((check) => !check.required || check.ok), checks };
|
|
18
|
+
}
|
|
19
|
+
export async function assertContextReadiness(root, config) {
|
|
20
|
+
const readiness = await checkContextReadiness(root, config);
|
|
21
|
+
const failures = readiness.checks.filter((check) => check.required && !check.ok);
|
|
22
|
+
if (failures.length)
|
|
23
|
+
throw new Error(`BLOCKED_EXTERNAL: mandatory context provider readiness failed. ${failures.map((failure) => `${failure.component}: ${failure.message}`).join("; ")}`);
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=preflight.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/context/preflight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAA4B;IACpF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrD,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,IAAI,QAAQ,CAAC;IAChF,IAAI,gBAAgB,KAAK,MAAM,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,sBAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,IAAI,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,UAAU,CAAC;IAC/E,IAAI,mBAAmB,KAAK,MAAM,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,IAAI,2BAA2B,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzH,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAA4B;IACrF,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7L,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { estimateTokens } from "../estimator.js";
|
|
2
|
+
export function projectAudit(fragment) {
|
|
3
|
+
const source = parseJson(fragment.content);
|
|
4
|
+
const findings = Array.isArray(source?.findings) ? source.findings : [];
|
|
5
|
+
const lines = findings.map((finding) => {
|
|
6
|
+
const item = record(finding);
|
|
7
|
+
return [item.id, item.severity, item.location, item.evidence, item.status].filter(Boolean).join(" | ");
|
|
8
|
+
});
|
|
9
|
+
const content = [
|
|
10
|
+
`findings=${findings.length}`,
|
|
11
|
+
...lines,
|
|
12
|
+
"authoritative raw audit evidence is available through the fragment source"
|
|
13
|
+
].join("\n");
|
|
14
|
+
return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
|
|
15
|
+
}
|
|
16
|
+
function parseJson(content) { try {
|
|
17
|
+
const value = JSON.parse(content);
|
|
18
|
+
return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
|
|
19
|
+
}
|
|
20
|
+
catch {
|
|
21
|
+
return undefined;
|
|
22
|
+
} }
|
|
23
|
+
function record(value) {
|
|
24
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
25
|
+
return {};
|
|
26
|
+
const item = value;
|
|
27
|
+
const location = item.location && typeof item.location === "object" ? JSON.stringify(item.location) : String(item.location ?? "");
|
|
28
|
+
return { id: String(item.id ?? ""), severity: String(item.severity ?? ""), location, evidence: String(item.evidence ?? item.summary ?? ""), status: String(item.status ?? "") };
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=audit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/context/projectors/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG;QACd,YAAY,QAAQ,CAAC,MAAM,EAAE;QAC7B,GAAG,KAAK;QACR,2EAA2E;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/I,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,IAAyC,IAAI,CAAC;IAAC,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,SAAS,CAAC;AAAC,CAAC,CAAC,CAAC;AAC/Q,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAClI,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;AAClL,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { estimateTokens } from "../estimator.js";
|
|
2
|
+
export function projectDiff(fragment) {
|
|
3
|
+
const lines = fragment.content.split(/\r?\n/);
|
|
4
|
+
const selected = lines.filter((line) => /^(diff --git|\+\+\+|---|@@|\+[^+]|-[^-])/.test(line));
|
|
5
|
+
const content = [...new Set(selected)].join("\n") || "No selected diff hunks; retrieve the authoritative diff artifact for exact anchors.";
|
|
6
|
+
return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
|
|
7
|
+
}
|
|
8
|
+
//# sourceMappingURL=diff.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/context/projectors/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qFAAqF,CAAC;IAC3I,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/I,CAAC"}
|