@nextclaw/kernel 0.19.2 → 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.
- package/dist/app/worker/index.d.ts +2 -2
- package/dist/app/worker/index.js +3 -2
- package/dist/{automatic-update-check.utils-C6lQfErN.d.ts → automatic-update-check.utils-8_3eYuwY.d.ts} +1 -1
- package/dist/{automatic-update-check.utils-C6lQfErN.d.ts.map → automatic-update-check.utils-8_3eYuwY.d.ts.map} +1 -1
- package/dist/index.d.ts +4 -4
- package/dist/index.js +651 -1510
- package/dist/index.js.map +1 -1
- package/dist/ncp-agent-session-journal-entry.utils-Dh0Ck_oW.js +112 -0
- package/dist/ncp-agent-session-journal-entry.utils-Dh0Ck_oW.js.map +1 -0
- package/dist/ncp-agent-session-journal.utils-B7a_PKCq.js +1457 -0
- package/dist/ncp-agent-session-journal.utils-B7a_PKCq.js.map +1 -0
- package/dist/ncp-agent-session-message-projection-tail.store-5sjmoFxv.js +117 -0
- package/dist/ncp-agent-session-message-projection-tail.store-5sjmoFxv.js.map +1 -0
- package/dist/{nextclaw-harness.manager-GK_qgrlk.d.ts → nextclaw-harness.manager-j0JHST4g.d.ts} +348 -80
- package/dist/nextclaw-harness.manager-j0JHST4g.d.ts.map +1 -0
- package/dist/{nextclaw-harness.manager-toewDc-x.js → nextclaw-harness.manager-mJToWeCB.js} +1877 -1579
- package/dist/nextclaw-harness.manager-mJToWeCB.js.map +1 -0
- package/dist/session-journal-delta-coalescer.utils-CI-N-Zpj.js +25 -0
- package/dist/session-journal-delta-coalescer.utils-CI-N-Zpj.js.map +1 -0
- package/dist/session-journal-maintenance.store-DrZMlaxf.js +621 -0
- package/dist/session-journal-maintenance.store-DrZMlaxf.js.map +1 -0
- package/dist/session-journal-stream.utils-CupSA3YS.js +207 -0
- package/dist/session-journal-stream.utils-CupSA3YS.js.map +1 -0
- package/dist/types/update-contract.types.d.ts +1 -1
- package/dist/types/update-contract.types.js +1 -1
- package/dist/{update-manifest.types-CBp2VTM1.js → update-manifest.types-DUocefbs.js} +1 -1
- package/dist/{update-manifest.types-CBp2VTM1.js.map → update-manifest.types-DUocefbs.js.map} +1 -1
- package/dist/{update-manifest.types-C_60CVvw.d.ts → update-manifest.types-Dijq24Om.d.ts} +1 -1
- package/dist/{update-manifest.types-C_60CVvw.d.ts.map → update-manifest.types-Dijq24Om.d.ts.map} +1 -1
- package/dist/utils/automatic-update-check.utils.d.ts +1 -1
- package/package.json +12 -9
- package/dist/nextclaw-harness.manager-GK_qgrlk.d.ts.map +0 -1
- package/dist/nextclaw-harness.manager-toewDc-x.js.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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"}
|