@inventarch/agent-composition-system 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/LANGUAGE.md +56 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +4 -0
  4. package/README.md +2 -2
  5. package/SPEC.md +11 -0
  6. package/dist/adapters.d.ts +70 -0
  7. package/dist/adapters.d.ts.map +1 -0
  8. package/dist/adapters.js +212 -0
  9. package/dist/adapters.js.map +1 -0
  10. package/dist/authoring-format.d.ts +23 -0
  11. package/dist/authoring-format.d.ts.map +1 -0
  12. package/dist/authoring-format.js +288 -0
  13. package/dist/authoring-format.js.map +1 -0
  14. package/dist/authoring-index.d.ts +32 -0
  15. package/dist/authoring-index.d.ts.map +1 -0
  16. package/dist/authoring-index.js +252 -0
  17. package/dist/authoring-index.js.map +1 -0
  18. package/dist/authoring-manifest.d.ts +69 -0
  19. package/dist/authoring-manifest.d.ts.map +1 -0
  20. package/dist/authoring-manifest.js +387 -0
  21. package/dist/authoring-manifest.js.map +1 -0
  22. package/dist/authoring-types.d.ts +225 -0
  23. package/dist/authoring-types.d.ts.map +1 -0
  24. package/dist/authoring-types.js +2 -0
  25. package/dist/authoring-types.js.map +1 -0
  26. package/dist/authoring.d.ts +47 -0
  27. package/dist/authoring.d.ts.map +1 -0
  28. package/dist/authoring.js +565 -0
  29. package/dist/authoring.js.map +1 -0
  30. package/dist/candidate.d.ts +11 -0
  31. package/dist/candidate.d.ts.map +1 -0
  32. package/dist/candidate.js +84 -0
  33. package/dist/candidate.js.map +1 -0
  34. package/dist/catalog.d.ts +92 -0
  35. package/dist/catalog.d.ts.map +1 -0
  36. package/dist/catalog.js +6 -0
  37. package/dist/catalog.js.map +1 -0
  38. package/dist/compile.d.ts +13 -0
  39. package/dist/compile.d.ts.map +1 -0
  40. package/dist/compile.js +713 -0
  41. package/dist/compile.js.map +1 -0
  42. package/dist/compiled.d.ts +121 -0
  43. package/dist/compiled.d.ts.map +1 -0
  44. package/dist/compiled.js +9 -0
  45. package/dist/compiled.js.map +1 -0
  46. package/dist/corpus.d.ts +33 -0
  47. package/dist/corpus.d.ts.map +1 -0
  48. package/dist/corpus.js +182 -0
  49. package/dist/corpus.js.map +1 -0
  50. package/dist/execution.d.ts +6 -0
  51. package/dist/execution.d.ts.map +1 -0
  52. package/dist/execution.js +54 -0
  53. package/dist/execution.js.map +1 -0
  54. package/dist/fields.d.ts +16 -0
  55. package/dist/fields.d.ts.map +1 -0
  56. package/dist/fields.js +131 -0
  57. package/dist/fields.js.map +1 -0
  58. package/dist/index.d.ts +18 -0
  59. package/dist/index.d.ts.map +1 -0
  60. package/dist/index.js +11 -0
  61. package/dist/index.js.map +1 -0
  62. package/dist/inputs.d.ts +5 -0
  63. package/dist/inputs.d.ts.map +1 -0
  64. package/dist/inputs.js +28 -0
  65. package/dist/inputs.js.map +1 -0
  66. package/dist/installed-catalog.d.ts +4 -0
  67. package/dist/installed-catalog.d.ts.map +1 -0
  68. package/dist/installed-catalog.js +49 -0
  69. package/dist/installed-catalog.js.map +1 -0
  70. package/dist/installed-read.d.ts +29 -0
  71. package/dist/installed-read.d.ts.map +1 -0
  72. package/dist/installed-read.js +150 -0
  73. package/dist/installed-read.js.map +1 -0
  74. package/dist/installed-source-policy.d.ts +31 -0
  75. package/dist/installed-source-policy.d.ts.map +1 -0
  76. package/dist/installed-source-policy.js +95 -0
  77. package/dist/installed-source-policy.js.map +1 -0
  78. package/dist/lifecycle-profile.d.ts +59 -0
  79. package/dist/lifecycle-profile.d.ts.map +1 -0
  80. package/dist/lifecycle-profile.js +206 -0
  81. package/dist/lifecycle-profile.js.map +1 -0
  82. package/dist/lifecycle-rows.d.ts +12 -0
  83. package/dist/lifecycle-rows.d.ts.map +1 -0
  84. package/dist/lifecycle-rows.js +35 -0
  85. package/dist/lifecycle-rows.js.map +1 -0
  86. package/dist/lifecycle-transport.d.ts +21 -0
  87. package/dist/lifecycle-transport.d.ts.map +1 -0
  88. package/dist/lifecycle-transport.js +127 -0
  89. package/dist/lifecycle-transport.js.map +1 -0
  90. package/dist/lifecycle.d.ts +122 -0
  91. package/dist/lifecycle.d.ts.map +1 -0
  92. package/dist/lifecycle.js +437 -0
  93. package/dist/lifecycle.js.map +1 -0
  94. package/dist/local-store.d.ts +50 -0
  95. package/dist/local-store.d.ts.map +1 -0
  96. package/dist/local-store.js +186 -0
  97. package/dist/local-store.js.map +1 -0
  98. package/dist/native-selection.json +205 -0
  99. package/dist/native.ia.tgz +0 -0
  100. package/dist/projection-codex.d.ts +15 -0
  101. package/dist/projection-codex.d.ts.map +1 -0
  102. package/dist/projection-codex.js +74 -0
  103. package/dist/projection-codex.js.map +1 -0
  104. package/dist/projection-format.d.ts +153 -0
  105. package/dist/projection-format.d.ts.map +1 -0
  106. package/dist/projection-format.js +201 -0
  107. package/dist/projection-format.js.map +1 -0
  108. package/dist/projection-host.d.ts +43 -0
  109. package/dist/projection-host.d.ts.map +1 -0
  110. package/dist/projection-host.js +339 -0
  111. package/dist/projection-host.js.map +1 -0
  112. package/dist/projection-routine.d.ts +4 -0
  113. package/dist/projection-routine.d.ts.map +1 -0
  114. package/dist/projection-routine.js +50 -0
  115. package/dist/projection-routine.js.map +1 -0
  116. package/dist/projections.d.ts +24 -0
  117. package/dist/projections.d.ts.map +1 -0
  118. package/dist/projections.js +431 -0
  119. package/dist/projections.js.map +1 -0
  120. package/dist/publication.d.ts +7 -0
  121. package/dist/publication.d.ts.map +1 -0
  122. package/dist/publication.js +140 -0
  123. package/dist/publication.js.map +1 -0
  124. package/dist/resource-context.d.ts +26 -0
  125. package/dist/resource-context.d.ts.map +1 -0
  126. package/dist/resource-context.js +271 -0
  127. package/dist/resource-context.js.map +1 -0
  128. package/dist/resource-files.d.ts +10 -0
  129. package/dist/resource-files.d.ts.map +1 -0
  130. package/dist/resource-files.js +88 -0
  131. package/dist/resource-files.js.map +1 -0
  132. package/dist/resource-format.d.ts +106 -0
  133. package/dist/resource-format.d.ts.map +1 -0
  134. package/dist/resource-format.js +242 -0
  135. package/dist/resource-format.js.map +1 -0
  136. package/dist/resource-sources.d.ts +7 -0
  137. package/dist/resource-sources.d.ts.map +1 -0
  138. package/dist/resource-sources.js +16 -0
  139. package/dist/resource-sources.js.map +1 -0
  140. package/dist/resources.d.ts +24 -0
  141. package/dist/resources.d.ts.map +1 -0
  142. package/dist/resources.js +83 -0
  143. package/dist/resources.js.map +1 -0
  144. package/dist/sources.d.ts +45 -0
  145. package/dist/sources.d.ts.map +1 -0
  146. package/dist/sources.js +290 -0
  147. package/dist/sources.js.map +1 -0
  148. package/dist/system-package.json +1618 -0
  149. package/dist/task-capture-format.d.ts +25 -0
  150. package/dist/task-capture-format.d.ts.map +1 -0
  151. package/dist/task-capture-format.js +62 -0
  152. package/dist/task-capture-format.js.map +1 -0
  153. package/dist/task-capture.d.ts +64 -0
  154. package/dist/task-capture.d.ts.map +1 -0
  155. package/dist/task-capture.js +421 -0
  156. package/dist/task-capture.js.map +1 -0
  157. package/dist/task-context-declaration.d.ts +19 -0
  158. package/dist/task-context-declaration.d.ts.map +1 -0
  159. package/dist/task-context-declaration.js +44 -0
  160. package/dist/task-context-declaration.js.map +1 -0
  161. package/dist/task-teaching-closure.d.ts +22 -0
  162. package/dist/task-teaching-closure.d.ts.map +1 -0
  163. package/dist/task-teaching-closure.js +202 -0
  164. package/dist/task-teaching-closure.js.map +1 -0
  165. package/dist/templates.d.ts +35 -0
  166. package/dist/templates.d.ts.map +1 -0
  167. package/dist/templates.js +110 -0
  168. package/dist/templates.js.map +1 -0
  169. package/dist/tools.d.ts +32 -0
  170. package/dist/tools.d.ts.map +1 -0
  171. package/dist/tools.js +276 -0
  172. package/dist/tools.js.map +1 -0
  173. package/package.json +266 -3
  174. package/references/installed-read.md +36 -0
  175. package/references/public-spec.md +7 -0
  176. package/references/spec-read-boundary.md +17 -0
  177. package/references/task-capture.md +23 -0
package/dist/fields.js ADDED
@@ -0,0 +1,131 @@
1
+ import { CompositionError } from './compiled.js';
2
+ export function fail(code, message, node, field) {
3
+ throw new CompositionError({
4
+ code,
5
+ message,
6
+ ...(node ? { source: { identity: node.identity, path: node.source.path, line: node.source.line } } : {}),
7
+ ...(field ? { field } : {}),
8
+ });
9
+ }
10
+ export function value(node, section, key, required = false) {
11
+ const matches = node.sections
12
+ .filter((s) => s.name === section)
13
+ .flatMap((s) => s.fields)
14
+ .filter((f) => 'key' in f && f.key === key);
15
+ if (matches.length === 0 && !required)
16
+ return undefined;
17
+ const f = matches[0];
18
+ if (matches.length !== 1 || !f || !('value' in f) || f.when || f.fields)
19
+ fail('IA-COMPOSITION-CONFLICT', 'Expected one unconditional scalar/list field', node, `${section}.${key}`);
20
+ return f.value;
21
+ }
22
+ export function text(v, node, path) {
23
+ if (!v || !['scalar', 'string', 'prose'].includes(v.kind) || !('text' in v) || !v.text.trim())
24
+ fail('IA-COMPOSITION-CONFLICT', 'Expected nonempty text', node, path);
25
+ return v.text;
26
+ }
27
+ export function field(node, section, key, fallback) {
28
+ const v = value(node, section, key, fallback === undefined);
29
+ return v === undefined ? fallback : text(v, node, `${section}.${key}`);
30
+ }
31
+ export function list(node, section, key) {
32
+ const v = value(node, section, key);
33
+ if (v === undefined)
34
+ return [];
35
+ if (v.kind !== 'list')
36
+ fail('IA-COMPOSITION-CONFLICT', 'Expected list', node, `${section}.${key}`);
37
+ return v.items;
38
+ }
39
+ export function strings(node, section, key) {
40
+ return list(node, section, key).map((v) => text(v, node, `${section}.${key}`));
41
+ }
42
+ export const LIMIT_KEYS = [
43
+ 'steps',
44
+ 'modelCalls',
45
+ 'operations',
46
+ 'tokens',
47
+ 'children',
48
+ 'depth',
49
+ 'bytes',
50
+ 'durationMs',
51
+ ];
52
+ const nativeLimits = {
53
+ steps: 'steps',
54
+ 'model-calls': 'modelCalls',
55
+ operations: 'operations',
56
+ tokens: 'tokens',
57
+ children: 'children',
58
+ depth: 'depth',
59
+ bytes: 'bytes',
60
+ 'duration-ms': 'durationMs',
61
+ };
62
+ export function limits(node) {
63
+ const entries = node.sections
64
+ .filter((s) => s.name === 'execution')
65
+ .flatMap((s) => s.fields)
66
+ .filter((f) => 'key' in f && (f.key.startsWith('limit-') || f.key === 'limits'));
67
+ const result = {};
68
+ for (const f of entries) {
69
+ if (!('key' in f) || !Object.hasOwn(nativeLimits, f.key.slice(6)) || f.when || f.fields)
70
+ fail('IA-COMPOSITION-CONFLICT', 'Unknown or conditional limit', node, 'execution.limit-*');
71
+ const key = nativeLimits[f.key.slice(6)], number = Number(text(f.value, node, `execution.${f.key}`));
72
+ if (Object.hasOwn(result, key) ||
73
+ !Number.isSafeInteger(number) ||
74
+ number < 0 ||
75
+ (key === 'durationMs' && number === 0))
76
+ fail('IA-COMPOSITION-CONFLICT', 'Invalid or duplicate limit', node, `execution.${f.key}`);
77
+ result[key] = number;
78
+ }
79
+ return result;
80
+ }
81
+ export function minimum(...values) {
82
+ const result = {};
83
+ for (const v of values)
84
+ for (const key of LIMIT_KEYS)
85
+ if (v[key] !== undefined)
86
+ result[key] = Math.min(result[key] ?? Infinity, v[key]);
87
+ return result;
88
+ }
89
+ export function unique(items) {
90
+ return [...new Set(items)];
91
+ }
92
+ /** The language closes sections; the installed composition consumer additionally closes executable fields. */
93
+ export function closedFields(node) {
94
+ const contracts = {
95
+ voice: { communication: ['tone', 'terminology', 'explanation', 'uncertainty', 'audience', 'citations'] },
96
+ 'agent-profile': {
97
+ composition: ['agent', 'voice', 'mandate', 'capabilities', 'delegates'],
98
+ execution: ['role', 'outcomes', 'mandate-contract', 'model-profile'],
99
+ },
100
+ harness: { composition: ['workspace', 'profiles', 'bindings'], execution: ['host-profile'] },
101
+ capability: {
102
+ composition: ['operations', 'playbooks', 'templates', 'checks', 'includes'],
103
+ execution: ['input', 'outcomes', 'context-profile', 'procedure-profile', 'mapping-profile', 'effects'],
104
+ },
105
+ 'execution-binding': {
106
+ binding: ['kind', 'implementation', 'target', 'mapping', 'event', 'guard', 'tools', 'filters'],
107
+ },
108
+ mandate: { execution: ['contract'] },
109
+ operation: { execution: ['handler', 'effects', 'input', 'output', 'profile', 'recovery'] },
110
+ };
111
+ const contract = contracts[node.discriminator];
112
+ if (!contract)
113
+ return;
114
+ for (const section of node.sections) {
115
+ const keys = contract[section.name];
116
+ if (!keys)
117
+ continue;
118
+ for (const f of section.fields) {
119
+ if (!('key' in f) ||
120
+ (!keys.includes(f.key) &&
121
+ !(section.name === 'execution' &&
122
+ node.discriminator !== 'operation' &&
123
+ Object.hasOwn(nativeLimits, f.key.slice(6)) &&
124
+ f.key.startsWith('limit-'))))
125
+ fail('IA-COMPOSITION-CONFLICT', 'Unknown executable field', node, section.name);
126
+ if (f.when || f.fields)
127
+ fail('IA-COMPOSITION-CONFLICT', 'Conditional or nested executable fields are unsupported', node, `${section.name}.${f.key}`);
128
+ }
129
+ }
130
+ }
131
+ //# sourceMappingURL=fields.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fields.js","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ export type { Manifest, Profile, OperationDefinition } from '@inventarch/agent-system';
2
+ export { captureWorkspace, adoptWorkspace, verifyCapture, Corpus } from './corpus.js';
3
+ export type { Capture } from './corpus.js';
4
+ export { compileHarness } from './compile.js';
5
+ export { executionManifest } from './execution.js';
6
+ export { candidateValidation } from './candidate.js';
7
+ export { managedPublication } from './publication.js';
8
+ export { installedImplementationDigest } from './installed-catalog.js';
9
+ export type { CompileOptions } from './compile.js';
10
+ export { installed } from './catalog.js';
11
+ export type { CompositionCatalog, Installed, HostContract, MandateContract, ContextContract, OperationContract, ResourceLimits, EffectClass, OutcomeContract, } from './catalog.js';
12
+ export { INSTALLED_READ, installedReadCatalog, installedReadAdapters } from './installed-read.js';
13
+ export type { InstalledReadCatalog, InstalledReadOptions } from './installed-read.js';
14
+ export { CompositionError } from './compiled.js';
15
+ export type { Compilation, CompiledHarness, CompiledProfile, CompiledCapability, ComponentPin, CompositionDiagnostic, CompositionCode, } from './compiled.js';
16
+ export { prepareTaskCapture, verifyTaskCapture, taskTeachingDigest, TaskCaptureError, TASK_CAPTURE_BYTES, TASK_CAPTURE_POLICY, taskCaptureRequest, } from './task-capture.js';
17
+ export type { TaskContextDeclaration, TaskCaptureFullView, TaskCaptureRequest, TaskCaptureSelection, PreparedTaskCapture, } from './task-capture.js';
18
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAClG,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,11 @@
1
+ export { captureWorkspace, adoptWorkspace, verifyCapture, Corpus } from './corpus.js';
2
+ export { compileHarness } from './compile.js';
3
+ export { executionManifest } from './execution.js';
4
+ export { candidateValidation } from './candidate.js';
5
+ export { managedPublication } from './publication.js';
6
+ export { installedImplementationDigest } from './installed-catalog.js';
7
+ export { installed } from './catalog.js';
8
+ export { INSTALLED_READ, installedReadCatalog, installedReadAdapters } from './installed-read.js';
9
+ export { CompositionError } from './compiled.js';
10
+ export { prepareTaskCapture, verifyTaskCapture, taskTeachingDigest, TaskCaptureError, TASK_CAPTURE_BYTES, TASK_CAPTURE_POLICY, taskCaptureRequest, } from './task-capture.js';
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAYzC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAElG,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAWjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { Json } from '@inventarch/session-system';
2
+ /** Decidable conjunction for the installed closed schema vocabulary (after schema validation).
3
+ * Optional properties may be omitted; arrays always admit the empty array unless an enum forbids it. */
4
+ export declare function compatibleInputs(schemas: Json[]): boolean;
5
+ //# sourceMappingURL=inputs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAEvD;wGACwG;AACxG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CA+BzD"}
package/dist/inputs.js ADDED
@@ -0,0 +1,28 @@
1
+ import { validateShape } from '@inventarch/agent-system';
2
+ /** Decidable conjunction for the installed closed schema vocabulary (after schema validation).
3
+ * Optional properties may be omitted; arrays always admit the empty array unless an enum forbids it. */
4
+ export function compatibleInputs(schemas) {
5
+ const objects = schemas;
6
+ const enumeration = objects.find((s) => Array.isArray(s['enum']))?.['enum'];
7
+ if (Array.isArray(enumeration))
8
+ return enumeration.some((candidate) => schemas.every((s) => validateShape(s, candidate)));
9
+ const types = new Set(objects.map((s) => s['type']));
10
+ if (types.size > 1 && ![...types].every((t) => t === 'number' || t === 'integer'))
11
+ return false;
12
+ if (types.has('number') || types.has('integer')) {
13
+ let min = Math.max(-Number.MAX_VALUE, ...objects.map((s) => (typeof s['minimum'] === 'number' ? s['minimum'] : -Number.MAX_VALUE)));
14
+ let max = Math.min(Number.MAX_VALUE, ...objects.map((s) => (typeof s['maximum'] === 'number' ? s['maximum'] : Number.MAX_VALUE)));
15
+ if (types.has('integer')) {
16
+ min = Math.max(-Number.MAX_SAFE_INTEGER, Math.ceil(min));
17
+ max = Math.min(Number.MAX_SAFE_INTEGER, Math.floor(max));
18
+ }
19
+ return min <= max;
20
+ }
21
+ if (types.has('object')) {
22
+ const required = new Set(objects.flatMap((s) => s['required']));
23
+ return [...required].every((key) => objects.every((s) => Object.hasOwn(s['properties'], key)) &&
24
+ compatibleInputs(objects.map((s) => s['properties'][key])));
25
+ }
26
+ return true;
27
+ }
28
+ //# sourceMappingURL=inputs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inputs.js","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ /** Node host helper over fixed installed package entrypoints, never record- or model-supplied paths.
2
+ * Bundled hosts supply their verified release artifact digest to inspectionCatalog instead. */
3
+ export declare function installedImplementationDigest(): string;
4
+ //# sourceMappingURL=installed-catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-catalog.d.ts","sourceRoot":"","sources":["../src/installed-catalog.ts"],"names":[],"mappings":"AAQA;+FAC+F;AAC/F,wBAAgB,6BAA6B,IAAI,MAAM,CAsCtD"}
@@ -0,0 +1,49 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { readdirSync, readFileSync } from 'node:fs';
3
+ import { dirname, resolve, relative } from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { createRequire } from 'node:module';
6
+ import { platformDebris } from '@inventarch/db/distribution';
7
+ import { digest } from '@inventarch/session-system';
8
+ /** Node host helper over fixed installed package entrypoints, never record- or model-supplied paths.
9
+ * Bundled hosts supply their verified release artifact digest to inspectionCatalog instead. */
10
+ export function installedImplementationDigest() {
11
+ const database = import.meta.resolve('@inventarch/db');
12
+ const entries = [
13
+ ['agent-composition-system', fileURLToPath(import.meta.url)],
14
+ ['agent-system', fileURLToPath(import.meta.resolve('@inventarch/agent-system'))],
15
+ ['session-system', fileURLToPath(import.meta.resolve('@inventarch/session-system'))],
16
+ ['template-system', fileURLToPath(import.meta.resolve('@inventarch/template-system'))],
17
+ ['authoring-system', fileURLToPath(import.meta.resolve('@inventarch/authoring-system'))],
18
+ ['runtime', fileURLToPath(import.meta.resolve('@inventarch/runtime'))],
19
+ ['db', fileURLToPath(database)],
20
+ ['graph', fileURLToPath(import.meta.resolve('@inventarch/graph'))],
21
+ ['language', fileURLToPath(import.meta.resolve('@inventarch/language'))],
22
+ ['compliance', createRequire(database).resolve('@inventarch/compliance')],
23
+ ];
24
+ const files = [];
25
+ for (const [name, entry] of entries) {
26
+ const root = dirname(entry);
27
+ const visit = (directory) => {
28
+ for (const child of readdirSync(directory, { withFileTypes: true })) {
29
+ if (child.isSymbolicLink())
30
+ throw new Error('Installed code aliases are unsupported');
31
+ const path = resolve(directory, child.name);
32
+ if (child.isDirectory())
33
+ visit(path);
34
+ else if (/\.(?:[cm]?js|ts)$/.test(child.name) &&
35
+ !child.name.endsWith('.d.ts') &&
36
+ !(child.isFile() && platformDebris(child.name)))
37
+ files.push({
38
+ package: name,
39
+ path: relative(root, path).replaceAll('\\', '/'),
40
+ digest: createHash('sha256').update(readFileSync(path)).digest('hex'),
41
+ });
42
+ }
43
+ };
44
+ visit(root);
45
+ }
46
+ files.sort((a, b) => (`${a.package}/${a.path}` < `${b.package}/${b.path}` ? -1 : 1));
47
+ return digest(files);
48
+ }
49
+ //# sourceMappingURL=installed-catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-catalog.js","sourceRoot":"","sources":["../src/installed-catalog.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import type { Manifest, OperationAdapter } from '@inventarch/agent-system';
2
+ import type { CompositionCatalog } from './catalog.js';
3
+ import type { CompiledHarness } from './compiled.js';
4
+ import type { Capture } from './corpus.js';
5
+ /** Fixed first-party identities. Native/model inputs never select a module or handler. */
6
+ export declare const INSTALLED_READ: Readonly<{
7
+ operation: "authoring-system/binding/operation/read-captured-source";
8
+ implementation: "captured-source-read-v1";
9
+ handler: "ia.captured-source.read.v1";
10
+ input: "captured-source-read-input-v1";
11
+ output: "captured-source-read-output-v1";
12
+ }>;
13
+ export type InstalledReadCatalog = Pick<CompositionCatalog, 'validators' | 'operations'>;
14
+ /** Installed descriptions only. No capture, grant, callback or read dispatch occurs here. */
15
+ export declare function installedReadCatalog(): InstalledReadCatalog;
16
+ export interface InstalledReadOptions {
17
+ readonly manifest: Manifest;
18
+ readonly compiled: CompiledHarness;
19
+ readonly catalog: CompositionCatalog;
20
+ readonly principal: string;
21
+ /** Host supplies fresh captured native bytes. This never supplies executable code or authority. */
22
+ readonly currentCapture: () => Capture | Promise<Capture>;
23
+ }
24
+ /** Bind one statically imported captured read to an exact compiled/installed executable closure. */
25
+ export declare function installedReadAdapters(input: Capture, options: InstalledReadOptions): {
26
+ operations: Readonly<Record<string, OperationAdapter>>;
27
+ close(): void;
28
+ };
29
+ //# sourceMappingURL=installed-read.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-read.d.ts","sourceRoot":"","sources":["../src/installed-read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAoB,MAAM,0BAA0B,CAAC;AAI7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,0FAA0F;AAC1F,eAAO,MAAM,cAAc;;;;;;EAMzB,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;AAsBzF,6FAA6F;AAC7F,wBAAgB,oBAAoB,IAAI,oBAAoB,CAsB3D;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mGAAmG;IACnG,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAKD,oGAAoG;AACpG,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,GAC5B;IAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CA+G3E"}
@@ -0,0 +1,150 @@
1
+ import { manifestDigest, validateShape } from '@inventarch/agent-system';
2
+ import { canonical, copy, digest, SessionError } from '@inventarch/session-system';
3
+ import { installed } from './catalog.js';
4
+ import { compileHarness } from './compile.js';
5
+ import { Corpus, verifyCapture } from './corpus.js';
6
+ import { executionManifest } from './execution.js';
7
+ import { installedImplementationDigest } from './installed-catalog.js';
8
+ /** Fixed first-party identities. Native/model inputs never select a module or handler. */
9
+ export const INSTALLED_READ = Object.freeze({
10
+ operation: 'authoring-system/binding/operation/read-captured-source',
11
+ implementation: 'captured-source-read-v1',
12
+ handler: 'ia.captured-source.read.v1',
13
+ input: 'captured-source-read-input-v1',
14
+ output: 'captured-source-read-output-v1',
15
+ });
16
+ const inputSchema = {
17
+ type: 'object',
18
+ properties: {
19
+ path: { type: 'string', maxLength: 2048 },
20
+ start: { type: 'integer', minimum: 0, maximum: 100000 },
21
+ limit: { type: 'integer', minimum: 1, maximum: 400 },
22
+ },
23
+ required: ['path'],
24
+ additionalProperties: false,
25
+ };
26
+ const outputSchema = {
27
+ type: 'object',
28
+ properties: {
29
+ text: { type: 'string', maxLength: 49152 },
30
+ revision: { type: 'string', maxLength: 64 },
31
+ citations: { type: 'array', items: { type: 'string', maxLength: 2200 }, maxItems: 1 },
32
+ },
33
+ required: ['text', 'revision', 'citations'],
34
+ additionalProperties: false,
35
+ };
36
+ /** Installed descriptions only. No capture, grant, callback or read dispatch occurs here. */
37
+ export function installedReadCatalog() {
38
+ return {
39
+ validators: {
40
+ [INSTALLED_READ.input]: installed({ schema: inputSchema }),
41
+ [INSTALLED_READ.output]: installed({ schema: outputSchema }),
42
+ },
43
+ operations: {
44
+ [INSTALLED_READ.implementation]: installed({
45
+ identity: INSTALLED_READ.operation,
46
+ owner: 'agent-composition-system',
47
+ handler: INSTALLED_READ.handler,
48
+ implementationDigest: installedImplementationDigest(),
49
+ input: INSTALLED_READ.input,
50
+ output: INSTALLED_READ.output,
51
+ effects: ['read'],
52
+ recovery: 'repeatable',
53
+ timeoutMs: 10000,
54
+ maxOutputBytes: 65536,
55
+ preflight: 'captured-workspace',
56
+ }),
57
+ },
58
+ };
59
+ }
60
+ function denied(message) {
61
+ throw new SessionError('IA-INSTALLED-READ-DENIED', message);
62
+ }
63
+ /** Bind one statically imported captured read to an exact compiled/installed executable closure. */
64
+ export function installedReadAdapters(input, options) {
65
+ const capture = verifyCapture(input), manifest = copy(options.manifest), compiled = copy(options.compiled), catalog = copy(options.catalog);
66
+ const principal = options.principal, currentCapture = options.currentCapture;
67
+ if (!principal ||
68
+ typeof currentCapture !== 'function' ||
69
+ manifestDigest(manifest) !== manifest.digest ||
70
+ manifest.sourceDigest !== capture.revision)
71
+ denied('Host manifest, principal or capture binding is unavailable');
72
+ const expected = executionManifest(compiled, catalog);
73
+ if (digest(expected) !== digest(manifest) || !manifest.operations[INSTALLED_READ.operation])
74
+ denied('Manifest differs from the retained compiled closure');
75
+ const rebuilt = compileHarness(capture, { harness: compiled.id, entry: compiled.entry.binding, catalog });
76
+ if (!rebuilt.ok || rebuilt.manifest.digest !== compiled.digest)
77
+ denied('Compiled closure differs from the retained native capture');
78
+ if (Object.values(manifest.operations).some((operation) => operation.handler === INSTALLED_READ.handler && operation.id !== INSTALLED_READ.operation))
79
+ denied('The fixed read handler cannot alias another operation');
80
+ const checkInstalled = () => {
81
+ const current = installedReadCatalog();
82
+ for (const id of [INSTALLED_READ.input, INSTALLED_READ.output])
83
+ if (canonical(catalog.validators[id] ?? null) !== canonical(current.validators[id]))
84
+ denied('Installed read validator changed');
85
+ if (canonical(catalog.operations[INSTALLED_READ.implementation] ?? null) !==
86
+ canonical(current.operations[INSTALLED_READ.implementation]))
87
+ denied('Installed read contract or implementation bytes changed');
88
+ if (!compiled.provenance.installed.some((pin) => pin.group === 'operations' &&
89
+ pin.id === INSTALLED_READ.implementation &&
90
+ pin.digest === current.operations[INSTALLED_READ.implementation].digest))
91
+ denied('Compiled installed read pin is unavailable');
92
+ };
93
+ checkInstalled();
94
+ const readers = Object.values(manifest.profiles).filter((profile) => profile.operations.includes(INSTALLED_READ.operation));
95
+ const corpus = new Corpus(capture);
96
+ let closed = false;
97
+ const authorize = async (context) => {
98
+ const check = () => {
99
+ context.signal.throwIfAborted();
100
+ if (closed ||
101
+ typeof context.assertCurrent !== 'function' ||
102
+ context.principal !== principal ||
103
+ context.grant.principal !== principal ||
104
+ digest(context.manifest) !== digest(manifest) ||
105
+ manifestDigest(context.manifest) !== manifest.digest ||
106
+ context.grant.workspace !== manifest.workspace ||
107
+ context.grant.expiresAt <= Date.now() ||
108
+ context.grant.limits.deadline <= Date.now() ||
109
+ !readers.some((profile) => context.grant.profiles.includes(profile.id) &&
110
+ (context.agent === undefined || context.agent === profile.agent)) ||
111
+ !context.grant.operations.includes(INSTALLED_READ.operation) ||
112
+ !context.grant.effects.includes('read') ||
113
+ !context.grant.sources.includes(capture.revision))
114
+ denied('Read exceeds current host authority');
115
+ };
116
+ check();
117
+ await context.assertCurrent();
118
+ check();
119
+ if (verifyCapture(await currentCapture()).revision !== capture.revision)
120
+ denied('Captured native source selection changed');
121
+ check();
122
+ checkInstalled();
123
+ };
124
+ const adapter = {
125
+ id: INSTALLED_READ.handler,
126
+ execute: async (args, context) => {
127
+ // Snapshot once before awaits; caller mutation cannot redirect an authorized read.
128
+ const selected = copy(args);
129
+ if (!validateShape(inputSchema, selected) || Buffer.byteLength(canonical(selected)) > 4096)
130
+ denied('Read arguments differ from the fixed schema');
131
+ await authorize(context);
132
+ const value = selected;
133
+ const result = await corpus.adapter.execute({ ...value, operation: 'read' }, context);
134
+ if (result.effect !== 'none' ||
135
+ !validateShape(outputSchema, result.output) ||
136
+ Buffer.byteLength(canonical(result.output)) > 65536)
137
+ denied('Captured read exceeds the fixed output contract');
138
+ await authorize(context);
139
+ return result;
140
+ },
141
+ };
142
+ return {
143
+ operations: Object.freeze({ [adapter.id]: adapter }),
144
+ close: () => {
145
+ closed = true;
146
+ corpus.close();
147
+ },
148
+ };
149
+ }
150
+ //# sourceMappingURL=installed-read.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-read.js","sourceRoot":"","sources":["../src/installed-read.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import type { ActivationPointer, BundleManifest, DistributionLock, ExpandedBundle, GenerationInputs } from '@inventarch/db/distribution';
2
+ import type { Capture } from './corpus.js';
3
+ export interface SourceInstallation {
4
+ readonly pointer: ActivationPointer;
5
+ readonly lock: DistributionLock;
6
+ readonly inputs: GenerationInputs;
7
+ readonly bundles: ReadonlyMap<string, ExpandedBundle>;
8
+ }
9
+ export interface RetainedSourceInstallation {
10
+ readonly pointer: ActivationPointer;
11
+ readonly lock: DistributionLock;
12
+ readonly inputs: GenerationInputs;
13
+ readonly bundles: readonly {
14
+ readonly id: string;
15
+ readonly manifest: BundleManifest;
16
+ readonly archiveDigest: string;
17
+ readonly manifestDigest: string;
18
+ readonly files: readonly {
19
+ readonly path: string;
20
+ readonly base64: string;
21
+ }[];
22
+ }[];
23
+ }
24
+ export declare const SOURCE_INSTALLATION_BYTES: number;
25
+ /** Decode retained data, then delegate all native membership and payload verification to the native owner. */
26
+ export declare function readSourceInstallation(value: unknown): SourceInstallation & {
27
+ readonly sources: Capture['sources'];
28
+ };
29
+ /** Synchronous copy occurs before callers can mutate file buffers, maps, metadata or activation. */
30
+ export declare function retainSourceInstallation(value: SourceInstallation): RetainedSourceInstallation;
31
+ //# sourceMappingURL=installed-source-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-source-policy.d.ts","sourceRoot":"","sources":["../src/installed-source-policy.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACvD;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;QAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,SAAS;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC/E,EAAE,CAAC;CACL;AAED,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAiC1D,8GAA8G;AAC9G,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;CAAE,CA+CpH;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,0BAA0B,CAoB9F"}
@@ -0,0 +1,95 @@
1
+ import { decodeActivationPointer, decodeBundleManifest, decodeDistributionLock, decodeGenerationInputs, DISTRIBUTION_ENGINE_VERSION, DISTRIBUTION_LIMITS, generationSources, satisfies, } from '@inventarch/db/distribution';
2
+ import { copy } from '@inventarch/session-system';
3
+ // This hosted retained-policy profile is narrower than the native 256 MiB expanded archive limit.
4
+ export const SOURCE_INSTALLATION_BYTES = 32 * 1024 * 1024;
5
+ function fail() {
6
+ throw new Error('Invalid retained source installation');
7
+ }
8
+ function object(value, keys) {
9
+ if (!value || typeof value !== 'object' || ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
10
+ fail();
11
+ const names = Reflect.ownKeys(value), descriptors = Object.getOwnPropertyDescriptors(value);
12
+ if (names.length !== keys.length ||
13
+ names.some((key) => typeof key !== 'string' ||
14
+ !keys.includes(key) ||
15
+ !descriptors[key]?.enumerable ||
16
+ !Object.hasOwn(descriptors[key], 'value')))
17
+ fail();
18
+ return value;
19
+ }
20
+ function array(value, max) {
21
+ if (!Array.isArray(value) ||
22
+ value.length > max ||
23
+ Reflect.ownKeys(value).length !== value.length + 1 ||
24
+ Object.values(Object.getOwnPropertyDescriptors(value)).some((row) => !Object.hasOwn(row, 'value')))
25
+ fail();
26
+ return value;
27
+ }
28
+ const hash = (value) => (typeof value === 'string' && /^[a-f0-9]{64}$/.test(value) ? value : fail());
29
+ /** Decode retained data, then delegate all native membership and payload verification to the native owner. */
30
+ export function readSourceInstallation(value) {
31
+ const row = object(value, ['pointer', 'lock', 'inputs', 'bundles']);
32
+ const pointer = decodeActivationPointer(row['pointer']), lock = decodeDistributionLock(row['lock']), inputs = decodeGenerationInputs(row['inputs']);
33
+ if (!satisfies(DISTRIBUTION_ENGINE_VERSION, lock.engine))
34
+ fail();
35
+ const bundles = new Map();
36
+ let total = 0, count = 0, previous = '';
37
+ for (const entry of array(row['bundles'], DISTRIBUTION_LIMITS.bundles)) {
38
+ const bundle = object(entry, ['id', 'manifest', 'archiveDigest', 'manifestDigest', 'files']);
39
+ const manifest = decodeBundleManifest(bundle['manifest']), id = bundle['id'];
40
+ if (id !== manifest.id || id <= previous)
41
+ fail();
42
+ previous = id;
43
+ const files = new Map();
44
+ let pathBefore = '';
45
+ for (const item of array(bundle['files'], DISTRIBUTION_LIMITS.files)) {
46
+ const file = object(item, ['path', 'base64']), path = file['path'], base64 = file['base64'];
47
+ if (++count > DISTRIBUTION_LIMITS.files ||
48
+ typeof path !== 'string' ||
49
+ path <= pathBefore ||
50
+ typeof base64 !== 'string' ||
51
+ base64.length > Math.ceil(DISTRIBUTION_LIMITS.file / 3) * 4)
52
+ fail();
53
+ const pin = manifest.files.find((pin) => pin.path === path);
54
+ if (!pin || (total += pin.bytes) > SOURCE_INSTALLATION_BYTES || base64.length !== Math.ceil(pin.bytes / 3) * 4)
55
+ fail();
56
+ const bytes = Buffer.from(base64, 'base64');
57
+ if (bytes.toString('base64') !== base64 || bytes.length !== pin.bytes)
58
+ fail();
59
+ files.set(path, bytes);
60
+ pathBefore = path;
61
+ }
62
+ bundles.set(id, {
63
+ manifest,
64
+ archiveDigest: hash(bundle['archiveDigest']),
65
+ manifestDigest: hash(bundle['manifestDigest']),
66
+ files,
67
+ });
68
+ }
69
+ if (bundles.size !== lock.packages.length || lock.packages.some((pkg) => !bundles.has(pkg.id)))
70
+ fail();
71
+ return { pointer, lock, inputs, bundles, sources: generationSources(pointer, lock, inputs, bundles) };
72
+ }
73
+ /** Synchronous copy occurs before callers can mutate file buffers, maps, metadata or activation. */
74
+ export function retainSourceInstallation(value) {
75
+ const data = {
76
+ pointer: value.pointer,
77
+ lock: value.lock,
78
+ inputs: value.inputs,
79
+ bundles: [...value.bundles]
80
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
81
+ .map(([id, bundle]) => ({
82
+ id,
83
+ manifest: bundle.manifest,
84
+ archiveDigest: bundle.archiveDigest,
85
+ manifestDigest: bundle.manifestDigest,
86
+ files: [...bundle.files]
87
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
88
+ .map(([path, bytes]) => ({ path, base64: bytes.toString('base64') })),
89
+ })),
90
+ };
91
+ readSourceInstallation(data);
92
+ // Native metadata decoders return closed detached values; JSON detaches the complete retained envelope.
93
+ return copy(data);
94
+ }
95
+ //# sourceMappingURL=installed-source-policy.js.map