@unbrained/pm-http 0.0.0-stage → 2026.10.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/ARCHITECTURE.md +59 -0
- package/CHANGELOG.md +24 -0
- package/LICENSE +21 -0
- package/README.md +186 -2
- package/dist/index.d.ts +116 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +30 -0
- package/dist/index.js.map +1 -0
- package/dist/src/api.d.ts +56 -0
- package/dist/src/api.d.ts.map +1 -0
- package/dist/src/api.js +200 -0
- package/dist/src/api.js.map +1 -0
- package/dist/src/capture.d.ts +23 -0
- package/dist/src/capture.d.ts.map +1 -0
- package/dist/src/capture.js +113 -0
- package/dist/src/capture.js.map +1 -0
- package/dist/src/commands.d.ts +6 -0
- package/dist/src/commands.d.ts.map +1 -0
- package/dist/src/commands.js +84 -0
- package/dist/src/commands.js.map +1 -0
- package/dist/src/core.d.ts +36 -0
- package/dist/src/core.d.ts.map +1 -0
- package/dist/src/core.js +75 -0
- package/dist/src/core.js.map +1 -0
- package/dist/src/derive.d.ts +62 -0
- package/dist/src/derive.d.ts.map +1 -0
- package/dist/src/derive.js +139 -0
- package/dist/src/derive.js.map +1 -0
- package/dist/src/policy.d.ts +29 -0
- package/dist/src/policy.d.ts.map +1 -0
- package/dist/src/policy.js +137 -0
- package/dist/src/policy.js.map +1 -0
- package/dist/src/store.d.ts +42 -0
- package/dist/src/store.d.ts.map +1 -0
- package/dist/src/store.js +124 -0
- package/dist/src/store.js.map +1 -0
- package/dist/src/transport.d.ts +9 -0
- package/dist/src/transport.d.ts.map +1 -0
- package/dist/src/transport.js +144 -0
- package/dist/src/transport.js.map +1 -0
- package/dist/src/types.d.ts +140 -0
- package/dist/src/types.d.ts.map +1 -0
- package/dist/src/types.js +2 -0
- package/dist/src/types.js.map +1 -0
- package/docs/real-data.md +20 -0
- package/manifest.json +14 -0
- package/package.json +150 -4
package/dist/src/core.js
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { encode } from '@toon-format/toon';
|
|
3
|
+
import { PmCliError, EXIT_CODE, OutputEnvelopeFitError, estimatePmOutputTokens } from '@unbrained/pm-cli/sdk';
|
|
4
|
+
/** Typed refusal with no raw network, environment or SDK diagnostic. */
|
|
5
|
+
export class HttpError extends Error {
|
|
6
|
+
/** Stable refusal classification for embedded callers. */
|
|
7
|
+
code;
|
|
8
|
+
/** Concrete next step without private diagnostics. */
|
|
9
|
+
remedy;
|
|
10
|
+
/** Safe hop identities and refusal metadata. */
|
|
11
|
+
details;
|
|
12
|
+
/** Keep all error fields safe for both renderers. */
|
|
13
|
+
constructor(code, message, remedy = 'Read pm http --help and correct the declaration', details = {}) {
|
|
14
|
+
super(message);
|
|
15
|
+
this.name = 'HttpError';
|
|
16
|
+
this.code = code;
|
|
17
|
+
this.remedy = remedy;
|
|
18
|
+
this.details = details;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
/** Reject before effects without interpolating untrusted input. */
|
|
22
|
+
export function requireInput(condition, message) { if (!condition)
|
|
23
|
+
throw new HttpError('invalid', message); }
|
|
24
|
+
/** Stable full SHA-256 identity for declarations and structural property names. */
|
|
25
|
+
export function digest(value) { return createHash('sha256').update(JSON.stringify(value)).digest('hex'); }
|
|
26
|
+
/** Render untrusted controls and instruction delimiters as inert escaped data. */
|
|
27
|
+
export function inert(value) { return value.replace(/[\u0000-\u001f\u007f-\u009f<>`]/g, c => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`); }
|
|
28
|
+
/** Recursively sanitize every emitted string, including object keys. */
|
|
29
|
+
export function data(value) {
|
|
30
|
+
if (typeof value === 'string')
|
|
31
|
+
return inert(value);
|
|
32
|
+
if (Array.isArray(value))
|
|
33
|
+
return value.map(data);
|
|
34
|
+
if (value !== null && typeof value === 'object')
|
|
35
|
+
return Object.fromEntries(Object.entries(value).map(([k, v]) => [inert(k), data(v)]));
|
|
36
|
+
return value;
|
|
37
|
+
}
|
|
38
|
+
/** Use host-selected TOON or JSON; untrusted text stays labeled data. */
|
|
39
|
+
export function wire(value, format) { const safe = data(value); return format === 'json' ? JSON.stringify(safe, null, 2) : encode(safe); }
|
|
40
|
+
/** Heuristic units from the SDK estimator, covering both formats and newline; not tokenizer counts. */
|
|
41
|
+
export function tokens(value) { return estimatePmOutputTokens(Math.max(Buffer.byteLength(wire(value, 'json') + '\n'), Buffer.byteLength(wire(value, 'toon') + '\n'))); }
|
|
42
|
+
/** Accept bounded integral controls without coercing malformed values. */
|
|
43
|
+
export function bound(value, min, max) { requireInput(Number.isSafeInteger(value) && value >= min && value <= max, 'Numeric control is outside its documented bounds'); return value; }
|
|
44
|
+
/** Resolve a reference name without retaining its value in diagnostics. */
|
|
45
|
+
export function reference(value) { requireInput(/^@[A-Z_][A-Z0-9_]{0,127}$/.test(value), 'Secrets and bodies require @ENV_NAME references'); return value; }
|
|
46
|
+
/** Read only explicitly referenced variables; never enumerate the environment. */
|
|
47
|
+
export function resolveReference(value) {
|
|
48
|
+
reference(value);
|
|
49
|
+
const resolved = process.env[value.slice(1)];
|
|
50
|
+
if (resolved === undefined || resolved.length === 0)
|
|
51
|
+
throw new HttpError('credential_missing', 'A referenced environment variable is absent', 'Set the declared variable in the sending process');
|
|
52
|
+
return resolved;
|
|
53
|
+
}
|
|
54
|
+
/** Reject prompt-sized and token-shaped declarations before persistence. */
|
|
55
|
+
export function label(value) { requireInput(/^[a-zA-Z][a-zA-Z0-9_-]{0,47}$/.test(value), 'Names must be 1 to 48 identifier characters'); return value.toLowerCase(); }
|
|
56
|
+
/** Translate host and fitter failures without exposing source content or SDK diagnostics. */
|
|
57
|
+
export function failure(error) {
|
|
58
|
+
if (error instanceof HttpError)
|
|
59
|
+
return error;
|
|
60
|
+
if (error instanceof OutputEnvelopeFitError)
|
|
61
|
+
return new HttpError(error.code, 'A verified HTTP packet could not be fitted', error.code === 'output_envelope_infeasible' ? 'Increase --budget to contain the complete omission receipt' : 'Read complete evidence with pm http missing and the observations SDK; report the fitting refusal');
|
|
62
|
+
if (error instanceof PmCliError && error.exitCode === EXIT_CODE.CONFLICT)
|
|
63
|
+
return new HttpError('conflict', 'Another writer holds or changed the target', 'Wait for the writer, read current context and explicitly resume with the same operation identity');
|
|
64
|
+
return new HttpError('sdk', 'HTTP context SDK operation failed', 'Check tracker health, access and registered schema; retry the same operation identity');
|
|
65
|
+
}
|
|
66
|
+
/** Adapt all public operations to safe, typed failures. */
|
|
67
|
+
export function guarded(fn) {
|
|
68
|
+
return async (...args) => { try {
|
|
69
|
+
return await fn(...args);
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
throw failure(error);
|
|
73
|
+
} };
|
|
74
|
+
}
|
|
75
|
+
//# sourceMappingURL=core.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { Contract, Missing, Observation, Options, State, Verdict } from './types.ts';
|
|
2
|
+
/** Evaluate known constraints independently; incomplete evidence cannot establish satisfaction. */
|
|
3
|
+
export declare function verdict(observation: Observation, contract: Contract | undefined, probeDigest: string): Verdict;
|
|
4
|
+
/** Enumerate exact missing probes, expectations and complete response evidence. */
|
|
5
|
+
export declare function missing(value: State): Missing[];
|
|
6
|
+
/** Read every historical observation without execution, with explicit completeness. */
|
|
7
|
+
export declare function observations(item: string, options: Options): Promise<{
|
|
8
|
+
revision: number;
|
|
9
|
+
observations: Observation[];
|
|
10
|
+
historical: boolean;
|
|
11
|
+
receipt: {
|
|
12
|
+
complete: boolean;
|
|
13
|
+
omitted: number;
|
|
14
|
+
};
|
|
15
|
+
}>;
|
|
16
|
+
/** Compare stored evidence in process without sending any request. */
|
|
17
|
+
export declare function compare(item: string, options: Options & {
|
|
18
|
+
probe?: string;
|
|
19
|
+
}): Promise<{
|
|
20
|
+
revision: number;
|
|
21
|
+
historical: boolean;
|
|
22
|
+
comparisons: Verdict[];
|
|
23
|
+
receipt: {
|
|
24
|
+
complete: boolean;
|
|
25
|
+
omitted: number;
|
|
26
|
+
};
|
|
27
|
+
}>;
|
|
28
|
+
/** Read outstanding evidence requests with no implicit retries. */
|
|
29
|
+
export declare function missingEvidence(item: string, options: Options): Promise<{
|
|
30
|
+
revision: number;
|
|
31
|
+
missing: Missing[];
|
|
32
|
+
receipt: {
|
|
33
|
+
complete: boolean;
|
|
34
|
+
omitted: number;
|
|
35
|
+
};
|
|
36
|
+
}>;
|
|
37
|
+
/** Derive first-bad/preceding-last-good differences; lacking a verdict, compare the latest pair. */
|
|
38
|
+
export declare function differences(value: State): unknown[];
|
|
39
|
+
/** Build a historical packet under a self-inclusive heuristic-unit ceiling, not a model-token budget. */
|
|
40
|
+
export declare function differencePacket(item: string, options: Options & {
|
|
41
|
+
budget?: number;
|
|
42
|
+
}): Promise<import("@unbrained/pm-cli/sdk").FittedOutputEnvelope<{
|
|
43
|
+
task: string;
|
|
44
|
+
revision: number;
|
|
45
|
+
historical: boolean;
|
|
46
|
+
rows: readonly unknown[];
|
|
47
|
+
estimatedTokens: number;
|
|
48
|
+
bytes: {
|
|
49
|
+
json: number;
|
|
50
|
+
toon: number;
|
|
51
|
+
};
|
|
52
|
+
receipt: {
|
|
53
|
+
sourceComplete: boolean;
|
|
54
|
+
omitted: number;
|
|
55
|
+
returned: number;
|
|
56
|
+
restore: string;
|
|
57
|
+
missing: string;
|
|
58
|
+
estimator: string;
|
|
59
|
+
budgetUnit: string;
|
|
60
|
+
};
|
|
61
|
+
}>>;
|
|
62
|
+
//# sourceMappingURL=derive.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/derive.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1F,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA2B9G;AACD,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,CAQ/C;AACD,uFAAuF;AACvF,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;;;;QAA6J,QAAQ;QAAQ,OAAO;;GAAU;AAC/P,sEAAsE;AACtE,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;QAGI,QAAQ;QAAQ,OAAO;;GAC3G;AACD,mEAAmE;AACnE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;;;QAAkI,QAAQ;QAAQ,OAAO;;GAAU;AAWvO,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,CAcnD;AAcD,yGAAyG;AACzG,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;QAZgB,IAAI;QAAoB,IAAI;;;QAAiC,cAAc;QAAQ,OAAO;QAAqB,QAAQ;QAAe,OAAO;QAA2C,OAAO;QAA6B,SAAS;QAAuC,UAAU;;IAoBhY"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import { matches } from './capture.js';
|
|
2
|
+
import { fitOutputEnvelope } from '@unbrained/pm-cli/sdk';
|
|
3
|
+
import { bound, digest, label, wire } from './core.js';
|
|
4
|
+
import { Store } from './store.js';
|
|
5
|
+
/** Evaluate known constraints independently; incomplete evidence cannot establish satisfaction. */
|
|
6
|
+
export function verdict(observation, contract, probeDigest) {
|
|
7
|
+
const row = { observation: observation.id, probe: observation.probe, at: observation.at, result: 'unknown', reasons: [] };
|
|
8
|
+
if (contract === undefined) {
|
|
9
|
+
row.reasons.push('No contract declared');
|
|
10
|
+
return row;
|
|
11
|
+
}
|
|
12
|
+
if (observation.outcome !== 'response' || observation.probeDigest !== probeDigest) {
|
|
13
|
+
row.reasons.push('No response for the current probe declaration');
|
|
14
|
+
return row;
|
|
15
|
+
}
|
|
16
|
+
if (observation.receipt.redirectsOmitted > 0) {
|
|
17
|
+
row.reasons.push('Redirect chain incomplete; final response is unknown');
|
|
18
|
+
return row;
|
|
19
|
+
}
|
|
20
|
+
let violated = false;
|
|
21
|
+
let incomplete = observation.receipt.bodyTruncated || observation.receipt.shapeIncomplete || observation.receipt.headersOmitted > 0;
|
|
22
|
+
/** Retain definitive failures separately from missing evidence. */
|
|
23
|
+
const fail = (reason) => { row.reasons.push(reason); violated = true; };
|
|
24
|
+
if (!contract.statuses.includes(observation.status))
|
|
25
|
+
fail('status');
|
|
26
|
+
for (const header of contract.headers) {
|
|
27
|
+
if (!observation.selectedHeaders?.includes(header)) {
|
|
28
|
+
row.reasons.push(`header-not-selected:${header}`);
|
|
29
|
+
incomplete = true;
|
|
30
|
+
}
|
|
31
|
+
else if (!Object.hasOwn(observation.headers, header)) {
|
|
32
|
+
if (observation.receipt.headersOmitted > 0)
|
|
33
|
+
row.reasons.push(`header-not-captured:${header}`);
|
|
34
|
+
else
|
|
35
|
+
fail(`header:${header}`);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
if (contract.shape !== undefined) {
|
|
39
|
+
if (observation.receipt.bodyTruncated || observation.receipt.shapeIncomplete)
|
|
40
|
+
row.reasons.push('json-shape-incomplete');
|
|
41
|
+
else if (observation.shape === undefined || !matches(observation.shape, contract.shape))
|
|
42
|
+
fail('json-shape');
|
|
43
|
+
}
|
|
44
|
+
if (contract.maxLatencyMs !== undefined) {
|
|
45
|
+
if (observation.timing.total === null) {
|
|
46
|
+
row.reasons.push('latency-unavailable');
|
|
47
|
+
incomplete = true;
|
|
48
|
+
}
|
|
49
|
+
else if (observation.timing.total > contract.maxLatencyMs)
|
|
50
|
+
fail('latency');
|
|
51
|
+
}
|
|
52
|
+
if (incomplete)
|
|
53
|
+
row.reasons.push('Capture incomplete; repeat explicitly with suitable bounds');
|
|
54
|
+
row.result = violated ? 'violates' : incomplete ? 'unknown' : 'satisfies';
|
|
55
|
+
return row;
|
|
56
|
+
}
|
|
57
|
+
/** Enumerate exact missing probes, expectations and complete response evidence. */
|
|
58
|
+
export function missing(value) {
|
|
59
|
+
return value.probes.flatMap(probe => {
|
|
60
|
+
const rows = [];
|
|
61
|
+
const observed = value.observations.filter(row => row.probe === probe.name && row.probeDigest === digest(probe));
|
|
62
|
+
if (observed.length === 0)
|
|
63
|
+
rows.push({ probe: probe.name, evidence: 'observation' });
|
|
64
|
+
else if (!observed.some(row => row.outcome === 'response' && !row.receipt.bodyTruncated && !row.receipt.shapeIncomplete && row.receipt.headersOmitted === 0 && !row.receipt.redirectsOmitted))
|
|
65
|
+
rows.push({ probe: probe.name, evidence: 'complete-response' });
|
|
66
|
+
if (!value.contracts.some(row => row.probe === probe.name))
|
|
67
|
+
rows.push({ probe: probe.name, evidence: 'contract' });
|
|
68
|
+
return rows;
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
/** Read every historical observation without execution, with explicit completeness. */
|
|
72
|
+
export async function observations(item, options) { const { value } = await new Store(options).read(item); return { revision: value.revision, observations: value.observations, historical: true, receipt: { complete: true, omitted: 0 } }; }
|
|
73
|
+
/** Compare stored evidence in process without sending any request. */
|
|
74
|
+
export async function compare(item, options) {
|
|
75
|
+
const { value } = await new Store(options).read(item);
|
|
76
|
+
const rows = value.observations.filter(row => options.probe === undefined || row.probe === label(options.probe)).map(row => verdict(row, value.contracts.find(contract => contract.probe === row.probe), digest(value.probes.find(probe => probe.name === row.probe))));
|
|
77
|
+
return { revision: value.revision, historical: true, comparisons: rows, receipt: { complete: true, omitted: 0 } };
|
|
78
|
+
}
|
|
79
|
+
/** Read outstanding evidence requests with no implicit retries. */
|
|
80
|
+
export async function missingEvidence(item, options) { const { value } = await new Store(options).read(item); return { revision: value.revision, missing: missing(value), receipt: { complete: true, omitted: 0 } }; }
|
|
81
|
+
/** Flatten per-field comparison data without including request secrets or body values. */
|
|
82
|
+
function fields(observation) {
|
|
83
|
+
const values = new Map([['status', observation.status ?? null], ['outcome', observation.outcome], ['digest', observation.digest ?? null], ['bytes', observation.bytes], ['timing.total', observation.timing.total], ['retry', observation.retry]]);
|
|
84
|
+
/** Walk structural properties so a packet names each changed field path. */
|
|
85
|
+
function walk(value, prefix) {
|
|
86
|
+
if (value !== null && typeof value === 'object' && !Array.isArray(value))
|
|
87
|
+
for (const [key, entry] of Object.entries(value))
|
|
88
|
+
walk(entry, `${prefix}.${key}`);
|
|
89
|
+
else
|
|
90
|
+
values.set(prefix, value);
|
|
91
|
+
}
|
|
92
|
+
walk(observation.headers, 'headers');
|
|
93
|
+
walk(observation.shape ?? null, 'shape');
|
|
94
|
+
return values;
|
|
95
|
+
}
|
|
96
|
+
/** Derive first-bad/preceding-last-good differences; lacking a verdict, compare the latest pair. */
|
|
97
|
+
export function differences(value) {
|
|
98
|
+
return value.probes.map(probe => {
|
|
99
|
+
const rows = value.observations.filter(row => row.probe === probe.name && row.probeDigest === digest(probe)).sort((a, b) => a.at.localeCompare(b.at, 'en') || a.id.localeCompare(b.id, 'en'));
|
|
100
|
+
const contract = value.contracts.find(entry => entry.probe === probe.name);
|
|
101
|
+
const firstBad = rows.findIndex(row => verdict(row, contract, digest(probe)).result === 'violates');
|
|
102
|
+
const after = firstBad < 0 ? rows.at(-1) : rows[firstBad];
|
|
103
|
+
const before = firstBad < 0 ? rows.at(-2) : rows.slice(0, firstBad).findLast(row => verdict(row, contract, digest(probe)).result === 'satisfies');
|
|
104
|
+
const changes = [];
|
|
105
|
+
if (before !== undefined && after !== undefined) {
|
|
106
|
+
const a = fields(before);
|
|
107
|
+
const b = fields(after);
|
|
108
|
+
for (const key of [...new Set([...a.keys(), ...b.keys()])].sort())
|
|
109
|
+
if (JSON.stringify(a.get(key)) !== JSON.stringify(b.get(key)))
|
|
110
|
+
changes.push({ field: key, before: a.get(key) ?? null, after: b.get(key) ?? null });
|
|
111
|
+
}
|
|
112
|
+
return { kind: 'difference', probe: probe.name, mode: firstBad < 0 ? 'latest-pair' : 'first-bad-last-good', before: before === undefined ? null : { id: before.id, at: before.at }, after: after === undefined ? null : { id: after.id, at: after.at }, verdict: after === undefined ? null : verdict(after, contract, digest(probe)), changes };
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
/** Construct domain accounting from the SDK fixed point without another convergence loop. */
|
|
116
|
+
function packetEnvelope(task, revision, rows, fit) {
|
|
117
|
+
const packet = { task, revision, historical: true, rows, estimatedTokens: fit.estimated_tokens, bytes: { json: fit.output_bytes, toon: fit.output_bytes }, receipt: { sourceComplete: true, omitted: fit.omitted_count, returned: rows.length, restore: `pm http diff ${task} --budget 1000000`, missing: `pm http missing ${task}`, estimator: 'ceil(max(json,toon)_utf8_bytes/4)', budgetUnit: 'heuristic-units' } };
|
|
118
|
+
// Both formats spell these scalar integers identically. Their length difference
|
|
119
|
+
// is independent of the accounting values, even across decimal digit boundaries.
|
|
120
|
+
// Subtract that difference from the SDK's maximum; the SDK alone converges and
|
|
121
|
+
// verifies the complete envelope, including these fields and output_fit.
|
|
122
|
+
const json = Buffer.byteLength(wire({ ...packet, output_fit: fit }, 'json') + '\n');
|
|
123
|
+
const toon = Buffer.byteLength(wire({ ...packet, output_fit: fit }, 'toon') + '\n');
|
|
124
|
+
const max = Math.max(json, toon);
|
|
125
|
+
packet.bytes = { json: Math.max(0, fit.output_bytes - (max - json)), toon: Math.max(0, fit.output_bytes - (max - toon)) };
|
|
126
|
+
return packet;
|
|
127
|
+
}
|
|
128
|
+
/** Build a historical packet under a self-inclusive heuristic-unit ceiling, not a model-token budget. */
|
|
129
|
+
export async function differencePacket(item, options) {
|
|
130
|
+
const budget = bound(options.budget ?? 1500, 256, 1000000);
|
|
131
|
+
const snapshot = await new Store(options).read(item);
|
|
132
|
+
const source = [...missing(snapshot.value).map(row => ({ kind: 'missing', ...row })), ...differences(snapshot.value)];
|
|
133
|
+
return fitOutputEnvelope(source, {
|
|
134
|
+
tokenBudget: budget, policy: 'skip',
|
|
135
|
+
buildEnvelope: (rows, receipt) => packetEnvelope(snapshot.id, snapshot.value.revision, rows, receipt),
|
|
136
|
+
renderers: { json: packet => wire(packet, 'json') + '\n', toon: packet => wire(packet, 'toon') + '\n' },
|
|
137
|
+
}).envelope;
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=derive.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../src/derive.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { Boundary, Probe, ProbeInput } from './types.ts';
|
|
2
|
+
/** Address resolver seam; socket destinations are still validated and pinned. */
|
|
3
|
+
export type Resolver = (host: string) => Promise<{
|
|
4
|
+
address: string;
|
|
5
|
+
family: number;
|
|
6
|
+
}[]>;
|
|
7
|
+
/** Restrict literal destinations conservatively, including IPv4-mapped IPv6. */
|
|
8
|
+
export declare function privateAddress(address: string): boolean;
|
|
9
|
+
/** Parse canonical HTTP URLs without ambiguous credentials, encoded paths or fragments. */
|
|
10
|
+
export declare function parseUrl(value: string): URL;
|
|
11
|
+
/** Require every hop to retain the exact origin and canonical path-prefix segment. */
|
|
12
|
+
export declare function within(url: URL, boundary: Boundary, hop?: number): void;
|
|
13
|
+
/** Single declaration validator used by preview, apply and send recovery. */
|
|
14
|
+
export declare function makeProbe(name: string, input: ProbeInput): Probe;
|
|
15
|
+
/** Determine whether an explicit separate review is required. */
|
|
16
|
+
export declare function mutating(probe: Probe): boolean;
|
|
17
|
+
/** Resolve the exact send-time request after all durable declarations have been checked. */
|
|
18
|
+
export declare function requestFor(probe: Probe, resolve: boolean): {
|
|
19
|
+
url: URL;
|
|
20
|
+
headers: Record<string, string>;
|
|
21
|
+
body?: string;
|
|
22
|
+
secrets: string[];
|
|
23
|
+
};
|
|
24
|
+
/** Resolve and pin DNS before opening a socket; reject rebinding to private networks. */
|
|
25
|
+
export declare function destination(url: URL, boundary: Boundary, resolver?: Resolver): Promise<{
|
|
26
|
+
address: string;
|
|
27
|
+
family: number;
|
|
28
|
+
}>;
|
|
29
|
+
//# sourceMappingURL=policy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9D,iFAAiF;AACjF,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAAC;AAIxF,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKvD;AACD,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAI3C;AACD,sFAAsF;AACtF,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,SAAI,GAAG,IAAI,CAGlE;AAsBD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,CAchE;AACD,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAA+D;AAS9G,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAc1I;AACD,yFAAyF;AACzF,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAE,QAA2B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMnJ"}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import { isIP } from 'node:net';
|
|
2
|
+
import { lookup } from 'node:dns/promises';
|
|
3
|
+
import { bound, digest, HttpError, label, reference, requireInput, resolveReference } from './core.js';
|
|
4
|
+
/** Resolve with the operating system so hosts-file and address-family policy apply. */
|
|
5
|
+
async function resolveAddresses(host) { return lookup(host, { all: true, verbatim: true }); }
|
|
6
|
+
/** Restrict literal destinations conservatively, including IPv4-mapped IPv6. */
|
|
7
|
+
export function privateAddress(address) {
|
|
8
|
+
const ip = address.replace(/^\[|\]$/g, '').toLowerCase();
|
|
9
|
+
if (ip.includes(':'))
|
|
10
|
+
return ip.startsWith('::') || ip.startsWith('fc') || ip.startsWith('fd') || ip.startsWith('fe') || ip.startsWith('ff') || !ip.startsWith('2') && !ip.startsWith('3');
|
|
11
|
+
const [a, b] = ip.split('.').map(Number);
|
|
12
|
+
return a === 0 || a === 10 || a === 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && (b === 168 || b === 0) || a === 100 && b >= 64 && b <= 127 || a >= 224 || a === 198 && (b === 18 || b === 19);
|
|
13
|
+
}
|
|
14
|
+
/** Parse canonical HTTP URLs without ambiguous credentials, encoded paths or fragments. */
|
|
15
|
+
export function parseUrl(value) {
|
|
16
|
+
let url;
|
|
17
|
+
try {
|
|
18
|
+
url = new URL(value);
|
|
19
|
+
}
|
|
20
|
+
catch {
|
|
21
|
+
throw new HttpError('invalid', 'Expected an absolute HTTP URL');
|
|
22
|
+
}
|
|
23
|
+
requireInput(['http:', 'https:'].includes(url.protocol) && !url.username && !url.password && !url.hash && !/%|\\/.test(url.pathname) && !value.includes('\\'), 'URL must use HTTP(S), plain paths, and no userinfo or fragment');
|
|
24
|
+
requireInput(value.length <= 4096, 'URL exceeds declaration ceiling');
|
|
25
|
+
return url;
|
|
26
|
+
}
|
|
27
|
+
/** Require every hop to retain the exact origin and canonical path-prefix segment. */
|
|
28
|
+
export function within(url, boundary, hop = 0) {
|
|
29
|
+
const prefix = boundary.prefix;
|
|
30
|
+
if (url.origin !== boundary.origin || !(prefix === '/' || url.pathname === prefix || url.pathname.startsWith(prefix.endsWith('/') ? prefix : prefix + '/')))
|
|
31
|
+
throw new HttpError('boundary', 'Redirect or request leaves the declared destination boundary', 'Declare and review a separate probe for that destination', { hop: String(hop), targetDigest: digest(url.href) });
|
|
32
|
+
}
|
|
33
|
+
/** Validate query templates without ever storing literal query values. */
|
|
34
|
+
function queryTemplate(url) { for (const [key, value] of url.searchParams) {
|
|
35
|
+
requireInput(/^[a-zA-Z][a-zA-Z0-9_-]{0,47}$/.test(key), 'Query names must be short identifiers');
|
|
36
|
+
reference(value);
|
|
37
|
+
} }
|
|
38
|
+
/** Keep opaque path identifiers in environment references rather than durable URLs. */
|
|
39
|
+
function pathTemplate(url, boundary = false) {
|
|
40
|
+
for (const segment of url.pathname.split('/').filter(Boolean)) {
|
|
41
|
+
if (segment.startsWith('@') && !boundary)
|
|
42
|
+
reference(segment);
|
|
43
|
+
else
|
|
44
|
+
requireInput(segment.length < 24 && /^[a-zA-Z0-9_.~-]+$/.test(segment), 'Opaque path segments require @ENV_NAME; boundaries need static short path segments');
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
/** Normalize header declarations; opaque values can only be environment references. */
|
|
48
|
+
function requestHeaders(values) {
|
|
49
|
+
requireInput(values.length <= 32, 'At most 32 request headers are allowed');
|
|
50
|
+
return Object.fromEntries(values.map(value => {
|
|
51
|
+
const index = value.indexOf('=');
|
|
52
|
+
requireInput(index > 0, 'Header needs name=value');
|
|
53
|
+
const key = value.slice(0, index).toLowerCase();
|
|
54
|
+
const content = value.slice(index + 1);
|
|
55
|
+
requireInput(/^[a-z][a-z0-9-]{0,63}$/.test(key) && !['host', 'content-length', 'transfer-encoding', 'connection', 'proxy-authorization'].includes(key), 'Unsupported request header');
|
|
56
|
+
if (content.startsWith('@'))
|
|
57
|
+
reference(content);
|
|
58
|
+
else
|
|
59
|
+
requireInput((key === 'accept' || key === 'content-type') && ['application/json', 'text/plain', '*/*'].includes(content) || key === 'user-agent' && content === 'pm-http', 'Opaque header values require @ENV_NAME');
|
|
60
|
+
return [key, content];
|
|
61
|
+
}));
|
|
62
|
+
}
|
|
63
|
+
/** Single declaration validator used by preview, apply and send recovery. */
|
|
64
|
+
export function makeProbe(name, input) {
|
|
65
|
+
const url = parseUrl(input.url);
|
|
66
|
+
queryTemplate(url);
|
|
67
|
+
pathTemplate(url);
|
|
68
|
+
const boundaryUrl = parseUrl(input.boundary ?? url.origin + '/');
|
|
69
|
+
requireInput(!boundaryUrl.search, 'Boundary cannot contain a query');
|
|
70
|
+
pathTemplate(boundaryUrl, true);
|
|
71
|
+
const host = boundaryUrl.hostname.replace(/^\[|\]$/g, '');
|
|
72
|
+
const boundary = { origin: boundaryUrl.origin, prefix: boundaryUrl.pathname, private: input.boundary !== undefined && (host === 'localhost' || isIP(host) !== 0 && privateAddress(host)) };
|
|
73
|
+
within(url, boundary);
|
|
74
|
+
const method = (input.method ?? 'GET').toUpperCase();
|
|
75
|
+
requireInput(['GET', 'HEAD', 'OPTIONS', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(method), 'Unsupported method');
|
|
76
|
+
const body = input.body === undefined ? undefined : reference(input.body);
|
|
77
|
+
requireInput(body === undefined || !['GET', 'HEAD', 'OPTIONS'].includes(method), 'Bodies require a mutating method and separate review');
|
|
78
|
+
const responseHeaders = [...new Set((input.responseHeaders ?? ['content-type', 'content-length', 'cache-control', 'retry-after']).map(key => key.toLowerCase()))];
|
|
79
|
+
requireInput(responseHeaders.length <= 32 && responseHeaders.every(key => /^[a-z][a-z0-9-]{0,63}$/.test(key)), 'Response header selection is invalid');
|
|
80
|
+
return { name: label(name), method, url: url.href, headers: requestHeaders(input.headers ?? []), ...(body === undefined ? {} : { body }), boundary, maxBytes: bound(input.maxBytes ?? 65536, 1, 1048576), timeoutMs: bound(input.timeoutMs ?? 5000, 1, 60000), maxHeaders: bound(input.maxHeaders ?? 64, 1, 128), responseHeaders };
|
|
81
|
+
}
|
|
82
|
+
/** Determine whether an explicit separate review is required. */
|
|
83
|
+
export function mutating(probe) { return !['GET', 'HEAD', 'OPTIONS'].includes(probe.method); }
|
|
84
|
+
/** Reuse declaration validation before effects, retaining the original private-destination authorization. */
|
|
85
|
+
function storedProbe(probe) {
|
|
86
|
+
bound(probe.maxBytes, 1, 1048576);
|
|
87
|
+
bound(probe.timeoutMs, 1, 60000);
|
|
88
|
+
bound(probe.maxHeaders, 1, 128);
|
|
89
|
+
requireInput(Array.isArray(probe.responseHeaders) && probe.responseHeaders.length <= 32 && typeof probe.boundary.private === 'boolean', 'Stored probe ceilings or destination authorization are invalid');
|
|
90
|
+
const checked = makeProbe(probe.name, { url: probe.url, method: probe.method, headers: Object.entries(probe.headers).map(([key, value]) => `${key}=${value}`), body: probe.body, boundary: probe.boundary.origin + probe.boundary.prefix, maxBytes: probe.maxBytes, timeoutMs: probe.timeoutMs, maxHeaders: probe.maxHeaders, responseHeaders: probe.responseHeaders });
|
|
91
|
+
requireInput(checked.method === probe.method && checked.boundary.origin === probe.boundary.origin && checked.boundary.prefix === probe.boundary.prefix && (!probe.boundary.private || checked.boundary.private) && JSON.stringify(checked.responseHeaders) === JSON.stringify(probe.responseHeaders), 'Stored probe must retain canonical declaration and boundary fields');
|
|
92
|
+
return { ...checked, boundary: { ...checked.boundary, private: probe.boundary.private }, ...(probe.review === undefined ? {} : { review: probe.review }) };
|
|
93
|
+
}
|
|
94
|
+
/** Resolve the exact send-time request after all durable declarations have been checked. */
|
|
95
|
+
export function requestFor(probe, resolve) {
|
|
96
|
+
probe = storedProbe(probe);
|
|
97
|
+
if (mutating(probe) && probe.review?.allowMutation !== true)
|
|
98
|
+
throw new HttpError('mutation_review', 'Mutating probe has no reviewed capability', 'Run pm http probe review with --allow-mutation and --reason');
|
|
99
|
+
if (mutating(probe))
|
|
100
|
+
requireInput([probe.review.author, probe.review.reason, probe.review.at].every(entry => typeof entry === 'string' && entry.trim().length > 0), 'Reviewed capability requires an author, reason and timestamp');
|
|
101
|
+
const secrets = [];
|
|
102
|
+
/** Resolve a declared reference and collect only its ephemeral value. */
|
|
103
|
+
const value = (entry) => { if (!resolve)
|
|
104
|
+
return entry; const actual = resolveReference(entry); secrets.push(actual); return actual; };
|
|
105
|
+
const url = new URL(probe.url);
|
|
106
|
+
if (resolve)
|
|
107
|
+
url.pathname = url.pathname.split('/').map(segment => { if (!segment.startsWith('@'))
|
|
108
|
+
return segment; const actual = value(segment); requireInput(/^[a-zA-Z0-9_-]{1,128}$/.test(actual), 'Resolved path reference must be a bounded single identifier segment'); return actual; }).join('/');
|
|
109
|
+
if (resolve) {
|
|
110
|
+
const params = [...url.searchParams];
|
|
111
|
+
url.search = '';
|
|
112
|
+
for (const [key, ref] of params)
|
|
113
|
+
url.searchParams.append(key, value(ref));
|
|
114
|
+
}
|
|
115
|
+
const headers = { 'user-agent': 'pm-http', ...Object.fromEntries(Object.entries(probe.headers).map(([key, entry]) => [key, entry.startsWith('@') ? value(entry) : entry])) };
|
|
116
|
+
requireInput(Object.values(headers).every(entry => !/[\r\n\u0000]/.test(entry) && entry.length <= 8192), 'Resolved request header is invalid');
|
|
117
|
+
const body = probe.body === undefined ? undefined : value(probe.body);
|
|
118
|
+
requireInput(body === undefined || Buffer.byteLength(body) <= 1048576, 'Request body exceeds the hard ceiling');
|
|
119
|
+
return { url, headers, body, secrets };
|
|
120
|
+
}
|
|
121
|
+
/** Resolve and pin DNS before opening a socket; reject rebinding to private networks. */
|
|
122
|
+
export async function destination(url, boundary, resolver = resolveAddresses) {
|
|
123
|
+
within(url, boundary);
|
|
124
|
+
const host = url.hostname.replace(/^\[|\]$/g, '');
|
|
125
|
+
let answers;
|
|
126
|
+
try {
|
|
127
|
+
answers = await resolver(host);
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
throw new HttpError('dns', 'Destination resolution failed', 'Check the declared host and retry explicitly');
|
|
131
|
+
}
|
|
132
|
+
if (answers.some(answer => privateAddress(answer.address)) && !boundary.private)
|
|
133
|
+
throw new HttpError('private_destination', 'Private, loopback or link-local destination lacks explicit authorization', 'Declare a boundary with the literal private address or localhost');
|
|
134
|
+
requireInput(answers.length > 0, 'Destination has no addresses');
|
|
135
|
+
return answers[0];
|
|
136
|
+
}
|
|
137
|
+
//# sourceMappingURL=policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { PmClient } from '@unbrained/pm-cli/sdk';
|
|
2
|
+
import type { GetResult } from '@unbrained/pm-cli/sdk';
|
|
3
|
+
import type { SchemaFieldDefinition } from '@unbrained/pm-cli/sdk/authoring';
|
|
4
|
+
import type { Options, State } from './types.ts';
|
|
5
|
+
/** Registered native extension field, portable through native item exports. */
|
|
6
|
+
export declare const FIELDS: SchemaFieldDefinition[];
|
|
7
|
+
/** Reserve a bounded result plus journal overhead before admitting any network effect. */
|
|
8
|
+
export declare const RESPONSE_RESERVATION = 131072;
|
|
9
|
+
/** Preserve a typed stale-revision reason without changing the public conflict category. */
|
|
10
|
+
export declare function assertRevision(actual: number, expected: number | undefined): void;
|
|
11
|
+
/** Bind all native task content and comments to one operation without trusting text as ownership. */
|
|
12
|
+
export declare function targetDigest(item: GetResult['item'], operation: string): string;
|
|
13
|
+
/** Enforce UTF-8 state capacity and recording slots, including every in-flight reservation. */
|
|
14
|
+
export declare function capacity(value: State): void;
|
|
15
|
+
/** Empty state is read-compatible with tasks predating this extension. */
|
|
16
|
+
export declare function state(raw: unknown): State;
|
|
17
|
+
/** Native SDK repository with cooperating writer leases and best-effort native conflict checks. */
|
|
18
|
+
export declare class Store {
|
|
19
|
+
/** Explicit tracker and invocation policy binding. */
|
|
20
|
+
readonly options: Options;
|
|
21
|
+
/** Native SDK client preserving the caller's backend. */
|
|
22
|
+
readonly client: PmClient;
|
|
23
|
+
/** Bind explicitly to one tracker; remote mutation needs a host-owned conditional writer. */
|
|
24
|
+
constructor(options: Options);
|
|
25
|
+
/** Resolve the SDK's attributed author setting. */
|
|
26
|
+
author(): Promise<string>;
|
|
27
|
+
/** Refuse unsupported remote effects before schema, journal or network writes. */
|
|
28
|
+
writable(): void;
|
|
29
|
+
/** Register through SDK schema services, never edit settings files. */
|
|
30
|
+
register(): Promise<void>;
|
|
31
|
+
/** Read the entire relevant extension field without host truncation or git discovery. */
|
|
32
|
+
read(id: string): Promise<{
|
|
33
|
+
id: string;
|
|
34
|
+
item: GetResult['item'];
|
|
35
|
+
value: State;
|
|
36
|
+
}>;
|
|
37
|
+
/** Guard one package operation with an SDK lease independent of the native item lock. */
|
|
38
|
+
locked<T>(key: string, action: () => Promise<T>): Promise<T>;
|
|
39
|
+
/** Freshly read each target and merge cooperating writes; native atomic preconditions remain an SDK gap. */
|
|
40
|
+
change(id: string, change: (value: State) => boolean | Promise<boolean>, comment?: string, references?: string[]): Promise<State>;
|
|
41
|
+
}
|
|
42
|
+
//# sourceMappingURL=store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,QAAQ,EAAoC,MAAM,uBAAuB,CAAC;AAC1H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjD,+EAA+E;AAC/E,eAAO,MAAM,MAAM,EAAE,qBAAqB,EAA6D,CAAC;AACxG,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEjF;AACD,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/E;AACD,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAK3C;AAGD,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAOzC;AACD,mGAAmG;AACnG,qBAAa,KAAK;IAChB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,6FAA6F;IAC7F,YAAY,OAAO,EAAE,OAAO,EAAsJ;IAClL,mDAAmD;IAC7C,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAiH;IAChJ,kFAAkF;IAClF,QAAQ,IAAI,IAAI,CAAwN;IACxO,uEAAuE;IACjE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAK9B;IACD,yFAAyF;IACnF,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAKrF;IACD,yFAAyF;IACnF,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQjE;IACD,4GAA4G;IACtG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CActI;CACF"}
|