npm - broapp - Versions diffs - 0.4.2 → 0.4.3 - Mend

broapp 0.4.2 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "broapp",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "description": "Build tooling and runtime for local applications made of a Bun host, a browser UI, and a Brobridge connection between them",
   "license": "MIT",
@@ -49,9 +49,9 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@brobridgejs/client": "^0.2.1",
-    "@brobridgejs/core": "^0.2.1",
-    "brobridge": "^0.2.1"
+    "@brobridgejs/client": "^0.2.2",
+    "@brobridgejs/core": "^0.2.2",
+    "brobridge": "^0.2.2"
   },
   "peerDependencies": {
     "react": ">=18",

package/src/ai/host/create-ai.ts CHANGED Viewed

@@ -71,6 +71,18 @@ export interface InProcessTurn {
   readonly history?: readonly ChatTurn[];
 }
+/** One question put to an in-process turn's stand-in. */
+export interface InProcessQuestion {
+  readonly tool: string;
+  readonly input: unknown;
+  /** The approval table's key, `<runId>:<callId>`. */
+  readonly requestId: string;
+  /** The call the question is about, as `ai.chatConfirm` names it with the run id. */
+  readonly callId: string;
+  /** When the question stops waiting, when the gate said. */
+  readonly expiresAt?: number;
+}
 /** How {@link Ai.turn} is answered and stopped. */
 export interface InProcessTurnOptions {
   /**
@@ -78,8 +90,14 @@ export interface InProcessTurnOptions {
    *
    * The caller is the person's stand-in, so it decides exactly as the person
    * would have: the gate still asks, and still records the answer.
+   *
+   * `'defer'` answers nothing. The question stays in the approval table for
+   * somebody else to answer by its request id, over `ai.chatConfirm` as a
+   * person in a chat would, and the gate's own window still ends it. That is
+   * for a stand-in that answers some questions itself and brings the rest to a
+   * person: whoever answers, each question is answered once.
    */
-  readonly answer: (question: { readonly tool: string; readonly input: unknown }) => boolean;
+  readonly answer: (question: InProcessQuestion) => boolean | 'defer';
   /** Aborting it cancels the turn, as a browser's cancel would. */
   readonly signal?: AbortSignal;
   readonly onEvent?: (event: ChatEvent) => void;
@@ -398,7 +416,14 @@ export function createAi(options: CreateAiOptions): Ai {
             // The gate's request id is `<runId>:<callId>`, which is what an
             // event without one would have named.
             const requestId = event.requestId ?? `${turn.runId}:${event.callId}`;
-            void settle(requestId, turnOptions.answer({ tool: event.tool ?? '', input: event.input }));
+            const answer = turnOptions.answer({
+              tool: event.tool ?? '',
+              input: event.input,
+              requestId,
+              callId: event.callId ?? '',
+              ...(event.expiresAt === undefined ? {} : { expiresAt: event.expiresAt }),
+            });
+            if (answer !== 'defer') void settle(requestId, answer);
           }
           return Promise.resolve();
         },

package/src/ai/host/index.ts CHANGED Viewed

@@ -12,6 +12,7 @@ export type {
   AiAppDescription,
   CreateAiOptions,
   DeliveredContext,
+  InProcessQuestion,
   InProcessTurn,
   InProcessTurnOptions,
   InProcessTurnResult,

package/src/ai/host/run.ts CHANGED Viewed

@@ -288,14 +288,22 @@ function boundOutput(output: unknown, max: number): unknown {
   return { type: 'text', value: cut(json, max) };
 }
-/** One transcript message with every tool input and output bounded. */
+/**
+ * One transcript message with every tool input and output bounded.
+ *
+ * A cut input stays an object, `{ truncated: "<head><omitted N chars>" }`,
+ * rather than becoming the string itself: an OpenAI-compatible provider sends
+ * a call's input as its `arguments`, and Ollama refuses a whole request whose
+ * arguments are not a JSON object ("invalid tool call arguments"). The first
+ * 12j evaluation lost a turn to exactly that.
+ */
 function boundMessage(message: ResponseMessage, limits: HistoryLimits): ModelMessage {
   if (!Array.isArray(message.content)) return message;
   const content = (message.content as readonly unknown[]).map((part) => {
     if (!isRecord(part)) return part;
     if (part['type'] === 'tool-call') {
       const json = JSON.stringify(part['input']) ?? '';
-      return json.length <= limits.inputChars ? part : { ...part, input: cut(json, limits.inputChars) };
+      return json.length <= limits.inputChars ? part : { ...part, input: { truncated: cut(json, limits.inputChars) } };
     }
     if (part['type'] === 'tool-result') return { ...part, output: boundOutput(part['output'], limits.outputChars) };
     return part;

package/src/host/runtime.ts CHANGED Viewed

@@ -76,6 +76,15 @@ export interface RunningApp {
    * looking attached for that whole minute.
    */
   readonly attached: boolean;
+  /**
+   * A fresh address for this application, carrying a new one-time launch token.
+   *
+   * Brobridge mints the token; each address works once and expires on the
+   * bridge's launch-token lifetime. Call it on the host's own decision — a
+   * person's click in an authenticated tab, a local process that already holds
+   * a credential — never because a browser asked. Do not log the result.
+   */
+  launchUrl(): string;
 }
 const POLL_INTERVAL_MS = 1_000;
@@ -215,5 +224,6 @@ export async function startApp(options: StartAppOptions): Promise<RunningApp> {
     get attached() {
       return isAttached();
     },
+    launchUrl: () => bridge.launchUrl(),
   };
 }