@opengeni/contracts 4.3.3-canary.39786771332001 → 4.5.0

package/dist/artifacts.d.ts

@@ -140,6 +140,11 @@ export declare const WorkspaceArtifactEvent: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export type WorkspaceArtifactEvent = z.infer<typeof WorkspaceArtifactEvent>;
+/** When this person last opened the Site; it orders the Site's sidebar row. */
+export declare const SiteOpenedResponse: z.ZodObject<{
+    openedAt: z.ZodString;
+}, z.core.$strip>;
+export type SiteOpenedResponse = z.infer<typeof SiteOpenedResponse>;
 export declare const WorkspaceArtifactListQuery: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     cursor: z.ZodOptional<z.ZodString>;

package/dist/atlassian.js

@@ -17,48 +17,48 @@ import {
   AtlassianSyncCadence,
   SaveAtlassianSourcesRequest,
   atlassianScopesAllowRead
-} from "./chunk-LDLNKGRV.js";
-import "./chunk-4JGHSSB7.js";
+} from "./chunk-QVD27B6P.js";
+import "./chunk-EZMMXU2Z.js";
+import "./chunk-CK33N4MN.js";
+import "./chunk-6IXO76Z6.js";
 import "./chunk-A25JT3JW.js";
-import "./chunk-O52OHRH5.js";
-import "./chunk-LZ2LAHIX.js";
-import "./chunk-TSWWZMUS.js";
-import "./chunk-XDLAGX66.js";
+import "./chunk-VGP74254.js";
+import "./chunk-EKWNTOG3.js";
 import "./chunk-2ZIHHL72.js";
-import "./chunk-D6XFSFSN.js";
-import "./chunk-NDZHPTCL.js";
+import "./chunk-GFMEIAB3.js";
+import "./chunk-C5E5WCHU.js";
+import "./chunk-ZDCRWCGZ.js";
 import "./chunk-SHO4YO4B.js";
+import "./chunk-4JGHSSB7.js";
+import "./chunk-C6HESWDB.js";
+import "./chunk-NDZHPTCL.js";
+import "./chunk-PUIUXIOL.js";
+import "./chunk-LZ2LAHIX.js";
+import "./chunk-YKZ4WU4P.js";
 import "./chunk-4VDMHLLL.js";
-import "./chunk-T3HSWMA5.js";
 import "./chunk-KHHZTBP7.js";
+import "./chunk-SWRN2DJ3.js";
+import "./chunk-HRRU4QPI.js";
+import "./chunk-T3HSWMA5.js";
+import "./chunk-TR623IYR.js";
 import "./chunk-NVJMJWLL.js";
-import "./chunk-ETVERQ3S.js";
 import "./chunk-TOOJIBJC.js";
-import "./chunk-6IXO76Z6.js";
-import "./chunk-J4HQ3UKY.js";
-import "./chunk-YKZ4WU4P.js";
-import "./chunk-EZMMXU2Z.js";
+import "./chunk-DJ6PLUZE.js";
+import "./chunk-XP5M3IKT.js";
+import "./chunk-6JVNWADW.js";
+import "./chunk-NJMU6O3S.js";
 import "./chunk-OL23ARTF.js";
-import "./chunk-CK33N4MN.js";
-import "./chunk-VGP74254.js";
-import "./chunk-C6HESWDB.js";
-import "./chunk-C5E5WCHU.js";
-import "./chunk-ZDCRWCGZ.js";
-import "./chunk-SWRN2DJ3.js";
-import "./chunk-HRRU4QPI.js";
-import "./chunk-ZYVEJFNU.js";
+import "./chunk-7272KVWZ.js";
+import "./chunk-RKX3NQYS.js";
+import "./chunk-XDLAGX66.js";
+import "./chunk-J4HQ3UKY.js";
 import "./chunk-PTSROVDG.js";
+import "./chunk-WQI7VNN4.js";
+import "./chunk-D6XFSFSN.js";
+import "./chunk-TSWWZMUS.js";
 import "./chunk-4QO6GJUX.js";
-import "./chunk-EKWNTOG3.js";
 import "./chunk-56SNIMDO.js";
-import "./chunk-XP5M3IKT.js";
-import "./chunk-PUIUXIOL.js";
-import "./chunk-RKX3NQYS.js";
-import "./chunk-7272KVWZ.js";
-import "./chunk-W3NBPR4E.js";
-import "./chunk-RUQ4I6DO.js";
 import "./chunk-WVCFSOUZ.js";
-import "./chunk-WQI7VNN4.js";
 export {
   ATLASSIAN_CREDENTIAL_LABEL,
   ATLASSIAN_CREDENTIAL_ROLE,

package/dist/{chunk-W3NBPR4E.js → chunk-6JVNWADW.js}

@@ -5,7 +5,7 @@ import {
   canonicalSpreadsheetDateFromMilliseconds,
   canonicalSpreadsheetDateMilliseconds,
   spreadsheetSheetId
-} from "./chunk-RUQ4I6DO.js";
+} from "./chunk-NJMU6O3S.js";
 import {
   fnv1a64
 } from "./chunk-WQI7VNN4.js";
@@ -1242,4 +1242,4 @@ export {
   decodeSpreadsheetMetadataKernelProjection,
   assertCanonicalSpreadsheetArtifactKernelProjectionBytes
 };
-//# sourceMappingURL=chunk-W3NBPR4E.js.map
+//# sourceMappingURL=chunk-6JVNWADW.js.map

package/dist/{chunk-ETVERQ3S.js → chunk-DJ6PLUZE.js}

@@ -1,21 +1,3 @@
-import {
-  DOCUMENT_ARTIFACT_COMMAND_MAX_BYTES,
-  DOCUMENT_ARTIFACT_COMMAND_MAX_COMMANDS,
-  DOCUMENT_ARTIFACT_COMMAND_VERSION,
-  DOCUMENT_ARTIFACT_QUERY_MAX_BYTES,
-  DOCUMENT_ARTIFACT_QUERY_RESPONSE_MAX_BYTES,
-  DOCUMENT_ARTIFACT_QUERY_RESPONSE_VERSION,
-  DOCUMENT_ARTIFACT_QUERY_VERSION,
-  assertCanonicalDocumentArtifactCommandBytes,
-  assertCanonicalDocumentArtifactQueryBytes,
-  assertCanonicalDocumentArtifactQueryResponseBytes,
-  decodeDocumentArtifactCommandBatch,
-  decodeDocumentArtifactQuery,
-  decodeDocumentArtifactQueryResponse,
-  encodeDocumentArtifactCommandBatch,
-  encodeDocumentArtifactQuery,
-  encodeDocumentArtifactQueryResponse
-} from "./chunk-PTSROVDG.js";
 import {
   PRESENTATION_ARTIFACT_COMMAND_MAX_BYTES,
   PRESENTATION_ARTIFACT_COMMAND_MAX_COMMANDS,
@@ -44,14 +26,32 @@ import {
   decodeSpreadsheetArtifactKernelQuery,
   encodeSpreadsheetArtifactKernelProjection,
   encodeSpreadsheetArtifactKernelQuery
-} from "./chunk-W3NBPR4E.js";
+} from "./chunk-6JVNWADW.js";
 import {
   SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES,
   SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS,
   assertCanonicalSpreadsheetArtifactCommandBytes,
   decodeSpreadsheetArtifactCommandBatch,
   encodeSpreadsheetArtifactCommandBatch
-} from "./chunk-RUQ4I6DO.js";
+} from "./chunk-NJMU6O3S.js";
+import {
+  DOCUMENT_ARTIFACT_COMMAND_MAX_BYTES,
+  DOCUMENT_ARTIFACT_COMMAND_MAX_COMMANDS,
+  DOCUMENT_ARTIFACT_COMMAND_VERSION,
+  DOCUMENT_ARTIFACT_QUERY_MAX_BYTES,
+  DOCUMENT_ARTIFACT_QUERY_RESPONSE_MAX_BYTES,
+  DOCUMENT_ARTIFACT_QUERY_RESPONSE_VERSION,
+  DOCUMENT_ARTIFACT_QUERY_VERSION,
+  assertCanonicalDocumentArtifactCommandBytes,
+  assertCanonicalDocumentArtifactQueryBytes,
+  assertCanonicalDocumentArtifactQueryResponseBytes,
+  decodeDocumentArtifactCommandBatch,
+  decodeDocumentArtifactQuery,
+  decodeDocumentArtifactQueryResponse,
+  encodeDocumentArtifactCommandBatch,
+  encodeDocumentArtifactQuery,
+  encodeDocumentArtifactQueryResponse
+} from "./chunk-PTSROVDG.js";
 import {
   COMMITTED_TRANSACTION_PROTOCOL_VERSION,
   DOCUMENT_ARTIFACT_MODEL_SCHEMA_VERSION,
@@ -214,4 +214,4 @@ export {
   currentEditableArtifactCompatibility,
   editableArtifactCodecFor
 };
-//# sourceMappingURL=chunk-ETVERQ3S.js.map
+//# sourceMappingURL=chunk-DJ6PLUZE.js.map

package/dist/{chunk-BFT5KU7Z.js → chunk-EEJP62UG.js}

@@ -1,7 +1,7 @@
 import {
   ConnectionKind,
   SessionTenancyVisibility
-} from "./chunk-LDLNKGRV.js";
+} from "./chunk-QVD27B6P.js";
 import {
   defineSchema
 } from "./chunk-56SNIMDO.js";
@@ -204,4 +204,4 @@ export {
   ConnectionUseAuditFact,
   ConnectionUseAuthorizationResult
 };
-//# sourceMappingURL=chunk-BFT5KU7Z.js.map
+//# sourceMappingURL=chunk-EEJP62UG.js.map

package/dist/{chunk-ZYVEJFNU.js → chunk-GFMEIAB3.js}

@@ -2,13 +2,13 @@ import {
   SPREADSHEET_DEFAULT_COLUMN_WIDTH,
   SPREADSHEET_DEFAULT_ROW_HEIGHT,
   SPREADSHEET_MAX_DIMENSION_PIXELS
-} from "./chunk-RUQ4I6DO.js";
-import {
-  COMMITTED_TRANSACTION_PROTOCOL_VERSION
-} from "./chunk-WVCFSOUZ.js";
+} from "./chunk-NJMU6O3S.js";
 import {
   fnv1a64Limbs
 } from "./chunk-WQI7VNN4.js";
+import {
+  COMMITTED_TRANSACTION_PROTOCOL_VERSION
+} from "./chunk-WVCFSOUZ.js";
 
 // src/editable-artifact-committed-transaction.ts
 var MAX_COMMITTED_TRANSACTION_BYTES = 8 * 1024 * 1024;
@@ -405,4 +405,4 @@ export {
   MAX_COMMITTED_TRANSACTION_CELLS,
   decodeCommittedTransactionSummary
 };
-//# sourceMappingURL=chunk-ZYVEJFNU.js.map
+//# sourceMappingURL=chunk-GFMEIAB3.js.map

package/dist/{chunk-RUQ4I6DO.js → chunk-NJMU6O3S.js}

@@ -1,9 +1,9 @@
-import {
-  SPREADSHEET_ARTIFACT_COMMAND_VERSION
-} from "./chunk-WVCFSOUZ.js";
 import {
   fnv1a64
 } from "./chunk-WQI7VNN4.js";
+import {
+  SPREADSHEET_ARTIFACT_COMMAND_VERSION
+} from "./chunk-WVCFSOUZ.js";
 
 // src/spreadsheet-artifact-date.ts
 var ECMASCRIPT_DATE_MAX_MILLISECONDS = 8640000000000000n;
@@ -826,4 +826,4 @@ export {
   decodeSpreadsheetArtifactCommandBatch,
   assertCanonicalSpreadsheetArtifactCommandBytes
 };
-//# sourceMappingURL=chunk-RUQ4I6DO.js.map
+//# sourceMappingURL=chunk-NJMU6O3S.js.map

package/dist/{chunk-LDLNKGRV.js → chunk-QVD27B6P.js}

@@ -1,34 +1,3 @@
-import {
-  MediaGenerationResult
-} from "./chunk-A25JT3JW.js";
-import {
-  ConnectorDocumentDestination
-} from "./chunk-LZ2LAHIX.js";
-import {
-  UsageAllowancePeriod,
-  UsageAllowanceStatus,
-  UsageAllowanceWindow
-} from "./chunk-TSWWZMUS.js";
-import {
-  CustomMcpSetupRequest
-} from "./chunk-XDLAGX66.js";
-import {
-  modelLogoUrl
-} from "./chunk-2ZIHHL72.js";
-import {
-  normalizeAutomaticSessionTitle
-} from "./chunk-T3HSWMA5.js";
-import {
-  OPENGENI_WEBHOOK_TEST_EVENT_TYPE,
-  WORKSPACE_WEBHOOK_EVENT_TYPES
-} from "./chunk-6IXO76Z6.js";
-import {
-  XaiProviderAccountAuthoritySnapshotV1
-} from "./chunk-YKZ4WU4P.js";
-import {
-  SessionUsageLimit,
-  SessionUsageLimitMicros
-} from "./chunk-OL23ARTF.js";
 import {
   WORKSPACE_CONTROL_REASON_MAX_BYTES,
   boundSessionEventPayload,
@@ -36,10 +5,20 @@ import {
   sessionEventJsonBytes,
   workspaceControlUtf8Bytes
 } from "./chunk-CK33N4MN.js";
+import {
+  OPENGENI_WEBHOOK_TEST_EVENT_TYPE,
+  WORKSPACE_WEBHOOK_EVENT_TYPES
+} from "./chunk-6IXO76Z6.js";
+import {
+  MediaGenerationResult
+} from "./chunk-A25JT3JW.js";
 import {
   RETAINED_OUTPUT_MAX_PAGE_BYTES,
   RetainedArtifactReferenceSchema
 } from "./chunk-VGP74254.js";
+import {
+  modelLogoUrl
+} from "./chunk-2ZIHHL72.js";
 import {
   GeneratePasswordSpec,
   VAULT_LIMITS,
@@ -48,6 +27,12 @@ import {
   VaultPolicy,
   isValidSecretName
 } from "./chunk-C6HESWDB.js";
+import {
+  ConnectorDocumentDestination
+} from "./chunk-LZ2LAHIX.js";
+import {
+  XaiProviderAccountAuthoritySnapshotV1
+} from "./chunk-YKZ4WU4P.js";
 import {
   OrganizationAccessPolicy,
   OrganizationWorkspaceScope
@@ -55,6 +40,21 @@ import {
 import {
   Permission
 } from "./chunk-HRRU4QPI.js";
+import {
+  normalizeAutomaticSessionTitle
+} from "./chunk-T3HSWMA5.js";
+import {
+  SessionUsageLimit,
+  SessionUsageLimitMicros
+} from "./chunk-OL23ARTF.js";
+import {
+  CustomMcpSetupRequest
+} from "./chunk-XDLAGX66.js";
+import {
+  UsageAllowancePeriod,
+  UsageAllowanceStatus,
+  UsageAllowanceWindow
+} from "./chunk-TSWWZMUS.js";
 import {
   defineSchema
 } from "./chunk-56SNIMDO.js";
@@ -1093,6 +1093,11 @@ var WorkspaceArtifactEvent = /* @__PURE__ */ defineSchema(
     createdAt: z8.string().datetime({ offset: true })
   })
 );
+var SiteOpenedResponse = /* @__PURE__ */ defineSchema(
+  () => z8.object({
+    openedAt: z8.string().datetime({ offset: true })
+  })
+);
 var WorkspaceArtifactListQuery = /* @__PURE__ */ defineSchema(
   () => z8.object({
     limit: z8.coerce.number().int().positive().max(WORKSPACE_ARTIFACT_LIST_MAX).default(WORKSPACE_ARTIFACT_LIST_DEFAULT),
@@ -39498,6 +39503,52 @@ async function verifyEnrollmentBearer(secret, token, nowSeconds = Math.floor(Dat
   return payload.data;
 }
 var OPENGENI_BROWSER_EXTENSION_URL = "https://chromewebstore.google.com/detail/opengeni-browser/phpmmcbeelfkcinjfbbggegjdcdmnnch";
+var USER_SETUP_BLOCKERS = [
+  {
+    code: "attached_browser_unavailable",
+    capabilityId: "api:connected-machine",
+    purpose: "chrome",
+    problem: "No Chrome profile is connected through the browser extension.",
+    rationale: "Connect your Chrome so the agent can use it.",
+    nextStep: `connect their computer as a Connected Machine, then add the browser extension to Chrome: ${OPENGENI_BROWSER_EXTENSION_URL}`
+  },
+  {
+    code: "personal_machine_permission_required",
+    capabilityId: "api:connected-machine",
+    problem: "This is a personal (Only me) machine, and its owner has not allowed this chat to use it yet.",
+    rationale: "Allow this chat to use your computer.",
+    nextStep: "open this chat in Opengeni and allow it to use their machine"
+  }
+];
+function userSetupBlocker(code) {
+  if (!code) return null;
+  return USER_SETUP_BLOCKERS.find((blocker) => blocker.code === code) ?? null;
+}
+function userSetupCardShownMessage(blocker, chatUrl = null) {
+  const elsewhere = chatUrl ? `If they are reading this chat somewhere else (for example Slack, or this is a worker or scheduled chat), give them this link to it: ${chatUrl}. ` : "If they are reading this chat somewhere else (for example Slack, or this is a worker or scheduled chat), tell them to open this chat in Opengeni to use it. ";
+  return `${blocker.problem} A card that fixes this is now posted in this chat in Opengeni. If they are reading this chat in Opengeni, tell them in one short sentence to use it there; do not describe its buttons or steps, and do not post another card. ` + elsewhere + "Do not wait for it and do not retry: finishing the card sends a message that continues this chat.";
+}
+function userSetupCardUnpostedMessage(blocker) {
+  return `${blocker.problem} The person can fix this. Offer the fix in this reply: post the setup card with capability_authorization_request (capabilityId ${blocker.capabilityId}) if that tool is available, and tell them the exact next step: ${blocker.nextStep}. Do not only report that it is unavailable.`;
+}
+function userSetupUnavailableMessage(blocker) {
+  return `${blocker.problem} This deployment doesn't support the setup that fixes it, so the person can't fix it here. Tell them that in one short sentence and carry on without it; do not post a setup card.`;
+}
+function sessionChatUrl(base, workspaceId, sessionId) {
+  if (!base) return null;
+  try {
+    const url = new URL(
+      `/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}`,
+      base
+    );
+    if (url.protocol !== "https:" && url.protocol !== "http:" || url.username || url.password) {
+      return null;
+    }
+    return url.toString();
+  } catch {
+    return null;
+  }
+}
 var EnrollTokenScope = /* @__PURE__ */ defineSchema(() => z72.enum(["user", "workspace"]));
 var enrollTokenId = /* @__PURE__ */ defineSchema(
   () => z72.string().regex(/^[A-Za-z0-9_-]{16,128}$/)
@@ -47762,6 +47813,30 @@ var SessionListTotals = /* @__PURE__ */ defineSkillContractSchema(
     )
   })
 );
+var SiteConversationGroup = /* @__PURE__ */ defineSkillContractSchema(
+  () => z72.object({
+    siteId: z72.string().uuid(),
+    channelId: z72.string().uuid().nullable(),
+    /** The Site's current title when the viewer can read it, else its creation label. */
+    title: z72.string(),
+    /** Root conversations in the group; 0 for a Site with none yet. */
+    conversations: z72.number().int().nonnegative(),
+    /** Latest activity: its conversations, its own changes, or the viewer opening it. */
+    updatedAt: z72.string().datetime(),
+    /** Creation time of the group's newest conversation, else of the Site. */
+    createdAt: z72.string().datetime(),
+    /** The same status counts as a project total, over the group's trees. */
+    total: z72.number().int().nonnegative(),
+    attention: z72.number().int().nonnegative(),
+    attentionSince: z72.string().datetime().nullable(),
+    failed: z72.number().int().nonnegative(),
+    active: z72.number().int().nonnegative(),
+    queued: z72.number().int().nonnegative(),
+    waiting: z72.number().int().nonnegative(),
+    unread: z72.number().int().nonnegative(),
+    activeWork: z72.number().int().nonnegative()
+  })
+);
 var SessionListResponse = /* @__PURE__ */ defineSkillContractSchema(
   () => z72.object({
     pinned: z72.array(Session),
@@ -47778,6 +47853,16 @@ var SessionListResponse = /* @__PURE__ */ defineSkillContractSchema(
     sortBy: z72.enum(["updatedAt", "createdAt", "name", "archivedAt"]).optional(),
     archiveStatus: z72.enum(["active", "archived", "all"]).optional(),
     originSiteId: z72.string().uuid().optional(),
+    /**
+     * Receipt for `siteConversations`. `include` lists Site conversations as
+     * ordinary rows; `group` keeps them out of the rows and returns
+     * `siteGroups` instead. Absent: they are omitted, as before.
+     */
+    siteConversations: z72.enum(["include", "group"]).optional(),
+    /** Complete Site rows for a `group` root page, newest activity first. */
+    siteGroups: z72.array(SiteConversationGroup).optional(),
+    /** True when Site rows beyond the server bound were omitted. */
+    siteGroupsTruncated: z72.literal(true).optional(),
     /** True when older matching pins were omitted from this bounded page. */
     pinnedTruncated: z72.boolean().optional(),
     sessions: z72.array(Session),
@@ -48562,7 +48647,14 @@ var ToolAuthNeededPayload = /* @__PURE__ */ defineSchema(
      * answers a refused switch or one-off command. Names the request; it grants
      * nothing.
      */
-    requestedSandboxId: z72.string().uuid().optional()
+    requestedSandboxId: z72.string().uuid().optional(),
+    /**
+     * Why a Connected Machine card was posted, when it is for something
+     * narrower than running this chat on a machine. `chrome`: the agent needs
+     * the person's own Chrome, so the card leads with connecting a computer
+     * and adding the Opengeni Browser extension. Grants nothing.
+     */
+    purpose: z72.literal("chrome").optional()
   }).superRefine((payload, context) => {
     if (payload.setupRequest && (payload.capability || payload.authoritySource === "host")) {
       context.addIssue({
@@ -51986,6 +52078,9 @@ var ClientConfig = /* @__PURE__ */ defineModelContractSchema(
     // Whether people can connect their own computers to this deployment. Absent
     // on older servers: clients then treat it as unknown.
     connectedMachines: z72.boolean().optional(),
+    // The Chrome extension people add to connect their own Chrome, and its
+    // Chrome Web Store page. Absent on older servers: Opengeni Browser.
+    browserExtension: z72.object({ name: z72.string(), installUrl: z72.string().url() }).optional(),
     defaultModel: z72.string(),
     // Legacy parsers require a nonempty list. If models is empty, this contains
     // only the explicitly unavailable legacyModelFallback hint, not admission.
@@ -52272,6 +52367,7 @@ export {
   WorkspaceArtifact,
   WorkspaceArtifactEventType,
   WorkspaceArtifactEvent,
+  SiteOpenedResponse,
   WorkspaceArtifactListQuery,
   WorkspaceArtifactListResponse,
   WorkspaceArtifactDetailResponse,
@@ -53762,6 +53858,12 @@ export {
   signEnrollmentBearer,
   verifyEnrollmentBearer,
   OPENGENI_BROWSER_EXTENSION_URL,
+  USER_SETUP_BLOCKERS,
+  userSetupBlocker,
+  userSetupCardShownMessage,
+  userSetupCardUnpostedMessage,
+  userSetupUnavailableMessage,
+  sessionChatUrl,
   EnrollTokenScope,
   EnrollTokenPayload,
   enrollTokenScope,
@@ -54453,6 +54555,7 @@ export {
   Session,
   CreateSessionResponse,
   SessionListTotals,
+  SiteConversationGroup,
   SessionListResponse,
   SessionListEntry,
   SessionListEntryResponse,
@@ -54761,4 +54864,4 @@ export {
   AtlassianDisconnectRequest,
   atlassianScopesAllowRead
 };
-//# sourceMappingURL=chunk-LDLNKGRV.js.map
+//# sourceMappingURL=chunk-QVD27B6P.js.map