repoburg 1.3.260 → 1.3.261

package/agent-pane/backend/dist/index.js

@@ -43612,6 +43612,19 @@ App state does NOT live in this folder \u2014 it is stored in the pane database
 - submitTurn(sessionId, prompt) - send a prompt to a session
 - onTurnCompleted(callback) - callback(event, { turnId, response }) when a turn ends
 - onToolCall(callback) - callback({ callId, name, tool, args }) when the AGENT calls one of the manifest tools (name and tool carry the same tool name); answer with resolveToolCall(callId, result)
+- openSession(sessionId) - show that session in the pane (the view switches to its conversation); works only while the app is on screen, so call it from a click handler
+- openUrl(url) - open an absolute http(s) URL in a new browser tab; call it from a click handler (popup blockers allow tabs opened by a click)
+
+## Links and navigation
+
+The app runs in a sandboxed frame. Never navigate the frame itself
+(location.href = ...): the page would replace the app, and most sites
+refuse to be framed.
+- external pages: a plain <a href="https://..."> link opens in a new
+  browser tab (target="_blank" works too); from code use
+  AgentPane.openUrl(url)
+- sessions: AgentPane.openSession(id), e.g. a "session" link next to a
+  job row (ids come from createSession)
 
 ## Agent tool calls (manifest "tools")
 
@@ -43626,7 +43639,8 @@ Headless contract for apps that declare tools:
 - headless state is the instance of the CALLING session's workspace
   ('' = global when the caller has no known workspace); open tabs
   sync via onStateChanged
-- createSession/submitTurn are not available in the headless runtime
+- createSession/submitTurn/openSession/openUrl are not available in the
+  headless runtime
 
 If the app cannot load headless (broken app.js, no handler), the pane
 falls back to relaying calls into the OPEN app iframe \u2014 the app must be
@@ -43678,6 +43692,13 @@ function readState(id) {
     return { pinned: false, data: null };
   }
 }
+function isRegularFile(p) {
+  try {
+    return fs.statSync(p).isFile();
+  } catch {
+    return false;
+  }
+}
 var watcher = null;
 var pendingChanges = /* @__PURE__ */ new Map();
 var HOT_RELOAD_DEBOUNCE_MS = 250;
@@ -43692,6 +43713,7 @@ function startAppsWatch(onAppChange) {
       const appId = segs[0];
       const file = segs[segs.length - 1];
       if (!appId || appId === path3.basename(root) || !APP_ID_RE.test(appId) || file === "state.json") return;
+      if (segs.length === 1 && isRegularFile(path3.join(root, appId))) return;
       const timer = pendingChanges.get(appId);
       if (timer) clearTimeout(timer);
       pendingChanges.set(
@@ -43795,6 +43817,12 @@ declare const AgentPane: {
   onToolCall(cb: (payload: AgentPaneToolCallPayload) => void): void;
   onStateChanged(cb: (payload: unknown) => void): void;
   resolveToolCall(callId: string, result?: unknown): Promise<{ ok: boolean }>;
+  /** Show a session in the pane (switches the view to its conversation).
+   *  Only works while the app is on screen: call it from a click handler. */
+  openSession(sessionId: string): Promise<{ ok: boolean }>;
+  /** Open an absolute http(s) URL in a new browser tab. Call it from a click
+   *  handler: popup blockers allow tabs opened by a user gesture. */
+  openUrl(url: string): Promise<{ ok: boolean }>;
 };
 `;
 var cache = /* @__PURE__ */ new Map();
@@ -44046,6 +44074,8 @@ function getHeadlessToolHandler(appId, workspace = "") {
     // UI-flow APIs are intentionally unavailable headless.
     createSession: () => Promise.reject(new Error("createSession is not available in the headless runtime")),
     submitTurn: () => Promise.reject(new Error("submitTurn is not available in the headless runtime")),
+    openSession: () => Promise.reject(new Error("openSession is not available in the headless runtime")),
+    openUrl: () => Promise.reject(new Error("openUrl is not available in the headless runtime")),
     onTurnCompleted: () => {
     },
     onTurnDelta: () => {
@@ -44230,6 +44260,7 @@ var SKELETON_TS = `// Skeleton mini app (TypeScript). window.AgentPane is the ty
 //   getState() / setState(data)   persistent state (survives reloads)
 //   createSession / submitTurn   talk to an agent session
 //   onTurnCompleted / onToolCall react to agent events
+//   openSession / openUrl        show a session / open a page in a new tab
 interface Ui {
   ready: boolean;
   data: Record<string, unknown>;

package/agent-pane/backend/dist/server.js

@@ -43599,6 +43599,19 @@ App state does NOT live in this folder \u2014 it is stored in the pane database
 - submitTurn(sessionId, prompt) - send a prompt to a session
 - onTurnCompleted(callback) - callback(event, { turnId, response }) when a turn ends
 - onToolCall(callback) - callback({ callId, name, tool, args }) when the AGENT calls one of the manifest tools (name and tool carry the same tool name); answer with resolveToolCall(callId, result)
+- openSession(sessionId) - show that session in the pane (the view switches to its conversation); works only while the app is on screen, so call it from a click handler
+- openUrl(url) - open an absolute http(s) URL in a new browser tab; call it from a click handler (popup blockers allow tabs opened by a click)
+
+## Links and navigation
+
+The app runs in a sandboxed frame. Never navigate the frame itself
+(location.href = ...): the page would replace the app, and most sites
+refuse to be framed.
+- external pages: a plain <a href="https://..."> link opens in a new
+  browser tab (target="_blank" works too); from code use
+  AgentPane.openUrl(url)
+- sessions: AgentPane.openSession(id), e.g. a "session" link next to a
+  job row (ids come from createSession)
 
 ## Agent tool calls (manifest "tools")
 
@@ -43613,7 +43626,8 @@ Headless contract for apps that declare tools:
 - headless state is the instance of the CALLING session's workspace
   ('' = global when the caller has no known workspace); open tabs
   sync via onStateChanged
-- createSession/submitTurn are not available in the headless runtime
+- createSession/submitTurn/openSession/openUrl are not available in the
+  headless runtime
 
 If the app cannot load headless (broken app.js, no handler), the pane
 falls back to relaying calls into the OPEN app iframe \u2014 the app must be
@@ -43665,6 +43679,13 @@ function readState(id) {
     return { pinned: false, data: null };
   }
 }
+function isRegularFile(p) {
+  try {
+    return fs.statSync(p).isFile();
+  } catch {
+    return false;
+  }
+}
 var watcher = null;
 var pendingChanges = /* @__PURE__ */ new Map();
 var HOT_RELOAD_DEBOUNCE_MS = 250;
@@ -43679,6 +43700,7 @@ function startAppsWatch(onAppChange) {
       const appId = segs[0];
       const file = segs[segs.length - 1];
       if (!appId || appId === path3.basename(root) || !APP_ID_RE.test(appId) || file === "state.json") return;
+      if (segs.length === 1 && isRegularFile(path3.join(root, appId))) return;
       const timer = pendingChanges.get(appId);
       if (timer) clearTimeout(timer);
       pendingChanges.set(
@@ -43782,6 +43804,12 @@ declare const AgentPane: {
   onToolCall(cb: (payload: AgentPaneToolCallPayload) => void): void;
   onStateChanged(cb: (payload: unknown) => void): void;
   resolveToolCall(callId: string, result?: unknown): Promise<{ ok: boolean }>;
+  /** Show a session in the pane (switches the view to its conversation).
+   *  Only works while the app is on screen: call it from a click handler. */
+  openSession(sessionId: string): Promise<{ ok: boolean }>;
+  /** Open an absolute http(s) URL in a new browser tab. Call it from a click
+   *  handler: popup blockers allow tabs opened by a user gesture. */
+  openUrl(url: string): Promise<{ ok: boolean }>;
 };
 `;
 var cache = /* @__PURE__ */ new Map();
@@ -44033,6 +44061,8 @@ function getHeadlessToolHandler(appId, workspace = "") {
     // UI-flow APIs are intentionally unavailable headless.
     createSession: () => Promise.reject(new Error("createSession is not available in the headless runtime")),
     submitTurn: () => Promise.reject(new Error("submitTurn is not available in the headless runtime")),
+    openSession: () => Promise.reject(new Error("openSession is not available in the headless runtime")),
+    openUrl: () => Promise.reject(new Error("openUrl is not available in the headless runtime")),
     onTurnCompleted: () => {
     },
     onTurnDelta: () => {
@@ -44217,6 +44247,7 @@ var SKELETON_TS = `// Skeleton mini app (TypeScript). window.AgentPane is the ty
 //   getState() / setState(data)   persistent state (survives reloads)
 //   createSession / submitTurn   talk to an agent session
 //   onTurnCompleted / onToolCall react to agent events
+//   openSession / openUrl        show a session / open a page in a new tab
 interface Ui {
   ready: boolean;
   data: Record<string, unknown>;