@opengeni/contracts 1.3.0 → 1.4.2

package/dist/transcription-recordings.d.ts

@@ -1,7 +1,10 @@
 import { z } from "zod";
 export declare const TranscriptionRecordingErrorCode: z.ZodEnum<{
+    allowance_exhausted: "allowance_exhausted";
     cancelled: "cancelled";
+    insufficient_credits: "insufficient_credits";
     invalid_audio: "invalid_audio";
+    monthly_model_cost_limit: "monthly_model_cost_limit";
     network: "network";
     not_supported: "not_supported";
     permission_denied: "permission_denied";
@@ -71,8 +74,11 @@ export declare const TranscriptionRecordingSegment: z.ZodObject<{
     durationMilliseconds: z.ZodNumber;
     byteLength: z.ZodNumber;
     errorCode: z.ZodNullable<z.ZodEnum<{
+        allowance_exhausted: "allowance_exhausted";
         cancelled: "cancelled";
+        insufficient_credits: "insufficient_credits";
         invalid_audio: "invalid_audio";
+        monthly_model_cost_limit: "monthly_model_cost_limit";
         network: "network";
         not_supported: "not_supported";
         permission_denied: "permission_denied";
@@ -108,8 +114,11 @@ export declare const TranscriptionRecording: z.ZodObject<{
     transcriptText: z.ZodNullable<z.ZodString>;
     languages: z.ZodArray<z.ZodString>;
     errorCode: z.ZodNullable<z.ZodEnum<{
+        allowance_exhausted: "allowance_exhausted";
         cancelled: "cancelled";
+        insufficient_credits: "insufficient_credits";
         invalid_audio: "invalid_audio";
+        monthly_model_cost_limit: "monthly_model_cost_limit";
         network: "network";
         not_supported: "not_supported";
         permission_denied: "permission_denied";
@@ -150,8 +159,11 @@ export declare const TranscriptionRecordingResponse: z.ZodObject<{
         transcriptText: z.ZodNullable<z.ZodString>;
         languages: z.ZodArray<z.ZodString>;
         errorCode: z.ZodNullable<z.ZodEnum<{
+            allowance_exhausted: "allowance_exhausted";
             cancelled: "cancelled";
+            insufficient_credits: "insufficient_credits";
             invalid_audio: "invalid_audio";
+            monthly_model_cost_limit: "monthly_model_cost_limit";
             network: "network";
             not_supported: "not_supported";
             permission_denied: "permission_denied";
@@ -181,8 +193,11 @@ export declare const TranscriptionRecordingResponse: z.ZodObject<{
         durationMilliseconds: z.ZodNumber;
         byteLength: z.ZodNumber;
         errorCode: z.ZodNullable<z.ZodEnum<{
+            allowance_exhausted: "allowance_exhausted";
             cancelled: "cancelled";
+            insufficient_credits: "insufficient_credits";
             invalid_audio: "invalid_audio";
+            monthly_model_cost_limit: "monthly_model_cost_limit";
             network: "network";
             not_supported: "not_supported";
             permission_denied: "permission_denied";
@@ -221,8 +236,11 @@ export declare const TranscriptionRecordingListResponse: z.ZodObject<{
         transcriptText: z.ZodNullable<z.ZodString>;
         languages: z.ZodArray<z.ZodString>;
         errorCode: z.ZodNullable<z.ZodEnum<{
+            allowance_exhausted: "allowance_exhausted";
             cancelled: "cancelled";
+            insufficient_credits: "insufficient_credits";
             invalid_audio: "invalid_audio";
+            monthly_model_cost_limit: "monthly_model_cost_limit";
             network: "network";
             not_supported: "not_supported";
             permission_denied: "permission_denied";
@@ -264,8 +282,11 @@ export declare const UploadTranscriptionRecordingChunkResponse: z.ZodObject<{
         transcriptText: z.ZodNullable<z.ZodString>;
         languages: z.ZodArray<z.ZodString>;
         errorCode: z.ZodNullable<z.ZodEnum<{
+            allowance_exhausted: "allowance_exhausted";
             cancelled: "cancelled";
+            insufficient_credits: "insufficient_credits";
             invalid_audio: "invalid_audio";
+            monthly_model_cost_limit: "monthly_model_cost_limit";
             network: "network";
             not_supported: "not_supported";
             permission_denied: "permission_denied";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/contracts",
-  "version": "1.3.0",
+  "version": "1.4.2",
   "description": "Shared zod schemas and wire-contract types for the OpenGeni API.",
   "license": "Apache-2.0",
   "repository": {

package/src/agent-config.ts

@@ -423,8 +423,11 @@ export type AgentFunctionToolClass = AgentCapabilityId | "runtime" | "sandbox";
 
 /** Tools served outside the first-party MCP catalog, by the name the model sees. */
 export const AGENT_FUNCTION_TOOL_CAPABILITIES = {
-  // Hosted provider tools.
+  // Web search: the provider-hosted `web_search`/`x_search` tools, or
+  // Opengeni's provider-agnostic `web_search` and `web_fetch` function tools
+  // (one transport per turn; the capability is the same).
   web_search: "webSearch",
+  web_fetch: "webSearch",
   x_search: "webSearch",
   image_generation: "media",
   // Runtime function tools.

package/src/index.ts

@@ -115,6 +115,7 @@ export * from "./editable-artifact-serialized-commit";
 export * from "./signup-attribution";
 export * from "./product-lifecycle-facts";
 export * from "./tool-catalog";
+export * from "./mcp-structured-content";
 export * from "./mcp-oauth";
 export * from "./tool-result-spill";
 export * from "./interaction";
@@ -1864,6 +1865,9 @@ export const TranscriptionErrorCode = z.enum([
   "too_large",
   "invalid_audio",
   "unknown",
+  "insufficient_credits",
+  "allowance_exhausted",
+  "monthly_model_cost_limit",
 ]);
 export type TranscriptionErrorCode = z.infer<typeof TranscriptionErrorCode>;
 
@@ -2120,6 +2124,7 @@ export const VoiceInputProviderId = z.enum([
   "codex-subscription",
   "openai",
   "azure-openai",
+  "azure-mai",
 ]);
 export type VoiceInputProviderId = z.infer<typeof VoiceInputProviderId>;
 
@@ -5016,6 +5021,8 @@ export type PromotionalCreditScope = z.infer<typeof PromotionalCreditScope>;
 export const PromotionalCreditBalance = PromotionalCreditScope.extend({
   grantId: z.string().uuid(),
   remainingMicros: z.number().int().nonnegative(),
+  /** Also pays for dictation and live voice, like general credits (signup credits). */
+  coversVoice: z.boolean().optional(),
 });
 export type PromotionalCreditBalance = z.infer<typeof PromotionalCreditBalance>;
 
@@ -7072,7 +7079,7 @@ export const CodexRealtimeWebrtcResponse = z
       .min(1)
       .max(1024 * 1024),
     version: CodexRealtimeWebrtcVersion,
-    model: z.literal("gpt-live-1-boulder-alpha"),
+    model: z.enum(["gpt-live-1-boulder-alpha", "opengeni-azure/gpt-live-1"]),
     connectionId: z.string().uuid(),
     connectionEpoch: z.number().int().positive(),
     startupFenceSequence: z.number().int().nonnegative(),
@@ -7229,6 +7236,7 @@ export const SyncSessionRealtimeLedgerResponse = z
 export type SyncSessionRealtimeLedgerResponse = z.infer<typeof SyncSessionRealtimeLedgerResponse>;
 
 export const SessionRealtimeModel = z.enum([
+  "opengeni-azure/gpt-live-1",
   "gpt-live-1-boulder-alpha",
   "supergrok/grok-voice-think-fast-2.0",
   "opengeni-gateway/openai/gpt-realtime-2.1",
@@ -7247,6 +7255,12 @@ export const WorkspaceRealtimeModelCatalogItem = z.object({
   description: z.string().min(1),
   available: z.boolean(),
   unavailableReason: z.string().nullable(),
+  /**
+   * Machine-readable reason when unavailable. Credit refusals use the same
+   * codes as voice input (`insufficient_credits`, `allowance_exhausted`,
+   * `monthly_model_cost_limit`).
+   */
+  unavailableCode: z.string().min(1).max(64).nullable().optional(),
   recommended: z.boolean(),
 });
 export type WorkspaceRealtimeModelCatalogItem = z.infer<typeof WorkspaceRealtimeModelCatalogItem>;
@@ -7302,9 +7316,21 @@ export const EndSessionRealtimeRequest = RenewSessionRealtimeRequest.extend({
 });
 export type EndSessionRealtimeRequest = z.infer<typeof EndSessionRealtimeRequest>;
 
+/**
+ * Server instruction to end a live call now. Deployment-funded voice returns
+ * it from a heartbeat when credits run out; the lease is then no longer
+ * extended, so the client should drain and end the call gracefully.
+ */
+export const SessionRealtimeStopInstruction = z.object({
+  code: z.string().min(1).max(64),
+  message: z.string().min(1).max(512),
+});
+export type SessionRealtimeStopInstruction = z.infer<typeof SessionRealtimeStopInstruction>;
+
 export const SessionRealtimeMutationResponse = z.object({
   mode: SessionRealtimeMode,
   replay: z.boolean(),
+  stop: SessionRealtimeStopInstruction.optional(),
 });
 export type SessionRealtimeMutationResponse = z.infer<typeof SessionRealtimeMutationResponse>;
 
@@ -12082,6 +12108,11 @@ export const CapabilityRuntime = z.object({
       ]),
     })
     .optional(),
+  // Server-derived connectability: present when the connector's OAuth
+  // authorization server refuses self-registration, so connecting needs an
+  // operator-registered client. `configured` is whether this deployment has
+  // one; connector surfaces offer the row only when it is true.
+  operatorOAuthClient: z.object({ configured: z.boolean() }).optional(),
 });
 export type CapabilityRuntime = z.infer<typeof CapabilityRuntime>;
 

package/src/mcp-structured-content.ts

@@ -0,0 +1,81 @@
+import type { AttemptToolResult } from "./tool-catalog";
+
+/**
+ * Remove the backwards-compatibility text copy of an MCP result's
+ * `structuredContent`.
+ *
+ * The MCP specification asks a server that returns `structuredContent` to also
+ * return the same value serialized in a text content block. Printing or sending
+ * both pays for the payload twice, and the text copy pays again for JSON string
+ * escaping inside the result envelope.
+ *
+ * The envelope (`content`, `structuredContent`, `_meta`, `isError`, extension
+ * fields) and its key order are kept. Only a plain `{type: "text", text}` block
+ * whose text parses as JSON to a value equal to `structuredContent` is removed.
+ * Prose, differing JSON, annotated text, images, resources, and every other
+ * block stay. A text block whose JSON carries an integer outside the IEEE-754
+ * safe range also stays, because its digits may be more precise than the
+ * parsed `structuredContent`. Numbers compare by IEEE-754 value.
+ *
+ * Results without a removable block are returned as the same object.
+ *
+ * Callers: the runtime's model-facing MCP projection, and the default
+ * `ogtool call` print. The native Connected Machine client implements the
+ * same rule in `agent/crates/opengeni-agent/src/codemode.rs`; keep them equal.
+ */
+export function omitStructuredContentTextDuplicates<T extends AttemptToolResult>(result: T): T {
+  const structured: unknown = result.structuredContent;
+  if (structured === undefined || structured === null) return result;
+  const content = result.content.filter(
+    (entry) => !isPlainTextBlock(entry) || !textDuplicatesStructuredContent(entry.text, structured),
+  );
+  if (content.length === result.content.length) return result;
+  return { ...result, content };
+}
+
+function isPlainTextBlock(entry: unknown): entry is { type: "text"; text: string } {
+  if (!entry || typeof entry !== "object" || Array.isArray(entry)) return false;
+  const record = entry as Record<string, unknown>;
+  if (record.type !== "text" || typeof record.text !== "string") return false;
+  // Annotations or _meta are block-level facts the structured value lacks.
+  return Object.keys(record).every((key) => key === "type" || key === "text");
+}
+
+function textDuplicatesStructuredContent(text: string, structured: unknown): boolean {
+  const trimmed = text.replace(/^[ \t\n\r]+/u, "");
+  if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return false;
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return false;
+  }
+  return !containsUnsafeInteger(parsed) && jsonValuesEqual(parsed, structured);
+}
+
+function containsUnsafeInteger(value: unknown): boolean {
+  if (typeof value === "number") return Number.isInteger(value) && !Number.isSafeInteger(value);
+  if (Array.isArray(value)) return value.some(containsUnsafeInteger);
+  if (value && typeof value === "object") return Object.values(value).some(containsUnsafeInteger);
+  return false;
+}
+
+function jsonValuesEqual(left: unknown, right: unknown): boolean {
+  if (left === right) return true;
+  if (typeof left !== "object" || typeof right !== "object" || left === null || right === null) {
+    return false;
+  }
+  if (Array.isArray(left) || Array.isArray(right)) {
+    if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) {
+      return false;
+    }
+    return left.every((entry, index) => jsonValuesEqual(entry, right[index]));
+  }
+  const leftRecord = left as Record<string, unknown>;
+  const rightRecord = right as Record<string, unknown>;
+  const leftKeys = Object.keys(leftRecord);
+  if (leftKeys.length !== Object.keys(rightRecord).length) return false;
+  return leftKeys.every(
+    (key) => Object.hasOwn(rightRecord, key) && jsonValuesEqual(leftRecord[key], rightRecord[key]),
+  );
+}

package/src/tool-action-review.ts

@@ -174,6 +174,7 @@ export const ToolReviewStatus = z.enum([
   "cancelled",
   "expired",
   "revoked",
+  "blocked",
   "stale",
   "failed",
   "unavailable",

package/src/tool-review-presentation.ts

@@ -14,7 +14,17 @@ export function toolReviewFieldLabel(key: string): string {
   const label = key
     .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
     .replace(/[_-]+/g, " ")
-    .replace(/\bids?\b/gi, (word) => (word.length === 3 ? "IDs" : "ID"));
+    .replace(/\bids?\b/gi, (word) => (word.length === 3 ? "IDs" : "ID"))
+    .replace(
+      /\b(api|url|uri|http|https|ip|sql|json|html)(s?)\b/gi,
+      (_word, name: string, plural: string) => `${name.toUpperCase()}${plural}`,
+    )
+    // Sentence case, keeping acronyms: "Working Directory" → "Working directory".
+    .replace(
+      /(?<=\S\s+)([A-Z])([a-z]+)\b/g,
+      (_word, first: string, rest: string) => `${first.toLowerCase()}${rest}`,
+    )
+    .trim();
   return label.charAt(0).toUpperCase() + label.slice(1);
 }
 export function decodeReviewArguments(value: unknown): Record<string, unknown> | null {
@@ -85,8 +95,35 @@ export function toolReviewFields(
           (field) =>
             field.path !== "/contentSha256" && field.path !== "/htmlBody" && field.preview !== "",
         )
-        .map((field) => ({ ...field, path: `/$email${field.path}` })),
-      ...original.fields,
+        .map((field) => ({
+          ...field,
+          label: field.path === "/textBody" ? "Message" : field.label,
+          path: `/$email${field.path}`,
+          ...(field.path === "/attachments"
+            ? {
+                preview: context
+                  .email!.attachments.map((attachment) => attachment.name)
+                  .join(", ")
+                  .slice(0, 240),
+              }
+            : {}),
+        })),
+      ...original.fields.filter(
+        (field) =>
+          ![
+            "/raw",
+            "/expectedContentSha256",
+            "/from",
+            "/to",
+            "/cc",
+            "/bcc",
+            "/subject",
+            "/body",
+            "/textBody",
+            "/htmlBody",
+            "/attachments",
+          ].includes(field.path),
+      ),
     ];
     return {
       fields: fields.slice(0, 16),
@@ -98,13 +135,26 @@ export function toolReviewFields(
     fields: entries.slice(0, 16).map(([key, value], index) => {
       const hidden = protectedReviewField(key, context?.protectedFields);
       const safe = hidden ? "[Protected value]" : value;
-      const count = Array.isArray(value) ? value.length : undefined;
+      const count = !hidden && Array.isArray(value) ? value.length : undefined;
+      const compactList =
+        !hidden &&
+        Array.isArray(value) &&
+        value.length > 0 &&
+        value.length <= 4 &&
+        value.every(
+          (entry) =>
+            typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean",
+        )
+          ? value.map(valueText).join(", ")
+          : undefined;
       const text =
-        count !== undefined
-          ? `${count.toLocaleString("en-US")} item${count === 1 ? "" : "s"}`
-          : safe && typeof safe === "object"
-            ? `${Object.keys(safe).length} field${Object.keys(safe).length === 1 ? "" : "s"}`
-            : valueText(safe);
+        compactList !== undefined
+          ? compactList
+          : count !== undefined
+            ? `${count.toLocaleString("en-US")} item${count === 1 ? "" : "s"}`
+            : safe && typeof safe === "object"
+              ? `${Object.keys(safe).length} field${Object.keys(safe).length === 1 ? "" : "s"}`
+              : valueText(safe);
       return {
         path: fieldPointer(key, index),
         label: bound(
@@ -115,7 +165,10 @@ export function toolReviewFields(
         ),
         preview: bound(text, 240),
         ...(count !== undefined ? { count } : {}),
-        truncated: !hidden && (text.length > 240 || (typeof value === "object" && value !== null)),
+        truncated:
+          !hidden &&
+          (text.length > 240 ||
+            (compactList === undefined && typeof value === "object" && value !== null)),
         ...(hidden ? { protected: true } : {}),
       };
     }),
@@ -132,7 +185,14 @@ export function toolReviewAction(
   "title" | "approveLabel" | "effects" | "consequence" | "selectionCount" | "selectionKind"
 > {
   const fallback = {
-    title: context?.title ?? bound(toolReviewFieldLabel(toolName.replace(/^mcp_[^_]+__/, "")), 256),
+    title:
+      context?.title ??
+      bound(
+        toolReviewFieldLabel(
+          toolName.replace(/^mcp_[^_]+__/, "").replace(/^batch[_-](?=[a-z])/i, ""),
+        ),
+        256,
+      ),
     approveLabel: "Approve action",
     effects: [] as string[],
   };
@@ -152,8 +212,10 @@ export function toolReviewAction(
   const selectionCount = ids?.every((id) => typeof id === "string") ? new Set(ids).size : undefined;
   const noun =
     selectionCount === undefined
-      ? selectionKind
-      : `${selectionCount.toLocaleString("en-US")} ${thread ? "thread" : "message"}${selectionCount === 1 ? "" : "s"}`;
+      ? thread
+        ? "conversations"
+        : "messages"
+      : `${selectionCount.toLocaleString("en-US")} ${thread ? "conversation" : "message"}${selectionCount === 1 ? "" : "s"}`;
   const addValues = toolName.startsWith("label_") ? args.labelIds : args.addLabelIds;
   const adds = Array.isArray(addValues)
     ? addValues.filter((v): v is string => typeof v === "string")
@@ -200,7 +262,7 @@ export function toolReviewAction(
       ...(trash
         ? { consequence: "Messages stay recoverable in Trash until Gmail deletes them." }
         : thread
-          ? { consequence: "Applies to every message in the selected thread." }
+          ? { consequence: "Applies to every message in the conversation." }
           : {}),
     };
   }

package/src/transcription-recordings.ts

@@ -12,6 +12,9 @@ export const TranscriptionRecordingErrorCode = z.enum([
   "too_large",
   "invalid_audio",
   "unknown",
+  "insufficient_credits",
+  "allowance_exhausted",
+  "monthly_model_cost_limit",
 ]);
 export type TranscriptionRecordingErrorCode = z.infer<typeof TranscriptionRecordingErrorCode>;