@inventarch/workspace-runtime 0.0.0-bootstrap.0 → 1.2.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 (126) hide show
  1. package/LANGUAGE.md +56 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +4 -0
  4. package/README.md +5 -1
  5. package/SPEC.md +19 -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/corpus.d.ts +33 -0
  35. package/dist/corpus.d.ts.map +1 -0
  36. package/dist/corpus.js +182 -0
  37. package/dist/corpus.js.map +1 -0
  38. package/dist/index.d.ts +6 -0
  39. package/dist/index.d.ts.map +1 -0
  40. package/dist/index.js +5 -0
  41. package/dist/index.js.map +1 -0
  42. package/dist/installed-catalog.d.ts +8 -0
  43. package/dist/installed-catalog.d.ts.map +1 -0
  44. package/dist/installed-catalog.js +108 -0
  45. package/dist/installed-catalog.js.map +1 -0
  46. package/dist/installed-source-policy.d.ts +31 -0
  47. package/dist/installed-source-policy.d.ts.map +1 -0
  48. package/dist/installed-source-policy.js +95 -0
  49. package/dist/installed-source-policy.js.map +1 -0
  50. package/dist/lifecycle-profile.d.ts +59 -0
  51. package/dist/lifecycle-profile.d.ts.map +1 -0
  52. package/dist/lifecycle-profile.js +206 -0
  53. package/dist/lifecycle-profile.js.map +1 -0
  54. package/dist/lifecycle-rows.d.ts +12 -0
  55. package/dist/lifecycle-rows.d.ts.map +1 -0
  56. package/dist/lifecycle-rows.js +35 -0
  57. package/dist/lifecycle-rows.js.map +1 -0
  58. package/dist/lifecycle-transport.d.ts +21 -0
  59. package/dist/lifecycle-transport.d.ts.map +1 -0
  60. package/dist/lifecycle-transport.js +127 -0
  61. package/dist/lifecycle-transport.js.map +1 -0
  62. package/dist/lifecycle.d.ts +122 -0
  63. package/dist/lifecycle.d.ts.map +1 -0
  64. package/dist/lifecycle.js +437 -0
  65. package/dist/lifecycle.js.map +1 -0
  66. package/dist/local-store.d.ts +50 -0
  67. package/dist/local-store.d.ts.map +1 -0
  68. package/dist/local-store.js +186 -0
  69. package/dist/local-store.js.map +1 -0
  70. package/dist/projection-codex.d.ts +15 -0
  71. package/dist/projection-codex.d.ts.map +1 -0
  72. package/dist/projection-codex.js +74 -0
  73. package/dist/projection-codex.js.map +1 -0
  74. package/dist/projection-format.d.ts +153 -0
  75. package/dist/projection-format.d.ts.map +1 -0
  76. package/dist/projection-format.js +201 -0
  77. package/dist/projection-format.js.map +1 -0
  78. package/dist/projection-host.d.ts +43 -0
  79. package/dist/projection-host.d.ts.map +1 -0
  80. package/dist/projection-host.js +339 -0
  81. package/dist/projection-host.js.map +1 -0
  82. package/dist/projection-routine.d.ts +4 -0
  83. package/dist/projection-routine.d.ts.map +1 -0
  84. package/dist/projection-routine.js +50 -0
  85. package/dist/projection-routine.js.map +1 -0
  86. package/dist/projections.d.ts +24 -0
  87. package/dist/projections.d.ts.map +1 -0
  88. package/dist/projections.js +431 -0
  89. package/dist/projections.js.map +1 -0
  90. package/dist/publication.d.ts +7 -0
  91. package/dist/publication.d.ts.map +1 -0
  92. package/dist/publication.js +140 -0
  93. package/dist/publication.js.map +1 -0
  94. package/dist/resource-context.d.ts +26 -0
  95. package/dist/resource-context.d.ts.map +1 -0
  96. package/dist/resource-context.js +271 -0
  97. package/dist/resource-context.js.map +1 -0
  98. package/dist/resource-files.d.ts +10 -0
  99. package/dist/resource-files.d.ts.map +1 -0
  100. package/dist/resource-files.js +88 -0
  101. package/dist/resource-files.js.map +1 -0
  102. package/dist/resource-format.d.ts +106 -0
  103. package/dist/resource-format.d.ts.map +1 -0
  104. package/dist/resource-format.js +280 -0
  105. package/dist/resource-format.js.map +1 -0
  106. package/dist/resource-sources.d.ts +7 -0
  107. package/dist/resource-sources.d.ts.map +1 -0
  108. package/dist/resource-sources.js +16 -0
  109. package/dist/resource-sources.js.map +1 -0
  110. package/dist/resources.d.ts +24 -0
  111. package/dist/resources.d.ts.map +1 -0
  112. package/dist/resources.js +83 -0
  113. package/dist/resources.js.map +1 -0
  114. package/dist/sources.d.ts +45 -0
  115. package/dist/sources.d.ts.map +1 -0
  116. package/dist/sources.js +290 -0
  117. package/dist/sources.js.map +1 -0
  118. package/dist/task-capture-format.d.ts +25 -0
  119. package/dist/task-capture-format.d.ts.map +1 -0
  120. package/dist/task-capture-format.js +62 -0
  121. package/dist/task-capture-format.js.map +1 -0
  122. package/dist/templates.d.ts +35 -0
  123. package/dist/templates.d.ts.map +1 -0
  124. package/dist/templates.js +110 -0
  125. package/dist/templates.js.map +1 -0
  126. package/package.json +244 -4
@@ -0,0 +1,59 @@
1
+ export declare class LifecycleError extends Error {
2
+ readonly code: string;
3
+ constructor(code: string, message: string);
4
+ }
5
+ export interface LifecycleProfile {
6
+ readonly format: 'ia.lifecycle-profile.v1';
7
+ readonly host: string;
8
+ readonly version: string;
9
+ readonly available: boolean;
10
+ readonly reason: string | null;
11
+ readonly events: readonly string[];
12
+ readonly maxContextCharacters: number | null;
13
+ readonly maxContextParts: number;
14
+ readonly maxInputBytes: number;
15
+ readonly maxPromptBytes: number;
16
+ readonly digest: string;
17
+ /** The row's closed UserPromptSubmit fields, digested with the body; absent on unavailable profiles and the two unfolded rows. */
18
+ readonly promptFields?: readonly string[];
19
+ }
20
+ export interface LifecycleEvent {
21
+ readonly format: 'ia.lifecycle-event.v1';
22
+ readonly profile: string;
23
+ readonly host: string;
24
+ readonly kind: 'start' | 'prompt' | 'native';
25
+ readonly source: 'startup' | 'resume' | 'clear' | 'compact' | 'fork' | null;
26
+ readonly session: string;
27
+ readonly agent: string | null;
28
+ readonly cwd: string;
29
+ readonly promptId: string | null;
30
+ readonly prompt: string | null;
31
+ /** Retriable host event identity, if the host supplies one. Never a delivery acknowledgement. */
32
+ readonly key: string | null;
33
+ readonly inputDigest: string;
34
+ readonly delivery: 'unconfirmed';
35
+ }
36
+ /** The exact Claude Code version, not a range, whose row new context registrations select. */
37
+ export declare const SELECTED_CLAUDE_CODE_VERSION = "2.1.285";
38
+ /** A compatibility declaration, not an observation that a host enabled or delivered hooks. */
39
+ export declare function lifecycleProfile(host: string, version: string): LifecycleProfile;
40
+ export declare function verifyLifecycleProfile(input: LifecycleProfile): LifecycleProfile;
41
+ /** The host and version of one available segmented row. */
42
+ export interface SegmentedLifecycleRow {
43
+ readonly host: string;
44
+ readonly version: string;
45
+ }
46
+ /** The available segmented row this exact digest names, or null; no version range is inferred. */
47
+ export declare function segmentedLifecycleRow(digest: unknown): SegmentedLifecycleRow | null;
48
+ /** True only for the digest of an available segmented Claude Code row; no version range is inferred. */
49
+ export declare function isSegmentedLifecycleProfile(digest: unknown): boolean;
50
+ /** Decode bounded host metadata only. No transcript, path, module or credential is opened. */
51
+ export declare function decodeLifecycleEvent(inputProfile: LifecycleProfile, input: string): LifecycleEvent;
52
+ /** Authenticated native hosts supply their own retained session/profile/attempt, never a coding-host transcript. */
53
+ export declare function createNativeLifecycleEvent(input: {
54
+ readonly session: string;
55
+ readonly profile: string;
56
+ readonly invocation: string | null;
57
+ readonly text: string;
58
+ }): LifecycleEvent;
59
+ //# sourceMappingURL=lifecycle-profile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-profile.d.ts","sourceRoot":"","sources":["../src/lifecycle-profile.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,206 @@
1
+ import { stableSerialize } from '@inventarch/graph';
2
+ import { decodeJson, frozen, metadataDigest } from './resource-format.js';
3
+ import { claudeCodeRows, profileFromRows } from './lifecycle-rows.js';
4
+ export class LifecycleError extends Error {
5
+ code;
6
+ constructor(code, message) {
7
+ super(message);
8
+ this.code = code;
9
+ this.name = 'LifecycleError';
10
+ }
11
+ }
12
+ function fail(message) {
13
+ throw new LifecycleError('IA-LIFECYCLE-INPUT', message);
14
+ }
15
+ function string(value, max = 4096, empty = false) {
16
+ if (typeof value !== 'string' ||
17
+ (!empty && !value) ||
18
+ Buffer.byteLength(value) > max ||
19
+ Buffer.from(value).toString('utf8') !== value ||
20
+ /\u0000/.test(value))
21
+ fail('Invalid or oversized lifecycle text');
22
+ return value;
23
+ }
24
+ function object(value, allowed) {
25
+ if (value === null ||
26
+ typeof value !== 'object' ||
27
+ Array.isArray(value) ||
28
+ ![null, Object.prototype].includes(Object.getPrototypeOf(value)))
29
+ fail('Expected lifecycle object');
30
+ const descriptors = Object.getOwnPropertyDescriptors(value);
31
+ if (Reflect.ownKeys(value).some((key) => typeof key !== 'string' ||
32
+ !allowed.includes(key) ||
33
+ !descriptors[key]?.enumerable ||
34
+ !Object.hasOwn(descriptors[key], 'value')))
35
+ fail('Unknown or non-data lifecycle field');
36
+ return value;
37
+ }
38
+ /** The exact Claude Code version, not a range, whose row new context registrations select. */
39
+ export const SELECTED_CLAUDE_CODE_VERSION = '2.1.285';
40
+ /** A compatibility declaration, not an observation that a host enabled or delivered hooks. */
41
+ export function lifecycleProfile(host, version) {
42
+ string(host, 64);
43
+ string(version, 64);
44
+ return profileFromRows(claudeCodeRows, host, version);
45
+ }
46
+ export function verifyLifecycleProfile(input) {
47
+ const expected = lifecycleProfile(input.host, input.version);
48
+ if (stableSerialize(input) !== stableSerialize(expected))
49
+ fail('Lifecycle profile differs from its installed definition');
50
+ if (!expected.available)
51
+ throw new LifecycleError('IA-LIFECYCLE-UNAVAILABLE', expected.reason);
52
+ return expected;
53
+ }
54
+ /** Each available segmented Claude Code row, keyed by its profile digest, computed once when the module loads. */
55
+ const segmentedRows = new Map([...claudeCodeRows.keys()].map((version) => [
56
+ lifecycleProfile('claude-code', version).digest,
57
+ frozen({ host: 'claude-code', version }),
58
+ ]));
59
+ /** The available segmented row this exact digest names, or null; no version range is inferred. */
60
+ export function segmentedLifecycleRow(digest) {
61
+ return typeof digest === 'string' ? (segmentedRows.get(digest) ?? null) : null;
62
+ }
63
+ /** True only for the digest of an available segmented Claude Code row; no version range is inferred. */
64
+ export function isSegmentedLifecycleProfile(digest) {
65
+ return segmentedLifecycleRow(digest) !== null;
66
+ }
67
+ /** Decode bounded host metadata only. No transcript, path, module or credential is opened. */
68
+ export function decodeLifecycleEvent(inputProfile, input) {
69
+ const profile = verifyLifecycleProfile(inputProfile);
70
+ if (profile.host === 'ia-native')
71
+ fail('Native context requires the trusted native event factory');
72
+ if (typeof input !== 'string' ||
73
+ Buffer.byteLength(input) > profile.maxInputBytes ||
74
+ Buffer.from(input).toString('utf8') !== input)
75
+ fail('Lifecycle input exceeds its byte bound or is invalid UTF-8');
76
+ let decoded;
77
+ try {
78
+ decoded = decodeJson(input);
79
+ }
80
+ catch {
81
+ fail('Lifecycle input is not bounded unambiguous JSON');
82
+ }
83
+ const common = [
84
+ 'session_id',
85
+ 'prompt_id',
86
+ 'transcript_path',
87
+ 'cwd',
88
+ 'scratchpad_dir',
89
+ 'permission_mode',
90
+ 'effort',
91
+ 'hook_event_name',
92
+ 'agent_id',
93
+ 'agent_type',
94
+ ];
95
+ const row = object(decoded, [
96
+ ...common,
97
+ 'source',
98
+ 'model',
99
+ 'session_title',
100
+ 'seconds_since_last_response',
101
+ 'context_tokens',
102
+ 'prompt_cache_likely_expired',
103
+ 'estimated_cache_write_usd',
104
+ 'prompt',
105
+ ]);
106
+ const event = string(row['hook_event_name'], 64);
107
+ if (!profile.events.includes(event))
108
+ fail('Unsupported lifecycle event');
109
+ const promptFields = profile.host === 'claude-code' ? claudeCodeRows.get(profile.version) : undefined;
110
+ if (!promptFields)
111
+ fail('Unsupported lifecycle event');
112
+ const start = event === 'SessionStart', eventFields = start
113
+ ? [
114
+ 'source',
115
+ 'model',
116
+ 'session_title',
117
+ 'seconds_since_last_response',
118
+ 'context_tokens',
119
+ 'prompt_cache_likely_expired',
120
+ 'estimated_cache_write_usd',
121
+ ]
122
+ : promptFields;
123
+ object(row, [...common, ...eventFields]);
124
+ const session = string(row['session_id'], 256), cwd = string(row['cwd']), agent = row['agent_id'] === undefined ? null : string(row['agent_id'], 256), promptId = row['prompt_id'] === undefined ? null : string(row['prompt_id'], 256);
125
+ for (const key of ['transcript_path', 'scratchpad_dir', 'agent_type', 'model', 'session_title'])
126
+ if (row[key] !== undefined)
127
+ string(row[key]);
128
+ if (row['permission_mode'] !== undefined &&
129
+ !['default', 'plan', 'acceptEdits', 'auto', 'dontAsk', 'bypassPermissions'].includes(string(row['permission_mode'], 32)))
130
+ fail('Unknown permission mode metadata');
131
+ if (row['effort'] !== undefined) {
132
+ const effort = object(row['effort'], ['level']);
133
+ if (!['low', 'medium', 'high', 'xhigh', 'max'].includes(string(effort['level'], 16)))
134
+ fail('Unknown effort metadata');
135
+ }
136
+ for (const key of ['seconds_since_last_response', 'context_tokens', 'estimated_cache_write_usd'])
137
+ if (row[key] !== undefined &&
138
+ (typeof row[key] !== 'number' ||
139
+ !Number.isFinite(row[key]) ||
140
+ row[key] < 0 ||
141
+ (key === 'context_tokens' && !Number.isSafeInteger(row[key]))))
142
+ fail('Invalid cost metadata');
143
+ if (row['prompt_cache_likely_expired'] !== undefined && typeof row['prompt_cache_likely_expired'] !== 'boolean')
144
+ fail('Invalid cache metadata');
145
+ const source = start ? string(row['source'], 16) : null;
146
+ if (source !== null && !['startup', 'resume', 'clear', 'compact', 'fork'].includes(source))
147
+ fail('Unsupported SessionStart source');
148
+ const prompt = start ? null : string(row['prompt'], profile.maxPromptBytes, true);
149
+ const key = !start && promptId !== null
150
+ ? metadataDigest({
151
+ format: 'ia.lifecycle-input-key.v1',
152
+ profile: profile.digest,
153
+ session,
154
+ agent,
155
+ promptId,
156
+ event,
157
+ })
158
+ : null;
159
+ return frozen({
160
+ format: 'ia.lifecycle-event.v1',
161
+ profile: profile.digest,
162
+ host: profile.host,
163
+ kind: start ? 'start' : 'prompt',
164
+ source: source,
165
+ session,
166
+ agent,
167
+ cwd,
168
+ promptId,
169
+ prompt,
170
+ key,
171
+ inputDigest: metadataDigest(row),
172
+ delivery: 'unconfirmed',
173
+ });
174
+ }
175
+ /** Authenticated native hosts supply their own retained session/profile/attempt, never a coding-host transcript. */
176
+ export function createNativeLifecycleEvent(input) {
177
+ const row = object(input, ['session', 'profile', 'invocation', 'text']), profile = lifecycleProfile('ia-native', '1');
178
+ const session = string(row['session'], 256), agent = string(row['profile'], 256), prompt = string(row['text'], profile.maxPromptBytes, true);
179
+ const promptId = row['invocation'] === null ? null : string(row['invocation'], 256);
180
+ const key = promptId === null
181
+ ? null
182
+ : metadataDigest({
183
+ format: 'ia.lifecycle-input-key.v1',
184
+ profile: profile.digest,
185
+ session,
186
+ agent,
187
+ promptId,
188
+ event: 'NativeContext',
189
+ });
190
+ return frozen({
191
+ format: 'ia.lifecycle-event.v1',
192
+ profile: profile.digest,
193
+ host: profile.host,
194
+ kind: 'native',
195
+ source: null,
196
+ session,
197
+ agent,
198
+ cwd: '',
199
+ promptId,
200
+ prompt,
201
+ key,
202
+ inputDigest: metadataDigest({ session, agent, promptId, prompt }),
203
+ delivery: 'unconfirmed',
204
+ });
205
+ }
206
+ //# sourceMappingURL=lifecycle-profile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-profile.js","sourceRoot":"","sources":["../src/lifecycle-profile.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { LifecycleProfile } from './lifecycle-profile.js';
2
+ /** Each available Claude Code row, keyed by its literal version, and its closed UserPromptSubmit fields. */
3
+ export declare const claudeCodeRows: ReadonlyMap<string, readonly string[]>;
4
+ /**
5
+ * The closed exception to folding a row's field table into its digested profile body. Bindings already written,
6
+ * recorded host evidence and a recorded decision pin these two digests, which predate the fold, so a component test
7
+ * pins their tables instead. Every row added from here folds; never add a version to this set.
8
+ */
9
+ export declare const UNFOLDED_CLAUDE_CODE_ROWS: ReadonlySet<string>;
10
+ /** One host/version profile against a row table. `lifecycleProfile` validates its strings and passes the installed table. */
11
+ export declare function profileFromRows(rows: ReadonlyMap<string, readonly string[]>, host: string, version: string): LifecycleProfile;
12
+ //# sourceMappingURL=lifecycle-rows.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-rows.d.ts","sourceRoot":"","sources":["../src/lifecycle-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,4GAA4G;AAC5G,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAGhE,CAAC;AACH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAC9F,6HAA6H;AAC7H,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,gBAAgB,CAsBlB"}
@@ -0,0 +1,35 @@
1
+ import { frozen, metadataDigest } from './resource-format.js';
2
+ /** Each available Claude Code row, keyed by its literal version, and its closed UserPromptSubmit fields. */
3
+ export const claudeCodeRows = new Map([
4
+ ['2.1.278', ['prompt']],
5
+ ['2.1.285', ['prompt', 'session_title']],
6
+ ]);
7
+ /**
8
+ * The closed exception to folding a row's field table into its digested profile body. Bindings already written,
9
+ * recorded host evidence and a recorded decision pin these two digests, which predate the fold, so a component test
10
+ * pins their tables instead. Every row added from here folds; never add a version to this set.
11
+ */
12
+ export const UNFOLDED_CLAUDE_CODE_ROWS = new Set(['2.1.278', '2.1.285']);
13
+ /** One host/version profile against a row table. `lifecycleProfile` validates its strings and passes the installed table. */
14
+ export function profileFromRows(rows, host, version) {
15
+ const native = host === 'ia-native' && version === '1', fields = host === 'claude-code' ? rows.get(version) : undefined, available = fields !== undefined || native;
16
+ const body = {
17
+ format: 'ia.lifecycle-profile.v1',
18
+ host,
19
+ version,
20
+ available,
21
+ reason: available
22
+ ? null
23
+ : host === 'codex' && version === '0.116.0'
24
+ ? 'Installed Codex 0.116.0 hooks are unavailable: the feature is under development and disabled.'
25
+ : 'This host version has no qualified lifecycle profile.',
26
+ maxContextCharacters: native ? null : 10_000,
27
+ maxContextParts: native ? 1 : 12,
28
+ events: native ? ['NativeContext'] : available ? ['SessionStart', 'UserPromptSubmit'] : [],
29
+ maxInputBytes: 1024 * 1024,
30
+ maxPromptBytes: 256 * 1024,
31
+ ...(fields === undefined || UNFOLDED_CLAUDE_CODE_ROWS.has(version) ? {} : { promptFields: [...fields] }),
32
+ };
33
+ return frozen({ ...body, digest: metadataDigest(body) });
34
+ }
35
+ //# sourceMappingURL=lifecycle-rows.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-rows.js","sourceRoot":"","sources":["../src/lifecycle-rows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE9D,4GAA4G;AAC5G,MAAM,CAAC,MAAM,cAAc,GAA2C,IAAI,GAAG,CAAC;IAC5E,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;CACzC,CAAC,CAAC;AACH;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC9F,6HAA6H;AAC7H,MAAM,UAAU,eAAe,CAC7B,IAA4C,EAC5C,IAAY,EACZ,OAAe;IAEf,MAAM,MAAM,GAAG,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,GAAG,EACpD,MAAM,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,EAC/D,SAAS,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC;IAC7C,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,yBAAkC;QAC1C,IAAI;QACJ,OAAO;QACP,SAAS;QACT,MAAM,EAAE,SAAS;YACf,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,KAAK,SAAS;gBACzC,CAAC,CAAC,+FAA+F;gBACjG,CAAC,CAAC,uDAAuD;QAC7D,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;QAC5C,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1F,aAAa,EAAE,IAAI,GAAG,IAAI;QAC1B,cAAc,EAAE,GAAG,GAAG,IAAI;QAC1B,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;KACzG,CAAC;IACF,OAAO,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,21 @@
1
+ export declare const LIFECYCLE_CONTEXT_SLOTS = 12;
2
+ export declare const LIFECYCLE_CONTEXT_CHARACTERS = 10000;
3
+ export interface LifecycleSegmentOutput {
4
+ readonly hookSpecificOutput: {
5
+ readonly hookEventName: 'SessionStart' | 'UserPromptSubmit';
6
+ readonly additionalContext: string;
7
+ };
8
+ }
9
+ export interface LifecycleFragments {
10
+ readonly outputs: readonly LifecycleSegmentOutput[];
11
+ readonly serialized: string;
12
+ }
13
+ /** Exact deterministic transport only; no view, permission, input or delivery cache. */
14
+ export declare function fragmentLifecycleContext(payload: string): LifecycleFragments;
15
+ /** Verifies an observed complete set, not host acknowledgement or all-or-nothing host enforcement. */
16
+ export declare function assembleLifecycleContextSegments(input: readonly string[]): {
17
+ readonly payload: string;
18
+ readonly id: string;
19
+ readonly delivery: 'unconfirmed';
20
+ };
21
+ //# sourceMappingURL=lifecycle-transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-transport.d.ts","sourceRoot":"","sources":["../src/lifecycle-transport.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,kBAAkB,EAAE;QAC3B,QAAQ,CAAC,aAAa,EAAE,cAAc,GAAG,kBAAkB,CAAC;QAC5D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;KACpC,CAAC;CACH;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAgED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA6C5E;AACD,sGAAsG;AACtG,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC,CA6BA"}
@@ -0,0 +1,127 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { stableSerialize } from '@inventarch/graph';
3
+ import { decodeJson, frozen, metadataDigest } from './resource-format.js';
4
+ import { isSegmentedLifecycleProfile, LifecycleError } from './lifecycle-profile.js';
5
+ export const LIFECYCLE_CONTEXT_SLOTS = 12;
6
+ export const LIFECYCLE_CONTEXT_CHARACTERS = 10_000;
7
+ const digest = (text) => createHash('sha256').update(text).digest('hex');
8
+ const instruction = 'Require all 12 matching slots and complete data; otherwise context is unavailable. Delivery unconfirmed.';
9
+ function fail() {
10
+ throw new LifecycleError('IA-LIFECYCLE-BUDGET', 'Lifecycle segment set exceeds its bound or has missing, mixed or invalid data');
11
+ }
12
+ function object(input) {
13
+ if (input === null || typeof input !== 'object' || Array.isArray(input))
14
+ fail();
15
+ return input;
16
+ }
17
+ function bounded(text, maximum) {
18
+ if (typeof text !== 'string' ||
19
+ text.length > maximum ||
20
+ Buffer.byteLength(text) > 1024 * 1024 ||
21
+ Buffer.from(text).toString('utf8') !== text)
22
+ fail();
23
+ return text;
24
+ }
25
+ function payloadInfo(payload) {
26
+ bounded(payload, 1024 * 1024);
27
+ const decoded = object(decodeJson(payload)), { id, ...body } = decoded, pins = object(body['pins']), event = object(body['event']);
28
+ if (body['format'] !== 'ia.lifecycle-context.v1' ||
29
+ body['delivery'] !== 'unconfirmed' ||
30
+ id !== metadataDigest(body) ||
31
+ !isSegmentedLifecycleProfile(pins['profile']) ||
32
+ !['start', 'prompt'].includes(event['kind']))
33
+ fail();
34
+ if (Object.keys(pins).sort().join(',') !== 'binding,implementation,installation,policy,profile,resources,source,view' ||
35
+ Object.values(pins).some((pin) => pin !== null && (typeof pin !== 'string' || !/^[a-f0-9]{64}$/.test(pin))) ||
36
+ Object.entries(pins).some(([key, pin]) => key !== 'installation' && pin === null))
37
+ fail();
38
+ if (Object.keys(event).sort().join(',') !== 'inputDigest,key,kind,source' ||
39
+ typeof event['inputDigest'] !== 'string' ||
40
+ !/^[a-f0-9]{64}$/.test(event['inputDigest']) ||
41
+ (event['key'] !== null && (typeof event['key'] !== 'string' || !/^[a-f0-9]{64}$/.test(event['key']))))
42
+ fail();
43
+ if (event['kind'] === 'prompt'
44
+ ? event['source'] !== null
45
+ : !['startup', 'resume', 'clear', 'compact', 'fork'].includes(event['source']) || event['key'] !== null)
46
+ fail();
47
+ return {
48
+ id: id,
49
+ pins,
50
+ event,
51
+ hookEventName: event['kind'] === 'start' ? 'SessionStart' : 'UserPromptSubmit',
52
+ };
53
+ }
54
+ /** Exact deterministic transport only; no view, permission, input or delivery cache. */
55
+ export function fragmentLifecycleContext(payload) {
56
+ const info = payloadInfo(payload), totalBytes = Buffer.byteLength(payload), wholeDigest = digest(payload);
57
+ const frame = (slot, count, chunk) => ({
58
+ format: 'ia.lifecycle-context-segment.v1',
59
+ packetId: info.id,
60
+ pins: info.pins,
61
+ event: info.event,
62
+ slot,
63
+ dataCount: count,
64
+ totalSlots: LIFECYCLE_CONTEXT_SLOTS,
65
+ totalBytes,
66
+ wholeDigest,
67
+ chunkDigest: chunk === null ? null : digest(chunk),
68
+ chunk,
69
+ instruction,
70
+ delivery: 'unconfirmed',
71
+ });
72
+ const points = Array.from(payload), chunks = [];
73
+ let offset = 0;
74
+ while (offset < points.length) {
75
+ if (chunks.length >= LIFECYCLE_CONTEXT_SLOTS)
76
+ fail();
77
+ let low = 0, high = Math.min(points.length - offset, LIFECYCLE_CONTEXT_CHARACTERS);
78
+ // Reserve the largest count representation before splitting; boundaries never split a surrogate pair.
79
+ while (low < high) {
80
+ const mid = Math.ceil((low + high) / 2), text = points.slice(offset, offset + mid).join('');
81
+ if (JSON.stringify(frame(chunks.length, LIFECYCLE_CONTEXT_SLOTS, text)).length <= LIFECYCLE_CONTEXT_CHARACTERS)
82
+ low = mid;
83
+ else
84
+ high = mid - 1;
85
+ }
86
+ if (!low)
87
+ fail();
88
+ chunks.push(points.slice(offset, offset + low).join(''));
89
+ offset += low;
90
+ }
91
+ const outputs = Array.from({ length: LIFECYCLE_CONTEXT_SLOTS }, (_, slot) => ({
92
+ hookSpecificOutput: {
93
+ hookEventName: info.hookEventName,
94
+ additionalContext: JSON.stringify(frame(slot, chunks.length, chunks[slot] ?? null)),
95
+ },
96
+ }));
97
+ return frozen({ outputs, serialized: outputs.map((output) => JSON.stringify(output)).join('') });
98
+ }
99
+ /** Verifies an observed complete set, not host acknowledgement or all-or-nothing host enforcement. */
100
+ export function assembleLifecycleContextSegments(input) {
101
+ if (!Array.isArray(input) || input.length !== LIFECYCLE_CONTEXT_SLOTS)
102
+ fail();
103
+ const rows = input.map((text) => object(decodeJson(bounded(text, LIFECYCLE_CONTEXT_CHARACTERS))));
104
+ const slots = new Set();
105
+ let payload = '';
106
+ for (const row of rows) {
107
+ const slot = row['slot'];
108
+ if (!Number.isSafeInteger(slot) ||
109
+ slot < 0 ||
110
+ slot >= LIFECYCLE_CONTEXT_SLOTS ||
111
+ slots.has(slot))
112
+ fail();
113
+ slots.add(slot);
114
+ }
115
+ rows.sort((a, b) => a['slot'] - b['slot']);
116
+ for (const row of rows) {
117
+ if (row['chunk'] !== null)
118
+ payload += bounded(row['chunk'], LIFECYCLE_CONTEXT_CHARACTERS);
119
+ }
120
+ const expected = fragmentLifecycleContext(payload), info = payloadInfo(payload);
121
+ for (let slot = 0; slot < LIFECYCLE_CONTEXT_SLOTS; slot++)
122
+ if (stableSerialize(rows[slot]) !==
123
+ stableSerialize(decodeJson(expected.outputs[slot].hookSpecificOutput.additionalContext)))
124
+ fail();
125
+ return frozen({ payload, id: info.id, delivery: 'unconfirmed' });
126
+ }
127
+ //# sourceMappingURL=lifecycle-transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-transport.js","sourceRoot":"","sources":["../src/lifecycle-transport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,122 @@
1
+ import type { ReadHandle } from '@inventarch/db';
2
+ import type { Tokenizer } from '@inventarch/runtime';
3
+ import type { LifecycleEvent, LifecycleProfile } from './lifecycle-profile.js';
4
+ import type { LifecycleSegmentOutput } from './lifecycle-transport.js';
5
+ export { assembleLifecycleContextSegments, LIFECYCLE_CONTEXT_SLOTS } from './lifecycle-transport.js';
6
+ export interface LifecyclePins {
7
+ readonly binding: string;
8
+ readonly source: string;
9
+ readonly view: string;
10
+ readonly resources: string;
11
+ readonly installation: string | null;
12
+ readonly profile: string;
13
+ readonly policy: string;
14
+ readonly implementation: string;
15
+ }
16
+ export interface ContextPart {
17
+ readonly id: string;
18
+ readonly text: string;
19
+ readonly citations: readonly string[];
20
+ }
21
+ export interface RequiredContextParts {
22
+ readonly pins: LifecyclePins;
23
+ readonly parts: readonly ContextPart[];
24
+ readonly missing: readonly {
25
+ readonly id: string;
26
+ readonly reason: string;
27
+ }[];
28
+ readonly proof: string;
29
+ }
30
+ export interface RequiredPartsInput {
31
+ readonly reader: ReadHandle;
32
+ readonly within: string;
33
+ readonly pins: LifecyclePins;
34
+ readonly coordinate: Readonly<Record<string, string>>;
35
+ }
36
+ export type RequiredParts = (input: RequiredPartsInput) => RequiredContextParts;
37
+ export interface LifecycleBudgets {
38
+ readonly tokens: number;
39
+ readonly records: number;
40
+ readonly bytes: number;
41
+ readonly timeoutMs: number;
42
+ }
43
+ export interface ScopedContextRequest {
44
+ readonly reader: ReadHandle;
45
+ readonly within: string;
46
+ readonly pins: LifecyclePins;
47
+ readonly profile: LifecycleProfile;
48
+ readonly event: LifecycleEvent;
49
+ readonly coordinate: Readonly<Record<string, unknown>>;
50
+ readonly text: string;
51
+ readonly budgets: LifecycleBudgets;
52
+ readonly requiredParts: RequiredParts;
53
+ readonly tokenizer?: Tokenizer;
54
+ /** Reserve mandatory authoring and native blocking material without optional retrieval. */
55
+ readonly optional?: 'include' | 'omit';
56
+ }
57
+ export type LifecycleOutput = {
58
+ readonly hookSpecificOutput: {
59
+ readonly hookEventName: 'SessionStart' | 'UserPromptSubmit';
60
+ readonly additionalContext: string;
61
+ };
62
+ } | {
63
+ readonly format: 'ia.native-context.v1';
64
+ readonly additionalContext: string;
65
+ };
66
+ export interface PreparedContext {
67
+ readonly format: 'ia.prepared-lifecycle-context.v1';
68
+ readonly id: string;
69
+ readonly pins: LifecyclePins;
70
+ readonly payload: string;
71
+ readonly output: LifecycleOutput;
72
+ readonly delivery: 'unconfirmed';
73
+ readonly usage: {
74
+ readonly bytes: number;
75
+ readonly tokens: number;
76
+ readonly records: number;
77
+ readonly estimator: string;
78
+ };
79
+ }
80
+ export interface PreparedContextSegments extends Omit<PreparedContext, 'format' | 'output'> {
81
+ readonly format: 'ia.prepared-lifecycle-context-segments.v1';
82
+ readonly outputs: readonly LifecycleSegmentOutput[];
83
+ }
84
+ export interface LifecycleView {
85
+ readonly reader: ReadHandle;
86
+ readonly within: string;
87
+ readonly pins: LifecyclePins;
88
+ readonly requiredParts: RequiredParts;
89
+ close(): void;
90
+ }
91
+ export interface LifecycleBinding {
92
+ readonly profile: LifecycleProfile;
93
+ readonly coordinate: Readonly<Record<string, unknown>>;
94
+ readonly bootstrap: string;
95
+ readonly budgets: LifecycleBudgets;
96
+ readonly binding: string;
97
+ readonly policy: string;
98
+ readonly implementation: string;
99
+ }
100
+ export interface LifecycleHost {
101
+ openCurrentView(binding: LifecycleBinding, event: LifecycleEvent, signal: AbortSignal): Promise<LifecycleView>;
102
+ assertCurrent(view: LifecycleView, binding: LifecycleBinding, signal: AbortSignal): void | Promise<void>;
103
+ /** Optional explicitly retained stream admission. It must compare content on replay and never assert stdout delivery. */
104
+ acceptInput?(identity: LifecycleInputIdentity, signal: AbortSignal): void | Promise<void>;
105
+ readonly now?: () => number;
106
+ }
107
+ export interface LifecycleInputIdentity {
108
+ readonly binding: string;
109
+ readonly key: string | null;
110
+ readonly inputDigest: string;
111
+ }
112
+ /** Pure selection over the caller-owned admitted view; never discovers resources or paths. */
113
+ export declare function prepareScopedContext(input: ScopedContextRequest): PreparedContext;
114
+ export declare function prepareScopedContextSegments(input: ScopedContextRequest): PreparedContextSegments;
115
+ /** The returned JSON is generated/unconfirmed. A stdout write is not host acknowledgement. */
116
+ export declare function serializeLifecycleContext(prepared: PreparedContext): LifecycleOutput;
117
+ /** Namespace the host event under the trusted registration; transcript paths supply no store identity. */
118
+ export declare function lifecycleInputIdentity(binding: string, event: LifecycleEvent): LifecycleInputIdentity;
119
+ /** Opens every bootstrap/prompt afresh; the host decides whether that view is live or retained. */
120
+ export declare function prepareLifecycleContext(input: LifecycleBinding, inputEvent: LifecycleEvent, host: LifecycleHost, caller?: AbortSignal): Promise<PreparedContext>;
121
+ export declare function prepareLifecycleContextSegments(input: LifecycleBinding, inputEvent: LifecycleEvent, host: LifecycleHost, caller?: AbortSignal): Promise<PreparedContextSegments>;
122
+ //# sourceMappingURL=lifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAErG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AACD,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,oBAAoB,CAAC;AAChF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CACxC;AACD,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,kBAAkB,EAAE;QAC3B,QAAQ,CAAC,aAAa,EAAE,cAAc,GAAG,kBAAkB,CAAC;QAC5D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;KACpC,CAAC;CACH,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,kCAAkC,CAAC;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AACD,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACzF,QAAQ,CAAC,MAAM,EAAE,2CAA2C,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACrD;AACD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/G,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzG,yHAAyH;IACzH,WAAW,CAAC,CAAC,QAAQ,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AACD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAkMD,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAEjF;AACD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,uBAAuB,CAEjG;AAgID,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAEpF;AAED,0GAA0G;AAC1G,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,sBAAsB,CASrG;AAmCD,mGAAmG;AACnG,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAE1B;AACD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAElC"}