agent-passport-system 2.3.0-alpha → 2.5.0-alpha
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 +22 -4
- package/dist/src/index.d.ts +4 -0
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +8 -0
- package/dist/src/index.js.map +1 -1
- package/dist/src/v2/accountability/__tests__/action.test.d.ts +2 -0
- package/dist/src/v2/accountability/__tests__/action.test.d.ts.map +1 -0
- package/dist/src/v2/accountability/__tests__/action.test.js +101 -0
- package/dist/src/v2/accountability/__tests__/action.test.js.map +1 -0
- package/dist/src/v2/accountability/__tests__/authority-boundary.test.d.ts +2 -0
- package/dist/src/v2/accountability/__tests__/authority-boundary.test.d.ts.map +1 -0
- package/dist/src/v2/accountability/__tests__/authority-boundary.test.js +79 -0
- package/dist/src/v2/accountability/__tests__/authority-boundary.test.js.map +1 -0
- package/dist/src/v2/accountability/__tests__/bundle.test.d.ts +2 -0
- package/dist/src/v2/accountability/__tests__/bundle.test.d.ts.map +1 -0
- package/dist/src/v2/accountability/__tests__/bundle.test.js +122 -0
- package/dist/src/v2/accountability/__tests__/bundle.test.js.map +1 -0
- package/dist/src/v2/accountability/__tests__/contestability.test.d.ts +2 -0
- package/dist/src/v2/accountability/__tests__/contestability.test.d.ts.map +1 -0
- package/dist/src/v2/accountability/__tests__/contestability.test.js +205 -0
- package/dist/src/v2/accountability/__tests__/contestability.test.js.map +1 -0
- package/dist/src/v2/accountability/__tests__/custody.test.d.ts +2 -0
- package/dist/src/v2/accountability/__tests__/custody.test.d.ts.map +1 -0
- package/dist/src/v2/accountability/__tests__/custody.test.js +155 -0
- package/dist/src/v2/accountability/__tests__/custody.test.js.map +1 -0
- package/dist/src/v2/accountability/__tests__/fixtures.test.d.ts +2 -0
- package/dist/src/v2/accountability/__tests__/fixtures.test.d.ts.map +1 -0
- package/dist/src/v2/accountability/__tests__/fixtures.test.js +48 -0
- package/dist/src/v2/accountability/__tests__/fixtures.test.js.map +1 -0
- package/dist/src/v2/accountability/construct/action.d.ts +7 -0
- package/dist/src/v2/accountability/construct/action.d.ts.map +1 -0
- package/dist/src/v2/accountability/construct/action.js +46 -0
- package/dist/src/v2/accountability/construct/action.js.map +1 -0
- package/dist/src/v2/accountability/construct/authority-boundary.d.ts +7 -0
- package/dist/src/v2/accountability/construct/authority-boundary.d.ts.map +1 -0
- package/dist/src/v2/accountability/construct/authority-boundary.js +34 -0
- package/dist/src/v2/accountability/construct/authority-boundary.js.map +1 -0
- package/dist/src/v2/accountability/construct/bundle.d.ts +19 -0
- package/dist/src/v2/accountability/construct/bundle.d.ts.map +1 -0
- package/dist/src/v2/accountability/construct/bundle.js +63 -0
- package/dist/src/v2/accountability/construct/bundle.js.map +1 -0
- package/dist/src/v2/accountability/construct/contestability.d.ts +9 -0
- package/dist/src/v2/accountability/construct/contestability.d.ts.map +1 -0
- package/dist/src/v2/accountability/construct/contestability.js +62 -0
- package/dist/src/v2/accountability/construct/contestability.js.map +1 -0
- package/dist/src/v2/accountability/construct/custody.d.ts +7 -0
- package/dist/src/v2/accountability/construct/custody.d.ts.map +1 -0
- package/dist/src/v2/accountability/construct/custody.js +41 -0
- package/dist/src/v2/accountability/construct/custody.js.map +1 -0
- package/dist/src/v2/accountability/index.d.ts +12 -0
- package/dist/src/v2/accountability/index.d.ts.map +1 -0
- package/dist/src/v2/accountability/index.js +37 -0
- package/dist/src/v2/accountability/index.js.map +1 -0
- package/dist/src/v2/accountability/types/action.d.ts +24 -0
- package/dist/src/v2/accountability/types/action.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/action.js +11 -0
- package/dist/src/v2/accountability/types/action.js.map +1 -0
- package/dist/src/v2/accountability/types/authority-boundary.d.ts +16 -0
- package/dist/src/v2/accountability/types/authority-boundary.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/authority-boundary.js +12 -0
- package/dist/src/v2/accountability/types/authority-boundary.js.map +1 -0
- package/dist/src/v2/accountability/types/base.d.ts +35 -0
- package/dist/src/v2/accountability/types/base.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/base.js +10 -0
- package/dist/src/v2/accountability/types/base.js.map +1 -0
- package/dist/src/v2/accountability/types/bundle.d.ts +23 -0
- package/dist/src/v2/accountability/types/bundle.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/bundle.js +12 -0
- package/dist/src/v2/accountability/types/bundle.js.map +1 -0
- package/dist/src/v2/accountability/types/contestability.d.ts +31 -0
- package/dist/src/v2/accountability/types/contestability.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/contestability.js +18 -0
- package/dist/src/v2/accountability/types/contestability.js.map +1 -0
- package/dist/src/v2/accountability/types/custody.d.ts +18 -0
- package/dist/src/v2/accountability/types/custody.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/custody.js +14 -0
- package/dist/src/v2/accountability/types/custody.js.map +1 -0
- package/dist/src/v2/accountability/types/index.d.ts +7 -0
- package/dist/src/v2/accountability/types/index.d.ts.map +1 -0
- package/dist/src/v2/accountability/types/index.js +7 -0
- package/dist/src/v2/accountability/types/index.js.map +1 -0
- package/dist/src/v2/accountability/verify/action.d.ts +8 -0
- package/dist/src/v2/accountability/verify/action.d.ts.map +1 -0
- package/dist/src/v2/accountability/verify/action.js +33 -0
- package/dist/src/v2/accountability/verify/action.js.map +1 -0
- package/dist/src/v2/accountability/verify/authority-boundary.d.ts +8 -0
- package/dist/src/v2/accountability/verify/authority-boundary.d.ts.map +1 -0
- package/dist/src/v2/accountability/verify/authority-boundary.js +26 -0
- package/dist/src/v2/accountability/verify/authority-boundary.js.map +1 -0
- package/dist/src/v2/accountability/verify/bundle.d.ts +8 -0
- package/dist/src/v2/accountability/verify/bundle.d.ts.map +1 -0
- package/dist/src/v2/accountability/verify/bundle.js +31 -0
- package/dist/src/v2/accountability/verify/bundle.js.map +1 -0
- package/dist/src/v2/accountability/verify/contestability.d.ts +8 -0
- package/dist/src/v2/accountability/verify/contestability.d.ts.map +1 -0
- package/dist/src/v2/accountability/verify/contestability.js +107 -0
- package/dist/src/v2/accountability/verify/contestability.js.map +1 -0
- package/dist/src/v2/accountability/verify/custody.d.ts +8 -0
- package/dist/src/v2/accountability/verify/custody.d.ts.map +1 -0
- package/dist/src/v2/accountability/verify/custody.js +58 -0
- package/dist/src/v2/accountability/verify/custody.js.map +1 -0
- package/dist/src/v2/index.d.ts +2 -0
- package/dist/src/v2/index.d.ts.map +1 -1
- package/dist/src/v2/index.js +4 -0
- package/dist/src/v2/index.js.map +1 -1
- package/dist/src/v2/instruction-provenance/canonicalize.d.ts +50 -0
- package/dist/src/v2/instruction-provenance/canonicalize.d.ts.map +1 -0
- package/dist/src/v2/instruction-provenance/canonicalize.js +128 -0
- package/dist/src/v2/instruction-provenance/canonicalize.js.map +1 -0
- package/dist/src/v2/instruction-provenance/envelope.d.ts +22 -0
- package/dist/src/v2/instruction-provenance/envelope.d.ts.map +1 -0
- package/dist/src/v2/instruction-provenance/envelope.js +107 -0
- package/dist/src/v2/instruction-provenance/envelope.js.map +1 -0
- package/dist/src/v2/instruction-provenance/index.d.ts +5 -0
- package/dist/src/v2/instruction-provenance/index.d.ts.map +1 -0
- package/dist/src/v2/instruction-provenance/index.js +11 -0
- package/dist/src/v2/instruction-provenance/index.js.map +1 -0
- package/dist/src/v2/instruction-provenance/types.d.ts +133 -0
- package/dist/src/v2/instruction-provenance/types.d.ts.map +1 -0
- package/dist/src/v2/instruction-provenance/types.js +11 -0
- package/dist/src/v2/instruction-provenance/types.js.map +1 -0
- package/dist/src/v2/instruction-provenance/verify.d.ts +28 -0
- package/dist/src/v2/instruction-provenance/verify.d.ts.map +1 -0
- package/dist/src/v2/instruction-provenance/verify.js +311 -0
- package/dist/src/v2/instruction-provenance/verify.js.map +1 -0
- package/package.json +3 -3
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { CreateIPRInput, InstructionProvenanceReceipt } from './types.js';
|
|
2
|
+
/** Typed error for IPR construction failures. */
|
|
3
|
+
export declare class IPRConstructionError extends Error {
|
|
4
|
+
readonly code: string;
|
|
5
|
+
constructor(code: string, message: string);
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Build, sign, and return a complete InstructionProvenanceReceipt envelope.
|
|
9
|
+
* Performs all v0.2 invariants:
|
|
10
|
+
* - tier locked to 'self-asserted'
|
|
11
|
+
* - discovery_patterns non-empty
|
|
12
|
+
* - every instruction_files[].path canonicalized
|
|
13
|
+
* - instruction_files sorted in canonical order
|
|
14
|
+
* - context_root derived from sorted files
|
|
15
|
+
* - receipt_id = sha256(canonical envelope bytes)
|
|
16
|
+
* - signature = Ed25519 over canonical envelope bytes
|
|
17
|
+
*/
|
|
18
|
+
export declare function createInstructionProvenanceReceipt(input: CreateIPRInput): InstructionProvenanceReceipt;
|
|
19
|
+
/** Ed25519 sign using the same PKCS8-prefix construction as the bilateral
|
|
20
|
+
* fixture generator. Returns hex (128 chars). */
|
|
21
|
+
export declare function signEd25519(message: string | Uint8Array, privateKeyHex: string): string;
|
|
22
|
+
//# sourceMappingURL=envelope.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/envelope.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,cAAc,EAEd,4BAA4B,EAC7B,MAAM,YAAY,CAAA;AAInB,iDAAiD;AACjD,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,cAAc,GACpB,4BAA4B,CAgF9B;AAED;kDACkD;AAClD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAOvF"}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
|
|
2
|
+
// ══════════════════════════════════════════════════════════════════
|
|
3
|
+
// IPR — envelope construction (createInstructionProvenanceReceipt)
|
|
4
|
+
// ══════════════════════════════════════════════════════════════════
|
|
5
|
+
// Tier-locked to 'self-asserted' in v0.2 per spec §4.1. Throws on attempts
|
|
6
|
+
// to construct 'witnessed' or 'verified' envelopes (reserved for v0.3+).
|
|
7
|
+
// ══════════════════════════════════════════════════════════════════
|
|
8
|
+
import { createPrivateKey, sign as cryptoSign } from 'node:crypto';
|
|
9
|
+
import { canonicalizeEnvelope, canonicalizePath, computeContextRoot, sha256Hex, sortInstructionFiles, } from './canonicalize.js';
|
|
10
|
+
const PKCS8_ED25519_PREFIX = Buffer.from('302e020100300506032b657004220420', 'hex');
|
|
11
|
+
/** Typed error for IPR construction failures. */
|
|
12
|
+
export class IPRConstructionError extends Error {
|
|
13
|
+
code;
|
|
14
|
+
constructor(code, message) {
|
|
15
|
+
super(`${code}: ${message}`);
|
|
16
|
+
this.code = code;
|
|
17
|
+
this.name = 'IPRConstructionError';
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Build, sign, and return a complete InstructionProvenanceReceipt envelope.
|
|
22
|
+
* Performs all v0.2 invariants:
|
|
23
|
+
* - tier locked to 'self-asserted'
|
|
24
|
+
* - discovery_patterns non-empty
|
|
25
|
+
* - every instruction_files[].path canonicalized
|
|
26
|
+
* - instruction_files sorted in canonical order
|
|
27
|
+
* - context_root derived from sorted files
|
|
28
|
+
* - receipt_id = sha256(canonical envelope bytes)
|
|
29
|
+
* - signature = Ed25519 over canonical envelope bytes
|
|
30
|
+
*/
|
|
31
|
+
export function createInstructionProvenanceReceipt(input) {
|
|
32
|
+
// Tier lock — v0.2 only emits 'self-asserted'.
|
|
33
|
+
if (input.attestation_tier !== undefined && input.attestation_tier !== 'self-asserted') {
|
|
34
|
+
throw new IPRConstructionError('TIER_RESERVED', `attestation_tier '${String(input.attestation_tier)}' reserved for v0.3+; v0.2 only emits 'self-asserted'`);
|
|
35
|
+
}
|
|
36
|
+
if (!Array.isArray(input.discovery_patterns) || input.discovery_patterns.length === 0) {
|
|
37
|
+
throw new IPRConstructionError('EMPTY_PATTERNS', 'discovery_patterns must be a non-empty array');
|
|
38
|
+
}
|
|
39
|
+
if (!input.working_root.startsWith('/')) {
|
|
40
|
+
throw new IPRConstructionError('WORKING_ROOT_NOT_ABSOLUTE', `working_root must be absolute POSIX: ${input.working_root}`);
|
|
41
|
+
}
|
|
42
|
+
if (!/^[0-9a-f]{64}$/.test(input.delegation_chain_root)) {
|
|
43
|
+
throw new IPRConstructionError('BAD_DELEGATION_ROOT', 'delegation_chain_root must be 64-char lowercase hex');
|
|
44
|
+
}
|
|
45
|
+
if (!/^[0-9a-f]{64}$/.test(input.publicKeyHex)) {
|
|
46
|
+
throw new IPRConstructionError('BAD_PUBLIC_KEY', 'publicKeyHex must be 64-char lowercase hex');
|
|
47
|
+
}
|
|
48
|
+
if (!/^[0-9a-f]{64}$/.test(input.privateKeyHex)) {
|
|
49
|
+
throw new IPRConstructionError('BAD_PRIVATE_KEY', 'privateKeyHex must be 64-char lowercase hex (Ed25519 seed)');
|
|
50
|
+
}
|
|
51
|
+
// Canonicalize each path; rejects symlink dereferencing, traversal, etc.
|
|
52
|
+
const canonicalFiles = input.instruction_files.map(f => ({
|
|
53
|
+
...f,
|
|
54
|
+
path: canonicalizePath(f.path, {
|
|
55
|
+
workingRoot: input.working_root,
|
|
56
|
+
filesystemMode: input.filesystem_mode,
|
|
57
|
+
}),
|
|
58
|
+
}));
|
|
59
|
+
// Validate digest format on every file.
|
|
60
|
+
for (const f of canonicalFiles) {
|
|
61
|
+
if (!/^[0-9a-f]{64}$/.test(f.digest)) {
|
|
62
|
+
throw new IPRConstructionError('BAD_DIGEST', `instruction_files entry has malformed digest: ${f.path}`);
|
|
63
|
+
}
|
|
64
|
+
if (f.is_symlink && !f.symlink_target) {
|
|
65
|
+
throw new IPRConstructionError('SYMLINK_MISSING_TARGET', `instruction_files entry is_symlink=true but symlink_target is missing: ${f.path}`);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
const sortedFiles = sortInstructionFiles(canonicalFiles);
|
|
69
|
+
const contextRoot = computeContextRoot(sortedFiles);
|
|
70
|
+
const issuedAt = input.issued_at ?? new Date().toISOString();
|
|
71
|
+
const signingKeyId = `ed25519:${input.publicKeyHex.slice(0, 16)}`;
|
|
72
|
+
// Build the unsigned envelope (signature + receipt_id absent).
|
|
73
|
+
const unsigned = {
|
|
74
|
+
delegation_chain_root: input.delegation_chain_root,
|
|
75
|
+
agent_did: input.agent_did,
|
|
76
|
+
discovery_patterns: input.discovery_patterns,
|
|
77
|
+
working_root: input.working_root,
|
|
78
|
+
filesystem_mode: input.filesystem_mode,
|
|
79
|
+
instruction_files: sortedFiles,
|
|
80
|
+
context_root: contextRoot,
|
|
81
|
+
attestation_tier: 'self-asserted',
|
|
82
|
+
recompute_at_action: input.recompute_at_action ?? false,
|
|
83
|
+
issued_at: issuedAt,
|
|
84
|
+
...(input.expires_at !== undefined ? { expires_at: input.expires_at } : {}),
|
|
85
|
+
bound_to: input.bound_to,
|
|
86
|
+
signing_key_id: signingKeyId,
|
|
87
|
+
};
|
|
88
|
+
const canonicalBytes = canonicalizeEnvelope(unsigned);
|
|
89
|
+
const receiptId = sha256Hex(canonicalBytes);
|
|
90
|
+
const signatureHex = signEd25519(canonicalBytes, input.privateKeyHex);
|
|
91
|
+
return {
|
|
92
|
+
receipt_id: receiptId,
|
|
93
|
+
...unsigned,
|
|
94
|
+
signature: signatureHex,
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
/** Ed25519 sign using the same PKCS8-prefix construction as the bilateral
|
|
98
|
+
* fixture generator. Returns hex (128 chars). */
|
|
99
|
+
export function signEd25519(message, privateKeyHex) {
|
|
100
|
+
const seed = Buffer.from(privateKeyHex, 'hex');
|
|
101
|
+
const derKey = Buffer.concat([PKCS8_ED25519_PREFIX, seed]);
|
|
102
|
+
const keyObj = createPrivateKey({ key: derKey, format: 'der', type: 'pkcs8' });
|
|
103
|
+
const msg = typeof message === 'string' ? Buffer.from(message, 'utf8') : Buffer.from(message);
|
|
104
|
+
const sig = cryptoSign(null, msg, keyObj);
|
|
105
|
+
return Buffer.from(sig).toString('hex');
|
|
106
|
+
}
|
|
107
|
+
//# sourceMappingURL=envelope.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/envelope.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { createInstructionProvenanceReceipt, IPRConstructionError, signEd25519 } from './envelope.js';
|
|
2
|
+
export { verifyInstructionProvenanceReceipt, verifyActionTimeContextRoot, matchesAnyPattern } from './verify.js';
|
|
3
|
+
export { IPRPathError, canonicalizePath, canonicalizeEnvelope, computeContextRoot, sortInstructionFiles, sha256Hex, } from './canonicalize.js';
|
|
4
|
+
export type { AttestationTier, FilesystemMode, InstructionRole, InstructionFile, InstructionProvenanceReceipt, InstructionProvenanceReceiptBoundTo, CanonicalizationResult, VerificationResult, CreateIPRInput, VerifyIPRInput, ActionTimeContextRootInput, } from './types.js';
|
|
5
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kCAAkC,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AACrG,OAAO,EAAE,kCAAkC,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,4BAA4B,EAC5B,mCAAmC,EACnC,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,GAC3B,MAAM,YAAY,CAAA"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
|
|
2
|
+
// ══════════════════════════════════════════════════════════════════
|
|
3
|
+
// InstructionProvenanceReceipt — public barrel
|
|
4
|
+
// ══════════════════════════════════════════════════════════════════
|
|
5
|
+
// Spec: ~/aeoess_web/specs/INSTRUCTION-PROVENANCE-RECEIPT-DRAFT-v0.2.md
|
|
6
|
+
// Tier scope this version: 'self-asserted' only.
|
|
7
|
+
// ══════════════════════════════════════════════════════════════════
|
|
8
|
+
export { createInstructionProvenanceReceipt, IPRConstructionError, signEd25519 } from './envelope.js';
|
|
9
|
+
export { verifyInstructionProvenanceReceipt, verifyActionTimeContextRoot, matchesAnyPattern } from './verify.js';
|
|
10
|
+
export { IPRPathError, canonicalizePath, canonicalizeEnvelope, computeContextRoot, sortInstructionFiles, sha256Hex, } from './canonicalize.js';
|
|
11
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,+CAA+C;AAC/C,qEAAqE;AACrE,wEAAwE;AACxE,iDAAiD;AACjD,qEAAqE;AAErE,OAAO,EAAE,kCAAkC,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AACrG,OAAO,EAAE,kCAAkC,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,MAAM,mBAAmB,CAAA"}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
/** v0.2 envelopes ship 'self-asserted'. v0.3 unlocks 'witnessed' and 'verified'. */
|
|
2
|
+
export type AttestationTier = 'self-asserted' | 'witnessed' | 'verified';
|
|
3
|
+
export type FilesystemMode = 'case-sensitive' | 'case-insensitive';
|
|
4
|
+
export type InstructionRole = 'system_prompt' | 'agent_md' | 'user_md' | 'memory' | 'rules' | 'other';
|
|
5
|
+
export interface InstructionFile {
|
|
6
|
+
/** Canonicalized relative POSIX path, per spec §5.1. Symlinks are separate
|
|
7
|
+
* entries with `is_symlink: true`; the link target appears as a distinct
|
|
8
|
+
* file. */
|
|
9
|
+
path: string;
|
|
10
|
+
/** Hex sha256 of file contents. Lowercase, 64 chars. */
|
|
11
|
+
digest: string;
|
|
12
|
+
/** Byte length of the file at issuance time. */
|
|
13
|
+
bytes: number;
|
|
14
|
+
/** Role classification. `'other'` for files matched by patterns but not
|
|
15
|
+
* fitting a named role. */
|
|
16
|
+
role: InstructionRole;
|
|
17
|
+
/** True iff this entry represents a symlink, not a regular file. The
|
|
18
|
+
* symlink's target file appears as its own entry. */
|
|
19
|
+
is_symlink?: boolean;
|
|
20
|
+
/** Target path of the symlink (only present when is_symlink=true). */
|
|
21
|
+
symlink_target?: string;
|
|
22
|
+
}
|
|
23
|
+
export interface InstructionProvenanceReceiptBoundTo {
|
|
24
|
+
type: 'session' | 'action' | 'window';
|
|
25
|
+
/** Reference to the bound entity. Format depends on `type`:
|
|
26
|
+
* - session: session_id
|
|
27
|
+
* - action: action_ref hex sha256 (Module 37 / A2A#1672)
|
|
28
|
+
* - window: ISO 8601 timestamp interval `<start>/<end>` */
|
|
29
|
+
ref: string;
|
|
30
|
+
}
|
|
31
|
+
export interface InstructionProvenanceReceipt {
|
|
32
|
+
/** sha256 of the canonical-JCS serialization of this object minus
|
|
33
|
+
* `signature` and `receipt_id`. */
|
|
34
|
+
receipt_id: string;
|
|
35
|
+
/** Existing APS field. Links IPR to its delegation root.
|
|
36
|
+
* Format: hex sha256 of canonical delegation chain. */
|
|
37
|
+
delegation_chain_root: string;
|
|
38
|
+
/** Acting agent DID. */
|
|
39
|
+
agent_did: string;
|
|
40
|
+
/** Glob patterns the agent claims to have walked, in arbitrary order.
|
|
41
|
+
* Must be non-empty. POSIX globs relative to `working_root`. */
|
|
42
|
+
discovery_patterns: string[];
|
|
43
|
+
/** Working root for path resolution. Absolute POSIX path. The agent's
|
|
44
|
+
* `instruction_files[].path` values are relative to this root. */
|
|
45
|
+
working_root: string;
|
|
46
|
+
/** Filesystem case mode for the working_root. Affects path comparison. */
|
|
47
|
+
filesystem_mode: FilesystemMode;
|
|
48
|
+
/** Files matched by `discovery_patterns`. Exhaustiveness contract: this
|
|
49
|
+
* array MUST contain every regular file matched by any pattern in
|
|
50
|
+
* `discovery_patterns`, in canonical sorted order by `path`. */
|
|
51
|
+
instruction_files: InstructionFile[];
|
|
52
|
+
/** sha256 of the canonical-JCS serialization of `instruction_files` only.
|
|
53
|
+
* The hash that changes when any file content or path changes. */
|
|
54
|
+
context_root: string;
|
|
55
|
+
/** Attestation tier per ENFORCEMENT-TRUST-ANCHOR Component 4. v0.2
|
|
56
|
+
* envelopes MUST carry `'self-asserted'`. */
|
|
57
|
+
attestation_tier: AttestationTier;
|
|
58
|
+
/** When true, action receipts emitted under this IPR MUST re-hash the
|
|
59
|
+
* files matching `discovery_patterns` immediately before action
|
|
60
|
+
* execution and inline the fresh `context_root` into the action receipt.
|
|
61
|
+
* Default false. Mandatory true at tier >= 2 in v2.4. */
|
|
62
|
+
recompute_at_action: boolean;
|
|
63
|
+
/** Issuance timestamp, ISO 8601 with millisecond precision and Z suffix. */
|
|
64
|
+
issued_at: string;
|
|
65
|
+
/** Optional expiry. Verifiers SHOULD treat absent as session-bound. */
|
|
66
|
+
expires_at?: string;
|
|
67
|
+
/** Binding scope. */
|
|
68
|
+
bound_to: InstructionProvenanceReceiptBoundTo;
|
|
69
|
+
/** Ed25519 signing key fingerprint: `ed25519:<first-16-hex-of-public-key>`. */
|
|
70
|
+
signing_key_id: string;
|
|
71
|
+
/** Ed25519 over the JCS canonicalization of this object minus
|
|
72
|
+
* `signature` and `receipt_id`. Hex, 128 chars. */
|
|
73
|
+
signature: string;
|
|
74
|
+
}
|
|
75
|
+
/** Result of `canonicalizePath`. Either a canonical relative POSIX string or
|
|
76
|
+
* a typed error explaining the rejection (callers throw `IPRPathError`). */
|
|
77
|
+
export interface CanonicalizationResult {
|
|
78
|
+
canonical: string;
|
|
79
|
+
}
|
|
80
|
+
/** Verification outcome from `verifyInstructionProvenanceReceipt`. */
|
|
81
|
+
export interface VerificationResult {
|
|
82
|
+
valid: boolean;
|
|
83
|
+
errors: string[];
|
|
84
|
+
/** Surfaced for callers that want to gate on tier even when valid=true. */
|
|
85
|
+
tier?: AttestationTier;
|
|
86
|
+
/** Surfaced for caller convenience; equals envelope.context_root when
|
|
87
|
+
* recomputation matched, otherwise the recomputed value. */
|
|
88
|
+
contextRoot?: string;
|
|
89
|
+
}
|
|
90
|
+
/** Inputs for createInstructionProvenanceReceipt. */
|
|
91
|
+
export interface CreateIPRInput {
|
|
92
|
+
delegation_chain_root: string;
|
|
93
|
+
agent_did: string;
|
|
94
|
+
discovery_patterns: string[];
|
|
95
|
+
working_root: string;
|
|
96
|
+
filesystem_mode: FilesystemMode;
|
|
97
|
+
instruction_files: InstructionFile[];
|
|
98
|
+
recompute_at_action?: boolean;
|
|
99
|
+
issued_at?: string;
|
|
100
|
+
expires_at?: string;
|
|
101
|
+
bound_to: InstructionProvenanceReceiptBoundTo;
|
|
102
|
+
/** Ed25519 private key (hex seed, 64 chars). */
|
|
103
|
+
privateKeyHex: string;
|
|
104
|
+
/** Ed25519 public key (hex, 64 chars) used to derive `signing_key_id`. */
|
|
105
|
+
publicKeyHex: string;
|
|
106
|
+
/** Tier override is not allowed in v0.2; envelope is always 'self-asserted'.
|
|
107
|
+
* Future-flagged here so v0.3 can wire 'witnessed' / 'verified'. */
|
|
108
|
+
attestation_tier?: 'self-asserted';
|
|
109
|
+
}
|
|
110
|
+
/** Verification options. */
|
|
111
|
+
export interface VerifyIPRInput {
|
|
112
|
+
envelope: InstructionProvenanceReceipt;
|
|
113
|
+
/** Ed25519 public key (hex, 64 chars) used to verify `signature`. */
|
|
114
|
+
publicKeyHex: string;
|
|
115
|
+
/** When provided, performs §6.3 step 10/11 exhaustiveness check by
|
|
116
|
+
* re-walking the working root with `discovery_patterns`. When omitted,
|
|
117
|
+
* the verifier skips filesystem checks (signature + schema only). */
|
|
118
|
+
filesystemCheck?: boolean;
|
|
119
|
+
/** Verifier clock for §6.4 step 12/13 (default: Date.now()). */
|
|
120
|
+
now?: Date;
|
|
121
|
+
/** Allowable clock skew in milliseconds for `issued_at` future check
|
|
122
|
+
* (default: 5 minutes). */
|
|
123
|
+
clockSkewMs?: number;
|
|
124
|
+
}
|
|
125
|
+
/** Action-receipt context-root verification input. */
|
|
126
|
+
export interface ActionTimeContextRootInput {
|
|
127
|
+
/** The IPR the action receipt is bound to. */
|
|
128
|
+
envelope: InstructionProvenanceReceipt;
|
|
129
|
+
/** Action-receipt-side fresh `context_root` computed immediately before
|
|
130
|
+
* action execution. Hex sha256, 64 chars. */
|
|
131
|
+
context_root_at_action_time: string;
|
|
132
|
+
}
|
|
133
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
|
|
2
|
+
// ══════════════════════════════════════════════════════════════════
|
|
3
|
+
// InstructionProvenanceReceipt — types
|
|
4
|
+
// ══════════════════════════════════════════════════════════════════
|
|
5
|
+
// Spec: ~/aeoess_web/specs/INSTRUCTION-PROVENANCE-RECEIPT-DRAFT-v0.2.md
|
|
6
|
+
// Tier scope this version: 'self-asserted' only. 'witnessed' and 'verified'
|
|
7
|
+
// are reserved schema values; verifiers MUST reject envelopes carrying them
|
|
8
|
+
// per ENFORCEMENT-TRUST-ANCHOR Component 4 (§§141-149).
|
|
9
|
+
// ══════════════════════════════════════════════════════════════════
|
|
10
|
+
export {};
|
|
11
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,uCAAuC;AACvC,qEAAqE;AACrE,wEAAwE;AACxE,4EAA4E;AAC5E,4EAA4E;AAC5E,wDAAwD;AACxD,qEAAqE"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { ActionTimeContextRootInput, VerificationResult, VerifyIPRInput } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Verify an InstructionProvenanceReceipt envelope per spec §6.
|
|
4
|
+
*
|
|
5
|
+
* Pipeline:
|
|
6
|
+
* §6.1 schema + signature
|
|
7
|
+
* §6.2 delegation linkage (signature key matches signing_key_id)
|
|
8
|
+
* §6.3 path canonicalization, sort order, context_root, exhaustiveness
|
|
9
|
+
* §6.4 issued_at + expires_at + bound_to consistency
|
|
10
|
+
*
|
|
11
|
+
* Filesystem-side checks (§6.3 step 10/11 cross-walk vs disk) only run
|
|
12
|
+
* when `filesystemCheck: true` AND `working_root` exists on this host.
|
|
13
|
+
*/
|
|
14
|
+
export declare function verifyInstructionProvenanceReceipt(input: VerifyIPRInput): VerificationResult;
|
|
15
|
+
/**
|
|
16
|
+
* §6.5 — when an IPR carries `recompute_at_action: true`, every action
|
|
17
|
+
* receipt under its binding scope MUST include `context_root_at_action_time`
|
|
18
|
+
* computed by re-walking discovery_patterns. This helper compares.
|
|
19
|
+
*/
|
|
20
|
+
export declare function verifyActionTimeContextRoot(input: ActionTimeContextRootInput): VerificationResult;
|
|
21
|
+
/**
|
|
22
|
+
* Tiny POSIX-glob matcher. Supports `*`, `?`, `**`, character literals.
|
|
23
|
+
* Patterns are matched against canonical relative paths (no leading `/`,
|
|
24
|
+
* forward-slash separators). Patterns may start with `./` (stripped) or
|
|
25
|
+
* `**` for recursive match.
|
|
26
|
+
*/
|
|
27
|
+
export declare function matchesAnyPattern(path: string, patterns: readonly string[]): boolean;
|
|
28
|
+
//# sourceMappingURL=verify.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../../src/v2/instruction-provenance/verify.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,0BAA0B,EAG1B,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAA;AAOnB;;;;;;;;;;;GAWG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CA4I5F;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,0BAA0B,GAAG,kBAAkB,CAiBjG;AAwBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAMpF"}
|