@opengeni/sdk 3.2.2 → 3.3.0

package/README.md

@@ -1115,6 +1115,27 @@ never enter the iframe; `@opengeni/sdk/site` uses a single parent-owned
 `MessagePort` that exposes only the retained tool allowlist intersected with the
 current viewer's live workspace catalog.
 
+Site AI can return directly into an app without any conversation UI:
+
+```ts
+import { createOpenGeniSiteClient } from "@opengeni/sdk/site";
+const site = createOpenGeniSiteClient();
+const result = await site.ai.run({ initialMessage: appPrompt, idempotencyKey: actionId });
+if (result.status === "completed") renderResult(result.text);
+```
+
+The app defines the prompt, context and output presentation. This helper uses
+native sessions and events with the same permissions, approvals, model access
+and billing; it is not a second executor. New Site work is private per viewer
+and excluded from ordinary workspace discovery. `pending` and `cancelled` are
+not successful results; model failure rejects. Retain the `onSession` handle
+to observe again using `site.ai.result(id, { turnId })`, without creating work.
+An `after` cursor returns only subsequent output; omit it for full replay.
+Aborting observation does not cancel native execution. See
+[`site-conversations.md`](../../docs/site-conversations.md) and
+[`site-session-embed`](../../examples/site-session-embed) for optional chat and
+headless inline examples. Do not store private handles in shared Site Data.
+
 ```ts
 let cursor: string | undefined;
 do {

package/dist/artifacts.js

@@ -1,9 +1,9 @@
 import {
   OpenGeniClient
-} from "./chunk-PDU6EU2M.js";
-import "./chunk-JP62FZSI.js";
-import "./chunk-JKG75TTU.js";
-import "./chunk-VPVMLM7Q.js";
+} from "./chunk-S5XTUA7L.js";
+import "./chunk-MJWC6GTA.js";
+import "./chunk-BWAJPU5S.js";
+import "./chunk-X5ITQVXE.js";
 import "./chunk-4AHR4KGA.js";
 import "./chunk-KADZ5PGG.js";
 import "./chunk-O7KANXC3.js";

package/dist/browser.js

@@ -8,8 +8,8 @@ import {
 } from "./chunk-P7UWKORG.js";
 import {
   OpenGeniClient
-} from "./chunk-JKG75TTU.js";
-import "./chunk-VPVMLM7Q.js";
+} from "./chunk-BWAJPU5S.js";
+import "./chunk-X5ITQVXE.js";
 import "./chunk-4AHR4KGA.js";
 import {
   OPENGENI_API_CONTRACT_HEADER,

package/dist/chat/index.js

@@ -8,17 +8,24 @@ import {
   uuidV5
 } from "../chunk-XA7HVIHI.js";
 import {
-  EMPTY_FINAL_REPLY_NOTICE,
-  OpenGeniEmbeddingClient,
-  turnCompletedWithEmptyFinalReply
-} from "../chunk-N2I422X4.js";
-import "../chunk-PDU6EU2M.js";
-import "../chunk-JP62FZSI.js";
+  OpenGeniEmbeddingClient
+} from "../chunk-HP7NVCAX.js";
+import "../chunk-S5XTUA7L.js";
+import "../chunk-MJWC6GTA.js";
 import {
   chatDefaults
 } from "../chunk-UM4ZXXJR.js";
-import "../chunk-JKG75TTU.js";
-import "../chunk-VPVMLM7Q.js";
+import {
+  ChatPendingFold,
+  ChatTurnFold,
+  OpenGeniChatError,
+  approvalPending,
+  asRecord,
+  humanInputPending,
+  stringValue
+} from "../chunk-OV3POE62.js";
+import "../chunk-BWAJPU5S.js";
+import "../chunk-X5ITQVXE.js";
 import {
   parseSseStream
 } from "../chunk-4AHR4KGA.js";
@@ -29,347 +36,6 @@ import {
   OpenGeniSetupError
 } from "../chunk-7EWT3PV6.js";
 
-// src/chat/types.ts
-var OpenGeniChatError = class extends Error {
-  code;
-  event;
-  constructor(code, message, event = null) {
-    super(message);
-    this.name = "OpenGeniChatError";
-    this.code = code;
-    this.event = event;
-  }
-};
-
-// src/chat/fold.ts
-var ChatPendingFold = class {
-  requests = /* @__PURE__ */ new Map();
-  push(event) {
-    const payload = asRecord(event.payload);
-    if (event.type === "session.requiresAction") {
-      for (const [key, request] of this.requests) {
-        if (request.pending.kind === "approval") this.requests.delete(key);
-      }
-      for (const approval of Array.isArray(payload.approvals) ? payload.approvals : []) {
-        const pending = approvalPending({ approvals: [approval] });
-        if (pending) this.put(pending, event.turnId ?? null);
-      }
-    } else if (event.type === "session.humanInput.requested") {
-      const pending = humanInputPending(payload);
-      if (pending) this.put(pending, event.turnId ?? null);
-    } else if (event.type === "user.approvalDecision") {
-      this.requests.delete(`approval:${payload.approvalId}`);
-    } else if (event.type === "user.humanInputResponse") {
-      this.requests.delete(`human_input:${payload.requestId}`);
-    } else if (["turn.completed", "turn.failed", "turn.cancelled"].includes(event.type)) {
-      for (const [key, request] of this.requests) {
-        if (request.turnId === null || event.turnId == null || request.turnId === event.turnId) {
-          this.requests.delete(key);
-        }
-      }
-    }
-  }
-  pending(now = Date.now()) {
-    return [...this.requests.values()].map((request) => request.pending).filter((pending) => {
-      if (pending.kind !== "human_input") return true;
-      const expiresAt = asRecord(pending.payload).expiresAt;
-      return expiresAt == null || typeof expiresAt === "string" && Date.parse(expiresAt) > now;
-    });
-  }
-  put(pending, turnId) {
-    this.requests.set(`${pending.kind}:${pending.requestId}`, { pending, turnId });
-  }
-};
-function noStep() {
-  return { chunks: [], terminal: null };
-}
-var ChatTurnFold = class {
-  constructor(workspaceId, sessionId, expectedTurnId) {
-    this.workspaceId = workspaceId;
-    this.sessionId = sessionId;
-    this.turnId = expectedTurnId;
-  }
-  events = [];
-  turnId;
-  pending = null;
-  failure = null;
-  emptyFinalReply = false;
-  segments = [];
-  openTools = /* @__PURE__ */ new Map();
-  get text() {
-    return this.segments.filter((segment) => !segment.commentary).map((segment) => segment.text).filter((text) => text.length > 0).join("\n\n");
-  }
-  push(event) {
-    const eventTurnId = typeof event.turnId === "string" ? event.turnId : null;
-    if (this.turnId && eventTurnId && eventTurnId !== this.turnId) {
-      return { chunks: [], terminal: null };
-    }
-    if (!this.turnId && eventTurnId && isTurnScopedType(event.type)) {
-      this.turnId = eventTurnId;
-    }
-    this.events.push(event);
-    const payload = asRecord(event.payload);
-    switch (event.type) {
-      case "agent.message.delta": {
-        const text = stringValue(payload.text);
-        if (!text) return noStep();
-        const messageId = stringValue(payload.messageId) || null;
-        if (messageId) return this.messageDelta(messageId, text, isCommentary(payload));
-        const open = this.segments.at(-1);
-        if (isCommentary(payload)) {
-          if (open?.open && open.commentary) {
-            open.text += text;
-          } else {
-            this.closeSegments();
-            this.segments.push({ text, open: true, commentary: true, messageId: null });
-          }
-          return noStep();
-        }
-        if (open?.open && !open.commentary) {
-          open.text += text;
-        } else {
-          this.closeSegments();
-          return { chunks: [this.startSegment(text, true, null)], terminal: null };
-        }
-        return { chunks: [{ type: "text", text }], terminal: null };
-      }
-      case "agent.message.completed": {
-        const text = stringValue(payload.text) ?? "";
-        const messageId = stringValue(payload.messageId) || null;
-        if (messageId) return this.messageCompleted(messageId, text, isCommentary(payload));
-        const last = this.segments.at(-1);
-        if (isCommentary(payload)) {
-          if (last?.commentary && (last.open || text.startsWith(last.text))) {
-            last.open = false;
-            if (text) last.text = text;
-            return noStep();
-          }
-          const streamed = last && !last.commentary && last.open && text.startsWith(last.text);
-          if (!streamed) {
-            if (text) {
-              this.closeSegments();
-              this.segments.push({ text, open: false, commentary: true, messageId: null });
-            }
-            return noStep();
-          }
-        }
-        const target = last?.commentary ? void 0 : last;
-        if (!target || !target.open && target.text && !text.startsWith(target.text)) {
-          if (!text) return noStep();
-          if (payload.phase === void 0 && this.latestAnswer()?.text === text) return noStep();
-          this.closeSegments();
-          return { chunks: [this.startSegment(text, false, null)], terminal: null };
-        }
-        target.open = false;
-        return { chunks: this.extendAnswer(target, text), terminal: null };
-      }
-      case "agent.toolCall.created": {
-        this.closeSegments();
-        const name = stringValue(payload.name) ?? "tool";
-        const callId = stringValue(payload.id);
-        if (callId) this.openTools.set(callId, name);
-        return {
-          chunks: [
-            {
-              type: "tool",
-              name,
-              status: "started",
-              ...callId ? { callId } : {},
-              ..."arguments" in payload ? { input: payload.arguments } : {}
-            }
-          ],
-          terminal: null
-        };
-      }
-      case "agent.toolCall.output": {
-        const callId = stringValue(payload.id);
-        const name = (callId ? this.openTools.get(callId) : void 0) ?? "tool";
-        if (callId) this.openTools.delete(callId);
-        return {
-          chunks: [
-            {
-              type: "tool",
-              name,
-              status: isErrorOutput(payload) ? "failed" : "completed",
-              ...callId ? { callId } : {}
-            }
-          ],
-          terminal: null
-        };
-      }
-      case "session.requiresAction": {
-        const pending = approvalPending(payload);
-        if (!pending) return { chunks: [], terminal: null };
-        this.pending = pending;
-        return {
-          chunks: [...this.settleSegments(), { type: "pending", pending }],
-          terminal: "pending"
-        };
-      }
-      case "session.humanInput.requested": {
-        const pending = humanInputPending(payload);
-        if (!pending) return { chunks: [], terminal: null };
-        this.pending = pending;
-        return {
-          chunks: [...this.settleSegments(), { type: "pending", pending }],
-          terminal: "pending"
-        };
-      }
-      case "turn.completed":
-        this.emptyFinalReply = turnCompletedWithEmptyFinalReply(payload);
-        return { chunks: this.settleSegments(), terminal: "completed" };
-      case "turn.failed":
-        this.failure = event;
-        return { chunks: this.settleSegments(), terminal: "failed" };
-      case "turn.cancelled":
-        return { chunks: this.settleSegments(), terminal: "cancelled" };
-      default:
-        return { chunks: [], terminal: null };
-    }
-  }
-  reply(terminal) {
-    const text = this.text;
-    return {
-      text,
-      sessionId: this.sessionId,
-      workspaceId: this.workspaceId,
-      turnId: this.turnId,
-      status: terminal === "pending" ? "pending" : terminal === "cancelled" ? "cancelled" : "completed",
-      pending: this.pending,
-      ...this.emptyFinalReply ? { emptyFinalReply: true, notice: EMPTY_FINAL_REPLY_NOTICE } : {},
-      events: [...this.events],
-      toString: () => text
-    };
-  }
-  /** The error to throw for a `turn.failed` settlement. */
-  failureError() {
-    const payload = asRecord(this.failure?.payload);
-    const code = stringValue(payload.code) ?? "turn_failed";
-    const message = stringValue(payload.error) ?? stringValue(payload.message) ?? "The turn failed.";
-    return new OpenGeniChatError(code, message, this.failure);
-  }
-  messageDelta(messageId, text, commentary) {
-    const segment = this.segmentOf(messageId);
-    if (segment?.open) {
-      segment.text += text;
-      return segment.commentary ? noStep() : { chunks: [{ type: "text", text }], terminal: null };
-    }
-    this.closeSegments();
-    if (commentary) {
-      this.segments.push({ text, open: true, commentary: true, messageId });
-      return noStep();
-    }
-    return { chunks: [this.startSegment(text, true, messageId)], terminal: null };
-  }
-  messageCompleted(messageId, text, commentary) {
-    const segment = this.segmentOf(messageId) ?? this.unidentifiedStreamingSegment(text);
-    if (segment) {
-      segment.messageId = messageId;
-      segment.open = false;
-      if (segment.commentary) {
-        if (text) segment.text = text;
-        return noStep();
-      }
-      return { chunks: this.extendAnswer(segment, text), terminal: null };
-    }
-    if (!text) return noStep();
-    if (commentary) {
-      this.segments.push({ text, open: false, commentary: true, messageId });
-      return noStep();
-    }
-    return { chunks: [this.startSegment(text, false, messageId)], terminal: null };
-  }
-  segmentOf(messageId) {
-    return this.findLastSegment((segment) => segment.messageId === messageId);
-  }
-  /** Deltas that carried no identity, still streaming the text this completion names. */
-  unidentifiedStreamingSegment(text) {
-    const last = this.segments.at(-1);
-    return last?.open && last.messageId === null && text.startsWith(last.text) ? last : void 0;
-  }
-  latestAnswer() {
-    return this.findLastSegment((segment) => !segment.commentary);
-  }
-  findLastSegment(predicate) {
-    for (let index = this.segments.length - 1; index >= 0; index -= 1) {
-      const segment = this.segments[index];
-      if (predicate(segment)) return segment;
-    }
-    return void 0;
-  }
-  /**
-   * Complete an answer segment. Only the newest answer can grow: a remainder
-   * for an earlier one would land after later text for append-only consumers.
-   */
-  extendAnswer(segment, text) {
-    if (text.length <= segment.text.length || !text.startsWith(segment.text)) return [];
-    if (segment !== this.latestAnswer()) return [];
-    const remainder = text.slice(segment.text.length);
-    segment.text = text;
-    return [{ type: "text", text: remainder }];
-  }
-  closeSegments() {
-    for (const segment of this.segments) segment.open = false;
-  }
-  /**
-   * Close the turn's text. A turn that produced commentary but no answer text
-   * (for example one that ends waiting for a worker) replies with its latest
-   * commentary rather than nothing.
-   */
-  settleSegments() {
-    this.closeSegments();
-    if (this.emptyFinalReply) return [];
-    if (this.segments.some((segment) => !segment.commentary)) return [];
-    const latest = [...this.segments].reverse().find((segment) => segment.commentary && segment.text);
-    if (!latest) return [];
-    latest.commentary = false;
-    return [{ type: "text", text: latest.text }];
-  }
-  startSegment(text, open, messageId) {
-    const separator = this.segments.some((segment) => !segment.commentary) ? "\n\n" : "";
-    this.segments.push({ text, open, commentary: false, messageId });
-    return { type: "text", text: separator + text };
-  }
-};
-function isCommentary(payload) {
-  return payload.phase === "commentary";
-}
-function isTurnScopedType(type) {
-  return type.startsWith("turn.") || type.startsWith("agent.") || type === "user.message";
-}
-function approvalPending(payload) {
-  const approvals = Array.isArray(payload.approvals) ? payload.approvals : [];
-  const first = approvals[0];
-  if (!first) return null;
-  const raw = asRecord(first);
-  const rawItem = asRecord(raw.rawItem);
-  const requestId = stringValue(rawItem.callId) ?? stringValue(rawItem.id) ?? stringValue(raw.id) ?? stringValue(raw.callId);
-  if (!requestId) return null;
-  return {
-    kind: "approval",
-    requestId,
-    name: stringValue(raw.name) ?? stringValue(raw.toolName) ?? stringValue(rawItem.name) ?? null,
-    payload: first
-  };
-}
-function humanInputPending(payload) {
-  const request = asRecord(payload.request);
-  const requestId = stringValue(request.id);
-  if (!requestId || !Array.isArray(request.questions)) return null;
-  return { kind: "human_input", requestId, name: null, payload: payload.request };
-}
-function asRecord(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-function stringValue(value) {
-  return typeof value === "string" ? value : void 0;
-}
-function isErrorOutput(payload) {
-  if (payload.error === true || payload.failed === true) return true;
-  const output = payload.output;
-  return !!output && typeof output === "object" && output.isError === true;
-}
-
 // src/chat/opengeni.ts
 var DEFAULT_OPENGENI_BASE_URL = "https://app.opengeni.ai";
 var DEFAULT_CHAT_SOURCE = "app";