@rho-workspace/rho 0.5.4 → 0.5.5

package/node_modules/@rho-workspace/plugin-agent/dist/operations.js

@@ -424,7 +424,10 @@ const legacyOperationContracts = {
     }
 };
 const business = (schema) => structuredClone(schema);
+export { externalSessionSchemas } from './external-session-contract.js';
+import { externalSessionOperations } from './external-session-contract.js';
 export const operationContracts = {
+    ...externalSessionOperations,
     ...activityOperationContracts,
     ...legacyOperationContracts,
     'feedback.submit': { inputSchema: feedbackSchemas.FeedbackSubmitInput, outputSchema: feedbackSchemas.SubmissionRecord, requires: ['documents', 'annotations'], effect: 'metadata' },

package/node_modules/@rho-workspace/plugin-agent/dist/presentation.d.ts

@@ -1,6 +1,20 @@
 import type { EntryPresentation, PluginPresentation } from '@rho-workspace/plugin-contracts';
 export declare const presentation: PluginPresentation;
 export declare const operationPresentation: {
+    'agent.sessions.list': {
+        order: number;
+        displayName: string;
+        description: string;
+        readOnly: true;
+        runsCode: false;
+    };
+    'agent.sessions.read': {
+        order: number;
+        displayName: string;
+        description: string;
+        readOnly: true;
+        runsCode: false;
+    };
     'agent.activity.read': {
         order: number;
         displayName: string;

package/node_modules/@rho-workspace/plugin-agent/dist/presentation.js

@@ -19,6 +19,8 @@ export const presentation = {
     readOnly: false, runsCode: false,
 };
 export const operationPresentation = {
+    'agent.sessions.list': { order: 58, displayName: 'External conversations', description: 'Reads retained conversations observed in this project. Input remains in the original client.', readOnly: true, runsCode: false },
+    'agent.sessions.read': { order: 59, displayName: 'External conversation', description: 'Reads native turns, tool outcomes and result receipts without sending or resuming anything.', readOnly: true, runsCode: false },
     'agent.activity.read': { order: 62, displayName: 'Agent activity', description: 'Reads selected Claude Code and dsh activity retained by the project Core Host, with cursors and gaps. Starts nothing.', readOnly: true, runsCode: false },
     'agent.activity.outputs': { order: 63, displayName: 'Observed outputs', description: 'Observes bounded current files and hashes inside a selected project output folder, without attributing them to an Agent.', readOnly: true, runsCode: false },
     'agent.activity.capture': { order: 64, displayName: 'Open observed output', description: 'Captures one CSV or image file in the project through Files: the exact version you observed, or its current bytes. CSV columns remain text; no producer or scientific claim is made.', readOnly: false, runsCode: false },

package/node_modules/@rho-workspace/plugin-agent/dist/ui-external-session.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+import type { ExternalSessionSummary, ExternalTurn, ExternalResult } from './external-session.js';
+export interface ExternalConversationProps {
+    session: ExternalSessionSummary;
+    read: (before?: number) => Promise<{
+        first: number;
+        turns: ExternalTurn[];
+        session: ExternalSessionSummary;
+    }>;
+    renderText: (text: string) => ReactNode;
+    renderResult: (result: ExternalResult) => ReactNode;
+    openFile: (path: string) => void;
+}
+/** Read-only conversation entry. Native client owns every input and permission. */
+export declare function ExternalConversation({ session, read, renderText, renderResult, openFile }: ExternalConversationProps): import("react").JSX.Element;

package/node_modules/@rho-workspace/plugin-agent/dist/ui-external-session.js

@@ -0,0 +1,37 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState, useRef } from 'react';
+/** Read-only conversation entry. Native client owns every input and permission. */
+export function ExternalConversation({ session, read, renderText, renderResult, openFile }) {
+    const [kept, setKept] = useState(null), [problem, setProblem] = useState('');
+    const root = useRef(null);
+    const [retry, setRetry] = useState(0);
+    useEffect(() => {
+        let live = true;
+        read().then(value => { if (live) {
+            setKept(value);
+            setProblem('');
+        } }, error => { if (live)
+            setProblem(error instanceof Error ? error.message : 'Could not read this conversation.'); });
+        return () => { live = false; };
+    }, [session.id, session.sourceCursor, session.state, read, retry]);
+    async function earlier() {
+        try {
+            const value = await read(kept?.first);
+            setKept(old => ({ first: value.first, turns: [...value.turns, ...(old?.turns ?? [])] }));
+            setProblem('');
+        }
+        catch (error) {
+            setProblem(error instanceof Error ? error.message : 'Could not read earlier messages.');
+        }
+    }
+    return _jsxs("div", { className: "external-conversation", ref: root, children: [_jsxs("p", { className: "external-input-owner", children: ["Read only \u00B7 Continue in ", session.producer === 'dsh' ? 'DeepSeek Harness' : session.producer, ". Input and permission choices stay there."] }), problem && _jsxs("p", { role: "alert", children: [problem, " ", _jsx("button", { onClick: () => setRetry(n => n + 1), children: "Retry" })] }), session.omittedTurns > 0 && _jsxs("p", { role: "status", children: [session.omittedTurns, " earlier turns are outside the retained observation."] }), session.problem && _jsx("p", { role: "status", children: session.problem }), !kept && !problem && _jsx("p", { children: "Reading conversation\u2026" }), kept?.turns.slice().reverse().map(turn => _jsxs("article", { className: "external-turn", children: [_jsxs("header", { children: [_jsx("h4", { children: turn.prompt || 'Prompt was not observed' }), _jsxs("small", { children: [new Date(turn.at).toLocaleString(), " \u00B7 ", turn.state === 'unknown' ? 'Outcome unknown' : turn.state] })] }), turn.results.length > 0 && _jsxs("section", { className: "external-results", "aria-label": "Results of this turn", children: [_jsx("h5", { children: "Results" }), turn.results.map((result, i) => _jsxs("div", { children: [renderResult(result), turn.tools.some(t => t.id === result.toolId) && _jsxs("button", { className: "text-button", onClick: () => {
+                                            const target = root.current?.querySelector('#' + CSS.escape('external-tool-' + result.toolId));
+                                            const outer = target?.closest('details');
+                                            if (outer)
+                                                outer.open = true;
+                                            const inner = target?.querySelector('details');
+                                            if (inner)
+                                                inner.open = true;
+                                            target?.scrollIntoView({ block: 'center' });
+                                        }, children: ["Show operation \u00B7 ", turn.tools.find(t => t.id === result.toolId)?.name] })] }, i))] }), turn.messages.length > 0 && _jsxs("details", { className: "external-messages", children: [_jsxs("summary", { children: [turn.messages.length, " earlier replies"] }), turn.messages.map((message, index) => _jsx("div", { children: renderText(message.text) }, index))] }), turn.reply ? renderText(turn.reply) : _jsx("p", { children: "No reply was observed." }), _jsxs("details", { className: "external-tools", children: [_jsxs("summary", { children: [turn.tools.length, " operations", turn.omittedTools ? ` · ${turn.omittedTools} not retained` : ''] }), _jsx("ol", { children: turn.tools.map(tool => _jsx("li", { id: 'external-tool-' + tool.id, children: _jsxs("details", { children: [_jsxs("summary", { children: [_jsx("strong", { children: tool.name }), _jsxs("span", { children: [tool.outcome === 'requested' ? 'Awaiting result' : tool.outcome === 'unknown' ? 'Outcome unknown' : tool.outcome, tool.exitCode !== undefined ? ' · exit ' + tool.exitCode : ''] })] }), _jsxs("small", { children: [new Date(tool.at).toLocaleString(), " \u00B7 ", tool.id] }), tool.detail && _jsx("pre", { children: tool.detail }), tool.output && _jsx("pre", { children: tool.output }), tool.paths.length > 0 && _jsxs("div", { className: "external-paths", children: [_jsx("small", { children: "Files mentioned \u00B7 opens current content" }), tool.paths.map(p => _jsx("button", { onClick: () => openFile(p), children: p }, p))] })] }) }, tool.id)) })] }), turn.omittedChars > 0 && _jsx("p", { className: "muted", children: "Some text exceeded the observation limit. The original client keeps its full record." })] }, turn.id)), kept && kept.first > 0 && _jsx("button", { onClick: () => void earlier(), children: "Earlier turns" }), _jsxs("details", { className: "external-source", children: [_jsx("summary", { children: "Source and observation" }), _jsxs("dl", { children: [_jsx("dt", { children: "Native session" }), _jsx("dd", { children: session.sessionId }), _jsx("dt", { children: "Last observed" }), _jsx("dd", { children: new Date(session.observedAt).toLocaleString() }), _jsx("dt", { children: "Native events read" }), _jsx("dd", { children: session.sourceCursor })] })] })] });
+}

package/node_modules/@rho-workspace/plugin-agent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rho-workspace/plugin-agent",
-  "version": "0.4.28",
+  "version": "0.4.29",
   "type": "module",
   "description": "Rho agent plugin",
   "license": "AGPL-3.0-only",
@@ -8,6 +8,9 @@
     "node": ">=22.22.0 <23"
   },
   "exports": {
+    "./external-session": "./dist/external-session.js",
+    "./dsh-session": "./dist/dsh-session.js",
+    "./external-session-contract": "./dist/external-session-contract.js",
     "./session-contract": "./dist/session-contract.js",
     "./conversation": "./dist/conversation.js",
     "./activity-normalize": "./dist/activity-normalize.js",
@@ -25,6 +28,7 @@
     "./claude-feedback-hook": "./dist/claude-feedback-hook.js",
     "./claude-feedback-worker": "./dist/claude-feedback-worker.js",
     "./ui": "./dist/ui.js",
+    "./ui-external-session": "./dist/ui-external-session.js",
     "./layered-contract": "./dist/layered-contract.js",
     "./layered": "./dist/layered.js",
     "./external-acp": "./dist/external-acp.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rho-workspace/rho",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "type": "module",
   "description": "Rho local workspace service, scoped browser shell and headless client",
   "license": "AGPL-3.0-only",
@@ -56,7 +56,9 @@
     "scripts/ui-toolchain.json",
     "scripts/ui-preview",
     "web/theme.css",
-    "docs/PLUGIN-AUTHORING.md"
+    "docs/PLUGIN-AUTHORING.md",
+    "docs/THIRD-PARTY-PLUGINS.md",
+    "scripts/third-party-acceptance.mjs"
   ],
   "scripts": {
     "acceptance:collaboration": "node scripts/collaboration-acceptance.mjs",
@@ -77,7 +79,7 @@
     "@rho-workspace/plugin-tables": "file:vendor/rho-workspace-plugin-tables-0.5.0.tgz",
     "@rho-workspace/plugin-media": "file:vendor/rho-workspace-plugin-media-0.4.0.tgz",
     "@rho-workspace/plugin-charts": "file:vendor/rho-workspace-plugin-charts-0.4.0.tgz",
-    "@rho-workspace/plugin-agent": "file:vendor/rho-workspace-plugin-agent-0.4.28.tgz",
+    "@rho-workspace/plugin-agent": "file:vendor/rho-workspace-plugin-agent-0.4.29.tgz",
     "@rho-workspace/plugin-annotations": "file:vendor/rho-workspace-plugin-annotations-0.5.2.tgz",
     "@rho-workspace/plugin-console": "file:vendor/rho-workspace-plugin-console-0.3.1.tgz",
     "@rho-workspace/plugin-kernel": "file:vendor/rho-workspace-plugin-kernel-0.5.5.tgz",

package/protocol/index.json

@@ -74,6 +74,18 @@
       "bytes": 3705,
       "sha256": "64d31b4cefd29c0132bc82223775ada64f974df17216a06e8be5e7ff98461d1e"
     },
+    "agent.sessions.list": {
+      "summary": "agent.sessions.list",
+      "path": "operations/agent.sessions.list.json",
+      "bytes": 2202,
+      "sha256": "43d0306205db0acba77d71280e8b5aa23a47cbed66c05c8710a39e6285fd5e3b"
+    },
+    "agent.sessions.read": {
+      "summary": "agent.sessions.read",
+      "path": "operations/agent.sessions.read.json",
+      "bytes": 6355,
+      "sha256": "1804a39c7edaf0caaf328404936aab0cd4d3d9e1731d7d03a86cc57c642d9c10"
+    },
     "annotation.create": {
       "summary": "annotation.create",
       "path": "operations/annotation.create.json",
@@ -404,6 +416,48 @@
       "bytes": 1004,
       "sha256": "4fbf03970c525ad073153aad9846ce960da2369b8cb45b4b6aaeef95cd8f19fd"
     },
+    "extension.call": {
+      "summary": "Call an enabled third-party operation at the described package digest, under the caller and project. The package runs trusted native code. Non-read calls retain the original changeId: repeat observes that invocation, including unknown outcomes, without re-execution. Completion is not scientific validity.",
+      "path": "operations/extension.call.json",
+      "bytes": 3054,
+      "sha256": "fef35859de95442313afcf2fb517ab7ec2e30781344e0b77174b904f70e5df3b"
+    },
+    "extension.content": {
+      "summary": "Read one installed plugin Skill or standalone HTML view at its selected package digest. Reading starts no plugin or runtime.",
+      "path": "operations/extension.content.json",
+      "bytes": 1627,
+      "sha256": "fe3542d6f35267766ef5227d9d6cb98009895ac9ec9cdc1355fbed97e07c77d9"
+    },
+    "extension.describe": {
+      "summary": "Read an installed third-party package manifest, operation input schemas, required Rho methods, Skills and views. Read its Skill with extension.content before use. Disabled packages cannot run.",
+      "path": "operations/extension.describe.json",
+      "bytes": 4684,
+      "sha256": "441616d6e634daa1ce2d058f6d0b0bd7ccd494de33f01a3dae3d6c344dc6f1a9"
+    },
+    "extension.install": {
+      "summary": "Local person/operator: install a trusted prebuilt npm package, local folder, tarball, or Git source. Lifecycle scripts are disabled. Replacement stages and checks the new package before switching; use replace and expectedDigest for updates.",
+      "path": "operations/extension.install.json",
+      "bytes": 4803,
+      "sha256": "862db9660b7c6d0ddfe53aa2c3e1254c0d4a4a717f23c6b820c3248d916b7ce9"
+    },
+    "extension.list": {
+      "summary": "List independently installed third-party packages and their enabled state, source and immutable digest. Reads start no plugin or runtime. Use extension.describe to discover operation schemas and Skills.",
+      "path": "operations/extension.list.json",
+      "bytes": 2933,
+      "sha256": "4af06a8a7c11dbed53a9d9804d215708d7e6b6c0edacdf1bf2817a3daf24f86f"
+    },
+    "extension.manage": {
+      "summary": "Local person/operator: enable, disable or remove an installed third-party package at the expected digest. Existing native tasks, R sessions, project files and retained receipts are preserved.",
+      "path": "operations/extension.manage.json",
+      "bytes": 1207,
+      "sha256": "90a83550840d2d33d3d0c7e5db0dcd09de4752b0b829f65a0cac2f39dbdf5a07"
+    },
+    "extension.read": {
+      "summary": "Observe an original plugin invocation, including pending or unknown outcomes. Never reruns code. Only its original caller can read it.",
+      "path": "operations/extension.read.json",
+      "bytes": 2409,
+      "sha256": "81f219ef1ce3aa15a3d7bd5865a97e141ff5db3ab4629a1eef7928dcf9681d40"
+    },
     "feedback.read": {
       "summary": "Original business binding only: fetch one complete frozen feedback object using its original delivery/context and a stable fetchId. relatedDocumentId is a pointer: read its CURRENT version before conditional edit/save and preserve human changes. This owner-served receipt does not prove client return or understanding.",
       "path": "operations/feedback.read.json",
@@ -605,8 +659,8 @@
     "project.work.read": {
       "summary": "Person at this machine only: read linked Agent sessions, retained native activity identities, current referenced files and the shared notes document. Source cursors and resource versions remain independent. Does not start an Agent, collector or Host.",
       "path": "operations/project.work.read.json",
-      "bytes": 22226,
-      "sha256": "fb1426f26fa7bbb5c01671832b58cac79aa708bc056d8a3cc8e6f0cfc249d9ab"
+      "bytes": 22262,
+      "sha256": "51d070968ec8b567765acecb7c8ddc83411fe222c469641b2679cc00a5cb1008"
     },
     "protocol.describe": {
       "summary": "protocol.describe",
@@ -683,8 +737,8 @@
     "session.grant": {
       "summary": "session.grant",
       "path": "operations/session.grant.json",
-      "bytes": 4767,
-      "sha256": "95564602b9006b5fe960bad93460916c1461f9578766d2fd95a1bccfd866b7a4"
+      "bytes": 5059,
+      "sha256": "d5d0e15b50349fbec4affa99ceb1b98c79a6dbdce048e1305f8cd8ad31a3fdd2"
     },
     "skill.list": {
       "summary": "List the application and enabled provider Skills shipped in the selected package. Skills guide discovery but do not grant authorization.",

package/protocol/operations/agent.sessions.list.json

@@ -0,0 +1,100 @@
+{
+  "method": "agent.sessions.list",
+  "inputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9._:@-]{1,128}$"
+      }
+    },
+    "required": [
+      "projectId"
+    ],
+    "type": "object"
+  },
+  "outputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "omitted": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "sessions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "pattern": "^x-[a-f0-9]{64}$",
+              "type": "string"
+            },
+            "inputOwner": {
+              "const": "external"
+            },
+            "lastAt": {
+              "type": "string"
+            },
+            "observedAt": {
+              "type": "string"
+            },
+            "omittedTurns": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "problem": {
+              "type": "string"
+            },
+            "producer": {
+              "type": "string"
+            },
+            "sessionId": {
+              "type": "string"
+            },
+            "sourceCursor": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "state": {
+              "enum": [
+                "running",
+                "completed",
+                "failed",
+                "stopped",
+                "unknown"
+              ]
+            },
+            "title": {
+              "type": "string"
+            },
+            "turns": {
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "id",
+            "producer",
+            "sessionId",
+            "title",
+            "lastAt",
+            "observedAt",
+            "state",
+            "turns",
+            "sourceCursor",
+            "omittedTurns",
+            "inputOwner"
+          ],
+          "type": "object"
+        },
+        "maxItems": 64,
+        "type": "array"
+      }
+    },
+    "required": [
+      "sessions",
+      "omitted"
+    ],
+    "type": "object"
+  },
+  "description": null
+}

package/protocol/operations/agent.sessions.read.json

@@ -0,0 +1,266 @@
+{
+  "method": "agent.sessions.read",
+  "inputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9._:@-]{1,128}$"
+      },
+      "before": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "limit": {
+        "maximum": 20,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "session": {
+        "pattern": "^x-[a-f0-9]{64}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "projectId",
+      "session"
+    ],
+    "type": "object"
+  },
+  "outputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "first": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "session": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "pattern": "^x-[a-f0-9]{64}$",
+            "type": "string"
+          },
+          "inputOwner": {
+            "const": "external"
+          },
+          "lastAt": {
+            "type": "string"
+          },
+          "observedAt": {
+            "type": "string"
+          },
+          "omittedTurns": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "problem": {
+            "type": "string"
+          },
+          "producer": {
+            "type": "string"
+          },
+          "sessionId": {
+            "type": "string"
+          },
+          "sourceCursor": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "state": {
+            "enum": [
+              "running",
+              "completed",
+              "failed",
+              "stopped",
+              "unknown"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "turns": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "producer",
+          "sessionId",
+          "title",
+          "lastAt",
+          "observedAt",
+          "state",
+          "turns",
+          "sourceCursor",
+          "omittedTurns",
+          "inputOwner"
+        ],
+        "type": "object"
+      },
+      "turns": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "at": {
+              "type": "string"
+            },
+            "endedAt": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "messages": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "at": {
+                    "type": "string"
+                  },
+                  "text": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "at",
+                  "text"
+                ],
+                "type": "object"
+              },
+              "maxItems": 200,
+              "type": "array"
+            },
+            "omittedChars": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "omittedTools": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "prompt": {
+              "type": "string"
+            },
+            "reply": {
+              "type": "string"
+            },
+            "results": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  },
+                  "projectId": {
+                    "type": "string"
+                  },
+                  "toolId": {
+                    "type": "string"
+                  },
+                  "version": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "path",
+                  "toolId"
+                ],
+                "type": "object"
+              },
+              "maxItems": 64,
+              "type": "array"
+            },
+            "state": {
+              "enum": [
+                "running",
+                "completed",
+                "failed",
+                "stopped",
+                "unknown"
+              ]
+            },
+            "tools": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "at": {
+                    "type": "string"
+                  },
+                  "detail": {
+                    "type": "string"
+                  },
+                  "exitCode": {
+                    "type": "integer"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "outcome": {
+                    "enum": [
+                      "requested",
+                      "returned",
+                      "failed",
+                      "unknown"
+                    ]
+                  },
+                  "output": {
+                    "type": "string"
+                  },
+                  "paths": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "maxItems": 32,
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "id",
+                  "at",
+                  "name",
+                  "detail",
+                  "output",
+                  "outcome",
+                  "paths"
+                ],
+                "type": "object"
+              },
+              "maxItems": 256,
+              "type": "array"
+            }
+          },
+          "required": [
+            "id",
+            "at",
+            "state",
+            "prompt",
+            "reply",
+            "messages",
+            "tools",
+            "results",
+            "omittedTools",
+            "omittedChars"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      }
+    },
+    "required": [
+      "session",
+      "first",
+      "turns"
+    ],
+    "type": "object"
+  },
+  "description": null
+}