npm - @forwardimpact/libbridge - Versions diffs - 0.1.5 → 0.1.6 - Mend

@forwardimpact/libbridge 0.1.5 → 0.1.6

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 (6) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libbridge",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Threaded-channel bridge primitives — relay messages between human channels (GitHub Discussions, Microsoft Teams) and the Kata agent team.",
   "keywords": [
     "bridge",

package/src/dispatcher.js CHANGED Viewed

@@ -1,7 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { dispatchWorkflow } from "./dispatch.js";
-import { appendHistory } from "./history.js";
 /** Dispatch dance: resolve per-user token, register callback, ack, fire workflow, flush. */
 export class Dispatcher {
@@ -57,7 +56,6 @@ export class Dispatcher {
    * @param {string} args.requester - Surface user id of the triggering human
    * @param {object} args.callbackMeta - Stored on the callback token
    * @param {unknown} [args.ackTarget] - If omitted, no acknowledgement is started
-   * @param {string} [args.historyText] - Appended to ctx.history as the user turn on success
    * @param {object} [args.workflowInputs] - Extra fields for `dispatchWorkflow`
    * @returns {Promise<{kind: "dispatched", token: string, correlationId: string} | {kind: "link_required", authorizeUrl: string} | {kind: "reauth_required"} | {kind: "transient", error: Error}>}
    */
@@ -67,7 +65,6 @@ export class Dispatcher {
     requester,
     callbackMeta,
     ackTarget,
-    historyText,
     workflowInputs,
   }) {
     if (!ctx) throw new Error("ctx is required");
@@ -94,9 +91,6 @@ export class Dispatcher {
         correlationId,
         ...(workflowInputs ?? {}),
       });
-      if (historyText !== undefined) {
-        appendHistory(ctx.history, { role: "user", text: historyText });
-      }
       ctx.dispatches.push(Date.now());
       ctx.last_active_at = Date.now();
       await this.#store.add(ctx);

package/src/history.js CHANGED Viewed

@@ -9,6 +9,8 @@
  * @param {number} [options.maxEntries] - Default 10
  */
 export function appendHistory(history, entry, { maxEntries = 10 } = {}) {
-  history.push(entry);
+  const record = { role: entry.role, text: entry.text };
+  if (entry.author !== undefined) record.author = entry.author;
+  history.push(record);
   while (history.length > maxEntries) history.shift();
 }

package/src/index.js CHANGED Viewed

@@ -18,6 +18,8 @@
  * @property {(ctx: object) => Promise<void>} add
  * @property {() => Promise<void>} flush
  * @property {() => Promise<void>} shutdown
+ * @property {(target: object) => Promise<void>} [putPendingDispatch]
+ * @property {(linkToken: string) => Promise<object|null>} [resolvePendingDispatch]
  */
 export { createBridgeServer } from "./server.js";
@@ -47,3 +49,4 @@ export {
   validateCallbackPayload,
 } from "./callback-payload.js";
 export { evaluateTrigger, parseIsoDuration } from "./triggers.js";
+export { prepareLinkResume, createLinkCompleteHandler } from "./link-resume.js";

package/src/link-resume.js ADDED Viewed

@@ -0,0 +1,92 @@
+import { randomUUID } from "node:crypto";
+import { normalizeBaseUrl } from "./callback-payload.js";
+import { buildPrompt } from "./prompt.js";
+/**
+ * @param {string} authorizeUrl
+ * @param {string} callbackBaseUrl
+ * @returns {{ linkToken: string, augmentedUrl: string }}
+ */
+export function prepareLinkResume(authorizeUrl, callbackBaseUrl) {
+  const linkToken = randomUUID();
+  const url = new URL(authorizeUrl);
+  url.searchParams.set(
+    "redirect_uri",
+    `${normalizeBaseUrl(callbackBaseUrl)}/api/link-complete`,
+  );
+  url.searchParams.set("client_state", linkToken);
+  return { linkToken, augmentedUrl: url.toString() };
+}
+/**
+ * @param {object} options
+ * @returns {(c: import("hono").Context) => Promise<Response>}
+ */
+export function createLinkCompleteHandler({
+  channel,
+  store,
+  dispatcher,
+  buildCallbackMeta,
+}) {
+  return async (c) => {
+    const linkToken = c.req.query("state");
+    if (!linkToken) {
+      return c.html(
+        "<!DOCTYPE html><html><body><h1>Error</h1>" +
+          "<p>Missing state parameter.</p></body></html>",
+        400,
+      );
+    }
+    const target = await store.resolvePendingDispatch(linkToken);
+    if (!target) {
+      return c.html(
+        "<!DOCTYPE html><html><body><h1>Already processed</h1>" +
+          "<p>This link has already been used or has expired." +
+          "</p></body></html>",
+      );
+    }
+    const ctx = await store.loadByChannel(channel, target.discussion_id);
+    if (!ctx) {
+      return c.html(
+        "<!DOCTYPE html><html><body><h1>Error</h1>" +
+          "<p>Discussion not found.</p></body></html>",
+        404,
+      );
+    }
+    const userTurn = [...ctx.history]
+      .reverse()
+      .find((e) => e.role === "user" && e.author === target.surface_user_id);
+    if (!userTurn) {
+      return c.html(
+        "<!DOCTYPE html><html><body><h1>Error</h1>" +
+          "<p>No message found to re-dispatch.</p></body></html>",
+        404,
+      );
+    }
+    const result = await dispatcher.dispatch({
+      ctx,
+      prompt: buildPrompt(userTurn.text, ctx.history),
+      requester: target.surface_user_id,
+      callbackMeta: buildCallbackMeta(ctx),
+      workflowInputs: { discussionId: target.discussion_id },
+    });
+    if (result.kind === "dispatched") {
+      return c.html(
+        "<!DOCTYPE html><html><body><h1>Processing</h1>" +
+          "<p>Your message is being processed. " +
+          "You can close this window.</p></body></html>",
+      );
+    }
+    return c.html(
+      "<!DOCTYPE html><html><body><h1>Unable to dispatch</h1>" +
+        "<p>Your account could not be verified. Please try " +
+        "linking again from the conversation.</p></body></html>",
+    );
+  };
+}

package/src/server.js CHANGED Viewed

@@ -23,6 +23,7 @@ import { serve } from "@hono/node-server";
  * @param {string} options.webhookPath - e.g. `/api/messages` or `/api/webhooks/github`
  * @param {(c: import("hono").Context) => Promise<Response> | Response} options.onWebhook
  * @param {(c: import("hono").Context) => Promise<Response> | Response} options.onCallback
+ * @param {((c: import("hono").Context) => Promise<Response> | Response)} [options.onLinkComplete]
  * @returns {{ start: () => Promise<void>, stop: () => Promise<void>, app: import("hono").Hono, address: () => ({port: number} | null) }}
  */
 export function createBridgeServer({
@@ -32,6 +33,7 @@ export function createBridgeServer({
   webhookPath,
   onWebhook,
   onCallback,
+  onLinkComplete,
 }) {
   if (!config) throw new Error("config is required");
   if (!logger) throw new Error("logger is required");
@@ -86,6 +88,17 @@ export function createBridgeServer({
     }
   });
+  if (onLinkComplete) {
+    app.get("/api/link-complete", async (c) => {
+      try {
+        return await onLinkComplete(c);
+      } catch (err) {
+        logger.error("bridge.link-complete", err);
+        return c.json({ error: "Link completion failure" }, 500);
+      }
+    });
+  }
   let server = null;
   return {