agenthooksprotocol 0.0.0-stage → 0.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/LICENSE +202 -0
- package/README.md +28 -2
- package/dist/src/client/auth.d.ts +147 -0
- package/dist/src/client/auth.d.ts.map +1 -0
- package/dist/src/client/auth.js +629 -0
- package/dist/src/client/auth.js.map +1 -0
- package/dist/src/client/composition.d.ts +42 -0
- package/dist/src/client/composition.d.ts.map +1 -0
- package/dist/src/client/composition.js +523 -0
- package/dist/src/client/composition.js.map +1 -0
- package/dist/src/client/content.d.ts +73 -0
- package/dist/src/client/content.d.ts.map +1 -0
- package/dist/src/client/content.js +404 -0
- package/dist/src/client/content.js.map +1 -0
- package/dist/src/client/hooks.d.ts +62 -0
- package/dist/src/client/hooks.d.ts.map +1 -0
- package/dist/src/client/hooks.js +997 -0
- package/dist/src/client/hooks.js.map +1 -0
- package/dist/src/client/index.d.ts +11 -0
- package/dist/src/client/index.d.ts.map +1 -0
- package/dist/src/client/index.js +9 -0
- package/dist/src/client/index.js.map +1 -0
- package/dist/src/client/transport.d.ts +12 -0
- package/dist/src/client/transport.d.ts.map +1 -0
- package/dist/src/client/transport.js +347 -0
- package/dist/src/client/transport.js.map +1 -0
- package/dist/src/client/types.d.ts +117 -0
- package/dist/src/client/types.d.ts.map +1 -0
- package/dist/src/client/types.js +10 -0
- package/dist/src/client/types.js.map +1 -0
- package/dist/src/client/validation.d.ts +3 -0
- package/dist/src/client/validation.d.ts.map +1 -0
- package/dist/src/client/validation.js +25 -0
- package/dist/src/client/validation.js.map +1 -0
- package/dist/src/compaction.d.ts +27 -0
- package/dist/src/compaction.d.ts.map +1 -0
- package/dist/src/compaction.js +155 -0
- package/dist/src/compaction.js.map +1 -0
- package/dist/src/content-upload.d.ts +60 -0
- package/dist/src/content-upload.d.ts.map +1 -0
- package/dist/src/content-upload.js +129 -0
- package/dist/src/content-upload.js.map +1 -0
- package/dist/src/draft/generated.d.ts +3085 -0
- package/dist/src/draft/generated.d.ts.map +1 -0
- package/dist/src/draft/generated.js +15372 -0
- package/dist/src/draft/generated.js.map +1 -0
- package/dist/src/draft/index.d.ts +31 -0
- package/dist/src/draft/index.d.ts.map +1 -0
- package/dist/src/draft/index.js +129 -0
- package/dist/src/draft/index.js.map +1 -0
- package/dist/src/draft/schemas.d.ts +8848 -0
- package/dist/src/draft/schemas.d.ts.map +1 -0
- package/dist/src/draft/schemas.js +9219 -0
- package/dist/src/draft/schemas.js.map +1 -0
- package/dist/src/draft-atomic.d.ts +18 -0
- package/dist/src/draft-atomic.d.ts.map +1 -0
- package/dist/src/draft-atomic.js +102 -0
- package/dist/src/draft-atomic.js.map +1 -0
- package/dist/src/draft-runtime.d.ts +89 -0
- package/dist/src/draft-runtime.d.ts.map +1 -0
- package/dist/src/draft-runtime.js +242 -0
- package/dist/src/draft-runtime.js.map +1 -0
- package/dist/src/elicitation.d.ts +18 -0
- package/dist/src/elicitation.d.ts.map +1 -0
- package/dist/src/elicitation.js +191 -0
- package/dist/src/elicitation.js.map +1 -0
- package/dist/src/errors.d.ts +7 -0
- package/dist/src/errors.d.ts.map +1 -0
- package/dist/src/errors.js +15 -0
- package/dist/src/errors.js.map +1 -0
- package/dist/src/framing.d.ts +7 -0
- package/dist/src/framing.d.ts.map +1 -0
- package/dist/src/framing.js +39 -0
- package/dist/src/framing.js.map +1 -0
- package/dist/src/generated.d.ts +304 -0
- package/dist/src/generated.d.ts.map +1 -0
- package/dist/src/generated.js +1885 -0
- package/dist/src/generated.js.map +1 -0
- package/dist/src/hook-runner.d.ts +11 -0
- package/dist/src/hook-runner.d.ts.map +1 -0
- package/dist/src/hook-runner.js +223 -0
- package/dist/src/hook-runner.js.map +1 -0
- package/dist/src/index.d.ts +8 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/index.js +8 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/observation.d.ts +26 -0
- package/dist/src/observation.d.ts.map +1 -0
- package/dist/src/observation.js +28 -0
- package/dist/src/observation.js.map +1 -0
- package/dist/src/server/attachments.d.ts +29 -0
- package/dist/src/server/attachments.d.ts.map +1 -0
- package/dist/src/server/attachments.js +112 -0
- package/dist/src/server/attachments.js.map +1 -0
- package/dist/src/server/hooks.d.ts +20 -0
- package/dist/src/server/hooks.d.ts.map +1 -0
- package/dist/src/server/hooks.js +129 -0
- package/dist/src/server/hooks.js.map +1 -0
- package/dist/src/server/index.d.ts +7 -0
- package/dist/src/server/index.d.ts.map +1 -0
- package/dist/src/server/index.js +4 -0
- package/dist/src/server/index.js.map +1 -0
- package/dist/src/server/stdio.d.ts +15 -0
- package/dist/src/server/stdio.d.ts.map +1 -0
- package/dist/src/server/stdio.js +69 -0
- package/dist/src/server/stdio.js.map +1 -0
- package/dist/src/transport.d.ts +7 -0
- package/dist/src/transport.d.ts.map +1 -0
- package/dist/src/transport.js +195 -0
- package/dist/src/transport.js.map +1 -0
- package/dist/src/types.d.ts +116 -0
- package/dist/src/types.d.ts.map +1 -0
- package/dist/src/types.js +14 -0
- package/dist/src/types.js.map +1 -0
- package/dist/src/validation.d.ts +7 -0
- package/dist/src/validation.d.ts.map +1 -0
- package/dist/src/validation.js +209 -0
- package/dist/src/validation.js.map +1 -0
- package/package.json +62 -4
- package/src/client/auth.ts +1076 -0
- package/src/client/composition.ts +708 -0
- package/src/client/content.ts +510 -0
- package/src/client/hooks.ts +1368 -0
- package/src/client/index.ts +28 -0
- package/src/client/transport.ts +408 -0
- package/src/client/types.ts +173 -0
- package/src/client/validation.ts +24 -0
- package/src/compaction.ts +196 -0
- package/src/content-upload.ts +205 -0
- package/src/draft/README.md +16 -0
- package/src/draft/ahp-codegen.lock.json +123 -0
- package/src/draft/generated.ts +19143 -0
- package/src/draft/index.ts +246 -0
- package/src/draft/schemas.ts +9413 -0
- package/src/draft-atomic.ts +119 -0
- package/src/draft-runtime.ts +365 -0
- package/src/elicitation.ts +254 -0
- package/src/errors.ts +30 -0
- package/src/framing.ts +56 -0
- package/src/generated.ts +2408 -0
- package/src/hook-runner.ts +310 -0
- package/src/index.ts +8 -0
- package/src/observation.ts +65 -0
- package/src/server/attachments.ts +128 -0
- package/src/server/hooks.ts +205 -0
- package/src/server/index.ts +18 -0
- package/src/server/node-crypto.d.ts +7 -0
- package/src/server/stdio.ts +81 -0
- package/src/transport.ts +273 -0
- package/src/types.ts +124 -0
- package/src/validation.ts +372 -0
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export class ConfigurationError extends Error {
|
|
2
|
+
issues;
|
|
3
|
+
code = "INVALID_CONFIGURATION";
|
|
4
|
+
constructor(issues) {
|
|
5
|
+
super("Hook configuration could not be resolved");
|
|
6
|
+
this.issues = issues;
|
|
7
|
+
this.name = "ConfigurationError";
|
|
8
|
+
}
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":"AAsKA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEtB;IADZ,IAAI,GAAG,uBAAuB,CAAC;IACxC,YAAqB,MAAqC;QACxD,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAD/B,WAAM,GAAN,MAAM,CAA+B;QAExD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/client/validation.ts"],"names":[],"mappings":"AAKA,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAiBnE"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { Ajv2020 } from "ajv/dist/2020.js";
|
|
2
|
+
import { fullFormats } from "ajv-formats/dist/formats.js";
|
|
3
|
+
import { schemas } from "../draft/schemas.js";
|
|
4
|
+
let registry;
|
|
5
|
+
/** Validate against the checked-in canonical schema without coercion. */
|
|
6
|
+
export function validateWire(name, value) {
|
|
7
|
+
if (!registry) {
|
|
8
|
+
registry = new Ajv2020({
|
|
9
|
+
allErrors: true,
|
|
10
|
+
strict: false,
|
|
11
|
+
ownProperties: true,
|
|
12
|
+
});
|
|
13
|
+
registry.addFormat("uri", fullFormats.uri);
|
|
14
|
+
registry.addFormat("date-time", fullFormats["date-time"]);
|
|
15
|
+
for (const schema of schemas)
|
|
16
|
+
registry.addSchema(schema);
|
|
17
|
+
}
|
|
18
|
+
const validate = registry.getSchema(`https://agenthooksprotocol.org/schemas/draft/${name}.schema.json`);
|
|
19
|
+
if (!validate)
|
|
20
|
+
return ["Unknown protocol schema"];
|
|
21
|
+
if (validate(value))
|
|
22
|
+
return [];
|
|
23
|
+
return (validate.errors ?? []).map((e) => `${e.instancePath}: ${e.keyword}`);
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=validation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/client/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,IAAI,QAA6B,CAAC;AAClC,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAc;IACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,OAAO,CAAC;YACrB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1D,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CACjC,gDAAgD,IAAI,cAAc,CACnE,CAAC;IACF,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC/E,CAAC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/** Serial host-side text compaction. Responses commit atomically. Only `applied`
|
|
2
|
+
* permits downstream use. Upload immutable UTF-8 bodies before wire exposure. */
|
|
3
|
+
export interface CompactionEffect {
|
|
4
|
+
type: string;
|
|
5
|
+
target?: string;
|
|
6
|
+
operation?: string;
|
|
7
|
+
value?: unknown;
|
|
8
|
+
text?: string;
|
|
9
|
+
reason?: string;
|
|
10
|
+
}
|
|
11
|
+
export interface CompactionObserver {
|
|
12
|
+
supplier: string;
|
|
13
|
+
run: (snapshot: any) => unknown;
|
|
14
|
+
}
|
|
15
|
+
export interface CompactionHook {
|
|
16
|
+
supplier: string;
|
|
17
|
+
failurePolicy: "fail-open" | "fail-closed";
|
|
18
|
+
run: (snapshot: any) => CompactionEffect[];
|
|
19
|
+
}
|
|
20
|
+
export declare function compactionCapabilities(boundary: "before" | "after", observeOnly?: boolean): any;
|
|
21
|
+
export declare function runCompaction(instructions: string, before?: CompactionHook[], after?: CompactionHook[], options?: {
|
|
22
|
+
generate?: (instructions: string) => string;
|
|
23
|
+
itemId?: string;
|
|
24
|
+
observeOnly?: boolean;
|
|
25
|
+
observers?: CompactionObserver[];
|
|
26
|
+
}): any;
|
|
27
|
+
//# sourceMappingURL=compaction.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/compaction.ts"],"names":[],"mappings":"AACA;iFACiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC;CACjC;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,WAAW,GAAG,aAAa,CAAC;IAC3C,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,gBAAgB,EAAE,CAAC;CAC5C;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAC5B,WAAW,UAAQ,GAClB,GAAG,CAiBL;AACD,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,cAAc,EAAO,EAC7B,KAAK,GAAE,cAAc,EAAO,EAC5B,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC7B,GACL,GAAG,CA+IL"}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { validateEffect } from "./draft/index.js";
|
|
2
|
+
const copy = (v) => structuredClone(v);
|
|
3
|
+
export function compactionCapabilities(boundary, observeOnly = false) {
|
|
4
|
+
if (boundary !== "before" && boundary !== "after")
|
|
5
|
+
throw new Error("unknown boundary");
|
|
6
|
+
if (observeOnly)
|
|
7
|
+
return { effects: [], modify: {} };
|
|
8
|
+
return {
|
|
9
|
+
effects: [
|
|
10
|
+
"modify",
|
|
11
|
+
"message",
|
|
12
|
+
...(boundary === "before" ? ["return", "deny"] : []),
|
|
13
|
+
],
|
|
14
|
+
modify: {
|
|
15
|
+
[boundary === "before" ? "instructions" : "summary"]: {
|
|
16
|
+
replace: true,
|
|
17
|
+
merge: false,
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
export function runCompaction(instructions, before = [], after = [], options = {}) {
|
|
23
|
+
const itemId = options.itemId ?? "summary-1";
|
|
24
|
+
if (typeof instructions !== "string" || typeof itemId !== "string" || !itemId)
|
|
25
|
+
throw new Error("invalid input");
|
|
26
|
+
for (const h of [...before, ...after])
|
|
27
|
+
if (typeof h.supplier !== "string" ||
|
|
28
|
+
!h.supplier ||
|
|
29
|
+
!["fail-open", "fail-closed"].includes(h.failurePolicy) ||
|
|
30
|
+
typeof h.run !== "function")
|
|
31
|
+
throw new Error("invalid hook");
|
|
32
|
+
if (options.observers && !options.observeOnly)
|
|
33
|
+
throw new Error("observers require observeOnly");
|
|
34
|
+
for (const o of options.observers ?? [])
|
|
35
|
+
if (typeof o.supplier !== "string" ||
|
|
36
|
+
!o.supplier ||
|
|
37
|
+
typeof o.run !== "function")
|
|
38
|
+
throw new Error("invalid observer");
|
|
39
|
+
let state = {
|
|
40
|
+
instructions,
|
|
41
|
+
candidate: null,
|
|
42
|
+
summary: null,
|
|
43
|
+
bodies: {},
|
|
44
|
+
messages: [],
|
|
45
|
+
denied: false,
|
|
46
|
+
};
|
|
47
|
+
const seen = [], failures = [];
|
|
48
|
+
const summary = (staged, body) => {
|
|
49
|
+
const ref = "urn:ahp:compaction:utf8:" +
|
|
50
|
+
Array.from(new TextEncoder().encode(body), (b) => b.toString(16).padStart(2, "0")).join("");
|
|
51
|
+
staged.bodies[ref] = body;
|
|
52
|
+
return { id: itemId, ref };
|
|
53
|
+
};
|
|
54
|
+
const pipeline = (boundary, hooks) => {
|
|
55
|
+
const caps = compactionCapabilities(boundary, options.observeOnly === true && boundary === "after");
|
|
56
|
+
for (const hook of hooks) {
|
|
57
|
+
const snapshot = { ...copy(state), boundary, capabilities: caps };
|
|
58
|
+
seen.push(copy(snapshot));
|
|
59
|
+
try {
|
|
60
|
+
const effects = hook.run(copy(snapshot));
|
|
61
|
+
if (!Array.isArray(effects))
|
|
62
|
+
throw new Error("effects must be array");
|
|
63
|
+
const staged = copy(state);
|
|
64
|
+
for (const e of effects) {
|
|
65
|
+
if (!e ||
|
|
66
|
+
typeof e !== "object" ||
|
|
67
|
+
!validateEffect(e).ok ||
|
|
68
|
+
!caps.effects.includes(e.type))
|
|
69
|
+
throw new Error("unsupported effect");
|
|
70
|
+
if (e.type === "modify") {
|
|
71
|
+
if (e.target !==
|
|
72
|
+
(boundary === "before" ? "instructions" : "summary") ||
|
|
73
|
+
e.operation !== "replace" ||
|
|
74
|
+
typeof e.value !== "string")
|
|
75
|
+
throw new Error("invalid modification");
|
|
76
|
+
if (boundary === "before")
|
|
77
|
+
staged.instructions = e.value;
|
|
78
|
+
else
|
|
79
|
+
staged.summary = summary(staged, e.value);
|
|
80
|
+
}
|
|
81
|
+
else if (e.type === "deny" &&
|
|
82
|
+
(typeof e.reason !== "string" || !e.reason))
|
|
83
|
+
throw new Error("denial requires reason");
|
|
84
|
+
else if (e.type === "return" && typeof e.value !== "string")
|
|
85
|
+
throw new Error("summary must be text");
|
|
86
|
+
else if (e.type === "message" && typeof e.text !== "string")
|
|
87
|
+
throw new Error("message must be text");
|
|
88
|
+
}
|
|
89
|
+
if (staged.instructions !== state.instructions)
|
|
90
|
+
staged.candidate = null;
|
|
91
|
+
for (const e of effects) {
|
|
92
|
+
if (e.type === "return")
|
|
93
|
+
staged.candidate = { body: e.value, supplier: hook.supplier };
|
|
94
|
+
else if (e.type === "deny")
|
|
95
|
+
staged.denied = true;
|
|
96
|
+
else if (e.type === "message")
|
|
97
|
+
staged.messages.push(e.text);
|
|
98
|
+
}
|
|
99
|
+
state = staged;
|
|
100
|
+
}
|
|
101
|
+
catch {
|
|
102
|
+
failures.push({ boundary, supplier: hook.supplier });
|
|
103
|
+
if (hook.failurePolicy === "fail-closed" &&
|
|
104
|
+
!(options.observeOnly && boundary === "after"))
|
|
105
|
+
return false;
|
|
106
|
+
}
|
|
107
|
+
if (state.denied)
|
|
108
|
+
return false;
|
|
109
|
+
}
|
|
110
|
+
return true;
|
|
111
|
+
};
|
|
112
|
+
let generated = false, applied = false, provenance = null;
|
|
113
|
+
if (pipeline("before", before)) {
|
|
114
|
+
let body;
|
|
115
|
+
if (state.candidate !== null) {
|
|
116
|
+
body = state.candidate.body;
|
|
117
|
+
provenance = { kind: "supplied", supplier: state.candidate.supplier };
|
|
118
|
+
}
|
|
119
|
+
else {
|
|
120
|
+
body = (options.generate ?? ((v) => "summary:" + v))(state.instructions);
|
|
121
|
+
if (typeof body !== "string")
|
|
122
|
+
throw new Error("generator must return text");
|
|
123
|
+
generated = true;
|
|
124
|
+
provenance = { kind: "generated" };
|
|
125
|
+
}
|
|
126
|
+
state.summary = summary(state, body);
|
|
127
|
+
applied = options.observeOnly ? true : pipeline("after", after);
|
|
128
|
+
}
|
|
129
|
+
const result = { ...state, seen, failures, generated, provenance, applied };
|
|
130
|
+
if (options.observeOnly && applied) {
|
|
131
|
+
for (const observer of [...after, ...(options.observers ?? [])]) {
|
|
132
|
+
const snapshot = {
|
|
133
|
+
...copy(state),
|
|
134
|
+
boundary: "after",
|
|
135
|
+
applied: true,
|
|
136
|
+
generated,
|
|
137
|
+
provenance: copy(provenance),
|
|
138
|
+
capabilities: compactionCapabilities("after", true),
|
|
139
|
+
};
|
|
140
|
+
seen.push(copy(snapshot));
|
|
141
|
+
const notify = observer.run;
|
|
142
|
+
// Scheduling never calls user code inline or awaits its returned promise.
|
|
143
|
+
// Browser/Node observers must yield for I/O; blocking native work belongs
|
|
144
|
+
// in a host worker. The unref'd timer cannot keep Node alive on shutdown.
|
|
145
|
+
const timer = setTimeout(() => {
|
|
146
|
+
void Promise.resolve()
|
|
147
|
+
.then(() => notify(snapshot))
|
|
148
|
+
.catch(() => { });
|
|
149
|
+
}, 0);
|
|
150
|
+
timer.unref?.();
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
return result;
|
|
154
|
+
}
|
|
155
|
+
//# sourceMappingURL=compaction.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/compaction.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/** Normative HTTP content upload. Event authentication is deliberately not an input. */
|
|
2
|
+
export interface UploadConfiguration {
|
|
3
|
+
endpoint: string;
|
|
4
|
+
auth?: {
|
|
5
|
+
type: "bearer";
|
|
6
|
+
tokenEnv: string;
|
|
7
|
+
[key: string]: unknown;
|
|
8
|
+
};
|
|
9
|
+
timeoutMs?: number;
|
|
10
|
+
maxBytes?: number;
|
|
11
|
+
[key: string]: unknown;
|
|
12
|
+
}
|
|
13
|
+
export interface BodyReference {
|
|
14
|
+
ref: string;
|
|
15
|
+
size: number;
|
|
16
|
+
sha256: string;
|
|
17
|
+
}
|
|
18
|
+
/** Check the receiver descriptor before exposing a body reference. */
|
|
19
|
+
export declare function validateBodyReference(value: unknown, size: number, sha256: string): BodyReference;
|
|
20
|
+
export declare function uploadContent(config: UploadConfiguration, bytes: Uint8Array, options?: {
|
|
21
|
+
resolveToken?: (name: string) => string | undefined;
|
|
22
|
+
allowLoopback?: boolean;
|
|
23
|
+
}): Promise<BodyReference>;
|
|
24
|
+
export interface NormalizedContentInput {
|
|
25
|
+
id: string;
|
|
26
|
+
kind: string;
|
|
27
|
+
mediaType: string;
|
|
28
|
+
ref?: string;
|
|
29
|
+
bytes?: Uint8Array;
|
|
30
|
+
category?: string;
|
|
31
|
+
role?: string;
|
|
32
|
+
parentItemId?: string;
|
|
33
|
+
synthesized?: boolean;
|
|
34
|
+
}
|
|
35
|
+
export interface NormalizedContentView {
|
|
36
|
+
id: string;
|
|
37
|
+
kind: string;
|
|
38
|
+
mediaType: string;
|
|
39
|
+
category?: string;
|
|
40
|
+
role?: string;
|
|
41
|
+
parentItemId?: string;
|
|
42
|
+
synthesized?: boolean;
|
|
43
|
+
selection: "body" | "metadata" | "omit";
|
|
44
|
+
body?: BodyReference;
|
|
45
|
+
gap?: {
|
|
46
|
+
reason: string;
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
/** Select once per subscriber. Return no body reference until upload confirms availability. */
|
|
50
|
+
export declare function prepareWireContent(items: readonly NormalizedContentInput[], options: {
|
|
51
|
+
subscription?: string;
|
|
52
|
+
selection: Record<string, "body" | "metadata" | "omit">;
|
|
53
|
+
authorized: (item: NormalizedContentInput) => boolean;
|
|
54
|
+
upload: (bytes: Uint8Array) => Promise<BodyReference>;
|
|
55
|
+
mode: "intercept" | "observe";
|
|
56
|
+
failClosed: boolean;
|
|
57
|
+
timeoutMs?: number;
|
|
58
|
+
maxBytes?: number;
|
|
59
|
+
}): Promise<NormalizedContentView[]>;
|
|
60
|
+
//# sourceMappingURL=content-upload.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"content-upload.d.ts","sourceRoot":"","sources":["../../src/content-upload.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,sEAAsE;AACtE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,aAAa,CAgBf;AACD,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,OAAO,CAAC,aAAa,CAAC,CAoExB;AACD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AACD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,GAAG,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AACD,+FAA+F;AAC/F,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,sBAAsB,EAAE,EACxC,OAAO,EAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC;IACxD,UAAU,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC;IACtD,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAyDlC"}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/** Check the receiver descriptor before exposing a body reference. */
|
|
2
|
+
export function validateBodyReference(value, size, sha256) {
|
|
3
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
4
|
+
throw Error("Invalid upload descriptor");
|
|
5
|
+
const body = value;
|
|
6
|
+
if (Object.keys(body).some((key) => !["ref", "size", "sha256"].includes(key)) ||
|
|
7
|
+
typeof body.ref !== "string" ||
|
|
8
|
+
!body.ref ||
|
|
9
|
+
!Number.isSafeInteger(body.size) ||
|
|
10
|
+
body.size !== size ||
|
|
11
|
+
typeof body.sha256 !== "string" ||
|
|
12
|
+
!/^[a-f0-9]{64}$/.test(body.sha256) ||
|
|
13
|
+
body.sha256 !== sha256)
|
|
14
|
+
throw Error("Unconfirmed bytes");
|
|
15
|
+
return { ref: body.ref, size, sha256 };
|
|
16
|
+
}
|
|
17
|
+
export async function uploadContent(config, bytes, options = {}) {
|
|
18
|
+
if (!config ||
|
|
19
|
+
typeof config.endpoint !== "string" ||
|
|
20
|
+
(config.timeoutMs !== undefined &&
|
|
21
|
+
(!Number.isSafeInteger(config.timeoutMs) || config.timeoutMs <= 0)) ||
|
|
22
|
+
(config.maxBytes !== undefined &&
|
|
23
|
+
(!Number.isSafeInteger(config.maxBytes) || config.maxBytes < 0)))
|
|
24
|
+
throw Error("Invalid upload configuration");
|
|
25
|
+
const url = new URL(config.endpoint);
|
|
26
|
+
if (url.username ||
|
|
27
|
+
url.password ||
|
|
28
|
+
url.hash ||
|
|
29
|
+
(url.protocol !== "https:" &&
|
|
30
|
+
!(options.allowLoopback &&
|
|
31
|
+
url.protocol === "http:" &&
|
|
32
|
+
["127.0.0.1", "localhost", "[::1]"].includes(url.hostname))))
|
|
33
|
+
throw Error("Unsafe upload endpoint");
|
|
34
|
+
if (!(bytes instanceof Uint8Array))
|
|
35
|
+
throw Error("Invalid content bytes");
|
|
36
|
+
const snapshot = new Uint8Array(bytes);
|
|
37
|
+
if (snapshot.length > (config.maxBytes ?? 52428800))
|
|
38
|
+
throw Error("Upload size limit");
|
|
39
|
+
const hash = new Uint8Array(await crypto.subtle.digest("SHA-256", snapshot));
|
|
40
|
+
const sha256 = Array.from(hash, (byte) => byte.toString(16).padStart(2, "0")).join("");
|
|
41
|
+
const headers = {
|
|
42
|
+
"content-type": "application/octet-stream",
|
|
43
|
+
"content-length": String(snapshot.length),
|
|
44
|
+
"ahp-content-sha256": sha256,
|
|
45
|
+
};
|
|
46
|
+
if (config.auth !== undefined) {
|
|
47
|
+
if (!config.auth ||
|
|
48
|
+
config.auth.type !== "bearer" ||
|
|
49
|
+
typeof config.auth.tokenEnv !== "string" ||
|
|
50
|
+
!/^[A-Za-z_][A-Za-z0-9_]*$/.test(config.auth.tokenEnv))
|
|
51
|
+
throw Error("Invalid upload authentication");
|
|
52
|
+
const token = options.resolveToken?.(config.auth.tokenEnv);
|
|
53
|
+
if (typeof token !== "string" || !token)
|
|
54
|
+
throw Error("Missing upload credential");
|
|
55
|
+
headers.authorization = `Bearer ${token}`;
|
|
56
|
+
}
|
|
57
|
+
const response = await fetch(url, {
|
|
58
|
+
method: "POST",
|
|
59
|
+
headers,
|
|
60
|
+
body: snapshot,
|
|
61
|
+
redirect: "error",
|
|
62
|
+
signal: AbortSignal.timeout(config.timeoutMs ?? 15000),
|
|
63
|
+
});
|
|
64
|
+
if (response.status !== 201 ||
|
|
65
|
+
response.headers
|
|
66
|
+
.get("content-type")
|
|
67
|
+
?.split(";")[0]
|
|
68
|
+
?.trim()
|
|
69
|
+
.toLowerCase() !== "application/json") {
|
|
70
|
+
await response.body?.cancel();
|
|
71
|
+
throw Error(`Content upload failed: HTTP ${response.status}`);
|
|
72
|
+
}
|
|
73
|
+
return validateBodyReference(await response.json(), snapshot.length, sha256);
|
|
74
|
+
}
|
|
75
|
+
/** Select once per subscriber. Return no body reference until upload confirms availability. */
|
|
76
|
+
export async function prepareWireContent(items, options) {
|
|
77
|
+
const result = [];
|
|
78
|
+
for (const item of items) {
|
|
79
|
+
const { id, kind, mediaType, category, role, parentItemId, synthesized } = item;
|
|
80
|
+
const view = {
|
|
81
|
+
id,
|
|
82
|
+
kind,
|
|
83
|
+
mediaType,
|
|
84
|
+
...(synthesized === undefined ? {} : { synthesized }),
|
|
85
|
+
...(category ? { category } : {}),
|
|
86
|
+
...(role ? { role } : {}),
|
|
87
|
+
...(parentItemId ? { parentItemId } : {}),
|
|
88
|
+
selection: options.selection[category ?? kind] ??
|
|
89
|
+
options.selection.default ??
|
|
90
|
+
"metadata",
|
|
91
|
+
};
|
|
92
|
+
if (view.selection === "body") {
|
|
93
|
+
if (!options.authorized(item))
|
|
94
|
+
view.gap = { reason: "permission_withheld" };
|
|
95
|
+
else if (item.bytes === undefined)
|
|
96
|
+
view.gap = { reason: "source_unavailable" };
|
|
97
|
+
else if (item.bytes.length > (options.maxBytes ?? 52428800))
|
|
98
|
+
view.gap = { reason: "limit_exceeded" };
|
|
99
|
+
else
|
|
100
|
+
try {
|
|
101
|
+
const bytes = new Uint8Array(item.bytes);
|
|
102
|
+
let timer;
|
|
103
|
+
let body;
|
|
104
|
+
try {
|
|
105
|
+
body = await Promise.race([
|
|
106
|
+
options.upload(bytes.slice()),
|
|
107
|
+
new Promise((_, reject) => {
|
|
108
|
+
timer = setTimeout(() => reject(Error("Upload timeout")), options.timeoutMs ?? 15000);
|
|
109
|
+
}),
|
|
110
|
+
]);
|
|
111
|
+
}
|
|
112
|
+
finally {
|
|
113
|
+
if (timer !== undefined)
|
|
114
|
+
clearTimeout(timer);
|
|
115
|
+
}
|
|
116
|
+
const hash = Array.from(new Uint8Array(await crypto.subtle.digest("SHA-256", bytes)), (byte) => byte.toString(16).padStart(2, "0")).join("");
|
|
117
|
+
view.body = validateBodyReference(body, bytes.length, hash);
|
|
118
|
+
}
|
|
119
|
+
catch {
|
|
120
|
+
view.gap = { reason: "transfer_failed" };
|
|
121
|
+
}
|
|
122
|
+
if (view.gap && options.mode === "intercept" && options.failClosed)
|
|
123
|
+
throw Error(`Content delivery failure: ${view.gap.reason}`);
|
|
124
|
+
}
|
|
125
|
+
result.push(view);
|
|
126
|
+
}
|
|
127
|
+
return result;
|
|
128
|
+
}
|
|
129
|
+
//# sourceMappingURL=content-upload.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"content-upload.js","sourceRoot":"","sources":["../../src/content-upload.ts"],"names":[],"mappings":"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"}
|