trajectories 0.1.2 → 0.1.3

package/dist/convert.d.ts

@@ -21,6 +21,14 @@ export declare function readSnapshot(input: {
     pythonExecutable?: string;
 }): Promise<Snapshot>;
 export declare function assertSnapshot(snapshot: Snapshot): void;
+/** Append a post-hoc annotation (judge verdict, review error, first-pointed step)
+ * to a finished snapshot. The channel is outside `raw` and every content hash:
+ * the snapshot id, source sha256 and record ids are unchanged, so annotations
+ * attach without re-normalizing. The result stays valid for assertSnapshot. */
+export declare function annotateSnapshot(snapshot: Snapshot, annotation: {
+    kind: string;
+    content: string;
+}): Snapshot;
 /** Complete portable context, stricter than an archive's integrity-only validation. */
 export declare function assertPortableSnapshot(snapshot: Snapshot): void;
 export declare function convert(snapshot: Snapshot, target: Harness, options: WriteOptions): NativeExport;

package/dist/convert.js

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { readFile, mkdir, writeFile, realpath } from 'node:fs/promises';
 import { resolve, dirname, relative, isAbsolute, sep, join, basename } from 'node:path';
 import { normalizeToCanonical, validateTranscript } from '@letta-ai/trajectory';
-import { HARNESSES } from './types.js';
+import { HARNESSES, isNativeHarness } from './types.js';
 import { createSeededNativeEntropy } from './writers/entropy.js';
 import { writePi } from './writers/pi.js';
 import { writeOmp } from './writers/omp.js';
@@ -16,6 +16,7 @@ import { writeGitHubCopilot } from './writers/github-copilot.js';
 import { writeCline } from './writers/cline.js';
 import { writeFx } from './writers/fx.js';
 import { normalizeGrokBuild } from './readers/grok-build.js';
+import { enrichAtifCanonical } from './readers/atif.js';
 import { readCursor, readCursorNative } from './readers/cursor.js';
 import { readDeepAgents, readDeepAgentsSeed } from './readers/deepagents.js';
 import { readCline } from './readers/cline.js';
@@ -212,7 +213,8 @@ function finalizeSnapshot(input, archived, clineCompaction = false) {
     const invalid = archived.diagnostics.filter(d => d.code === 'invalid_json_line' || d.code === 'non_object_json_line');
     if (invalid.length)
         throw new Error(`Invalid native transcript: ${invalid.map(d => d.message).join('; ')}`);
-    const canonical = input.harness === 'pi' ? projectPiProviderContext(raw, archived) : archived;
+    const canonical = input.harness === 'pi' ? projectPiProviderContext(raw, archived)
+        : input.harness === 'atif' ? enrichAtifCanonical(raw, archived) : archived;
     const metadata = provenance(input.harness, canonical);
     if (input.nativeSessionId && metadata.nativeSessionId !== input.nativeSessionId)
         throw new Error('Selected native session does not match source provenance.');
@@ -352,12 +354,31 @@ export function assertSnapshot(snapshot) {
         if (sha256(attachment.content) !== attachment.sha256)
             throw new Error('Snapshot attachment integrity check failed.');
     }
+    for (const annotation of snapshot.annotations ?? []) {
+        if (typeof annotation.kind !== 'string' || !annotation.kind || typeof annotation.content !== 'string'
+            || sha256(annotation.content) !== annotation.sha256)
+            throw new Error('Snapshot annotation integrity check failed.');
+    }
     for (const record of canonical.records) {
         if (sha256(record.record_json) !== record.record_hash)
             throw new Error('Snapshot canonical record integrity check failed.');
     }
     validateTranscript(canonical.records.map(r => JSON.parse(r.record_json)));
 }
+/** Append a post-hoc annotation (judge verdict, review error, first-pointed step)
+ * to a finished snapshot. The channel is outside `raw` and every content hash:
+ * the snapshot id, source sha256 and record ids are unchanged, so annotations
+ * attach without re-normalizing. The result stays valid for assertSnapshot. */
+export function annotateSnapshot(snapshot, annotation) {
+    assertSnapshot(snapshot);
+    if (typeof annotation?.kind !== 'string' || !annotation.kind.trim())
+        throw new Error('Snapshot annotation requires a kind.');
+    if (typeof annotation.content !== 'string')
+        throw new Error('Snapshot annotation content must be a string.');
+    const entry = { kind: annotation.kind, content: annotation.content,
+        sha256: sha256(annotation.content), createdAt: new Date().toISOString() };
+    return { ...snapshot, annotations: [...(snapshot.annotations ?? []), entry] };
+}
 /** Complete portable context, stricter than an archive's integrity-only validation. */
 export function assertPortableSnapshot(snapshot) {
     assertSnapshot(snapshot);
@@ -385,8 +406,9 @@ export function convertManaged(snapshot, target, options, entropySeed, records)
 }
 function convertWithEntropy(snapshot, target, options, entropy, retainedRecords) {
     assertPortableSnapshot(snapshot);
-    if (!HARNESSES.includes(target))
-        throw new Error(`Unsupported target: ${target}`);
+    if (!isNativeHarness(target)) {
+        throw new Error(HARNESSES.includes(target) ? `Unsupported target: ${target} is a read-only interchange format.` : `Unsupported target: ${target}`);
+    }
     if (!isAbsolute(options.cwd) || !isAbsolute(options.directory))
         throw new Error('cwd and directory must be absolute paths.');
     const records = retainedRecords ?? snapshot.canonical.records.map(r => JSON.parse(r.record_json));

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-export { HARNESSES } from './types.js';
-export type { Harness, Snapshot, ConversionDiagnostic, WriteOptions, NativeExport, NativeWriter, NativeEntropy } from './types.js';
+export { HARNESSES, NATIVE_HARNESSSES } from './types.js';
+export type { Harness, NativeHarness, Snapshot, SnapshotAnnotation, SnapshotCanonical, ExtendedCanonicalRecord, CanonicalRecordMetadata, ConversionDiagnostic, WriteOptions, NativeExport, NativeWriter, NativeEntropy } from './types.js';
 export * from './log-types.js';
-export { readSnapshot, assertSnapshot, assertPortableSnapshot, convert, writeNativeExport, writeSnapshot } from './convert.js';
+export { readSnapshot, assertSnapshot, assertPortableSnapshot, annotateSnapshot, convert, writeNativeExport, writeSnapshot } from './convert.js';
 export { createSession, getSession, listSessions, stageCapture, appendCapture, switchSession, readSession, getNativeBinding, getHeadMetadata } from './log.js';
 export { assertSnapshotContinuation } from './store.js';
 export { migrateLegacyStore, type MigrationManifest, type MigratedSession } from './migrate.js';
+export { createSharedClient, createSharedHandler, sharedObservationId } from './shared.js';
+export type { ObservedRecord, ObservedSession, ObservedState, ObservedSummary, SharedTransfer, ObservedSyncReceipt, ManagedSyncReceipt } from './shared.js';