@pasko70/pibo 1.16.5 → 2.0.0

package/dist/apps/chat/agent-store.js

@@ -3,10 +3,75 @@ import { mkdirSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { piboHomePath } from "../../core/pibo-home.js";
 import { DatabaseSync } from "node:sqlite";
-import { DEFAULT_BUILTIN_TOOL_NAMES } from "../../core/profiles.js";
+import { DEFAULT_AGENT_RUNTIME_INSTANCE_ID, DEFAULT_BUILTIN_TOOL_NAMES } from "../../core/profiles.js";
 import { isPiboThinkingLevel } from "../../core/thinking.js";
 import { findPiPackage } from "../../pi-packages/store.js";
 const CUSTOM_AGENT_NAME_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+export function previewCustomAgentCreate(input, options = {}) {
+    const now = options.now ?? new Date().toISOString();
+    const id = options.id ?? `agent_${randomUUID()}`;
+    return {
+        id,
+        profileName: input.displayName,
+        displayName: input.displayName,
+        profileAliases: [],
+        description: input.description,
+        runtimeInstanceId: sanitizeRuntimeInstanceId(input.runtimeInstanceId),
+        runtimeOptions: cloneRuntimeOptions(input.runtimeOptions),
+        nativeTools: [...(input.nativeTools ?? [])],
+        skills: [...(input.skills ?? [])],
+        contextFiles: [...(input.contextFiles ?? [])],
+        subagents: sanitizeSubagents(input.subagents ?? []),
+        mcpServers: uniqueStrings(input.mcpServers ?? []),
+        piPackages: sanitizePiPackages(input.piPackages ?? []),
+        mainModel: sanitizeModelProfile(input.mainModel),
+        subagentModel: sanitizeModelProfile(input.subagentModel),
+        thinkingLevel: sanitizeThinkingLevel(input.thinkingLevel),
+        mainThinkingLevel: sanitizeThinkingLevel(input.mainThinkingLevel),
+        subagentThinkingLevel: sanitizeThinkingLevel(input.subagentThinkingLevel),
+        fast: sanitizeBoolean(input.fast),
+        mainFast: sanitizeBoolean(input.mainFast),
+        subagentFast: sanitizeBoolean(input.subagentFast),
+        builtinTools: input.builtinTools ?? "default",
+        builtinToolNames: sanitizeBuiltinToolNames(input.builtinToolNames),
+        autoContextFiles: input.autoContextFiles ?? true,
+        runControl: input.runControl ?? false,
+        goalControl: input.goalControl ?? true,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function previewCustomAgentUpdate(existing, input, options = {}) {
+    const profileName = input.displayName ?? existing.displayName;
+    return {
+        ...existing,
+        profileName,
+        displayName: input.displayName ?? existing.displayName,
+        description: input.description === undefined ? existing.description : input.description,
+        runtimeInstanceId: input.runtimeInstanceId === undefined ? existing.runtimeInstanceId : sanitizeRuntimeInstanceId(input.runtimeInstanceId),
+        runtimeOptions: input.runtimeOptions === undefined ? existing.runtimeOptions : cloneRuntimeOptions(input.runtimeOptions),
+        nativeTools: input.nativeTools ? [...input.nativeTools] : existing.nativeTools,
+        skills: input.skills ? [...input.skills] : existing.skills,
+        contextFiles: input.contextFiles ? [...input.contextFiles] : existing.contextFiles,
+        subagents: input.subagents ? sanitizeSubagents(input.subagents) : existing.subagents,
+        mcpServers: input.mcpServers ? uniqueStrings(input.mcpServers) : existing.mcpServers,
+        piPackages: input.piPackages ? sanitizePiPackages(input.piPackages) : existing.piPackages,
+        mainModel: input.mainModel === undefined ? existing.mainModel : sanitizeModelProfile(input.mainModel),
+        subagentModel: input.subagentModel === undefined ? existing.subagentModel : sanitizeModelProfile(input.subagentModel),
+        thinkingLevel: input.thinkingLevel === undefined ? existing.thinkingLevel : sanitizeThinkingLevel(input.thinkingLevel),
+        mainThinkingLevel: input.mainThinkingLevel === undefined ? existing.mainThinkingLevel : sanitizeThinkingLevel(input.mainThinkingLevel),
+        subagentThinkingLevel: input.subagentThinkingLevel === undefined ? existing.subagentThinkingLevel : sanitizeThinkingLevel(input.subagentThinkingLevel),
+        fast: input.fast === undefined ? existing.fast : sanitizeBoolean(input.fast),
+        mainFast: input.mainFast === undefined ? existing.mainFast : sanitizeBoolean(input.mainFast),
+        subagentFast: input.subagentFast === undefined ? existing.subagentFast : sanitizeBoolean(input.subagentFast),
+        builtinTools: input.builtinTools ?? existing.builtinTools,
+        builtinToolNames: input.builtinToolNames ? sanitizeBuiltinToolNames(input.builtinToolNames) : existing.builtinToolNames,
+        autoContextFiles: input.autoContextFiles ?? existing.autoContextFiles,
+        runControl: input.runControl ?? existing.runControl,
+        goalControl: input.goalControl ?? existing.goalControl,
+        updatedAt: options.now ?? new Date().toISOString(),
+    };
+}
 export class CustomAgentStore {
     db;
     constructor(path) {
@@ -24,6 +89,8 @@ export class CustomAgentStore {
 				profile_name TEXT NOT NULL UNIQUE,
 				display_name TEXT NOT NULL,
 				description TEXT,
+				runtime_instance_id TEXT NOT NULL DEFAULT 'pi',
+				runtime_options_json TEXT NOT NULL DEFAULT '{}',
 				native_tools_json TEXT NOT NULL,
 				skills_json TEXT NOT NULL,
 				context_files_json TEXT NOT NULL,
@@ -53,6 +120,7 @@ export class CustomAgentStore {
         this.migrateArchivedAtColumn();
         this.migrateAutoContextFilesColumn();
         this.migrateMcpServersColumn();
+        this.migrateRuntimeColumns();
         this.migratePiPackagesColumn();
         this.migrateModelColumns();
         this.migrateThinkingLevelColumn();
@@ -78,42 +146,12 @@ export class CustomAgentStore {
     }
     create(input) {
         this.migrateLegacyProfileNames();
-        const now = new Date().toISOString();
-        const id = `agent_${randomUUID()}`;
-        const profileName = input.displayName;
-        this.requireProfileNameAvailable(profileName);
-        const agent = {
-            id,
-            profileName,
-            displayName: input.displayName,
-            profileAliases: [],
-            description: input.description,
-            nativeTools: [...(input.nativeTools ?? [])],
-            skills: [...(input.skills ?? [])],
-            contextFiles: [...(input.contextFiles ?? [])],
-            subagents: sanitizeSubagents(input.subagents ?? []),
-            mcpServers: uniqueStrings(input.mcpServers ?? []),
-            piPackages: sanitizePiPackages(input.piPackages ?? []),
-            mainModel: sanitizeModelProfile(input.mainModel),
-            subagentModel: sanitizeModelProfile(input.subagentModel),
-            thinkingLevel: sanitizeThinkingLevel(input.thinkingLevel),
-            mainThinkingLevel: sanitizeThinkingLevel(input.mainThinkingLevel),
-            subagentThinkingLevel: sanitizeThinkingLevel(input.subagentThinkingLevel),
-            fast: sanitizeBoolean(input.fast),
-            mainFast: sanitizeBoolean(input.mainFast),
-            subagentFast: sanitizeBoolean(input.subagentFast),
-            builtinTools: input.builtinTools ?? "default",
-            builtinToolNames: sanitizeBuiltinToolNames(input.builtinToolNames),
-            autoContextFiles: input.autoContextFiles ?? true,
-            runControl: input.runControl ?? false,
-            goalControl: input.goalControl ?? true,
-            createdAt: now,
-            updatedAt: now,
-        };
+        this.requireProfileNameAvailable(input.displayName);
+        const agent = previewCustomAgentCreate(input);
         this.insert(agent);
-        const created = this.get(id);
+        const created = this.get(agent.id);
         if (!created)
-            throw new Error(`Failed to create custom agent "${id}"`);
+            throw new Error(`Failed to create custom agent "${agent.id}"`);
         return created;
     }
     update(id, input) {
@@ -123,38 +161,15 @@ export class CustomAgentStore {
             return undefined;
         const profileName = input.displayName ?? existing.displayName;
         this.requireProfileNameAvailable(profileName, id);
-        const updated = {
-            ...existing,
-            profileName,
-            displayName: input.displayName ?? existing.displayName,
-            description: input.description === undefined ? existing.description : input.description,
-            nativeTools: input.nativeTools ? [...input.nativeTools] : existing.nativeTools,
-            skills: input.skills ? [...input.skills] : existing.skills,
-            contextFiles: input.contextFiles ? [...input.contextFiles] : existing.contextFiles,
-            subagents: input.subagents ? sanitizeSubagents(input.subagents) : existing.subagents,
-            mcpServers: input.mcpServers ? uniqueStrings(input.mcpServers) : existing.mcpServers,
-            piPackages: input.piPackages ? sanitizePiPackages(input.piPackages) : existing.piPackages,
-            mainModel: input.mainModel === undefined ? existing.mainModel : sanitizeModelProfile(input.mainModel),
-            subagentModel: input.subagentModel === undefined ? existing.subagentModel : sanitizeModelProfile(input.subagentModel),
-            thinkingLevel: input.thinkingLevel === undefined ? existing.thinkingLevel : sanitizeThinkingLevel(input.thinkingLevel),
-            mainThinkingLevel: input.mainThinkingLevel === undefined ? existing.mainThinkingLevel : sanitizeThinkingLevel(input.mainThinkingLevel),
-            subagentThinkingLevel: input.subagentThinkingLevel === undefined ? existing.subagentThinkingLevel : sanitizeThinkingLevel(input.subagentThinkingLevel),
-            fast: input.fast === undefined ? existing.fast : sanitizeBoolean(input.fast),
-            mainFast: input.mainFast === undefined ? existing.mainFast : sanitizeBoolean(input.mainFast),
-            subagentFast: input.subagentFast === undefined ? existing.subagentFast : sanitizeBoolean(input.subagentFast),
-            builtinTools: input.builtinTools ?? existing.builtinTools,
-            builtinToolNames: input.builtinToolNames ? sanitizeBuiltinToolNames(input.builtinToolNames) : existing.builtinToolNames,
-            autoContextFiles: input.autoContextFiles ?? existing.autoContextFiles,
-            runControl: input.runControl ?? existing.runControl,
-            goalControl: input.goalControl ?? existing.goalControl,
-            updatedAt: new Date().toISOString(),
-        };
+        const updated = previewCustomAgentUpdate(existing, input);
         this.db
             .prepare(`
 				UPDATE chat_agents SET
 					profile_name = ?,
 					display_name = ?,
 					description = ?,
+					runtime_instance_id = ?,
+					runtime_options_json = ?,
 					native_tools_json = ?,
 					skills_json = ?,
 					context_files_json = ?,
@@ -177,7 +192,7 @@ export class CustomAgentStore {
 					updated_at = ?
 				WHERE id = ?
 			`)
-            .run(updated.profileName, updated.displayName, updated.description ?? null, JSON.stringify(updated.nativeTools), JSON.stringify(updated.skills), JSON.stringify(updated.contextFiles), JSON.stringify(sanitizeSubagents(updated.subagents)), JSON.stringify(updated.mcpServers), JSON.stringify(updated.piPackages), updated.mainModel ? JSON.stringify(updated.mainModel) : null, updated.subagentModel ? JSON.stringify(updated.subagentModel) : null, updated.thinkingLevel ?? null, updated.mainThinkingLevel ?? null, updated.subagentThinkingLevel ?? null, serializeBoolean(updated.fast), serializeBoolean(updated.mainFast), serializeBoolean(updated.subagentFast), updated.builtinTools, JSON.stringify(updated.builtinToolNames), updated.autoContextFiles ? 1 : 0, updated.runControl ? 1 : 0, updated.goalControl ? 1 : 0, updated.updatedAt, id);
+            .run(updated.profileName, updated.displayName, updated.description ?? null, updated.runtimeInstanceId, JSON.stringify(updated.runtimeOptions), JSON.stringify(updated.nativeTools), JSON.stringify(updated.skills), JSON.stringify(updated.contextFiles), JSON.stringify(sanitizeSubagents(updated.subagents)), JSON.stringify(updated.mcpServers), JSON.stringify(updated.piPackages), updated.mainModel ? JSON.stringify(updated.mainModel) : null, updated.subagentModel ? JSON.stringify(updated.subagentModel) : null, updated.thinkingLevel ?? null, updated.mainThinkingLevel ?? null, updated.subagentThinkingLevel ?? null, serializeBoolean(updated.fast), serializeBoolean(updated.mainFast), serializeBoolean(updated.subagentFast), updated.builtinTools, JSON.stringify(updated.builtinToolNames), updated.autoContextFiles ? 1 : 0, updated.runControl ? 1 : 0, updated.goalControl ? 1 : 0, updated.updatedAt, id);
         return this.get(id);
     }
     setArchived(id, archived) {
@@ -207,6 +222,8 @@ export class CustomAgentStore {
 					profile_name,
 					display_name,
 					description,
+					runtime_instance_id,
+					runtime_options_json,
 					native_tools_json,
 					skills_json,
 					context_files_json,
@@ -229,9 +246,9 @@ export class CustomAgentStore {
 					created_at,
 					updated_at,
 					archived_at
-				) VALUES (${Array.from({ length: 26 }, () => "?").join(", ")})
+				) VALUES (${Array.from({ length: 28 }, () => "?").join(", ")})
 			`)
-            .run(agent.id, agent.profileName, agent.displayName, agent.description ?? null, JSON.stringify(agent.nativeTools), JSON.stringify(agent.skills), JSON.stringify(agent.contextFiles), JSON.stringify(sanitizeSubagents(agent.subagents)), JSON.stringify(agent.mcpServers), JSON.stringify(agent.piPackages), agent.mainModel ? JSON.stringify(agent.mainModel) : null, agent.subagentModel ? JSON.stringify(agent.subagentModel) : null, agent.thinkingLevel ?? null, agent.mainThinkingLevel ?? null, agent.subagentThinkingLevel ?? null, serializeBoolean(agent.fast), serializeBoolean(agent.mainFast), serializeBoolean(agent.subagentFast), agent.builtinTools, JSON.stringify(agent.builtinToolNames), agent.autoContextFiles ? 1 : 0, agent.runControl ? 1 : 0, agent.goalControl ? 1 : 0, agent.createdAt, agent.updatedAt, agent.archivedAt ?? null);
+            .run(agent.id, agent.profileName, agent.displayName, agent.description ?? null, agent.runtimeInstanceId, JSON.stringify(agent.runtimeOptions), JSON.stringify(agent.nativeTools), JSON.stringify(agent.skills), JSON.stringify(agent.contextFiles), JSON.stringify(sanitizeSubagents(agent.subagents)), JSON.stringify(agent.mcpServers), JSON.stringify(agent.piPackages), agent.mainModel ? JSON.stringify(agent.mainModel) : null, agent.subagentModel ? JSON.stringify(agent.subagentModel) : null, agent.thinkingLevel ?? null, agent.mainThinkingLevel ?? null, agent.subagentThinkingLevel ?? null, serializeBoolean(agent.fast), serializeBoolean(agent.mainFast), serializeBoolean(agent.subagentFast), agent.builtinTools, JSON.stringify(agent.builtinToolNames), agent.autoContextFiles ? 1 : 0, agent.runControl ? 1 : 0, agent.goalControl ? 1 : 0, agent.createdAt, agent.updatedAt, agent.archivedAt ?? null);
     }
     requireProfileNameAvailable(profileName, currentId) {
         const row = this.db.prepare("SELECT id FROM chat_agents WHERE profile_name = ?").get(profileName);
@@ -341,6 +358,15 @@ export class CustomAgentStore {
             this.db.prepare("ALTER TABLE chat_agents ADD COLUMN mcp_servers_json TEXT NOT NULL DEFAULT '[]'").run();
         }
     }
+    migrateRuntimeColumns() {
+        const columns = this.tableColumns();
+        if (!columns.has("runtime_instance_id")) {
+            this.db.prepare(`ALTER TABLE chat_agents ADD COLUMN runtime_instance_id TEXT NOT NULL DEFAULT '${DEFAULT_AGENT_RUNTIME_INSTANCE_ID}'`).run();
+        }
+        if (!columns.has("runtime_options_json")) {
+            this.db.prepare("ALTER TABLE chat_agents ADD COLUMN runtime_options_json TEXT NOT NULL DEFAULT '{}'").run();
+        }
+    }
     migratePiPackagesColumn() {
         const columns = new Set(this.db.prepare("PRAGMA table_info(chat_agents)").all().map((column) => column.name));
         if (!columns.has("pi_packages_json")) {
@@ -536,6 +562,8 @@ function agentFromRow(row, profileAliases) {
         displayName: row.display_name,
         profileAliases: profileAliases.filter((alias) => alias !== row.profile_name),
         description: row.description ?? undefined,
+        runtimeInstanceId: sanitizeRuntimeInstanceId(row.runtime_instance_id),
+        runtimeOptions: parseRuntimeOptions(row.runtime_options_json),
         nativeTools: parseStringArray(row.native_tools_json),
         skills: parseStringArray(row.skills_json),
         contextFiles: parseStringArray(row.context_files_json),
@@ -572,6 +600,25 @@ function parseStringArray(value) {
 function uniqueStrings(value) {
     return [...new Set(value.filter((item) => typeof item === "string" && item.trim()).map((item) => item.trim()))];
 }
+function sanitizeRuntimeInstanceId(value) {
+    if (typeof value !== "string" || !value.trim())
+        return DEFAULT_AGENT_RUNTIME_INSTANCE_ID;
+    return value.trim();
+}
+function cloneRuntimeOptions(value) {
+    return structuredClone(value ?? {});
+}
+function parseRuntimeOptions(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? structuredClone(parsed)
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
 function sanitizePiPackages(value) {
     const packages = uniqueStrings(value);
     for (const pkg of packages) {

package/dist/apps/chat/chat-api-routes.js

@@ -300,7 +300,7 @@ export function sessionActionResource(pathname) {
     if (parts.length !== 2 || !parts[0])
         return undefined;
     const action = parts[1];
-    if (action !== "read" && action !== "kill" && action !== "kill-all")
+    if (action !== "read" && action !== "kill" && action !== "kill-all" && action !== "runtime-binding")
         return undefined;
     try {
         return { piboSessionId: decodeURIComponent(parts[0]), action };

package/dist/apps/chat/chat-request-normalizers.js

@@ -1,6 +1,7 @@
 import { existsSync, statSync } from "node:fs";
 import { isAbsolute, resolve } from "node:path";
 import { savePiboModelDefaults } from "../../core/model-defaults.js";
+import { DEFAULT_AGENT_RUNTIME_INSTANCE_ID } from "../../core/profiles.js";
 import { isPiboThinkingLevel } from "../../core/thinking.js";
 import { PiboWebHttpError } from "../../web/http.js";
 import { listPiPackages } from "../../pi-packages/store.js";
@@ -127,6 +128,46 @@ export function normalizeAgentDescription(value) {
         throw new PiboWebHttpError("Agent description is too long", 400);
     return description;
 }
+export function normalizeAgentRuntimeInstanceId(value) {
+    if (value === undefined)
+        return DEFAULT_AGENT_RUNTIME_INSTANCE_ID;
+    if (typeof value !== "string" || !value.trim()) {
+        throw new PiboWebHttpError("runtimeInstanceId must be a non-empty string", 400);
+    }
+    const instanceId = value.trim();
+    if (!/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/.test(instanceId)) {
+        throw new PiboWebHttpError("runtimeInstanceId is invalid", 400);
+    }
+    return instanceId;
+}
+export function normalizeAgentRuntimeOptions(value) {
+    if (value === undefined || value === null)
+        return {};
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new PiboWebHttpError("runtimeOptions must be a JSON object", 400);
+    }
+    return normalizeAgentRuntimeJsonObject(value, "runtimeOptions", 0);
+}
+function normalizeAgentRuntimeJsonObject(value, path, depth) {
+    if (depth > 20)
+        throw new PiboWebHttpError(`${path} exceeds the maximum nesting depth`, 400);
+    const normalized = {};
+    for (const [key, item] of Object.entries(value)) {
+        normalized[key] = normalizeAgentRuntimeJsonValue(item, `${path}.${key}`, depth + 1);
+    }
+    return normalized;
+}
+function normalizeAgentRuntimeJsonValue(value, path, depth) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (Array.isArray(value))
+        return value.map((item, index) => normalizeAgentRuntimeJsonValue(item, `${path}[${index}]`, depth + 1));
+    if (value && typeof value === "object")
+        return normalizeAgentRuntimeJsonObject(value, path, depth + 1);
+    throw new PiboWebHttpError(`${path} must contain JSON values only`, 400);
+}
 export function normalizeNameArray(value, label) {
     if (value === undefined)
         return [];
@@ -607,6 +648,8 @@ export function createAgentInput(body) {
     return {
         displayName: normalizeAgentDisplayName(body.displayName),
         description: normalizeAgentDescription(body.description),
+        runtimeInstanceId: normalizeAgentRuntimeInstanceId(body.runtimeInstanceId),
+        runtimeOptions: normalizeAgentRuntimeOptions(body.runtimeOptions),
         nativeTools: normalizeNameArray(body.nativeTools, "nativeTools"),
         skills: normalizeNameArray(body.skills, "skills"),
         contextFiles: normalizeNameArray(body.contextFiles, "contextFiles"),
@@ -634,6 +677,10 @@ export function createAgentUpdate(body) {
         update.displayName = normalizeAgentDisplayName(body.displayName);
     if (body.description !== undefined)
         update.description = normalizeAgentDescription(body.description);
+    if (body.runtimeInstanceId !== undefined)
+        update.runtimeInstanceId = normalizeAgentRuntimeInstanceId(body.runtimeInstanceId);
+    if (body.runtimeOptions !== undefined)
+        update.runtimeOptions = normalizeAgentRuntimeOptions(body.runtimeOptions);
     if (body.nativeTools !== undefined)
         update.nativeTools = normalizeNameArray(body.nativeTools, "nativeTools");
     if (body.skills !== undefined)

package/dist/apps/chat/data/chat-data-mappers.js

@@ -1,18 +1,18 @@
 import { normalizeSessionErrorDetails } from "../../../core/session-errors.js";
 import { roomWorkspaceFromMetadata } from "../types/rooms.js";
-export function storedPiboEventFromV2Row(row) {
+export function storedPiboEventFromV2Row(row, payloadStore) {
     const attributes = parseJsonObject(row.attributes_json);
-    const payload = outputPayloadFromV2Row(row, attributes);
+    const payload = outputPayloadFromV2Row(row, attributes, readPersistedPayload(row, payloadStore));
     if (!payload)
         return undefined;
     return { id: String(row.stream_id), piboSessionId: row.session_id ?? undefined, eventSequence: row.session_sequence ?? undefined, eventId: row.event_id ?? undefined, streamId: row.stream_id, type: row.type, createdAt: row.created_at, payload };
 }
-export function storedChatEventFromV2Row(row) {
+export function storedChatEventFromV2Row(row, payloadStore) {
     const attributes = parseJsonObject(row.attributes_json);
-    return { streamId: row.stream_id, roomId: row.room_id ?? undefined, piboSessionId: row.session_id ?? undefined, eventId: row.event_id ?? `evt_${row.stream_id}`, eventType: row.type, actorType: actorTypeValue(row.actor_type), actorId: row.actor_id ?? undefined, clientTxnId: typeof attributes.clientTxnId === "string" ? attributes.clientTxnId : undefined, createdAt: row.created_at, retentionClass: retentionClassValue(row.retention_class), payload: (outputPayloadFromV2Row(row, attributes) ?? null) };
+    return { streamId: row.stream_id, roomId: row.room_id ?? undefined, piboSessionId: row.session_id ?? undefined, eventId: row.event_id ?? `evt_${row.stream_id}`, eventType: row.type, actorType: actorTypeValue(row.actor_type), actorId: row.actor_id ?? undefined, clientTxnId: typeof attributes.clientTxnId === "string" ? attributes.clientTxnId : undefined, createdAt: row.created_at, retentionClass: retentionClassValue(row.retention_class), payload: (outputPayloadFromV2Row(row, attributes, readPersistedPayload(row, payloadStore)) ?? null) };
 }
-function outputPayloadFromV2Row(row, attributes) {
-    const inlinePayload = attributes.inlinePayload;
+function outputPayloadFromV2Row(row, attributes, persistedPayload) {
+    const inlinePayload = attributes.inlinePayload ?? persistedPayload;
     if (inlinePayload && typeof inlinePayload === "object" && !Array.isArray(inlinePayload) && typeof inlinePayload.type === "string")
         return inlinePayload;
     const piboSessionId = row.session_id;
@@ -25,7 +25,7 @@ function outputPayloadFromV2Row(row, attributes) {
             type: row.type,
             assistantIndex: numberAttribute(attributes, "assistantIndex"),
             contentIndex: numberAttribute(attributes, "contentIndex"),
-            text: row.preview_text ?? "",
+            text: typeof inlinePayload === "string" ? inlinePayload : row.preview_text ?? "",
         });
     }
     if (row.type === "message_queued")
@@ -42,7 +42,7 @@ function outputPayloadFromV2Row(row, attributes) {
             type: row.type,
             thinkingIndex: numberAttribute(attributes, "thinkingIndex"),
             contentIndex: numberAttribute(attributes, "contentIndex"),
-            ...(row.type === "thinking_started" ? {} : { text: row.preview_text ?? "" }),
+            ...(row.type === "thinking_started" ? {} : { text: typeof inlinePayload === "string" ? inlinePayload : row.preview_text ?? "" }),
         });
     }
     if (row.type === "tool_call")
@@ -71,7 +71,22 @@ function outputPayloadFromV2Row(row, attributes) {
         return { type: "user.message.accepted", piboSessionId, roomId: row.room_id ?? undefined, text: stringAttribute(attributes, "inlineText") ?? row.preview_text ?? "", clientTxnId: stringAttribute(attributes, "clientTxnId") };
     return { ...base, type: row.type };
 }
-export function sessionFromRow(row) { return { piboSessionId: row.id, piSessionId: row.pi_session_id ?? row.id, parentId: row.parent_id ?? undefined, profile: row.profile, channel: row.channel, kind: row.kind, createdAt: row.created_at, updatedAt: row.updated_at, lastActivityAt: row.last_activity_at, status: row.status === "running" || row.status === "error" ? row.status : "idle" }; }
+function readPersistedPayload(row, payloadStore) {
+    if (!row.payload_ref || !payloadStore)
+        return undefined;
+    try {
+        const metadata = payloadStore.getPayload(row.payload_ref);
+        if (!metadata)
+            return undefined;
+        return metadata.contentType.includes("json")
+            ? payloadStore.readPayloadJson(row.payload_ref)
+            : payloadStore.readPayloadText(row.payload_ref);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function sessionFromRow(row) { return { piboSessionId: row.id, piSessionId: row.pi_session_id ?? "", runtimeInstanceId: row.runtime_instance_id ?? undefined, runtimeAdapterId: row.runtime_adapter_id ?? undefined, runtimeBindingState: isRuntimeBindingState(row.binding_state) ? row.binding_state : undefined, nativeSessionId: row.native_session_id ?? undefined, parentId: row.parent_id ?? undefined, profile: row.profile, channel: row.channel, kind: row.kind, createdAt: row.created_at, updatedAt: row.updated_at, lastActivityAt: row.last_activity_at, status: row.status === "running" || row.status === "error" ? row.status : "idle" }; }
 export function roomFromRow(row) { const metadata = parseJsonObject(row.metadata_json); return { id: row.id, name: row.name, topic: row.topic ?? undefined, workspace: row.workspace ?? roomWorkspaceFromMetadata(metadata), type: row.type, parentRoomId: row.parent_room_id ?? undefined, createdAt: row.created_at, updatedAt: row.updated_at, retentionPolicyId: row.retention_policy_id ?? undefined, metadata }; }
 export function parseJsonObject(value) { try {
     const parsed = JSON.parse(value);
@@ -92,5 +107,6 @@ export function previewForPayload(payload) { if (typeof payload === "object" &&
 export function statusFromOutputEvent(event) { if (event.type === "session_error")
     return "error"; if (event.type === "message_finished")
     return "idle"; return "running"; }
+function isRuntimeBindingState(value) { return value === "unbound" || value === "bound" || value === "missing" || value === "error"; }
 function actorTypeValue(value) { return value === "user" || value === "assistant" || value === "system" || value === "agent" ? value : undefined; }
 function retentionClassValue(value) { return value === "live_delta" || value === "chat_message" || value === "audit_event" ? value : "trace_event"; }

package/dist/apps/chat/data/history-query-service.js

@@ -0,0 +1,108 @@
+export class ChatHistoryQueryService {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    listProductHistoryEntries(input) {
+        const limit = Math.max(1, Math.min(input.limit ?? 200, 1000));
+        const clauses = ["m.session_id = ?", "m.role IN ('user', 'assistant', 'system')"];
+        const values = [input.piboSessionId];
+        if (input.beforeSequence !== undefined) {
+            clauses.push("COALESCE(e.session_sequence, m.sequence) < ?");
+            values.push(input.beforeSequence);
+        }
+        const rows = this.store.db.prepare(`
+			SELECT m.*, e.session_sequence AS event_sequence
+			FROM chat_messages m
+			LEFT JOIN event_log e ON e.stream_id = m.source_stream_id
+			WHERE ${clauses.join(" AND ")}
+			ORDER BY m.sequence DESC
+			LIMIT ?
+		`).all(...values, limit);
+        return rows.reverse().flatMap((row) => {
+            const role = historyRole(row.role);
+            if (!role)
+                return [];
+            const attributes = parseObject(row.attributes_json);
+            const text = this.readMessageText(row, attributes);
+            return [{
+                    id: `product:${row.id}`,
+                    type: "message",
+                    source: "product",
+                    createdAt: row.created_at,
+                    sequence: row.event_sequence ?? row.sequence,
+                    turnId: row.turn_id ?? undefined,
+                    role,
+                    content: text,
+                    assistantIndex: numberValue(attributes.assistantIndex),
+                    contentIndex: numberValue(attributes.contentIndex),
+                    status: historyStatus(row.status),
+                    metadata: compactObject({
+                        messageId: row.id,
+                        sourceStreamId: row.source_stream_id ?? undefined,
+                        completedAt: row.completed_at ?? undefined,
+                        payloadRef: row.content_payload_ref ?? undefined,
+                    }),
+                }];
+        });
+    }
+    getProductHistoryCoverage(piboSessionId) {
+        const row = this.store.db.prepare(`
+			SELECT
+				COUNT(*) AS message_count,
+				MIN(e.session_sequence) AS first_event_sequence,
+				MAX(e.session_sequence) AS last_event_sequence,
+				MIN(m.created_at) AS first_created_at,
+				MAX(m.created_at) AS last_created_at
+			FROM chat_messages m
+			LEFT JOIN event_log e ON e.stream_id = m.source_stream_id
+			WHERE m.session_id = ?
+		`).get(piboSessionId);
+        return {
+            messageCount: Number(row.message_count ?? 0),
+            firstEventSequence: row.first_event_sequence ?? undefined,
+            lastEventSequence: row.last_event_sequence ?? undefined,
+            firstCreatedAt: row.first_created_at ?? undefined,
+            lastCreatedAt: row.last_created_at ?? undefined,
+        };
+    }
+    readMessageText(row, attributes) {
+        if (row.content_payload_ref) {
+            try {
+                return this.store.payloads.readPayloadText(row.content_payload_ref);
+            }
+            catch {
+                // Retain the durable preview if the external payload was removed or corrupted.
+            }
+        }
+        if (typeof attributes.inlineText === "string")
+            return attributes.inlineText;
+        return row.content_preview ?? "";
+    }
+}
+function historyRole(role) {
+    return role === "user" || role === "assistant" || role === "system" ? role : undefined;
+}
+function historyStatus(status) {
+    if (status === "running" || status === "streaming" || status === "in_progress")
+        return "running";
+    if (status === "error" || status === "failed")
+        return "error";
+    return "complete";
+}
+function parseObject(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function compactObject(value) {
+    const compact = Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+    return Object.keys(compact).length ? compact : undefined;
+}

package/dist/apps/chat/data/session-query-service.js

@@ -30,11 +30,22 @@ export class ChatSessionQueryService {
         return undefined;
     }
     listSessions() {
-        const rows = this.store.db.prepare("SELECT * FROM sessions WHERE deleted_at IS NULL ORDER BY last_activity_at DESC, created_at DESC").all();
+        const rows = this.store.db.prepare(`
+			SELECT s.*, b.runtime_instance_id, b.runtime_adapter_id, b.native_session_id, b.binding_state
+			FROM sessions s
+			LEFT JOIN session_runtime_bindings b ON b.pibo_session_id = s.id
+			WHERE s.deleted_at IS NULL
+			ORDER BY s.last_activity_at DESC, s.created_at DESC
+		`).all();
         return rows.map(sessionFromRow);
     }
     getSession(piboSessionId) {
-        const row = this.store.db.prepare("SELECT * FROM sessions WHERE id = ? AND deleted_at IS NULL").get(piboSessionId);
+        const row = this.store.db.prepare(`
+			SELECT s.*, b.runtime_instance_id, b.runtime_adapter_id, b.native_session_id, b.binding_state
+			FROM sessions s
+			LEFT JOIN session_runtime_bindings b ON b.pibo_session_id = s.id
+			WHERE s.id = ? AND s.deleted_at IS NULL
+		`).get(piboSessionId);
         return row ? sessionFromRow(row) : undefined;
     }
     hasSessionActivity(piboSessionId) {
@@ -76,17 +87,27 @@ export class ChatSessionQueryService {
 				s.created_at,
 				s.updated_at,
 				s.last_activity_at,
+				b.runtime_instance_id,
+				b.runtime_adapter_id,
+				b.native_session_id,
+				b.binding_state,
 				n.status AS navigation_status,
 				n.title AS navigation_title,
 				n.sort_key AS navigation_sort_key,
 				n.updated_at AS navigation_updated_at
 			FROM sessions s
+			LEFT JOIN session_runtime_bindings b ON b.pibo_session_id = s.id
 			LEFT JOIN session_navigation n ON n.session_id = s.id
 			WHERE s.id = ? AND s.deleted_at IS NULL
 		`).get(session.id);
         if (!row)
             return false;
-        return row.pi_session_id === session.piSessionId
+        const binding = session.runtimeBinding;
+        return row.pi_session_id === (session.piSessionId || null)
+            && row.runtime_instance_id === (binding?.runtimeInstanceId ?? "pi")
+            && row.runtime_adapter_id === (binding?.adapterId ?? "pi")
+            && row.native_session_id === (binding?.nativeSessionId ?? (session.piSessionId || null))
+            && row.binding_state === (binding?.state ?? (session.piSessionId ? "bound" : "unbound"))
             && row.room_id === roomId
             && row.root_session_id === rootSessionId(session)
             && row.parent_id === (session.parentId ?? null)

package/dist/apps/chat/data/timeline-query-service.js

@@ -23,7 +23,7 @@ export class ChatTimelineQueryService {
         const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
         const limit = Math.max(1, Math.min(input.limit ?? 1000, 5000));
         const rows = this.store.db.prepare(`SELECT * FROM event_log ${where} ORDER BY stream_id ASC LIMIT ?`).all(...values, limit);
-        return rows.map(storedChatEventFromV2Row);
+        return rows.map((row) => storedChatEventFromV2Row(row, this.store.payloads));
     }
     listSessionEvents(piboSessionId, limit = 1000) {
         return this.listTraceEvents({ piboSessionId, limit, includeLive: true });
@@ -38,7 +38,7 @@ export class ChatTimelineQueryService {
 				AND type IN ('message_queued', 'message_steered', 'message_started', 'message_finished', 'session_error', 'thinking_finished', 'assistant_message')
 			ORDER BY session_sequence ASC, stream_id ASC
 		`).all(piboSessionId);
-        const events = rows.map(storedPiboEventFromV2Row).filter((event) => event !== undefined);
+        const events = rows.map((row) => storedPiboEventFromV2Row(row, this.store.payloads)).filter((event) => event !== undefined);
         return messageTurnTimingsFromEvents(events);
     }
     listTraceEvents(input) {
@@ -68,7 +68,7 @@ export class ChatTimelineQueryService {
 			)
 			ORDER BY session_sequence ASC, stream_id ASC
 		`).all(...values, limit);
-        return rows.map(storedPiboEventFromV2Row).filter((event) => event !== undefined);
+        return rows.map((row) => storedPiboEventFromV2Row(row, this.store.payloads)).filter((event) => event !== undefined);
     }
     countEventsByType(input = {}) {
         const clauses = [];