@particle-academy/agent-integrations 0.39.1 → 0.41.0

package/dist/components-shared-whiteboard.js

@@ -1,5 +1,5 @@
-import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-QYWPCRT2.js';
-import { createSessionDescriptor, attachSseRelay } from './chunk-JDCB2NMM.js';
+import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-QDC7MXBH.js';
+import { createSessionDescriptor, attachSseRelay } from './chunk-6TZ5IBRN.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
 import { registerWhiteboardBridge } from './chunk-2U5JB6ZA.js';
 import './chunk-CT3LRNH7.js';

package/dist/index.cjs

@@ -2800,6 +2800,13 @@ function registerGitBridge(host, options) {
 // src/bridges/files.ts
 var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
 var MAX_SNAPSHOT_DEPTH = 8;
+function invalidFolderName(name) {
+  const trimmed = name.trim();
+  if (trimmed === "") return "A folder name is required.";
+  if (trimmed.includes("/") || trimmed.includes("\\")) return "A folder name may not contain a path separator.";
+  if (trimmed === "." || trimmed === "..") return "That folder name is reserved.";
+  return null;
+}
 function assertPathWithinRoot(root, path) {
   const segments = path.replace(/[\\/]+/g, "/").split("/");
   if (segments.includes("..")) {
@@ -2829,6 +2836,7 @@ var asPaths = (v) => {
 function registerFilesBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
+  const pendingMode = options.pendingMode ?? true;
   const disposers = [];
   const guard = (path) => {
     if (options.root !== void 0) assertPathWithinRoot(options.root, path);
@@ -2995,6 +3003,42 @@ function registerFilesBridge(host, options) {
     },
     fTarget
   );
+  if (adapter.createFolder) {
+    reg(
+      "files_create_folder",
+      "Create a folder inside `parentPath`. Staged for human confirmation unless the host disabled pendingMode.",
+      {
+        parentPath: { type: "string", description: "Directory to create in; defaults to the current directory." },
+        name: { type: "string", description: "The new folder's name. A leaf name \u2014 no separators." },
+        confirm: { type: "boolean", description: "Acknowledge a staged write when the host wired no confirm hook." }
+      },
+      ["name"],
+      async (args) => {
+        const parentPath = guard(args.parentPath !== void 0 ? str3(args.parentPath) : adapter.getPath());
+        const name = str3(args.name).trim();
+        const invalid = invalidFolderName(name);
+        if (invalid) return errorResult(invalid);
+        const label = `${parentPath}/${name}`;
+        if (pendingMode) {
+          if (options.confirm) {
+            const ok = await options.confirm({ action: "files_create_folder", path: label, label });
+            if (!ok) return errorResult(`Declined: create folder ${label} (human did not confirm).`);
+          } else if (args.confirm !== true) {
+            return errorResult(
+              `Staged: create folder ${label}. Re-call with confirm:true to proceed.`
+            );
+          }
+        }
+        try {
+          await adapter.createFolder({ parentPath, name });
+        } catch (e) {
+          return errorResult(e instanceof Error ? e.message : String(e));
+        }
+        return textResult(`Created folder ${label}.`, { parentPath, name, path: label });
+      },
+      (args) => ({ kind: "directory", path: `${str3(args.parentPath)}/${str3(args.name)}`, label: str3(args.name) })
+    );
+  }
   reg(
     "files_request_snapshot",
     "Request a fresh snapshot subtree rooted at `path` (snapshot mode) \u2014 e.g. to pull a remote machine's current tree. Requires the host to wire requestSnapshot.",
@@ -4887,9 +4931,9 @@ var SseRelayTransport = class {
       this.peers.add(subscriberId);
       this.notifyPeers();
       fancyAutoCommon.emitActivity({
-        agentId: "agent",
-        agentName: "Agent",
-        agentColor: "#a855f7",
+        agentId: this.opts.agent?.id ?? "agent",
+        agentName: this.opts.agent?.name ?? "Agent",
+        agentColor: this.opts.agent?.color ?? "#a855f7",
         action: "agent_connected",
         timestamp: Date.now(),
         target: { kind: "navigation", label: "Agent connected" },
@@ -4903,9 +4947,9 @@ var SseRelayTransport = class {
       this.notifyPeers();
       if (this.peers.size === 0) {
         fancyAutoCommon.emitActivity({
-          agentId: "agent",
-          agentName: "Agent",
-          agentColor: "#a855f7",
+          agentId: this.opts.agent?.id ?? "agent",
+          agentName: this.opts.agent?.name ?? "Agent",
+          agentColor: this.opts.agent?.color ?? "#a855f7",
           action: "agent_disconnected",
           timestamp: Date.now(),
           target: { kind: "navigation", label: "Agent disconnected" },
@@ -4928,6 +4972,15 @@ function attachSseRelay(server, options) {
   transport.start();
   Promise.resolve().then(() => (init_registry(), registry_exports)).then(({ onActivity: onActivity2 }) => {
     const off = onActivity2((event) => {
+      if (options.activityFilter) {
+        let keep;
+        try {
+          keep = options.activityFilter(event);
+        } catch {
+          return;
+        }
+        if (!keep) return;
+      }
       transport.send({
         jsonrpc: "2.0",
         method: "notifications/agent_activity",
@@ -4991,7 +5044,13 @@ function useCoBrowseSession(options) {
     if (!response.ok) {
       throw new Error(`Relay registration failed (${response.status})`);
     }
-    const relay = attachSseRelay(server, { baseUrl: relayBaseUrl, sessionId: descriptor.id, token: descriptor.token });
+    const relay = attachSseRelay(server, {
+      baseUrl: relayBaseUrl,
+      sessionId: descriptor.id,
+      token: descriptor.token,
+      agent: options.agent,
+      activityFilter: options.activityFilter
+    });
     relay.onStateChange(setRelayState);
     relay.onPeersChange(setAgentCount);
     relayRef.current = relay;