@opengeni/contracts 4.1.0 → 5.0.0

package/dist/sandbox-provider-command.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 /** Provider-owned execution identity and acknowledged output cursors. These
  * values are retained by the control plane, never recovered from sandbox files. */
-export declare const SandboxProviderCommand: z.ZodObject<{
+export declare const ModalLegacyProviderCommand: z.ZodObject<{
     kind: z.ZodLiteral<"modal-control-v1">;
     sandboxId: z.ZodString;
     taskId: z.ZodString;
@@ -20,4 +20,94 @@ export declare const SandboxProviderCommand: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export type ModalLegacyProviderCommand = z.infer<typeof ModalLegacyProviderCommand>;
+export declare const CommandSupervisionDescriptor: z.ZodObject<{
+    protocol: z.ZodLiteral<"native-subreaper-v1">;
+    invocationId: z.ZodString;
+    nonce: z.ZodString;
+    controlPath: z.ZodString;
+}, z.core.$strict>;
+export type CommandSupervisionDescriptor = z.infer<typeof CommandSupervisionDescriptor>;
+export declare const CommandSupervisionReceipt: z.ZodObject<{
+    protocol: z.ZodLiteral<"native-subreaper-v1">;
+    invocationId: z.ZodString;
+    receiptId: z.ZodString;
+    leaderExitCode: z.ZodNumber;
+}, z.core.$strict>;
+export type CommandSupervisionReceipt = z.infer<typeof CommandSupervisionReceipt>;
+export declare const ModalRouterProviderCommand: z.ZodObject<{
+    kind: z.ZodLiteral<"modal-router-v1">;
+    sandboxId: z.ZodString;
+    taskId: z.ZodString;
+    execId: z.ZodString;
+    pty: z.ZodOptional<z.ZodBoolean>;
+    supervision: z.ZodOptional<z.ZodObject<{
+        protocol: z.ZodLiteral<"native-subreaper-v1">;
+        invocationId: z.ZodString;
+        nonce: z.ZodString;
+        controlPath: z.ZodString;
+    }, z.core.$strict>>;
+    streams: z.ZodObject<{
+        stdout: z.ZodObject<{
+            byteOffset: z.ZodNumber;
+            utf8Remainder: z.ZodString;
+            eof: z.ZodBoolean;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        stderr: z.ZodObject<{
+            byteOffset: z.ZodNumber;
+            utf8Remainder: z.ZodString;
+            eof: z.ZodBoolean;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ModalRouterProviderCommand = z.infer<typeof ModalRouterProviderCommand>;
+/** Legacy locators are read-only compatibility for already launched commands;
+ * new starts use authenticated task-router byte offsets, never batch indices. */
+export declare const SandboxProviderCommand: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"modal-control-v1">;
+    sandboxId: z.ZodString;
+    taskId: z.ZodString;
+    execId: z.ZodString;
+    pty: z.ZodOptional<z.ZodBoolean>;
+    streams: z.ZodObject<{
+        stdout: z.ZodObject<{
+            batchIndex: z.ZodNumber;
+            utf8Remainder: z.ZodString;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        stderr: z.ZodObject<{
+            batchIndex: z.ZodNumber;
+            utf8Remainder: z.ZodString;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"modal-router-v1">;
+    sandboxId: z.ZodString;
+    taskId: z.ZodString;
+    execId: z.ZodString;
+    pty: z.ZodOptional<z.ZodBoolean>;
+    supervision: z.ZodOptional<z.ZodObject<{
+        protocol: z.ZodLiteral<"native-subreaper-v1">;
+        invocationId: z.ZodString;
+        nonce: z.ZodString;
+        controlPath: z.ZodString;
+    }, z.core.$strict>>;
+    streams: z.ZodObject<{
+        stdout: z.ZodObject<{
+            byteOffset: z.ZodNumber;
+            utf8Remainder: z.ZodString;
+            eof: z.ZodBoolean;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        stderr: z.ZodObject<{
+            byteOffset: z.ZodNumber;
+            utf8Remainder: z.ZodString;
+            eof: z.ZodBoolean;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
 export type SandboxProviderCommand = z.infer<typeof SandboxProviderCommand>;

package/dist/sandbox-recovery.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+/** Public, content-free selection. Never include native provider bindings. */
+export declare const SandboxRecoverySelection: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    sandboxGroupId: z.ZodString;
+    leaseId: z.ZodString;
+    routeEpoch: z.ZodNumber;
+    authorityEpoch: z.ZodNumber;
+    leaseEpoch: z.ZodNumber;
+    workspaceGeneration: z.ZodNumber;
+    archiveGeneration: z.ZodNumber;
+    artifactId: z.ZodString;
+    revision: z.ZodString;
+    capturedAt: z.ZodString;
+}, z.core.$strict>;
+export type SandboxRecoverySelection = z.infer<typeof SandboxRecoverySelection>;
+export declare const SandboxRecoveryProjection: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        consent_accepted: "consent_accepted";
+        eligible: "eligible";
+        restored: "restored";
+        restoring: "restoring";
+        unsupported: "unsupported";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+    checkpoint: z.ZodNullable<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        sessionId: z.ZodString;
+        sandboxGroupId: z.ZodString;
+        leaseId: z.ZodString;
+        routeEpoch: z.ZodNumber;
+        authorityEpoch: z.ZodNumber;
+        leaseEpoch: z.ZodNumber;
+        workspaceGeneration: z.ZodNumber;
+        archiveGeneration: z.ZodNumber;
+        artifactId: z.ZodString;
+        revision: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strict>>;
+    operationId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SandboxRecoveryProjection = z.infer<typeof SandboxRecoveryProjection>;
+export declare const SandboxRecoveryRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    acceptHistoricalCheckpoint: z.ZodLiteral<true>;
+    selection: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        sessionId: z.ZodString;
+        sandboxGroupId: z.ZodString;
+        leaseId: z.ZodString;
+        routeEpoch: z.ZodNumber;
+        authorityEpoch: z.ZodNumber;
+        leaseEpoch: z.ZodNumber;
+        workspaceGeneration: z.ZodNumber;
+        archiveGeneration: z.ZodNumber;
+        artifactId: z.ZodString;
+        revision: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SandboxRecoveryRequest = z.infer<typeof SandboxRecoveryRequest>;
+export declare const SandboxRecoveryResponse: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        accepted: "accepted";
+        replayed: "replayed";
+    }>;
+    operationId: z.ZodString;
+    recovery: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            consent_accepted: "consent_accepted";
+            eligible: "eligible";
+            restored: "restored";
+            restoring: "restoring";
+            unsupported: "unsupported";
+        }>;
+        reason: z.ZodNullable<z.ZodString>;
+        checkpoint: z.ZodNullable<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            sessionId: z.ZodString;
+            sandboxGroupId: z.ZodString;
+            leaseId: z.ZodString;
+            routeEpoch: z.ZodNumber;
+            authorityEpoch: z.ZodNumber;
+            leaseEpoch: z.ZodNumber;
+            workspaceGeneration: z.ZodNumber;
+            archiveGeneration: z.ZodNumber;
+            artifactId: z.ZodString;
+            revision: z.ZodString;
+            capturedAt: z.ZodString;
+        }, z.core.$strict>>;
+        operationId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SandboxRecoveryResponse = z.infer<typeof SandboxRecoveryResponse>;
+/** Re-injected from durable receipts on every attempt, not lossy transcript state. */
+export declare function sandboxRecoveryDiscontinuity(selection: SandboxRecoverySelection): string;

package/dist/session-goal-reports.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const SessionGoalReportRequirement: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>;
+export type SessionGoalReportRequirement = z.infer<typeof SessionGoalReportRequirement>;
+export declare const SessionGoalReportRequirements: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>>;
+export declare const SessionGoalReportDelivery: z.ZodObject<{
+    requirementId: z.ZodString;
+    artifactId: z.ZodString;
+    inspectionReceiptId: z.ZodString;
+}, z.core.$strict>;
+export type SessionGoalReportDelivery = z.infer<typeof SessionGoalReportDelivery>;
+export declare const SessionGoalReportDeliveries: z.ZodArray<z.ZodObject<{
+    requirementId: z.ZodString;
+    artifactId: z.ZodString;
+    inspectionReceiptId: z.ZodString;
+}, z.core.$strict>>;

package/dist/session-message-search.d.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+/** Literal Unicode case-insensitive search, without trimming or normalization. */
+export declare const SessionMessageSearchRequest: z.ZodObject<{
+    query: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodOptional<z.ZodLiteral<"session">>;
+    archiveStatus: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        all: "all";
+        archived: "archived";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SessionMessageSearchRequest = z.infer<typeof SessionMessageSearchRequest>;
+export declare const SessionMessageSearchMatch: z.ZodObject<{
+    sessionId: z.ZodString;
+    sessionTitle: z.ZodNullable<z.ZodString>;
+    eventId: z.ZodString;
+    sequence: z.ZodNumber;
+    turnId: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    messageId: z.ZodNullable<z.ZodString>;
+    messageMatchOffset: z.ZodNumber;
+    snippet: z.ZodObject<{
+        text: z.ZodString;
+        matchStart: z.ZodNumber;
+        matchEnd: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SessionMessageSearchMatch = z.infer<typeof SessionMessageSearchMatch>;
+/** A bounded scan page, not necessarily a full page of matches. Continue even
+ * after an empty page while hasMore is true. Counts describe this live traversal,
+ * not a frozen snapshot; restart to reflect concurrent changes. All non-overlapping
+ * literal occurrences in user messages and completed assistant messages.
+ * With groupBy=session, matches and both matched counts describe one first-hit
+ * representative per matching session, not full message/occurrence totals.
+ */
+export declare const SessionMessageSearchResponse: z.ZodObject<{
+    matches: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        sessionTitle: z.ZodNullable<z.ZodString>;
+        eventId: z.ZodString;
+        sequence: z.ZodNumber;
+        turnId: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>;
+        messageId: z.ZodNullable<z.ZodString>;
+        messageMatchOffset: z.ZodNumber;
+        snippet: z.ZodObject<{
+            text: z.ZodString;
+            matchStart: z.ZodNumber;
+            matchEnd: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+    scannedMessages: z.ZodNumber;
+    matchedMessageCount: z.ZodNumber;
+    matchedOccurrenceCount: z.ZodNumber;
+    countIsExact: z.ZodBoolean;
+}, z.core.$strip>;
+export type SessionMessageSearchResponse = z.infer<typeof SessionMessageSearchResponse>;

package/dist/skill-catalog-context.d.ts

@@ -0,0 +1,7 @@
+/** Durable, model-visible catalog context. Text markers survive SDK/provider replay. */
+export declare const SKILL_CATALOG_CONTEXT_PREFIX = "<opengeni_skill_catalog>\n";
+export declare const SKILL_CATALOG_CONTEXT_SUFFIX = "\n</opengeni_skill_catalog>";
+export declare function skillCatalogContextItem(catalog: string): Record<string, unknown>;
+/** Accept the Chat Completions projection and SDK text-part normalization too. */
+export declare function readSkillCatalogContext(item: Record<string, unknown>): string | null;
+export declare function latestSkillCatalogContext(items: readonly Record<string, unknown>[]): Record<string, unknown> | undefined;

package/dist/skills.d.ts

@@ -44,6 +44,7 @@ export type SkillSaveInput = SkillWriteContext & {
     reason: string;
 };
 export type SkillRevisionInput = SkillWriteContext & {
+    removalOperationId?: string | undefined;
     operationId: string;
     skillId: string;
     revisionId: string;
@@ -51,12 +52,20 @@ export type SkillRevisionInput = SkillWriteContext & {
     expectedScopeVersion: number;
     reason: string;
 };
+export type SkillRemoveInput = SkillWriteContext & {
+    operationId: string;
+    skillId: string;
+    expectedRevisionId: string | null;
+    expectedScopeVersion: number;
+    reason: string;
+};
 export type SkillInstallInput = SkillWriteContext & {
     operationId: string;
     skillFacetId: string;
     reason: string;
 };
 export declare const SkillReviewReference: z.ZodObject<{
+    removalOperationId: z.ZodOptional<z.ZodUUID>;
     sourceOperationId: z.ZodUUID;
     skillId: z.ZodUUID;
     revisionId: z.ZodUUID;
@@ -78,6 +87,7 @@ export declare function skillReviewHumanInput(skillReview: SkillReviewReference)
         required: boolean;
         allowOther: boolean;
         skillReview: {
+            removalOperationId?: string | undefined;
             sourceOperationId: string;
             skillId: string;
             revisionId: string;
@@ -87,6 +97,7 @@ export declare function skillReviewHumanInput(skillReview: SkillReviewReference)
     }[];
 };
 export declare const SkillWriteReceipt: z.ZodObject<{
+    removed: z.ZodOptional<z.ZodBoolean>;
     operationId: z.ZodUUID;
     skillId: z.ZodUUID;
     revisionId: z.ZodUUID;
@@ -101,6 +112,7 @@ export declare const SkillWriteReceipt: z.ZodObject<{
         source_finalization: "source_finalization";
     }>>;
     skillReview: z.ZodOptional<z.ZodObject<{
+        removalOperationId: z.ZodOptional<z.ZodUUID>;
         sourceOperationId: z.ZodUUID;
         skillId: z.ZodUUID;
         revisionId: z.ZodUUID;
@@ -111,6 +123,7 @@ export declare const SkillWriteReceipt: z.ZodObject<{
 }, z.core.$strip>;
 export type SkillWriteReceipt = z.infer<typeof SkillWriteReceipt>;
 export declare const SkillPublicationReceipt: z.ZodObject<{
+    removed: z.ZodOptional<z.ZodBoolean>;
     operationId: z.ZodUUID;
     skillId: z.ZodUUID;
     revisionId: z.ZodUUID;
@@ -125,6 +138,7 @@ export declare const SkillPublicationReceipt: z.ZodObject<{
         source_finalization: "source_finalization";
     }>>;
     skillReview: z.ZodOptional<z.ZodObject<{
+        removalOperationId: z.ZodOptional<z.ZodUUID>;
         sourceOperationId: z.ZodUUID;
         skillId: z.ZodUUID;
         revisionId: z.ZodUUID;
@@ -149,6 +163,7 @@ export declare const SkillSourceReleaseReceipt: z.ZodObject<{
 }, z.core.$strip>;
 export type SkillSourceReleaseReceipt = z.infer<typeof SkillSourceReleaseReceipt>;
 export type SkillRecord = {
+    removalOperationId?: string | null;
     activationMode: "workspace_managed" | "session_selected";
     pendingRevisionIds: string[];
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/contracts",
-  "version": "4.1.0",
+  "version": "5.0.0",
   "description": "Shared zod schemas and wire-contract types for the OpenGeni API.",
   "license": "Apache-2.0",
   "repository": {
@@ -18,9 +18,9 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    "./host-mcp-resolvers": {
-      "types": "./dist/host-mcp-resolvers.d.ts",
-      "import": "./dist/host-mcp-resolvers.js"
+    "./managed-sign-in-methods": {
+      "types": "./dist/managed-sign-in-methods.d.ts",
+      "import": "./dist/managed-sign-in-methods.js"
     },
     "./mcp-endpoint": {
       "types": "./dist/mcp-endpoint.d.ts",

package/src/bundled-skills.ts

@@ -1,6 +1,8 @@
 import { z } from "zod";
 
 export const BundledSkillId = z.enum([
+  "builtin:opengeni-help",
+  "builtin:opengeni-client",
   "builtin:opengeni-visualize",
   "builtin:document-parsing",
   "builtin:opengeni-skills",