@opengeni/contracts 5.1.0 → 5.1.1-canary.36079201993001

package/dist/artifact-catalog.d.ts

@@ -33,6 +33,7 @@ export declare const ArtifactCatalogItem: z.ZodObject<{
         artifactId: z.ZodString;
         kind: z.ZodEnum<{
             assistant_completion: "assistant_completion";
+            browser_screenshot: "browser_screenshot";
             computer_screenshot: "computer_screenshot";
             event_media: "event_media";
             file: "file";
@@ -120,6 +121,7 @@ export declare const ArtifactCatalogListResponse: z.ZodObject<{
             artifactId: z.ZodString;
             kind: z.ZodEnum<{
                 assistant_completion: "assistant_completion";
+                browser_screenshot: "browser_screenshot";
                 computer_screenshot: "computer_screenshot";
                 event_media: "event_media";
                 file: "file";

package/dist/atlassian.js

@@ -17,8 +17,8 @@ import {
   AtlassianSyncCadence,
   SaveAtlassianSourcesRequest,
   atlassianScopesAllowRead
-} from "./chunk-O23LYZFL.js";
-import "./chunk-M5ZGRVIQ.js";
+} from "./chunk-2KSPFPTV.js";
+import "./chunk-5IXYF6XN.js";
 import "./chunk-7ABONTXE.js";
 import "./chunk-NRMCVHAU.js";
 import "./chunk-WYBDERIY.js";

package/dist/{chunk-O23LYZFL.js → chunk-2KSPFPTV.js}

@@ -4,7 +4,7 @@ import {
   RetainedArtifactReferenceSchema,
   retainedOutputUnavailable,
   validateRetainedOutputEvidence
-} from "./chunk-M5ZGRVIQ.js";
+} from "./chunk-5IXYF6XN.js";
 import {
   normalizeAutomaticSessionTitle
 } from "./chunk-7ABONTXE.js";
@@ -313,8 +313,8 @@ var AgentLearningDefaults = z6.object({
 }).strict();
 var DEFAULT_AGENT_LEARNING = Object.freeze({
   knowledge: "automatic",
-  instructions: "review_first",
-  skills: "review_first"
+  instructions: "automatic",
+  skills: "automatic"
 });
 var AgentLearningOverrides = AgentLearningDefaults.partial();
 var AgentLearningOverridePatch = z6.object({
@@ -586,6 +586,15 @@ var KnowledgeEntryRevision = z7.object({
   reviewBatchId: z7.uuid().nullable(),
   outcome: z7.enum(["published", "pending", "rejected", "superseded"])
 }).strict();
+var KnowledgeIndexStatus = z7.enum([
+  "saved",
+  "queued",
+  "indexing",
+  "awaiting_funding",
+  "indexed",
+  "source_unavailable",
+  "provider_failed"
+]);
 var KnowledgeEntryRecord = z7.object({
   id: z7.uuid(),
   scope: KnowledgeEntryScope,
@@ -595,7 +604,8 @@ var KnowledgeEntryRecord = z7.object({
   revision: KnowledgeEntryRevision,
   archived: z7.boolean(),
   createdAt: z7.string().datetime({ offset: true }),
-  updatedAt: z7.string().datetime({ offset: true })
+  updatedAt: z7.string().datetime({ offset: true }),
+  indexStatus: KnowledgeIndexStatus.optional()
 }).strict();
 var KnowledgeEntryListRequest = z7.object({
   query: z7.string().max(4096).optional(),
@@ -635,7 +645,8 @@ var KnowledgeEntrySummary = KnowledgeEntryRecord.omit({ revision: true }).extend
 var KnowledgeEntryListResponse = z7.object({
   entries: z7.array(KnowledgeEntrySummary),
   nextCursor: z7.string().nullable(),
-  searchMode: z7.enum(["keyword", "hybrid", "vector"]).optional()
+  searchMode: z7.enum(["keyword", "hybrid", "vector"]).optional(),
+  fallbackReason: z7.enum(["awaiting_funding", "quota", "provider_unavailable", "query_limit"]).optional()
 });
 var KnowledgeReviewBatch = z7.object({
   id: z7.uuid(),
@@ -4370,6 +4381,14 @@ var BrowserObservation = z24.object({
   frameId: opaqueGeneration.nullable(),
   semantic: z24.union([InteractionSemanticSnapshot, InteractionSemanticDiff]).nullable(),
   screenshot: RetainedArtifactReferenceSchema.nullable(),
+  viewport: z24.object({
+    width: z24.number().int().positive(),
+    height: z24.number().int().positive(),
+    visualWidth: z24.number().positive(),
+    visualHeight: z24.number().positive(),
+    deviceScaleFactor: z24.number().positive(),
+    maxTouchPoints: z24.number().int().nonnegative()
+  }).strict().nullable().optional(),
   focusedRef: boundedOpaqueId.nullable(),
   changedRegions: z24.array(InteractionRect).max(INTERACTION_MAX_CHANGED_NODES),
   diagnostics: InteractionDiagnosticSummary,
@@ -4419,6 +4438,62 @@ var BrowserLocator = z24.discriminatedUnion("kind", [
   z24.object({ kind: z24.literal("test_id"), value: z24.string().min(1).max(2048) }).strict(),
   z24.object({ kind: z24.literal("css"), selector: z24.string().min(1).max(8192) }).strict()
 ]);
+var BrowserTargetState = z24.object({
+  browserSessionId: z24.string().uuid(),
+  controllerGeneration: opaqueGeneration,
+  targetId: boundedOpaqueId,
+  targetGeneration: opaqueGeneration,
+  documentGeneration: opaqueGeneration.nullable(),
+  frameId: opaqueGeneration.nullable()
+}).strict();
+var BrowserDomSafeAttribute = z24.enum([
+  "href",
+  "src",
+  "alt",
+  "title",
+  "role",
+  "aria-label",
+  "aria-expanded",
+  "aria-checked",
+  "aria-selected",
+  "placeholder",
+  "type",
+  "name",
+  "data-testid"
+]);
+var BrowserDomReadSelector = z24.string().min(1).max(8192).regex(/^[A-Za-z0-9_#.,\s>*-]+$/u);
+var BrowserDomReadLocator = z24.discriminatedUnion("kind", [
+  z24.object({ kind: z24.literal("ref"), ref: boundedOpaqueId }).strict(),
+  z24.object({ kind: z24.literal("placeholder"), text: z24.string().min(1).max(8192) }).strict(),
+  z24.object({ kind: z24.literal("test_id"), value: z24.string().min(1).max(2048) }).strict(),
+  z24.object({ kind: z24.literal("css"), selector: BrowserDomReadSelector }).strict()
+]);
+var BrowserDomReadFence = z24.object({
+  expectedTargetGeneration: opaqueGeneration,
+  expectedDocumentGeneration: opaqueGeneration,
+  expectedFrameId: opaqueGeneration
+});
+var BrowserDomReadRequest = z24.discriminatedUnion("kind", [
+  BrowserDomReadFence.extend({
+    kind: z24.literal("element"),
+    locator: BrowserDomReadLocator,
+    attributes: z24.array(BrowserDomSafeAttribute).max(13).optional(),
+    maxChars: z24.number().int().min(1).max(32768).optional()
+  }).strict(),
+  BrowserDomReadFence.extend({
+    kind: z24.literal("count"),
+    selector: BrowserDomReadSelector
+  }).strict()
+]);
+var BrowserDomReadResponse = BrowserTargetState.extend({
+  kind: z24.enum(["element", "count"]),
+  count: z24.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
+  text: z24.string().max(32768).nullable().optional(),
+  value: z24.string().max(32768).nullable().optional(),
+  attributes: z24.partialRecord(BrowserDomSafeAttribute, z24.string().max(32768).nullable()).optional(),
+  redacted: z24.enum(["password", "payment", "private", "policy"]).nullable().optional(),
+  truncated: z24.boolean()
+}).strict();
 var ComputerLocator = z24.discriminatedUnion("kind", [
   z24.object({ kind: z24.literal("ref"), ref: boundedOpaqueId }).strict(),
   z24.object({
@@ -4457,6 +4532,15 @@ var BrowserPermission = z24.enum([
 var BrowserPermissionSetting = z24.enum(["granted", "denied", "prompt"]);
 var browserActionVariants = [
   z24.object({ type: z24.literal("navigate"), url: boundedUrl }).strict(),
+  z24.object({ type: z24.literal("history"), direction: z24.enum(["back", "forward"]) }).strict(),
+  z24.object({ type: z24.literal("activate") }).strict(),
+  z24.object({
+    type: z24.literal("viewport"),
+    width: z24.number().int().min(240).max(4096),
+    height: z24.number().int().min(240).max(4096),
+    mobile: z24.boolean(),
+    deviceScaleFactor: z24.number().min(0.5).max(4).optional()
+  }).strict(),
   z24.object({
     type: z24.literal("click"),
     locator: BrowserLocator,
@@ -5420,13 +5504,15 @@ var SandboxFileArtifactReceipt = z25.object({
   artifact: RetainedArtifactReferenceSchema
 }).strict().superRefine((value, context) => {
   const pathSegments = value.sandboxPath.split("/");
-  if (!value.sandboxPath.startsWith("/workspace/") || value.sandboxPath.includes("\0") || pathSegments.some(
-    (segment, index) => index > 1 && (!segment || segment === "." || segment === "..")
+  const unc = value.sandboxPath.startsWith("//");
+  const absolute = unc ? /^\/\/[^/]+\/[^/]+\/.+/u.test(value.sandboxPath) && !value.sandboxPath.startsWith("//?/") : value.sandboxPath.startsWith("/") || /^[A-Z]:\//u.test(value.sandboxPath);
+  if (!absolute || /[\\\u0000-\u001f\u007f]/u.test(value.sandboxPath) || pathSegments.some(
+    (segment, index) => index >= (unc ? 2 : 1) && (!segment || segment === "." || segment === "..")
   ) || pathSegments.at(-1) !== value.filename) {
     context.addIssue({
       code: "custom",
       path: ["sandboxPath"],
-      message: "sandbox path must canonically identify the published filename in /workspace"
+      message: "sandbox path must canonically identify the published filename at an absolute host path"
     });
   }
   if (value.artifact.kind !== "file" || value.artifact.retention.policy !== "workspace_file") {
@@ -10380,6 +10466,8 @@ var FIRST_PARTY_MCP_TOOL_NAMES = [
   "browser_open",
   "browser_tabs",
   "browser_observe",
+  "browser_read",
+  "browser_screenshot",
   "browser_act",
   "browser_clipboard",
   "browser_debug",
@@ -10401,6 +10489,7 @@ var FIRST_PARTY_MCP_TOOL_NAMES = [
   "environment_set_variable",
   "capability_catalog_search",
   "capability_authorization_request",
+  "custom_mcp_setup_request",
   "github_connect_link",
   "github_repositories_list",
   "social_connections_list",
@@ -10479,6 +10568,8 @@ var FIRST_PARTY_IN_PROCESS_TOOL_NAMES = [
   "browser_open",
   "browser_tabs",
   "browser_observe",
+  "browser_read",
+  "browser_screenshot",
   "browser_act",
   "browser_clipboard",
   "browser_debug",
@@ -13439,7 +13530,17 @@ var RotateSessionMcpCredentialsRequest = z48.object({
       expectedCredentialVersion: z48.number().int().min(1).max(2147483646),
       expectedServerUrl: httpsUrl,
       headers: z48.record(z48.string(), z48.string())
-    }).strict()
+    }).strict().or(
+      z48.object({
+        id: SessionMcpServerId,
+        expectedCredentialVersion: z48.number().int().min(1).max(2147483646),
+        expectedServerUrl: httpsUrl,
+        /** Resolve from the authenticated caller's native account inventory. */
+        nativeConnectionId: z48.string().uuid(),
+        /** Explicit opt-in; must match the selected account's bound MCP URL. */
+        replacementServerUrl: httpsUrl.optional()
+      }).strict()
+    )
   ).min(1).max(64)
 }).strict();
 var RotateSessionMcpCredentialsReceipt = z48.object({
@@ -14435,7 +14536,7 @@ Required native document reports (persisted; completion requires current-head in
     return `Previous session goal (frozen at logical-turn acceptance; objective revision ${snapshot.objectiveRevision}; status completed): ${snapshot.text}
 Success criteria: ${snapshot.successCriteria ?? "none specified"}.${rootConstraints} This goal is complete and remains as historical context. If the user provides a new long-running objective, create it with opengeni__goal_set; goal_update cannot revise a completed goal.`;
   }
-  const policy = snapshot.mutationPolicy === "review_changes" ? "Semantic changes are proposals until a user applies them." : snapshot.mutationPolicy === "preserve_intent" ? "You may directly refine wording without changing intent; adaptations and replacements are proposals until a user applies them." : "You may autonomously refine, adapt, or replace the goal when explicit user direction or material new evidence justifies it.";
+  const policy = snapshot.mutationPolicy === "review_changes" ? "Semantic changes are proposals until a user applies them." : "You may update your operational goal directly when explicit user direction or material new evidence justifies it. Keep it faithful to the user's intended outcome; changing the goal grants no additional authority.";
   return `Standing session goal (frozen at logical-turn acceptance; objective revision ${snapshot.objectiveRevision}; status ${snapshot.state}): ${snapshot.text}
 Success criteria: ${snapshot.successCriteria ?? "none specified"}.${rootConstraints}${reports}
 Mutation policy: ${snapshot.mutationPolicy}. ${policy} Treat later ordinary messages as additional context unless they explicitly redirect this objective. Root constraints are user/API authority and cannot be widened, removed, or rewritten by an agent. Semantic goal changes use opengeni__goal_update with the expected objective revision, change kind, and rationale.`;
@@ -18512,8 +18613,25 @@ var ToolAuthNeededPayload = z48.object({
     action: z48.enum(["connect", "add_credentials", "enable"]),
     rationale: z48.string().min(1).max(2e3),
     requiredVariables: z48.array(VariableSetVariableName).max(64).default([])
+  }).optional(),
+  /** An agent suggestion, not a catalog entry or authority to contact this URL. */
+  setupRequest: z48.object({
+    kind: z48.literal("mcp"),
+    name: z48.string().trim().min(1).max(256),
+    endpointUrl: z48.string().url().max(2048).refine((url) => {
+      const parsed = new URL(url);
+      return parsed.protocol === "https:" && !parsed.username && !parsed.password && !parsed.hash && !parsed.search;
+    }),
+    rationale: z48.string().trim().min(1).max(2e3)
   }).optional()
 }).superRefine((payload, context) => {
+  if (payload.setupRequest && (payload.capability || payload.authoritySource === "host")) {
+    context.addIssue({
+      code: "custom",
+      message: "A setup proposal cannot carry connection authority",
+      path: ["setupRequest"]
+    });
+  }
   if (payload.authoritySource === "host") {
     if (payload.reason !== "unsupported_auth") {
       context.addIssue({
@@ -21421,6 +21539,7 @@ export {
   KnowledgeEntryWriteReceipt,
   KnowledgeFilePreparationResult,
   KnowledgeEntryRevision,
+  KnowledgeIndexStatus,
   KnowledgeEntryRecord,
   KnowledgeEntryListRequest,
   KnowledgeEntrySummary,
@@ -21789,6 +21908,12 @@ export {
   BrowserDiagnosticEntry,
   BrowserDiagnosticBatch,
   BrowserLocator,
+  BrowserTargetState,
+  BrowserDomSafeAttribute,
+  BrowserDomReadSelector,
+  BrowserDomReadLocator,
+  BrowserDomReadRequest,
+  BrowserDomReadResponse,
   ComputerLocator,
   BrowserPermission,
   BrowserPermissionSetting,
@@ -23285,4 +23410,4 @@ export {
   AtlassianDisconnectRequest,
   atlassianScopesAllowRead
 };
-//# sourceMappingURL=chunk-O23LYZFL.js.map
+//# sourceMappingURL=chunk-2KSPFPTV.js.map