@inf-monkeys-tech/monkeys 1.0.14 → 1.0.16

package/lib/runtime/agent-session-projector.d.ts

@@ -0,0 +1,17 @@
+import { type AgentSessionEvent, type AgentSessionSnapshot, type AgentSessionStatus, type AgentSessionViewModel } from "../contracts/agent";
+export interface AgentSessionEventGap {
+    expectedSequence: number;
+    receivedSequence: number;
+}
+export interface AgentSessionEventProjection {
+    sessionId: string;
+    events: AgentSessionEvent[];
+    lastSequence: number;
+    status: AgentSessionStatus;
+    resumable: boolean;
+    gap?: AgentSessionEventGap;
+}
+export declare function createAgentSessionEventProjection(sessionId: string): AgentSessionEventProjection;
+export declare function projectAgentSessionEvents(current: AgentSessionEventProjection, candidates: readonly unknown[]): AgentSessionEventProjection;
+export declare function toAgentSessionViewModel(projection: AgentSessionEventProjection, snapshot: AgentSessionSnapshot): AgentSessionViewModel;
+//# sourceMappingURL=agent-session-projector.d.ts.map

package/lib/runtime/agent-session-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-projector.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-session-projector.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,oBAAoB,CAAC;CAC5B;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,GAChB,2BAA2B,CAQ7B;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,2BAA2B,EACpC,UAAU,EAAE,SAAS,OAAO,EAAE,GAC7B,2BAA2B,CA4E7B;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,2BAA2B,EACvC,QAAQ,EAAE,oBAAoB,GAC7B,qBAAqB,CAUvB"}

package/lib/runtime/agent-session-projector.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAgentSessionViewModel = exports.projectAgentSessionEvents = exports.createAgentSessionEventProjection = void 0;
+const agent_1 = require("../contracts/agent");
+function createAgentSessionEventProjection(sessionId) {
+    return {
+        sessionId,
+        events: [],
+        lastSequence: -1,
+        status: "queued",
+        resumable: false,
+    };
+}
+exports.createAgentSessionEventProjection = createAgentSessionEventProjection;
+function projectAgentSessionEvents(current, candidates) {
+    const parsed = candidates.map((candidate) => agent_1.AgentSessionEventSchema.parse(candidate));
+    if (parsed.some((event) => event.sessionId !== current.sessionId)) {
+        throw new TypeError("Agent session event sessionId does not match the projection sessionId.");
+    }
+    const eventIds = new Set(current.events.map((event) => event.eventId));
+    const idempotencyKeys = new Set(current.events.map((event) => event.idempotencyKey));
+    const eventsBySequence = new Map(current.events.map((event) => [event.sequence, event]));
+    const acceptedCandidates = [];
+    for (const event of parsed.sort((left, right) => left.sequence - right.sequence)) {
+        if (eventIds.has(event.eventId) ||
+            idempotencyKeys.has(event.idempotencyKey))
+            continue;
+        const existing = eventsBySequence.get(event.sequence);
+        if (existing) {
+            throw new TypeError(`Conflicting Agent session events share sequence ${event.sequence}.`);
+        }
+        eventsBySequence.set(event.sequence, event);
+        eventIds.add(event.eventId);
+        idempotencyKeys.add(event.idempotencyKey);
+        acceptedCandidates.push(event);
+    }
+    for (const event of acceptedCandidates)
+        eventsBySequence.delete(event.sequence);
+    let expectedSequence = current.lastSequence + 1;
+    let gap;
+    for (const event of acceptedCandidates) {
+        if (event.sequence < expectedSequence) {
+            throw new TypeError(`Agent session event sequence ${event.sequence} is behind the recovery cursor.`);
+        }
+        if (event.sequence > expectedSequence) {
+            gap = { expectedSequence, receivedSequence: event.sequence };
+            break;
+        }
+        eventsBySequence.set(event.sequence, event);
+        eventIds.add(event.eventId);
+        idempotencyKeys.add(event.idempotencyKey);
+        expectedSequence += 1;
+    }
+    const events = [...eventsBySequence.values()].sort((left, right) => left.sequence - right.sequence);
+    let status = "queued";
+    let resumable = false;
+    for (const event of events) {
+        if (event.eventType === "status")
+            status = event.payload.status;
+        if (event.eventType === "resume")
+            resumable = event.payload.resumable;
+    }
+    return {
+        sessionId: current.sessionId,
+        events,
+        lastSequence: events.length > 0 ? events[events.length - 1].sequence : -1,
+        status,
+        resumable,
+        ...(gap ? { gap } : {}),
+    };
+}
+exports.projectAgentSessionEvents = projectAgentSessionEvents;
+function toAgentSessionViewModel(projection, snapshot) {
+    return agent_1.AgentSessionViewModelSchema.parse({
+        contract: "AgentSessionViewModel",
+        sessionId: projection.sessionId,
+        snapshot,
+        status: projection.status,
+        events: projection.events,
+        lastSequence: projection.lastSequence,
+        resumable: projection.resumable,
+    });
+}
+exports.toAgentSessionViewModel = toAgentSessionViewModel;
+//# sourceMappingURL=agent-session-projector.js.map

package/lib/runtime/agent-session-projector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-projector.js","sourceRoot":"","sources":["../../src/runtime/agent-session-projector.ts"],"names":[],"mappings":"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"}

package/lib/runtime/index.d.ts

@@ -1,4 +1,5 @@
 export * from './capability-registry';
+export * from './agent-session-projector';
 export * from './declaration-compiler';
 export * from './page-compiler';
 export * from './product-runtime';

package/lib/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/lib/runtime/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./capability-registry"), exports);
+__exportStar(require("./agent-session-projector"), exports);
 __exportStar(require("./declaration-compiler"), exports);
 __exportStar(require("./page-compiler"), exports);
 __exportStar(require("./product-runtime"), exports);

package/lib/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,yDAAuC;AACvC,kDAAgC;AAChC,oDAAkC;AAClC,yDAAuC;AACvC,kDAAgC;AAChC,4DAA0C;AAC1C,iDAA+B;AAC/B,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C;AAC1C,yDAAuC;AACvC,kDAAgC;AAChC,oDAAkC;AAClC,yDAAuC;AACvC,kDAAgC;AAChC,4DAA0C;AAC1C,iDAA+B;AAC/B,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Monkeys JS SDK",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -29,11 +29,13 @@
       "require": "./lib/runtime/index.js",
       "default": "./lib/runtime/index.js"
     },
+    "./fixtures/*": "./test/fixtures/*",
     "./json-schema/*": "./lib/json-schema/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib",
+    "test/fixtures",
     "README.md"
   ],
   "repository": {

package/test/fixtures/agent-session-agent.json

@@ -0,0 +1,134 @@
+{
+  "contract": "AgentSessionViewModel",
+  "sessionId": "agent-session-1",
+  "snapshot": {
+    "mode": "agent",
+    "modelId": "openai:gpt-5.1-codex",
+    "capabilities": {
+      "text": true,
+      "reasoning": false,
+      "plan": false,
+      "tasks": false,
+      "tools": true,
+      "mcp": true,
+      "shell": true,
+      "fileChange": true,
+      "skills": true,
+      "approval": true,
+      "artifacts": true,
+      "usage": true,
+      "resume": true,
+      "diff": false,
+      "workspaceFiles": false,
+      "terminal": false,
+      "testResults": false
+    }
+  },
+  "status": "waiting_approval",
+  "events": [
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-1",
+      "sessionId": "agent-session-1",
+      "sequence": 0,
+      "idempotencyKey": "agent-session-1:0",
+      "occurredAt": "2026-07-30T08:00:00.000Z",
+      "eventType": "status",
+      "payload": { "status": "running" }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-2",
+      "sessionId": "agent-session-1",
+      "sequence": 1,
+      "idempotencyKey": "agent-session-1:1",
+      "occurredAt": "2026-07-30T08:00:01.000Z",
+      "eventType": "tool",
+      "payload": {
+        "toolCallId": "tool-1",
+        "toolName": "shell",
+        "status": "running",
+        "input": { "command": "git status" }
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-3",
+      "sessionId": "agent-session-1",
+      "sequence": 2,
+      "idempotencyKey": "agent-session-1:2",
+      "occurredAt": "2026-07-30T08:00:02.000Z",
+      "eventType": "approval",
+      "payload": {
+        "approvalId": "approval-1",
+        "toolCallId": "tool-1",
+        "status": "requested",
+        "title": "Run shell command",
+        "requestedAction": { "command": "git status" }
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-4",
+      "sessionId": "agent-session-1",
+      "sequence": 3,
+      "idempotencyKey": "agent-session-1:3",
+      "occurredAt": "2026-07-30T08:00:03.000Z",
+      "eventType": "artifact",
+      "payload": {
+        "artifactId": "artifact-1",
+        "name": "report.txt",
+        "kind": "file",
+        "status": "ready"
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-5",
+      "sessionId": "agent-session-1",
+      "sequence": 4,
+      "idempotencyKey": "agent-session-1:4",
+      "occurredAt": "2026-07-30T08:00:04.000Z",
+      "eventType": "usage",
+      "payload": { "inputTokens": 24, "outputTokens": 8, "totalTokens": 32 }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-6",
+      "sessionId": "agent-session-1",
+      "sequence": 5,
+      "idempotencyKey": "agent-session-1:5",
+      "occurredAt": "2026-07-30T08:00:05.000Z",
+      "eventType": "resume",
+      "payload": { "resumable": true, "reason": "approval_required" }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-7",
+      "sessionId": "agent-session-1",
+      "sequence": 6,
+      "idempotencyKey": "agent-session-1:6",
+      "occurredAt": "2026-07-30T08:00:06.000Z",
+      "eventType": "status",
+      "payload": { "status": "waiting_approval" }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "agent-event-8",
+      "sessionId": "agent-session-1",
+      "sequence": 7,
+      "idempotencyKey": "agent-session-1:7",
+      "occurredAt": "2026-07-30T08:00:07.000Z",
+      "eventType": "message",
+      "payload": {
+        "messageId": "agent-message-1",
+        "role": "assistant",
+        "operation": "append",
+        "parts": [{ "type": "text", "text": "Waiting for approval" }],
+        "status": "streaming"
+      }
+    }
+  ],
+  "lastSequence": 7,
+  "resumable": true
+}

package/test/fixtures/agent-session-chatbot.json

@@ -0,0 +1,83 @@
+{
+  "contract": "AgentSessionViewModel",
+  "sessionId": "chatbot-session-1",
+  "snapshot": {
+    "mode": "chatbot",
+    "modelId": "openai:gpt-5.1",
+    "capabilities": {
+      "text": true,
+      "reasoning": false,
+      "plan": false,
+      "tasks": false,
+      "tools": true,
+      "mcp": true,
+      "shell": false,
+      "fileChange": false,
+      "skills": true,
+      "approval": true,
+      "artifacts": false,
+      "usage": true,
+      "resume": false,
+      "diff": false,
+      "workspaceFiles": false,
+      "terminal": false,
+      "testResults": false
+    }
+  },
+  "status": "completed",
+  "events": [
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "chatbot-event-1",
+      "sessionId": "chatbot-session-1",
+      "sequence": 0,
+      "idempotencyKey": "chatbot-session-1:0",
+      "occurredAt": "2026-07-30T08:00:00.000Z",
+      "eventType": "message",
+      "payload": {
+        "messageId": "chatbot-message-1",
+        "role": "assistant",
+        "operation": "append",
+        "parts": [{ "type": "text", "text": "Hello" }],
+        "status": "completed"
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "chatbot-event-2",
+      "sessionId": "chatbot-session-1",
+      "sequence": 1,
+      "idempotencyKey": "chatbot-session-1:1",
+      "occurredAt": "2026-07-30T08:00:01.000Z",
+      "eventType": "tool",
+      "payload": {
+        "toolCallId": "tool-1",
+        "toolName": "search",
+        "status": "completed",
+        "output": { "count": 1 }
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "chatbot-event-3",
+      "sessionId": "chatbot-session-1",
+      "sequence": 2,
+      "idempotencyKey": "chatbot-session-1:2",
+      "occurredAt": "2026-07-30T08:00:02.000Z",
+      "eventType": "usage",
+      "payload": { "inputTokens": 12, "outputTokens": 4, "totalTokens": 16 }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "chatbot-event-4",
+      "sessionId": "chatbot-session-1",
+      "sequence": 3,
+      "idempotencyKey": "chatbot-session-1:3",
+      "occurredAt": "2026-07-30T08:00:03.000Z",
+      "eventType": "status",
+      "payload": { "status": "completed" }
+    }
+  ],
+  "lastSequence": 3,
+  "resumable": false
+}

package/test/fixtures/agent-session-commands.json

@@ -0,0 +1,72 @@
+{
+  "commands": [
+    {
+      "contract": "AgentSessionCommand",
+      "commandId": "command-stop-1",
+      "sessionId": "agent-session-1",
+      "idempotencyKey": "agent-session-1:stop:1",
+      "expectedSequence": 2,
+      "issuedAt": "2026-07-30T00:00:00.000Z",
+      "commandType": "stop",
+      "payload": { "reason": "User requested stop." }
+    },
+    {
+      "contract": "AgentSessionCommand",
+      "commandId": "command-resume-1",
+      "sessionId": "agent-session-1",
+      "idempotencyKey": "agent-session-1:resume:1",
+      "expectedSequence": 4,
+      "issuedAt": "2026-07-30T00:01:00.000Z",
+      "commandType": "resume",
+      "payload": { "resumeEventId": "resume-event-1" }
+    },
+    {
+      "contract": "AgentSessionCommand",
+      "commandId": "command-retry-1",
+      "sessionId": "agent-session-1",
+      "idempotencyKey": "agent-session-1:retry:1",
+      "expectedSequence": 6,
+      "issuedAt": "2026-07-30T00:02:00.000Z",
+      "commandType": "retry",
+      "payload": { "sourceEventId": "error-event-1" }
+    },
+    {
+      "contract": "AgentSessionCommand",
+      "commandId": "command-approval-1",
+      "sessionId": "agent-session-1",
+      "idempotencyKey": "agent-session-1:approval:1",
+      "expectedSequence": 8,
+      "issuedAt": "2026-07-30T00:03:00.000Z",
+      "commandType": "approval",
+      "payload": { "approvalId": "approval-1", "decision": "approved" }
+    }
+  ],
+  "results": [
+    {
+      "contract": "AgentSessionCommandResult",
+      "commandId": "command-stop-1",
+      "sessionId": "agent-session-1",
+      "idempotencyKey": "agent-session-1:stop:1",
+      "outcome": "accepted",
+      "sessionStatus": "stopping",
+      "acceptedSequence": 3,
+      "resultEventIds": ["status-event-3"],
+      "occurredAt": "2026-07-30T00:00:00.100Z"
+    },
+    {
+      "contract": "AgentSessionCommandResult",
+      "commandId": "command-retry-2",
+      "sessionId": "agent-session-1",
+      "idempotencyKey": "agent-session-1:retry:2",
+      "outcome": "rejected",
+      "sessionStatus": "completed",
+      "resultEventIds": [],
+      "error": {
+        "code": "INVALID_SESSION_STATE",
+        "message": "Retry requires a failed session.",
+        "retryable": false
+      },
+      "occurredAt": "2026-07-30T00:04:00.000Z"
+    }
+  ]
+}

package/test/fixtures/agent-session-kernel.json

@@ -0,0 +1,131 @@
+{
+  "contract": "AgentSessionViewModel",
+  "sessionId": "kernel-session-1",
+  "snapshot": {
+    "mode": "agent",
+    "modelId": "kernel:claude-code",
+    "capabilities": {
+      "text": true,
+      "reasoning": true,
+      "plan": false,
+      "tasks": false,
+      "tools": true,
+      "mcp": false,
+      "shell": true,
+      "fileChange": true,
+      "skills": false,
+      "approval": true,
+      "artifacts": true,
+      "usage": false,
+      "resume": true,
+      "diff": false,
+      "workspaceFiles": true,
+      "terminal": true,
+      "testResults": false
+    }
+  },
+  "status": "running",
+  "events": [
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-1",
+      "sessionId": "kernel-session-1",
+      "sequence": 0,
+      "idempotencyKey": "kernel-session-1:0",
+      "occurredAt": "2026-07-30T08:00:00.000Z",
+      "eventType": "status",
+      "payload": { "status": "running" }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-2",
+      "sessionId": "kernel-session-1",
+      "sequence": 1,
+      "idempotencyKey": "kernel-session-1:1",
+      "occurredAt": "2026-07-30T08:00:01.000Z",
+      "eventType": "workspace-file",
+      "payload": {
+        "path": "src/index.ts",
+        "operation": "upsert",
+        "mimeType": "text/typescript",
+        "size": 128
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-3",
+      "sessionId": "kernel-session-1",
+      "sequence": 2,
+      "idempotencyKey": "kernel-session-1:2",
+      "occurredAt": "2026-07-30T08:00:02.000Z",
+      "eventType": "terminal",
+      "payload": {
+        "terminalId": "terminal-1",
+        "stream": "stdout",
+        "chunk": "Tests passed\n"
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-4",
+      "sessionId": "kernel-session-1",
+      "sequence": 3,
+      "idempotencyKey": "kernel-session-1:3",
+      "occurredAt": "2026-07-30T08:00:03.000Z",
+      "eventType": "message",
+      "payload": {
+        "messageId": "kernel-message-1",
+        "role": "assistant",
+        "operation": "append",
+        "parts": [{ "type": "text", "text": "Tests passed" }],
+        "status": "completed"
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-5",
+      "sessionId": "kernel-session-1",
+      "sequence": 4,
+      "idempotencyKey": "kernel-session-1:4",
+      "occurredAt": "2026-07-30T08:00:04.000Z",
+      "eventType": "reasoning",
+      "payload": {
+        "reasoningId": "kernel-reasoning-1",
+        "text": "Checking tests",
+        "status": "completed"
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-6",
+      "sessionId": "kernel-session-1",
+      "sequence": 5,
+      "idempotencyKey": "kernel-session-1:5",
+      "occurredAt": "2026-07-30T08:00:05.000Z",
+      "eventType": "tool",
+      "payload": {
+        "toolCallId": "kernel-tool-1",
+        "toolName": "shell",
+        "status": "completed",
+        "output": "Tests passed"
+      }
+    },
+    {
+      "contract": "AgentSessionEvent",
+      "eventId": "kernel-event-7",
+      "sessionId": "kernel-session-1",
+      "sequence": 6,
+      "idempotencyKey": "kernel-session-1:6",
+      "occurredAt": "2026-07-30T08:00:06.000Z",
+      "eventType": "artifact",
+      "payload": {
+        "artifactId": "kernel-artifact-1",
+        "name": "test.log",
+        "kind": "file",
+        "status": "ready"
+      }
+    }
+  ],
+  "lastSequence": 6,
+  "resumable": true
+}