snipara-companion 3.6.9 → 3.6.11
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/CHANGELOG.md +15 -0
- package/README.md +11 -4
- package/dist/index.d.ts +239 -227
- package/dist/index.js +1193 -1057
- package/docs/FULL_REFERENCE.md +14 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
Release notes for `snipara-companion`, newest first.
|
|
4
4
|
|
|
5
|
+
## New In 3.6.11
|
|
6
|
+
|
|
7
|
+
- Adds Snipara-specific lead, code, review, and security role adapters for
|
|
8
|
+
isolated Agent Context retrieval.
|
|
9
|
+
- Scopes the AC-1 evidence status gate to the current manifest hash and reports
|
|
10
|
+
historical receipts excluded from the current readiness calculation.
|
|
11
|
+
|
|
12
|
+
## New In 3.6.10
|
|
13
|
+
|
|
14
|
+
- Captures rationale-shaped messages from verified standalone commits through
|
|
15
|
+
Why Capture, carrying commit SHA and changed-file provenance while keeping
|
|
16
|
+
candidates pending human review.
|
|
17
|
+
- Skips automatic commit capture during managed workflows so phase/final
|
|
18
|
+
rationale is not duplicated.
|
|
19
|
+
|
|
5
20
|
## New In 3.6.9
|
|
6
21
|
|
|
7
22
|
- Auto-accepts only `info` and `watch` Advisor recommendations in managed
|
package/README.md
CHANGED
|
@@ -164,9 +164,10 @@ snipara-companion agent-context evidence status --enforce
|
|
|
164
164
|
|
|
165
165
|
Receipts are appended to `.snipara/agent-context/evidence.jsonl`, linked to the
|
|
166
166
|
manifest hash, and rejected if they claim a source, recall, or promotion target
|
|
167
|
-
outside the resolved policy.
|
|
168
|
-
|
|
169
|
-
|
|
167
|
+
outside the resolved policy. The status gate evaluates only receipts linked to
|
|
168
|
+
the current manifest hash and reports older receipts as excluded. `--enforce`
|
|
169
|
+
stays non-zero until the documented AC-1 exit gate is met; it does not authorize
|
|
170
|
+
a hosted compiler or memory promotion workflow.
|
|
170
171
|
|
|
171
172
|
### Context Control
|
|
172
173
|
|
|
@@ -346,7 +347,8 @@ resume with the current phase, recent handoffs, timeline, context packs, and
|
|
|
346
347
|
verification hints.
|
|
347
348
|
|
|
348
349
|
`workflow timeline` reads the append-only activity log at
|
|
349
|
-
`.snipara/activity/timeline.jsonl
|
|
350
|
+
`.snipara/activity/timeline.jsonl`, including privacy-safe PostToolUse outcomes
|
|
351
|
+
and file evidence when the Companion hook is installed. `workflow session` derives
|
|
350
352
|
`.snipara/activity/session.json` for fast local resume and Orchestrator dogfood;
|
|
351
353
|
Session Snapshot V0 includes latest activity, risk reasons, touched files, a
|
|
352
354
|
next action, and advisory Intent Detection V0. Intent Detection V0 reports the
|
|
@@ -505,3 +507,8 @@ Capture failures stay visible but do not block the primary workflow command. No
|
|
|
505
507
|
documentation prompt is shown. `final-commit` remains handoff-only: the report
|
|
506
508
|
explains what was stored or proposed, but it does not itself approve canonical
|
|
507
509
|
decision drafts or write final summary text as durable memory.
|
|
510
|
+
After a verified `git commit`, `git revert`, or `git cherry-pick` result, the
|
|
511
|
+
PostToolUse hook runs the same preview-then-confirm flow when no managed
|
|
512
|
+
workflow is active. It submits the commit message, commit SHA, and changed-file
|
|
513
|
+
evidence as `sourceKind=commit`; ordinary messages produce no candidate, and
|
|
514
|
+
any captured rationale remains pending human review.
|
package/dist/index.d.ts
CHANGED
|
@@ -23,199 +23,6 @@ declare function buildCommitResultMetadata(options: {
|
|
|
23
23
|
};
|
|
24
24
|
declare function extractFilesFromToolInput(toolInput?: string): string[];
|
|
25
25
|
|
|
26
|
-
type ContextPackKind = "tool_output" | "log" | "diff" | "file" | "text" | "note";
|
|
27
|
-
interface ContextPackRecord {
|
|
28
|
-
version: "snipara.context_pack.v1";
|
|
29
|
-
id: string;
|
|
30
|
-
createdAt: string;
|
|
31
|
-
updatedAt: string;
|
|
32
|
-
kind: ContextPackKind;
|
|
33
|
-
label: string | null;
|
|
34
|
-
source: string | null;
|
|
35
|
-
tags: string[];
|
|
36
|
-
repoRoot: string;
|
|
37
|
-
sha256: string;
|
|
38
|
-
bytes: number;
|
|
39
|
-
lineCount: number;
|
|
40
|
-
contentType: "text/plain";
|
|
41
|
-
contentEncoding: "utf8";
|
|
42
|
-
preview: string;
|
|
43
|
-
expiresAt: string | null;
|
|
44
|
-
sensitive: boolean;
|
|
45
|
-
warnings: Array<{
|
|
46
|
-
code: string;
|
|
47
|
-
message: string;
|
|
48
|
-
}>;
|
|
49
|
-
storage: {
|
|
50
|
-
baseRelativePath: string;
|
|
51
|
-
manifestRelativePath: string;
|
|
52
|
-
blobRelativePath: string;
|
|
53
|
-
};
|
|
54
|
-
}
|
|
55
|
-
interface PackContextOptions {
|
|
56
|
-
cwd?: string;
|
|
57
|
-
content: string;
|
|
58
|
-
label?: string;
|
|
59
|
-
source?: string;
|
|
60
|
-
kind?: string;
|
|
61
|
-
tags?: string[];
|
|
62
|
-
ttlDays?: number;
|
|
63
|
-
maxBytes?: number;
|
|
64
|
-
allowSensitive?: boolean;
|
|
65
|
-
now?: Date;
|
|
66
|
-
}
|
|
67
|
-
interface ContextPackPackCommandOptions {
|
|
68
|
-
cwd?: string;
|
|
69
|
-
text?: string;
|
|
70
|
-
file?: string;
|
|
71
|
-
input?: string;
|
|
72
|
-
label?: string;
|
|
73
|
-
source?: string;
|
|
74
|
-
kind?: string;
|
|
75
|
-
tags?: string[];
|
|
76
|
-
ttlDays?: number;
|
|
77
|
-
maxBytes?: number;
|
|
78
|
-
allowSensitive?: boolean;
|
|
79
|
-
json?: boolean;
|
|
80
|
-
}
|
|
81
|
-
interface ContextPackRetrieveCommandOptions {
|
|
82
|
-
cwd?: string;
|
|
83
|
-
output?: string;
|
|
84
|
-
metadataOnly?: boolean;
|
|
85
|
-
json?: boolean;
|
|
86
|
-
}
|
|
87
|
-
interface ContextPackStatsCommandOptions {
|
|
88
|
-
cwd?: string;
|
|
89
|
-
json?: boolean;
|
|
90
|
-
}
|
|
91
|
-
interface ContextPackCleanCommandOptions {
|
|
92
|
-
cwd?: string;
|
|
93
|
-
all?: boolean;
|
|
94
|
-
expired?: boolean;
|
|
95
|
-
olderThanDays?: number;
|
|
96
|
-
dryRun?: boolean;
|
|
97
|
-
json?: boolean;
|
|
98
|
-
now?: Date;
|
|
99
|
-
}
|
|
100
|
-
interface ContextPackStoragePaths {
|
|
101
|
-
repoRoot: string;
|
|
102
|
-
baseDir: string;
|
|
103
|
-
blobsDir: string;
|
|
104
|
-
manifestsDir: string;
|
|
105
|
-
latestPath: string;
|
|
106
|
-
}
|
|
107
|
-
interface PackContextResult {
|
|
108
|
-
record: ContextPackRecord;
|
|
109
|
-
created: boolean;
|
|
110
|
-
baseDir: string;
|
|
111
|
-
manifestPath: string;
|
|
112
|
-
blobPath: string;
|
|
113
|
-
}
|
|
114
|
-
interface RetrieveContextPackResult {
|
|
115
|
-
record: ContextPackRecord;
|
|
116
|
-
content: string;
|
|
117
|
-
baseDir: string;
|
|
118
|
-
manifestPath: string;
|
|
119
|
-
blobPath: string;
|
|
120
|
-
}
|
|
121
|
-
interface ContextPackStats {
|
|
122
|
-
version: "snipara.context_pack.stats.v1";
|
|
123
|
-
baseDir: string;
|
|
124
|
-
totalPacks: number;
|
|
125
|
-
totalBytes: number;
|
|
126
|
-
sensitivePacks: number;
|
|
127
|
-
expiredPacks: number;
|
|
128
|
-
kinds: Record<string, number>;
|
|
129
|
-
oldestCreatedAt: string | null;
|
|
130
|
-
newestCreatedAt: string | null;
|
|
131
|
-
latestId: string | null;
|
|
132
|
-
}
|
|
133
|
-
interface ContextPackCleanResult {
|
|
134
|
-
version: "snipara.context_pack.clean.v1";
|
|
135
|
-
baseDir: string;
|
|
136
|
-
dryRun: boolean;
|
|
137
|
-
selected: number;
|
|
138
|
-
deleted: number;
|
|
139
|
-
deletedIds: string[];
|
|
140
|
-
}
|
|
141
|
-
declare function getContextPackStoragePaths(cwd?: string): ContextPackStoragePaths;
|
|
142
|
-
declare function packContext(options: PackContextOptions): PackContextResult;
|
|
143
|
-
declare function resolveContextPackRecord(idOrRef: string, cwd?: string): {
|
|
144
|
-
paths: ContextPackStoragePaths;
|
|
145
|
-
record: ContextPackRecord;
|
|
146
|
-
manifestPath: string;
|
|
147
|
-
};
|
|
148
|
-
declare function retrieveContextPack(idOrRef: string, cwd?: string): RetrieveContextPackResult;
|
|
149
|
-
declare function buildContextPackStats(options?: ContextPackStatsCommandOptions): ContextPackStats;
|
|
150
|
-
declare function cleanContextPacks(options?: ContextPackCleanCommandOptions): ContextPackCleanResult;
|
|
151
|
-
declare function contextPackPackCommand(options: ContextPackPackCommandOptions): Promise<void>;
|
|
152
|
-
declare function contextPackRetrieveCommand(idOrRef: string, options?: ContextPackRetrieveCommandOptions): Promise<void>;
|
|
153
|
-
declare function contextPackStatsCommand(options?: ContextPackStatsCommandOptions): Promise<void>;
|
|
154
|
-
declare function contextPackCleanCommand(options?: ContextPackCleanCommandOptions): Promise<void>;
|
|
155
|
-
|
|
156
|
-
type PrivacyLevel = "standard" | "sensitive" | "restricted";
|
|
157
|
-
type CanonicalEventType = "session_start" | "session_end" | "compact" | "message_user" | "message_assistant" | "tool_call" | "tool_result" | "file_changed" | "error_observed";
|
|
158
|
-
interface CanonicalEventOptions {
|
|
159
|
-
eventType: CanonicalEventType;
|
|
160
|
-
client?: string;
|
|
161
|
-
workspace?: string;
|
|
162
|
-
sessionId?: string;
|
|
163
|
-
agentId?: string;
|
|
164
|
-
privacyLevel?: PrivacyLevel;
|
|
165
|
-
payload?: Record<string, unknown>;
|
|
166
|
-
contextPackReceipts?: LocalContextPackReceiptPayload[];
|
|
167
|
-
}
|
|
168
|
-
type LocalContextPackReceiptOperation = "pack" | "retrieve" | "reference";
|
|
169
|
-
interface LocalContextPackReceiptPayload {
|
|
170
|
-
version: "snipara.context_pack.receipt.v1";
|
|
171
|
-
receipt_id: string;
|
|
172
|
-
pack_id: string;
|
|
173
|
-
operation: LocalContextPackReceiptOperation;
|
|
174
|
-
content_uploaded: false;
|
|
175
|
-
policy_decision: "local_only" | "blocked" | "metadata_only";
|
|
176
|
-
privacy_level: PrivacyLevel;
|
|
177
|
-
kind: ContextPackRecord["kind"];
|
|
178
|
-
label?: string | null;
|
|
179
|
-
source?: string | null;
|
|
180
|
-
tags: string[];
|
|
181
|
-
bytes: number;
|
|
182
|
-
line_count: number;
|
|
183
|
-
baseline_tokens?: number;
|
|
184
|
-
packed_tokens?: number;
|
|
185
|
-
retrieved_tokens?: number;
|
|
186
|
-
saved_tokens?: number;
|
|
187
|
-
payload_digest?: string;
|
|
188
|
-
sensitive: boolean;
|
|
189
|
-
created_at: string;
|
|
190
|
-
expires_at?: string | null;
|
|
191
|
-
local_ref: {
|
|
192
|
-
base_relative_path: string;
|
|
193
|
-
manifest_relative_path: string;
|
|
194
|
-
};
|
|
195
|
-
}
|
|
196
|
-
declare function buildLocalContextPackReceipt(record: ContextPackRecord, options?: {
|
|
197
|
-
operation?: LocalContextPackReceiptOperation;
|
|
198
|
-
privacyLevel?: PrivacyLevel;
|
|
199
|
-
policyDecision?: LocalContextPackReceiptPayload["policy_decision"];
|
|
200
|
-
}): LocalContextPackReceiptPayload;
|
|
201
|
-
declare function buildLocalContextPackReceipts(options: {
|
|
202
|
-
ids: string[];
|
|
203
|
-
cwd?: string;
|
|
204
|
-
operation?: LocalContextPackReceiptOperation;
|
|
205
|
-
privacyLevel?: PrivacyLevel;
|
|
206
|
-
}): LocalContextPackReceiptPayload[];
|
|
207
|
-
declare function attachLocalContextPackReceipts(payload: Record<string, unknown>, receipts: LocalContextPackReceiptPayload[]): Record<string, unknown>;
|
|
208
|
-
declare function buildCanonicalEvent(options: CanonicalEventOptions): {
|
|
209
|
-
type: CanonicalEventType;
|
|
210
|
-
client: string;
|
|
211
|
-
workspace: string;
|
|
212
|
-
session_id: string;
|
|
213
|
-
agent_id: string;
|
|
214
|
-
timestamp: string;
|
|
215
|
-
privacy_level: PrivacyLevel;
|
|
216
|
-
payload: Record<string, unknown>;
|
|
217
|
-
};
|
|
218
|
-
|
|
219
26
|
interface RLMConfig {
|
|
220
27
|
apiKey?: string;
|
|
221
28
|
projectId?: string;
|
|
@@ -478,7 +285,7 @@ interface SessionPersistResult {
|
|
|
478
285
|
session_id: string;
|
|
479
286
|
files_tracked: number;
|
|
480
287
|
}
|
|
481
|
-
type WhyCaptureSourceKind = "phase_commit" | "final_commit" | "handoff";
|
|
288
|
+
type WhyCaptureSourceKind = "commit" | "phase_commit" | "final_commit" | "handoff";
|
|
482
289
|
interface WhyCaptureInput {
|
|
483
290
|
decision?: string;
|
|
484
291
|
why?: string;
|
|
@@ -1565,6 +1372,242 @@ declare function listProjectsForApiKey(apiKey: string, apiUrl?: string, timeout?
|
|
|
1565
1372
|
*/
|
|
1566
1373
|
declare function createClient(timeout?: number, options?: ConfigResolutionOptions): RLMClient;
|
|
1567
1374
|
|
|
1375
|
+
interface CompanionWhyCaptureCandidate {
|
|
1376
|
+
text: string;
|
|
1377
|
+
type?: string;
|
|
1378
|
+
category?: string;
|
|
1379
|
+
decision?: string;
|
|
1380
|
+
rationale?: string;
|
|
1381
|
+
}
|
|
1382
|
+
interface CompanionWhyCaptureMemory {
|
|
1383
|
+
memoryId?: string;
|
|
1384
|
+
text: string;
|
|
1385
|
+
type?: string;
|
|
1386
|
+
category?: string;
|
|
1387
|
+
reviewStatus?: string;
|
|
1388
|
+
}
|
|
1389
|
+
interface CompanionWhyCaptureIssue {
|
|
1390
|
+
text: string;
|
|
1391
|
+
reason?: string;
|
|
1392
|
+
}
|
|
1393
|
+
interface CompanionWhyCaptureReceipt {
|
|
1394
|
+
status: "captured" | "no_candidates" | "skipped" | "error";
|
|
1395
|
+
sourceKind: WhyCaptureSourceKind;
|
|
1396
|
+
previewCandidateCount: number;
|
|
1397
|
+
capturedCount: number;
|
|
1398
|
+
previewCandidates: CompanionWhyCaptureCandidate[];
|
|
1399
|
+
pendingMemories: CompanionWhyCaptureMemory[];
|
|
1400
|
+
duplicates: CompanionWhyCaptureIssue[];
|
|
1401
|
+
failed: CompanionWhyCaptureIssue[];
|
|
1402
|
+
commitSha?: string;
|
|
1403
|
+
error?: string;
|
|
1404
|
+
}
|
|
1405
|
+
interface StandaloneCommitEvidence {
|
|
1406
|
+
commitSha: string;
|
|
1407
|
+
summary: string;
|
|
1408
|
+
files: string[];
|
|
1409
|
+
}
|
|
1410
|
+
declare function hasActiveManagedWorkflow(cwd: string): boolean;
|
|
1411
|
+
declare function readStandaloneCommitEvidence(cwd: string, commitSha: string, additionalFiles?: string[]): StandaloneCommitEvidence | undefined;
|
|
1412
|
+
declare function captureStandaloneCommitWhy(input: {
|
|
1413
|
+
cwd: string;
|
|
1414
|
+
commitSha: string;
|
|
1415
|
+
files?: string[];
|
|
1416
|
+
}): Promise<CompanionWhyCaptureReceipt>;
|
|
1417
|
+
|
|
1418
|
+
type ContextPackKind = "tool_output" | "log" | "diff" | "file" | "text" | "note";
|
|
1419
|
+
interface ContextPackRecord {
|
|
1420
|
+
version: "snipara.context_pack.v1";
|
|
1421
|
+
id: string;
|
|
1422
|
+
createdAt: string;
|
|
1423
|
+
updatedAt: string;
|
|
1424
|
+
kind: ContextPackKind;
|
|
1425
|
+
label: string | null;
|
|
1426
|
+
source: string | null;
|
|
1427
|
+
tags: string[];
|
|
1428
|
+
repoRoot: string;
|
|
1429
|
+
sha256: string;
|
|
1430
|
+
bytes: number;
|
|
1431
|
+
lineCount: number;
|
|
1432
|
+
contentType: "text/plain";
|
|
1433
|
+
contentEncoding: "utf8";
|
|
1434
|
+
preview: string;
|
|
1435
|
+
expiresAt: string | null;
|
|
1436
|
+
sensitive: boolean;
|
|
1437
|
+
warnings: Array<{
|
|
1438
|
+
code: string;
|
|
1439
|
+
message: string;
|
|
1440
|
+
}>;
|
|
1441
|
+
storage: {
|
|
1442
|
+
baseRelativePath: string;
|
|
1443
|
+
manifestRelativePath: string;
|
|
1444
|
+
blobRelativePath: string;
|
|
1445
|
+
};
|
|
1446
|
+
}
|
|
1447
|
+
interface PackContextOptions {
|
|
1448
|
+
cwd?: string;
|
|
1449
|
+
content: string;
|
|
1450
|
+
label?: string;
|
|
1451
|
+
source?: string;
|
|
1452
|
+
kind?: string;
|
|
1453
|
+
tags?: string[];
|
|
1454
|
+
ttlDays?: number;
|
|
1455
|
+
maxBytes?: number;
|
|
1456
|
+
allowSensitive?: boolean;
|
|
1457
|
+
now?: Date;
|
|
1458
|
+
}
|
|
1459
|
+
interface ContextPackPackCommandOptions {
|
|
1460
|
+
cwd?: string;
|
|
1461
|
+
text?: string;
|
|
1462
|
+
file?: string;
|
|
1463
|
+
input?: string;
|
|
1464
|
+
label?: string;
|
|
1465
|
+
source?: string;
|
|
1466
|
+
kind?: string;
|
|
1467
|
+
tags?: string[];
|
|
1468
|
+
ttlDays?: number;
|
|
1469
|
+
maxBytes?: number;
|
|
1470
|
+
allowSensitive?: boolean;
|
|
1471
|
+
json?: boolean;
|
|
1472
|
+
}
|
|
1473
|
+
interface ContextPackRetrieveCommandOptions {
|
|
1474
|
+
cwd?: string;
|
|
1475
|
+
output?: string;
|
|
1476
|
+
metadataOnly?: boolean;
|
|
1477
|
+
json?: boolean;
|
|
1478
|
+
}
|
|
1479
|
+
interface ContextPackStatsCommandOptions {
|
|
1480
|
+
cwd?: string;
|
|
1481
|
+
json?: boolean;
|
|
1482
|
+
}
|
|
1483
|
+
interface ContextPackCleanCommandOptions {
|
|
1484
|
+
cwd?: string;
|
|
1485
|
+
all?: boolean;
|
|
1486
|
+
expired?: boolean;
|
|
1487
|
+
olderThanDays?: number;
|
|
1488
|
+
dryRun?: boolean;
|
|
1489
|
+
json?: boolean;
|
|
1490
|
+
now?: Date;
|
|
1491
|
+
}
|
|
1492
|
+
interface ContextPackStoragePaths {
|
|
1493
|
+
repoRoot: string;
|
|
1494
|
+
baseDir: string;
|
|
1495
|
+
blobsDir: string;
|
|
1496
|
+
manifestsDir: string;
|
|
1497
|
+
latestPath: string;
|
|
1498
|
+
}
|
|
1499
|
+
interface PackContextResult {
|
|
1500
|
+
record: ContextPackRecord;
|
|
1501
|
+
created: boolean;
|
|
1502
|
+
baseDir: string;
|
|
1503
|
+
manifestPath: string;
|
|
1504
|
+
blobPath: string;
|
|
1505
|
+
}
|
|
1506
|
+
interface RetrieveContextPackResult {
|
|
1507
|
+
record: ContextPackRecord;
|
|
1508
|
+
content: string;
|
|
1509
|
+
baseDir: string;
|
|
1510
|
+
manifestPath: string;
|
|
1511
|
+
blobPath: string;
|
|
1512
|
+
}
|
|
1513
|
+
interface ContextPackStats {
|
|
1514
|
+
version: "snipara.context_pack.stats.v1";
|
|
1515
|
+
baseDir: string;
|
|
1516
|
+
totalPacks: number;
|
|
1517
|
+
totalBytes: number;
|
|
1518
|
+
sensitivePacks: number;
|
|
1519
|
+
expiredPacks: number;
|
|
1520
|
+
kinds: Record<string, number>;
|
|
1521
|
+
oldestCreatedAt: string | null;
|
|
1522
|
+
newestCreatedAt: string | null;
|
|
1523
|
+
latestId: string | null;
|
|
1524
|
+
}
|
|
1525
|
+
interface ContextPackCleanResult {
|
|
1526
|
+
version: "snipara.context_pack.clean.v1";
|
|
1527
|
+
baseDir: string;
|
|
1528
|
+
dryRun: boolean;
|
|
1529
|
+
selected: number;
|
|
1530
|
+
deleted: number;
|
|
1531
|
+
deletedIds: string[];
|
|
1532
|
+
}
|
|
1533
|
+
declare function getContextPackStoragePaths(cwd?: string): ContextPackStoragePaths;
|
|
1534
|
+
declare function packContext(options: PackContextOptions): PackContextResult;
|
|
1535
|
+
declare function resolveContextPackRecord(idOrRef: string, cwd?: string): {
|
|
1536
|
+
paths: ContextPackStoragePaths;
|
|
1537
|
+
record: ContextPackRecord;
|
|
1538
|
+
manifestPath: string;
|
|
1539
|
+
};
|
|
1540
|
+
declare function retrieveContextPack(idOrRef: string, cwd?: string): RetrieveContextPackResult;
|
|
1541
|
+
declare function buildContextPackStats(options?: ContextPackStatsCommandOptions): ContextPackStats;
|
|
1542
|
+
declare function cleanContextPacks(options?: ContextPackCleanCommandOptions): ContextPackCleanResult;
|
|
1543
|
+
declare function contextPackPackCommand(options: ContextPackPackCommandOptions): Promise<void>;
|
|
1544
|
+
declare function contextPackRetrieveCommand(idOrRef: string, options?: ContextPackRetrieveCommandOptions): Promise<void>;
|
|
1545
|
+
declare function contextPackStatsCommand(options?: ContextPackStatsCommandOptions): Promise<void>;
|
|
1546
|
+
declare function contextPackCleanCommand(options?: ContextPackCleanCommandOptions): Promise<void>;
|
|
1547
|
+
|
|
1548
|
+
type PrivacyLevel = "standard" | "sensitive" | "restricted";
|
|
1549
|
+
type CanonicalEventType = "session_start" | "session_end" | "compact" | "message_user" | "message_assistant" | "tool_call" | "tool_result" | "file_changed" | "error_observed";
|
|
1550
|
+
interface CanonicalEventOptions {
|
|
1551
|
+
eventType: CanonicalEventType;
|
|
1552
|
+
client?: string;
|
|
1553
|
+
workspace?: string;
|
|
1554
|
+
sessionId?: string;
|
|
1555
|
+
agentId?: string;
|
|
1556
|
+
privacyLevel?: PrivacyLevel;
|
|
1557
|
+
payload?: Record<string, unknown>;
|
|
1558
|
+
contextPackReceipts?: LocalContextPackReceiptPayload[];
|
|
1559
|
+
}
|
|
1560
|
+
type LocalContextPackReceiptOperation = "pack" | "retrieve" | "reference";
|
|
1561
|
+
interface LocalContextPackReceiptPayload {
|
|
1562
|
+
version: "snipara.context_pack.receipt.v1";
|
|
1563
|
+
receipt_id: string;
|
|
1564
|
+
pack_id: string;
|
|
1565
|
+
operation: LocalContextPackReceiptOperation;
|
|
1566
|
+
content_uploaded: false;
|
|
1567
|
+
policy_decision: "local_only" | "blocked" | "metadata_only";
|
|
1568
|
+
privacy_level: PrivacyLevel;
|
|
1569
|
+
kind: ContextPackRecord["kind"];
|
|
1570
|
+
label?: string | null;
|
|
1571
|
+
source?: string | null;
|
|
1572
|
+
tags: string[];
|
|
1573
|
+
bytes: number;
|
|
1574
|
+
line_count: number;
|
|
1575
|
+
baseline_tokens?: number;
|
|
1576
|
+
packed_tokens?: number;
|
|
1577
|
+
retrieved_tokens?: number;
|
|
1578
|
+
saved_tokens?: number;
|
|
1579
|
+
payload_digest?: string;
|
|
1580
|
+
sensitive: boolean;
|
|
1581
|
+
created_at: string;
|
|
1582
|
+
expires_at?: string | null;
|
|
1583
|
+
local_ref: {
|
|
1584
|
+
base_relative_path: string;
|
|
1585
|
+
manifest_relative_path: string;
|
|
1586
|
+
};
|
|
1587
|
+
}
|
|
1588
|
+
declare function buildLocalContextPackReceipt(record: ContextPackRecord, options?: {
|
|
1589
|
+
operation?: LocalContextPackReceiptOperation;
|
|
1590
|
+
privacyLevel?: PrivacyLevel;
|
|
1591
|
+
policyDecision?: LocalContextPackReceiptPayload["policy_decision"];
|
|
1592
|
+
}): LocalContextPackReceiptPayload;
|
|
1593
|
+
declare function buildLocalContextPackReceipts(options: {
|
|
1594
|
+
ids: string[];
|
|
1595
|
+
cwd?: string;
|
|
1596
|
+
operation?: LocalContextPackReceiptOperation;
|
|
1597
|
+
privacyLevel?: PrivacyLevel;
|
|
1598
|
+
}): LocalContextPackReceiptPayload[];
|
|
1599
|
+
declare function attachLocalContextPackReceipts(payload: Record<string, unknown>, receipts: LocalContextPackReceiptPayload[]): Record<string, unknown>;
|
|
1600
|
+
declare function buildCanonicalEvent(options: CanonicalEventOptions): {
|
|
1601
|
+
type: CanonicalEventType;
|
|
1602
|
+
client: string;
|
|
1603
|
+
workspace: string;
|
|
1604
|
+
session_id: string;
|
|
1605
|
+
agent_id: string;
|
|
1606
|
+
timestamp: string;
|
|
1607
|
+
privacy_level: PrivacyLevel;
|
|
1608
|
+
payload: Record<string, unknown>;
|
|
1609
|
+
};
|
|
1610
|
+
|
|
1568
1611
|
type ToolResultClassification = "success" | "failure" | "empty_result" | "timeout";
|
|
1569
1612
|
interface ToolResultPayloadOptions {
|
|
1570
1613
|
tool?: string;
|
|
@@ -1699,7 +1742,7 @@ declare function runMemoryGuardCheck(options?: MemoryGuardCheckOptions): Promise
|
|
|
1699
1742
|
|
|
1700
1743
|
declare const ACTIVITY_TIMELINE_VERSION: "snipara.activity_timeline.v0";
|
|
1701
1744
|
declare const SESSION_SNAPSHOT_VERSION: "snipara.session_snapshot.v0";
|
|
1702
|
-
type ActivityEventSource = "workflow" | "team-sync" | "decision" | "producer-loop" | "journal" | "orchestrator";
|
|
1745
|
+
type ActivityEventSource = "workflow" | "tool" | "team-sync" | "decision" | "producer-loop" | "journal" | "orchestrator";
|
|
1703
1746
|
interface ActivityTimelineEvent {
|
|
1704
1747
|
schemaVersion: typeof ACTIVITY_TIMELINE_VERSION;
|
|
1705
1748
|
eventId: string;
|
|
@@ -3921,37 +3964,6 @@ declare function getTeamSyncStatePath(rootDir?: string): string;
|
|
|
3921
3964
|
declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
|
|
3922
3965
|
declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
|
|
3923
3966
|
|
|
3924
|
-
interface CompanionWhyCaptureCandidate {
|
|
3925
|
-
text: string;
|
|
3926
|
-
type?: string;
|
|
3927
|
-
category?: string;
|
|
3928
|
-
decision?: string;
|
|
3929
|
-
rationale?: string;
|
|
3930
|
-
}
|
|
3931
|
-
interface CompanionWhyCaptureMemory {
|
|
3932
|
-
memoryId?: string;
|
|
3933
|
-
text: string;
|
|
3934
|
-
type?: string;
|
|
3935
|
-
category?: string;
|
|
3936
|
-
reviewStatus?: string;
|
|
3937
|
-
}
|
|
3938
|
-
interface CompanionWhyCaptureIssue {
|
|
3939
|
-
text: string;
|
|
3940
|
-
reason?: string;
|
|
3941
|
-
}
|
|
3942
|
-
interface CompanionWhyCaptureReceipt {
|
|
3943
|
-
status: "captured" | "no_candidates" | "skipped" | "error";
|
|
3944
|
-
sourceKind: WhyCaptureSourceKind;
|
|
3945
|
-
previewCandidateCount: number;
|
|
3946
|
-
capturedCount: number;
|
|
3947
|
-
previewCandidates: CompanionWhyCaptureCandidate[];
|
|
3948
|
-
pendingMemories: CompanionWhyCaptureMemory[];
|
|
3949
|
-
duplicates: CompanionWhyCaptureIssue[];
|
|
3950
|
-
failed: CompanionWhyCaptureIssue[];
|
|
3951
|
-
commitSha?: string;
|
|
3952
|
-
error?: string;
|
|
3953
|
-
}
|
|
3954
|
-
|
|
3955
3967
|
declare const FINAL_COMMIT_REPORT_VERSION: "snipara.final_commit_report.v1";
|
|
3956
3968
|
declare const FINAL_COMMIT_REPORT_RELATIVE_PATH: string;
|
|
3957
3969
|
type FinalCommitOutcome = "completed" | "partial" | "blocked" | "abandoned";
|
|
@@ -5268,4 +5280,4 @@ declare function installAutomationBundle(args: {
|
|
|
5268
5280
|
}): Promise<AutomationInstallResult>;
|
|
5269
5281
|
declare function getAutomationStatus(projectDir?: string): AutomationStatusResult;
|
|
5270
5282
|
|
|
5271
|
-
export { AGENT_CONTEXT_EVIDENCE_DEFAULT_LEDGER, AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, FINAL_COMMIT_REPORT_RELATIVE_PATH, FINAL_COMMIT_REPORT_VERSION, MEMORY_GUARD_CONTEXT_TIMEOUT_MS, MEMORY_GUARD_RECALL_TIMEOUT_MS, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, POLICY_LEDGER_SYNC_REPORT_VERSION, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentContextEvidenceRecordCommand, agentContextEvidenceStatusCommand, agentContextEvidenceTemplateCommand, agentContextResolveCommand, agentContextValidateCommand, agentReadinessAuditCommand, appendActivityEvent, applyLocalContextMutationPlan, applyManagedWorkflowPolicyAutoResponses, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCommitResultMetadata, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildFinalCommitReport, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalAgentContextValidationReport, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextMutationPlan, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectContextValidationReport, buildLocalProjectDriftReport, buildLocalProjectRealityCheck, buildLocalProjectRealityCheckWithAutoContext, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkerTrustCandidates, buildWorkflowImpactGate, buildWorkflowPhaseCommitReceipt, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectPolicyLedgerSyncArtifacts, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextControlApplyCommand, contextControlDriftCommand, contextControlHostedApplyCommand, contextControlHostedDiffCommand, contextControlPlanCommand, contextControlValidateCommand, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, controlledWorkerExecuteCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, deriveManagedWorkflowJudgmentResolution, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentContextResolution, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatFinalCommitReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, hashWorkerProfile, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, mergeHybridCodeResults, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readAgentContextEvidenceLedger, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, readWorkerTrustEvent, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveCodeGraphMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldFailCollaborationGuard, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workerTrustCandidateCommand, workerTrustReviewCommand, workerTrustStatusCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, workflowSyncPolicyLedgerCommand, writeFinalCommitReport, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };
|
|
5283
|
+
export { AGENT_CONTEXT_EVIDENCE_DEFAULT_LEDGER, AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, FINAL_COMMIT_REPORT_RELATIVE_PATH, FINAL_COMMIT_REPORT_VERSION, MEMORY_GUARD_CONTEXT_TIMEOUT_MS, MEMORY_GUARD_RECALL_TIMEOUT_MS, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, POLICY_LEDGER_SYNC_REPORT_VERSION, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentContextEvidenceRecordCommand, agentContextEvidenceStatusCommand, agentContextEvidenceTemplateCommand, agentContextResolveCommand, agentContextValidateCommand, agentReadinessAuditCommand, appendActivityEvent, applyLocalContextMutationPlan, applyManagedWorkflowPolicyAutoResponses, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCommitResultMetadata, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildFinalCommitReport, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalAgentContextValidationReport, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextMutationPlan, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectContextValidationReport, buildLocalProjectDriftReport, buildLocalProjectRealityCheck, buildLocalProjectRealityCheckWithAutoContext, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkerTrustCandidates, buildWorkflowImpactGate, buildWorkflowPhaseCommitReceipt, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, captureStandaloneCommitWhy, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectPolicyLedgerSyncArtifacts, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextControlApplyCommand, contextControlDriftCommand, contextControlHostedApplyCommand, contextControlHostedDiffCommand, contextControlPlanCommand, contextControlValidateCommand, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, controlledWorkerExecuteCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, deriveManagedWorkflowJudgmentResolution, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentContextResolution, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatFinalCommitReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, hasActiveManagedWorkflow, hashWorkerProfile, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, mergeHybridCodeResults, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readAgentContextEvidenceLedger, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, readStandaloneCommitEvidence, readWorkerTrustEvent, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveCodeGraphMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldFailCollaborationGuard, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workerTrustCandidateCommand, workerTrustReviewCommand, workerTrustStatusCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, workflowSyncPolicyLedgerCommand, writeFinalCommitReport, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };
|