@nextclaw/kernel 0.19.3 → 0.19.4

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 (33) hide show
  1. package/dist/app/worker/index.d.ts +2 -2
  2. package/dist/app/worker/index.js +3 -2
  3. package/dist/{automatic-update-check.utils-C6lQfErN.d.ts → automatic-update-check.utils-8_3eYuwY.d.ts} +1 -1
  4. package/dist/{automatic-update-check.utils-C6lQfErN.d.ts.map → automatic-update-check.utils-8_3eYuwY.d.ts.map} +1 -1
  5. package/dist/index.d.ts +4 -4
  6. package/dist/index.js +651 -1510
  7. package/dist/index.js.map +1 -1
  8. package/dist/ncp-agent-session-journal-entry.utils-Dh0Ck_oW.js +112 -0
  9. package/dist/ncp-agent-session-journal-entry.utils-Dh0Ck_oW.js.map +1 -0
  10. package/dist/ncp-agent-session-journal.utils-B7a_PKCq.js +1457 -0
  11. package/dist/ncp-agent-session-journal.utils-B7a_PKCq.js.map +1 -0
  12. package/dist/ncp-agent-session-message-projection-tail.store-5sjmoFxv.js +117 -0
  13. package/dist/ncp-agent-session-message-projection-tail.store-5sjmoFxv.js.map +1 -0
  14. package/dist/{nextclaw-harness.manager-GK_qgrlk.d.ts → nextclaw-harness.manager-j0JHST4g.d.ts} +348 -80
  15. package/dist/nextclaw-harness.manager-j0JHST4g.d.ts.map +1 -0
  16. package/dist/{nextclaw-harness.manager-DHzYOORP.js → nextclaw-harness.manager-mJToWeCB.js} +1871 -1657
  17. package/dist/nextclaw-harness.manager-mJToWeCB.js.map +1 -0
  18. package/dist/session-journal-delta-coalescer.utils-CI-N-Zpj.js +25 -0
  19. package/dist/session-journal-delta-coalescer.utils-CI-N-Zpj.js.map +1 -0
  20. package/dist/session-journal-maintenance.store-DrZMlaxf.js +621 -0
  21. package/dist/session-journal-maintenance.store-DrZMlaxf.js.map +1 -0
  22. package/dist/session-journal-stream.utils-CupSA3YS.js +207 -0
  23. package/dist/session-journal-stream.utils-CupSA3YS.js.map +1 -0
  24. package/dist/types/update-contract.types.d.ts +1 -1
  25. package/dist/types/update-contract.types.js +1 -1
  26. package/dist/{update-manifest.types-CBp2VTM1.js → update-manifest.types-DUocefbs.js} +1 -1
  27. package/dist/{update-manifest.types-CBp2VTM1.js.map → update-manifest.types-DUocefbs.js.map} +1 -1
  28. package/dist/{update-manifest.types-C_60CVvw.d.ts → update-manifest.types-Dijq24Om.d.ts} +1 -1
  29. package/dist/{update-manifest.types-C_60CVvw.d.ts.map → update-manifest.types-Dijq24Om.d.ts.map} +1 -1
  30. package/dist/utils/automatic-update-check.utils.d.ts +1 -1
  31. package/package.json +13 -10
  32. package/dist/nextclaw-harness.manager-DHzYOORP.js.map +0 -1
  33. package/dist/nextclaw-harness.manager-GK_qgrlk.d.ts.map +0 -1
@@ -0,0 +1,112 @@
1
+ import { c as isRecord, f as toIsoString, l as normalizeNcpAgentId } from "./ncp-agent-session-journal.utils-B7a_PKCq.js";
2
+ import { open } from "node:fs/promises";
3
+ import { NcpEventType } from "@nextclaw/ncp";
4
+ import { createInterface } from "node:readline";
5
+ //#region src/utils/ncp-agent-session-journal-entry.utils.ts
6
+ function isNcpAgentSessionMessageProjectionBoundaryEvent(event) {
7
+ return event.type === NcpEventType.MessageSent || event.type === NcpEventType.MessageCompleted || event.type === NcpEventType.MessageAbort || event.type === NcpEventType.RunFinished || event.type === NcpEventType.RunError || event.type === "session.snapshot.message";
8
+ }
9
+ function attachNcpAgentSessionJournalTimestamp(event, timestamp) {
10
+ if (!("payload" in event) || !isRecord(event.payload)) return event;
11
+ return {
12
+ ...event,
13
+ payload: {
14
+ ...event.payload,
15
+ timestamp
16
+ }
17
+ };
18
+ }
19
+ var NcpAgentSessionJournalParser = class {
20
+ metadata = {};
21
+ agentId;
22
+ createdAt = (/* @__PURE__ */ new Date()).toISOString();
23
+ updatedAt = this.createdAt;
24
+ nextSeq = 1;
25
+ projectedJournalOffset = 0;
26
+ events = [];
27
+ constructor(collectEvents = true) {
28
+ this.collectEvents = collectEvents;
29
+ }
30
+ append = (line, index, lineEndOffset) => {
31
+ if (!line.trim()) return null;
32
+ const parsed = this.parseLine(line, index);
33
+ if (!parsed) return null;
34
+ if (parsed._type === "metadata") {
35
+ this.applyMetadata(parsed);
36
+ return null;
37
+ }
38
+ if (parsed._type === "event" && isRecord(parsed.event)) return this.applyEvent(parsed, lineEndOffset);
39
+ return null;
40
+ };
41
+ finish = () => ({
42
+ metadata: this.metadata,
43
+ ...this.agentId ? { agentId: this.agentId } : {},
44
+ createdAt: this.createdAt,
45
+ updatedAt: this.updatedAt,
46
+ nextSeq: this.nextSeq,
47
+ projectedJournalOffset: this.projectedJournalOffset,
48
+ events: this.events
49
+ });
50
+ parseLine = (line, index) => {
51
+ try {
52
+ const parsed = JSON.parse(line);
53
+ return isRecord(parsed) ? parsed : null;
54
+ } catch (error) {
55
+ console.warn(`[ncp-agent-session-journal] skipped corrupted journal line ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);
56
+ return null;
57
+ }
58
+ };
59
+ applyMetadata = (entry) => {
60
+ this.metadata = isRecord(entry.metadata) ? structuredClone(entry.metadata) : {};
61
+ this.agentId = normalizeNcpAgentId(typeof entry.agent_id === "string" ? entry.agent_id : void 0);
62
+ this.createdAt = toIsoString(entry.created_at, this.createdAt);
63
+ this.updatedAt = toIsoString(entry.updated_at, this.updatedAt);
64
+ };
65
+ applyEvent = (entry, lineEndOffset) => {
66
+ const seq = Number(entry.seq);
67
+ this.nextSeq = Math.max(this.nextSeq, Number.isFinite(seq) ? Math.trunc(seq) + 1 : this.nextSeq);
68
+ const eventTimestamp = toIsoString(entry.timestamp, this.updatedAt);
69
+ this.updatedAt = eventTimestamp;
70
+ const replayEvent = attachNcpAgentSessionJournalTimestamp(structuredClone(entry.event), eventTimestamp);
71
+ if (this.collectEvents) this.events.push(replayEvent);
72
+ if (isNcpAgentSessionMessageProjectionBoundaryEvent(replayEvent)) this.projectedJournalOffset = lineEndOffset;
73
+ return replayEvent;
74
+ };
75
+ };
76
+ async function scanSessionJournal(params) {
77
+ const { endOffset, onEvent, path } = params;
78
+ const startOffset = Math.max(0, params.startOffset ?? 0);
79
+ const parser = new NcpAgentSessionJournalParser(false);
80
+ if (endOffset <= startOffset) return parser.finish();
81
+ const file = await open(path, "r");
82
+ const stream = file.createReadStream({
83
+ start: startOffset,
84
+ end: endOffset - 1,
85
+ encoding: "utf-8",
86
+ autoClose: false
87
+ });
88
+ const lines = createInterface({
89
+ input: stream,
90
+ crlfDelay: Infinity
91
+ });
92
+ let lineIndex = 0;
93
+ let byteOffset = startOffset;
94
+ try {
95
+ for await (const line of lines) {
96
+ const lineEndOffset = Math.min(endOffset, byteOffset + Buffer.byteLength(line, "utf-8") + 1);
97
+ const event = parser.append(line, lineIndex, lineEndOffset);
98
+ if (event) await onEvent?.(event, lineIndex);
99
+ byteOffset = lineEndOffset;
100
+ lineIndex += 1;
101
+ }
102
+ return parser.finish();
103
+ } finally {
104
+ lines.close();
105
+ stream.destroy();
106
+ await file.close();
107
+ }
108
+ }
109
+ //#endregion
110
+ export { scanSessionJournal as t };
111
+
112
+ //# sourceMappingURL=ncp-agent-session-journal-entry.utils-Dh0Ck_oW.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ncp-agent-session-journal-entry.utils-Dh0Ck_oW.js","names":[],"sources":["../src/utils/ncp-agent-session-journal-entry.utils.ts"],"sourcesContent":["import { NcpEventType } from \"@nextclaw/ncp\";\nimport { open } from \"node:fs/promises\";\nimport { createInterface } from \"node:readline\";\nimport {\n isRecord,\n NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE,\n type NcpAgentSessionJournalEventEntry,\n type NcpAgentSessionJournalReplayEvent,\n normalizeNcpAgentId,\n toIsoString\n} from \"./ncp-agent-session-journal.utils.js\";\n\nexport type ParsedNcpAgentSessionJournal = {\n metadata: Record<string, unknown>;\n agentId?: string;\n createdAt: string;\n updatedAt: string;\n nextSeq: number;\n projectedJournalOffset: number;\n events: NcpAgentSessionJournalReplayEvent[];\n};\n\nexport function isNcpAgentSessionMessageProjectionBoundaryEvent(event: NcpAgentSessionJournalReplayEvent): boolean {\n return (\n event.type === NcpEventType.MessageSent ||\n event.type === NcpEventType.MessageCompleted ||\n event.type === NcpEventType.MessageAbort ||\n event.type === NcpEventType.RunFinished ||\n event.type === NcpEventType.RunError ||\n event.type === NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE\n );\n}\n\nexport function serializeNcpAgentSessionJournalEntry(entry: NcpAgentSessionJournalEventEntry): string {\n const serialized = JSON.stringify(entry);\n if (!serialized) {\n throw new Error(\"ncp agent session journal entry serialization produced empty output\");\n }\n const parsed = JSON.parse(serialized) as unknown;\n if (!isRecord(parsed)) {\n throw new Error(\"ncp agent session journal entry serialization produced a non-object entry\");\n }\n return serialized;\n}\n\nexport function attachNcpAgentSessionJournalTimestamp(\n event: NcpAgentSessionJournalReplayEvent,\n timestamp: string\n): NcpAgentSessionJournalReplayEvent {\n if (!(\"payload\" in event) || !isRecord(event.payload)) {\n return event;\n }\n return {\n ...event,\n payload: {\n ...event.payload,\n timestamp\n }\n } as unknown as NcpAgentSessionJournalReplayEvent;\n}\n\nexport class NcpAgentSessionJournalParser {\n private metadata: Record<string, unknown> = {};\n private agentId: string | undefined;\n private createdAt = new Date().toISOString();\n private updatedAt = this.createdAt;\n private nextSeq = 1;\n private projectedJournalOffset = 0;\n private readonly events: NcpAgentSessionJournalReplayEvent[] = [];\n\n constructor(private readonly collectEvents = true) {}\n\n append = (line: string, index: number, lineEndOffset: number): NcpAgentSessionJournalReplayEvent | null => {\n if (!line.trim()) {\n return null;\n }\n const parsed = this.parseLine(line, index);\n if (!parsed) {\n return null;\n }\n if (parsed._type === \"metadata\") {\n this.applyMetadata(parsed);\n return null;\n }\n if (parsed._type === \"event\" && isRecord(parsed.event)) {\n return this.applyEvent(parsed, lineEndOffset);\n }\n return null;\n };\n\n finish = (): ParsedNcpAgentSessionJournal => ({\n metadata: this.metadata,\n ...(this.agentId ? { agentId: this.agentId } : {}),\n createdAt: this.createdAt,\n updatedAt: this.updatedAt,\n nextSeq: this.nextSeq,\n projectedJournalOffset: this.projectedJournalOffset,\n events: this.events\n });\n\n private parseLine = (line: string, index: number): Record<string, unknown> | null => {\n try {\n const parsed = JSON.parse(line) as unknown;\n return isRecord(parsed) ? parsed : null;\n } catch (error) {\n console.warn(\n `[ncp-agent-session-journal] skipped corrupted journal line ${index + 1}: ${error instanceof Error ? error.message : String(error)}`\n );\n return null;\n }\n };\n\n private applyMetadata = (entry: Record<string, unknown>): void => {\n this.metadata = isRecord(entry.metadata) ? structuredClone(entry.metadata) : {};\n this.agentId = normalizeNcpAgentId(typeof entry.agent_id === \"string\" ? entry.agent_id : undefined);\n this.createdAt = toIsoString(entry.created_at, this.createdAt);\n this.updatedAt = toIsoString(entry.updated_at, this.updatedAt);\n };\n\n private applyEvent = (entry: Record<string, unknown>, lineEndOffset: number): NcpAgentSessionJournalReplayEvent => {\n const seq = Number(entry.seq);\n this.nextSeq = Math.max(this.nextSeq, Number.isFinite(seq) ? Math.trunc(seq) + 1 : this.nextSeq);\n const eventTimestamp = toIsoString(entry.timestamp, this.updatedAt);\n this.updatedAt = eventTimestamp;\n const event = structuredClone(entry.event) as NcpAgentSessionJournalReplayEvent;\n const replayEvent = attachNcpAgentSessionJournalTimestamp(event, eventTimestamp);\n if (this.collectEvents) this.events.push(replayEvent);\n if (isNcpAgentSessionMessageProjectionBoundaryEvent(replayEvent)) {\n this.projectedJournalOffset = lineEndOffset;\n }\n return replayEvent;\n };\n}\n\nexport function parseNcpAgentSessionJournal(raw: string): ParsedNcpAgentSessionJournal {\n const parser = new NcpAgentSessionJournalParser();\n let byteOffset = 0;\n const lines = raw.split(\"\\n\");\n for (const [index, line] of lines.entries()) {\n const lineEndOffset = byteOffset + Buffer.byteLength(line, \"utf-8\") + (index < lines.length - 1 ? 1 : 0);\n parser.append(line, index, lineEndOffset);\n byteOffset = lineEndOffset;\n }\n return parser.finish();\n}\n\nexport async function scanSessionJournal(params: {\n path: string;\n startOffset?: number;\n endOffset: number;\n onEvent?: (event: NcpAgentSessionJournalReplayEvent, eventIndex: number) => Promise<void> | void;\n}): Promise<ParsedNcpAgentSessionJournal> {\n const { endOffset, onEvent, path } = params;\n const startOffset = Math.max(0, params.startOffset ?? 0);\n const parser = new NcpAgentSessionJournalParser(false);\n if (endOffset <= startOffset) return parser.finish();\n const file = await open(path, \"r\");\n const stream = file.createReadStream({\n start: startOffset,\n end: endOffset - 1,\n encoding: \"utf-8\",\n autoClose: false,\n });\n const lines = createInterface({ input: stream, crlfDelay: Infinity });\n let lineIndex = 0;\n let byteOffset = startOffset;\n try {\n for await (const line of lines) {\n const lineEndOffset = Math.min(\n endOffset,\n byteOffset + Buffer.byteLength(line, \"utf-8\") + 1,\n );\n const event = parser.append(line, lineIndex, lineEndOffset);\n if (event) await onEvent?.(event, lineIndex);\n byteOffset = lineEndOffset;\n lineIndex += 1;\n }\n return parser.finish();\n } finally {\n lines.close();\n stream.destroy();\n await file.close();\n }\n}\n"],"mappings":"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"}