@opengeni/contracts 0.50.0 → 1.0.0

package/dist/personal-github.js

@@ -0,0 +1,222 @@
+import {
+  ConnectionMetadata
+} from "./chunk-X7ETVO4P.js";
+import "./chunk-5IXYF6XN.js";
+import "./chunk-NRMCVHAU.js";
+import "./chunk-WYBDERIY.js";
+import "./chunk-4JGHSSB7.js";
+import "./chunk-EK7NDGFR.js";
+import "./chunk-O77VSFYZ.js";
+import "./chunk-NVJMJWLL.js";
+import "./chunk-SIOU2K4U.js";
+import "./chunk-YRKRZ6OF.js";
+import "./chunk-2VORLN2R.js";
+import "./chunk-FZ6BXQHL.js";
+import "./chunk-GRG7PHWQ.js";
+import "./chunk-YRXAWWCU.js";
+import "./chunk-2ACYHZFB.js";
+import "./chunk-KHHZTBP7.js";
+import "./chunk-YBW5JSA3.js";
+import "./chunk-RJ76DRPO.js";
+import "./chunk-QR5D2IQC.js";
+import "./chunk-3SIZGL3O.js";
+import "./chunk-RIY7GYQS.js";
+import "./chunk-JUFK3T4Q.js";
+import "./chunk-TSCDAGET.js";
+import "./chunk-BCS7WHCK.js";
+import "./chunk-D2HKF2EF.js";
+import "./chunk-MYBZRDTY.js";
+import "./chunk-MZLBPKFE.js";
+import "./chunk-RKX3NQYS.js";
+import "./chunk-Y3KNXVTD.js";
+import "./chunk-TXTQIYCV.js";
+import "./chunk-PX3VCKAU.js";
+
+// src/personal-github.ts
+import { z } from "zod";
+var PERSONAL_GITHUB_PROVIDER_DOMAIN = "github.com";
+var PERSONAL_GITHUB_PROVIDER_FAMILY = "github";
+var PERSONAL_GITHUB_CREDENTIAL_ROLE = "opengeni_github_personal";
+var PERSONAL_GITHUB_CONNECTION_SURFACE_ID = "github:personal";
+var PERSONAL_GITHUB_REQUESTED_SCOPES = ["repo"];
+var PERSONAL_GITHUB_AUTHORIZATION_URL = "https://github.com/login/oauth/authorize";
+var PERSONAL_GITHUB_TOKEN_URL = "https://github.com/login/oauth/access_token";
+var PERSONAL_GITHUB_USER_URL = "https://api.github.com/user";
+var PERSONAL_GITHUB_API_ORIGIN = "https://api.github.com";
+var PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX = 100;
+var PersonalGitHubRepositoryId = z.string().regex(/^[1-9]\d*$/u);
+var PersonalGitHubRepositoryAccess = z.enum(["read", "write"]);
+var PersonalGitHubRepositoryPermissions = z.object({
+  pull: z.boolean(),
+  push: z.boolean(),
+  admin: z.boolean(),
+  maintain: z.boolean(),
+  triage: z.boolean()
+}).strict();
+var PersonalGitHubRepositoryVisibility = z.enum(["public", "private", "internal"]);
+var PersonalGitHubRepositoryFullName = z.string().min(3).max(140).regex(/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})\/[A-Za-z0-9_.-]{1,100}$/u);
+function canonicalPersonalGitHubRepositoryUrl(fullName) {
+  return `https://github.com/${fullName}`;
+}
+var PersonalGitHubRepository = z.object({
+  repositoryId: PersonalGitHubRepositoryId,
+  fullName: PersonalGitHubRepositoryFullName,
+  canonicalUrl: z.string().url().max(512),
+  defaultBranch: z.string().min(1).max(255),
+  visibility: PersonalGitHubRepositoryVisibility,
+  private: z.boolean(),
+  archived: z.boolean(),
+  disabled: z.boolean(),
+  permissions: PersonalGitHubRepositoryPermissions
+}).strict().superRefine((repository, context) => {
+  if (repository.canonicalUrl !== canonicalPersonalGitHubRepositoryUrl(repository.fullName)) {
+    context.addIssue({
+      code: "custom",
+      path: ["canonicalUrl"],
+      message: "canonicalUrl must be derived from fullName"
+    });
+  }
+  if (repository.private !== (repository.visibility === "private")) {
+    context.addIssue({
+      code: "custom",
+      path: ["private"],
+      message: "private must agree with visibility"
+    });
+  }
+});
+var PersonalGitHubSelectedRepository = PersonalGitHubRepository.safeExtend({
+  selectedAccess: PersonalGitHubRepositoryAccess,
+  selectionGeneration: z.number().int().positive(),
+  selectedAt: z.string().datetime({ offset: true }),
+  lastVerifiedAt: z.string().datetime({ offset: true })
+}).strict();
+var PersonalGitHubRepositorySelectionState = z.object({
+  connectionAuthorityGeneration: z.number().int().positive(),
+  credentialBindingId: z.string().uuid(),
+  providerPrincipalId: PersonalGitHubRepositoryId,
+  selectionGeneration: z.number().int().nonnegative(),
+  repositories: z.array(PersonalGitHubSelectedRepository).max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX)
+}).strict();
+var ListPersonalGitHubRepositoriesQuery = z.object({
+  cursor: z.coerce.number().int().positive().max(1e4).default(1),
+  limit: z.coerce.number().int().min(1).max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX).default(50)
+}).strict();
+var PersonalGitHubRepositoryCatalogItem = PersonalGitHubRepository.safeExtend({
+  selectedAccess: PersonalGitHubRepositoryAccess.nullable()
+}).strict();
+var ListPersonalGitHubRepositoriesResponse = z.object({
+  repositories: z.array(PersonalGitHubRepositoryCatalogItem).max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX),
+  nextCursor: z.number().int().positive().nullable(),
+  selection: PersonalGitHubRepositorySelectionState
+}).strict();
+var PersonalGitHubRepositorySelectionInput = z.object({
+  repositoryId: PersonalGitHubRepositoryId,
+  fullName: PersonalGitHubRepositoryFullName,
+  access: PersonalGitHubRepositoryAccess
+}).strict();
+var ReplacePersonalGitHubRepositorySelectionsRequest = z.object({
+  expectedConnectionAuthorityGeneration: z.number().int().positive(),
+  expectedSelectionGeneration: z.number().int().nonnegative(),
+  idempotencyKey: z.string().trim().min(1).max(200),
+  repositories: z.array(PersonalGitHubRepositorySelectionInput).max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX)
+}).strict().superRefine((request, context) => {
+  const repositoryIds = /* @__PURE__ */ new Set();
+  const fullNames = /* @__PURE__ */ new Set();
+  request.repositories.forEach((repository, index) => {
+    const normalizedFullName = repository.fullName.toLowerCase();
+    if (repositoryIds.has(repository.repositoryId)) {
+      context.addIssue({
+        code: "custom",
+        path: ["repositories", index, "repositoryId"],
+        message: "repositoryId must be unique"
+      });
+    }
+    if (fullNames.has(normalizedFullName)) {
+      context.addIssue({
+        code: "custom",
+        path: ["repositories", index, "fullName"],
+        message: "fullName must be unique"
+      });
+    }
+    repositoryIds.add(repository.repositoryId);
+    fullNames.add(normalizedFullName);
+  });
+});
+var VerifyPersonalGitHubRepositorySelectionsRequest = z.object({
+  expectedConnectionAuthorityGeneration: z.number().int().positive(),
+  expectedSelectionGeneration: z.number().int().nonnegative(),
+  idempotencyKey: z.string().trim().min(1).max(200)
+}).strict();
+var PersonalGitHubConnectionMetadata = z.object({
+  credentialRole: z.literal(PERSONAL_GITHUB_CREDENTIAL_ROLE),
+  providerFamily: z.literal(PERSONAL_GITHUB_PROVIDER_FAMILY),
+  providerPrincipalId: z.string().regex(/^\d+$/u),
+  githubUserId: z.string().regex(/^\d+$/u),
+  githubLogin: z.string().min(1).max(100),
+  oauthEnvironment: z.string().min(1).max(128),
+  oauthClientMarker: z.string().regex(/^[a-f0-9]{32}$/u),
+  credentialBindingId: z.string().uuid(),
+  connectedAt: z.string().datetime({ offset: true }),
+  lastVerifiedAt: z.string().datetime({ offset: true }),
+  disconnectedAt: z.string().datetime({ offset: true }).nullable().optional(),
+  refreshTokenExpiresAt: z.string().datetime({ offset: true }).nullable().optional()
+}).passthrough();
+var PersonalGitHubOAuthStartRequest = z.object({
+  /** Existing exact connection generation to re-authorize in place. */
+  connectionId: z.string().uuid().optional(),
+  /** Same-workspace UI path restored after the callback. */
+  returnPath: z.string().min(1).max(2048).optional()
+}).strict();
+var PersonalGitHubOAuthStartResponse = z.object({
+  authorizationUrl: z.string().url(),
+  expiresAt: z.string().datetime({ offset: true })
+}).strict();
+var PersonalGitHubConnectionStatusResponse = z.object({
+  enabled: z.boolean(),
+  connection: ConnectionMetadata.nullable(),
+  reviewUrl: z.string().url().nullable()
+}).strict();
+var PersonalGitHubDisconnectRequest = z.object({
+  expectedVersion: z.number().int().positive(),
+  idempotencyKey: z.string().trim().min(1).max(200)
+}).strict();
+function isPersonalGitHubConnection(connection) {
+  return connection.providerDomain.toLowerCase() === PERSONAL_GITHUB_PROVIDER_DOMAIN && connection.kind === "oauth2" && PersonalGitHubConnectionMetadata.safeParse(connection.metadata).success;
+}
+function hasReservedPersonalGitHubMetadata(metadata) {
+  return metadata?.credentialRole === PERSONAL_GITHUB_CREDENTIAL_ROLE;
+}
+export {
+  ListPersonalGitHubRepositoriesQuery,
+  ListPersonalGitHubRepositoriesResponse,
+  PERSONAL_GITHUB_API_ORIGIN,
+  PERSONAL_GITHUB_AUTHORIZATION_URL,
+  PERSONAL_GITHUB_CONNECTION_SURFACE_ID,
+  PERSONAL_GITHUB_CREDENTIAL_ROLE,
+  PERSONAL_GITHUB_PROVIDER_DOMAIN,
+  PERSONAL_GITHUB_PROVIDER_FAMILY,
+  PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX,
+  PERSONAL_GITHUB_REQUESTED_SCOPES,
+  PERSONAL_GITHUB_TOKEN_URL,
+  PERSONAL_GITHUB_USER_URL,
+  PersonalGitHubConnectionMetadata,
+  PersonalGitHubConnectionStatusResponse,
+  PersonalGitHubDisconnectRequest,
+  PersonalGitHubOAuthStartRequest,
+  PersonalGitHubOAuthStartResponse,
+  PersonalGitHubRepository,
+  PersonalGitHubRepositoryAccess,
+  PersonalGitHubRepositoryCatalogItem,
+  PersonalGitHubRepositoryId,
+  PersonalGitHubRepositoryPermissions,
+  PersonalGitHubRepositorySelectionInput,
+  PersonalGitHubRepositorySelectionState,
+  PersonalGitHubRepositoryVisibility,
+  PersonalGitHubSelectedRepository,
+  ReplacePersonalGitHubRepositorySelectionsRequest,
+  VerifyPersonalGitHubRepositorySelectionsRequest,
+  canonicalPersonalGitHubRepositoryUrl,
+  hasReservedPersonalGitHubMetadata,
+  isPersonalGitHubConnection
+};
+//# sourceMappingURL=personal-github.js.map

package/dist/personal-github.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/personal-github.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { ConnectionMetadata } from \"./index\";\n\nexport const PERSONAL_GITHUB_PROVIDER_DOMAIN = \"github.com\" as const;\nexport const PERSONAL_GITHUB_PROVIDER_FAMILY = \"github\" as const;\nexport const PERSONAL_GITHUB_CREDENTIAL_ROLE = \"opengeni_github_personal\" as const;\nexport const PERSONAL_GITHUB_CONNECTION_SURFACE_ID = \"github:personal\" as const;\nexport const PERSONAL_GITHUB_REQUESTED_SCOPES = [\"repo\"] as const;\nexport const PERSONAL_GITHUB_AUTHORIZATION_URL =\n  \"https://github.com/login/oauth/authorize\" as const;\nexport const PERSONAL_GITHUB_TOKEN_URL = \"https://github.com/login/oauth/access_token\" as const;\nexport const PERSONAL_GITHUB_USER_URL = \"https://api.github.com/user\" as const;\nexport const PERSONAL_GITHUB_API_ORIGIN = \"https://api.github.com\" as const;\nexport const PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX = 100 as const;\n\nexport const PersonalGitHubRepositoryId = z.string().regex(/^[1-9]\\d*$/u);\nexport type PersonalGitHubRepositoryId = z.infer<typeof PersonalGitHubRepositoryId>;\n\nexport const PersonalGitHubRepositoryAccess = z.enum([\"read\", \"write\"]);\nexport type PersonalGitHubRepositoryAccess = z.infer<typeof PersonalGitHubRepositoryAccess>;\n\nexport const PersonalGitHubRepositoryPermissions = z\n  .object({\n    pull: z.boolean(),\n    push: z.boolean(),\n    admin: z.boolean(),\n    maintain: z.boolean(),\n    triage: z.boolean(),\n  })\n  .strict();\nexport type PersonalGitHubRepositoryPermissions = z.infer<\n  typeof PersonalGitHubRepositoryPermissions\n>;\n\nexport const PersonalGitHubRepositoryVisibility = z.enum([\"public\", \"private\", \"internal\"]);\nexport type PersonalGitHubRepositoryVisibility = z.infer<typeof PersonalGitHubRepositoryVisibility>;\n\nconst PersonalGitHubRepositoryFullName = z\n  .string()\n  .min(3)\n  .max(140)\n  .regex(/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})\\/[A-Za-z0-9_.-]{1,100}$/u);\n\nexport function canonicalPersonalGitHubRepositoryUrl(fullName: string): string {\n  return `https://github.com/${fullName}`;\n}\n\n/** A bounded, credential-free projection verified directly against GitHub. */\nexport const PersonalGitHubRepository = z\n  .object({\n    repositoryId: PersonalGitHubRepositoryId,\n    fullName: PersonalGitHubRepositoryFullName,\n    canonicalUrl: z.string().url().max(512),\n    defaultBranch: z.string().min(1).max(255),\n    visibility: PersonalGitHubRepositoryVisibility,\n    private: z.boolean(),\n    archived: z.boolean(),\n    disabled: z.boolean(),\n    permissions: PersonalGitHubRepositoryPermissions,\n  })\n  .strict()\n  .superRefine((repository, context) => {\n    if (repository.canonicalUrl !== canonicalPersonalGitHubRepositoryUrl(repository.fullName)) {\n      context.addIssue({\n        code: \"custom\",\n        path: [\"canonicalUrl\"],\n        message: \"canonicalUrl must be derived from fullName\",\n      });\n    }\n    if (repository.private !== (repository.visibility === \"private\")) {\n      context.addIssue({\n        code: \"custom\",\n        path: [\"private\"],\n        message: \"private must agree with visibility\",\n      });\n    }\n  });\nexport type PersonalGitHubRepository = z.infer<typeof PersonalGitHubRepository>;\n\nexport const PersonalGitHubSelectedRepository = PersonalGitHubRepository.safeExtend({\n  selectedAccess: PersonalGitHubRepositoryAccess,\n  selectionGeneration: z.number().int().positive(),\n  selectedAt: z.string().datetime({ offset: true }),\n  lastVerifiedAt: z.string().datetime({ offset: true }),\n}).strict();\nexport type PersonalGitHubSelectedRepository = z.infer<typeof PersonalGitHubSelectedRepository>;\n\nexport const PersonalGitHubRepositorySelectionState = z\n  .object({\n    connectionAuthorityGeneration: z.number().int().positive(),\n    credentialBindingId: z.string().uuid(),\n    providerPrincipalId: PersonalGitHubRepositoryId,\n    selectionGeneration: z.number().int().nonnegative(),\n    repositories: z\n      .array(PersonalGitHubSelectedRepository)\n      .max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX),\n  })\n  .strict();\nexport type PersonalGitHubRepositorySelectionState = z.infer<\n  typeof PersonalGitHubRepositorySelectionState\n>;\n\nexport const ListPersonalGitHubRepositoriesQuery = z\n  .object({\n    cursor: z.coerce.number().int().positive().max(10_000).default(1),\n    limit: z.coerce.number().int().min(1).max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX).default(50),\n  })\n  .strict();\nexport type ListPersonalGitHubRepositoriesQuery = z.infer<\n  typeof ListPersonalGitHubRepositoriesQuery\n>;\n\nexport const PersonalGitHubRepositoryCatalogItem = PersonalGitHubRepository.safeExtend({\n  selectedAccess: PersonalGitHubRepositoryAccess.nullable(),\n}).strict();\nexport type PersonalGitHubRepositoryCatalogItem = z.infer<\n  typeof PersonalGitHubRepositoryCatalogItem\n>;\n\nexport const ListPersonalGitHubRepositoriesResponse = z\n  .object({\n    repositories: z\n      .array(PersonalGitHubRepositoryCatalogItem)\n      .max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX),\n    nextCursor: z.number().int().positive().nullable(),\n    selection: PersonalGitHubRepositorySelectionState,\n  })\n  .strict();\nexport type ListPersonalGitHubRepositoriesResponse = z.infer<\n  typeof ListPersonalGitHubRepositoriesResponse\n>;\n\nexport const PersonalGitHubRepositorySelectionInput = z\n  .object({\n    repositoryId: PersonalGitHubRepositoryId,\n    fullName: PersonalGitHubRepositoryFullName,\n    access: PersonalGitHubRepositoryAccess,\n  })\n  .strict();\nexport type PersonalGitHubRepositorySelectionInput = z.infer<\n  typeof PersonalGitHubRepositorySelectionInput\n>;\n\nexport const ReplacePersonalGitHubRepositorySelectionsRequest = z\n  .object({\n    expectedConnectionAuthorityGeneration: z.number().int().positive(),\n    expectedSelectionGeneration: z.number().int().nonnegative(),\n    idempotencyKey: z.string().trim().min(1).max(200),\n    repositories: z\n      .array(PersonalGitHubRepositorySelectionInput)\n      .max(PERSONAL_GITHUB_REPOSITORY_CATALOG_MAX),\n  })\n  .strict()\n  .superRefine((request, context) => {\n    const repositoryIds = new Set<string>();\n    const fullNames = new Set<string>();\n    request.repositories.forEach((repository, index) => {\n      const normalizedFullName = repository.fullName.toLowerCase();\n      if (repositoryIds.has(repository.repositoryId)) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"repositories\", index, \"repositoryId\"],\n          message: \"repositoryId must be unique\",\n        });\n      }\n      if (fullNames.has(normalizedFullName)) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"repositories\", index, \"fullName\"],\n          message: \"fullName must be unique\",\n        });\n      }\n      repositoryIds.add(repository.repositoryId);\n      fullNames.add(normalizedFullName);\n    });\n  });\nexport type ReplacePersonalGitHubRepositorySelectionsRequest = z.infer<\n  typeof ReplacePersonalGitHubRepositorySelectionsRequest\n>;\n\nexport const VerifyPersonalGitHubRepositorySelectionsRequest = z\n  .object({\n    expectedConnectionAuthorityGeneration: z.number().int().positive(),\n    expectedSelectionGeneration: z.number().int().nonnegative(),\n    idempotencyKey: z.string().trim().min(1).max(200),\n  })\n  .strict();\nexport type VerifyPersonalGitHubRepositorySelectionsRequest = z.infer<\n  typeof VerifyPersonalGitHubRepositorySelectionsRequest\n>;\n\n/**\n * Owner-visible, credential-free metadata for one dedicated personal GitHub\n * OAuth connection. Repository selections are a separate authority and never\n * live in this credential record.\n */\nexport const PersonalGitHubConnectionMetadata = z\n  .object({\n    credentialRole: z.literal(PERSONAL_GITHUB_CREDENTIAL_ROLE),\n    providerFamily: z.literal(PERSONAL_GITHUB_PROVIDER_FAMILY),\n    providerPrincipalId: z.string().regex(/^\\d+$/u),\n    githubUserId: z.string().regex(/^\\d+$/u),\n    githubLogin: z.string().min(1).max(100),\n    oauthEnvironment: z.string().min(1).max(128),\n    oauthClientMarker: z.string().regex(/^[a-f0-9]{32}$/u),\n    credentialBindingId: z.string().uuid(),\n    connectedAt: z.string().datetime({ offset: true }),\n    lastVerifiedAt: z.string().datetime({ offset: true }),\n    disconnectedAt: z.string().datetime({ offset: true }).nullable().optional(),\n    refreshTokenExpiresAt: z.string().datetime({ offset: true }).nullable().optional(),\n  })\n  .passthrough();\nexport type PersonalGitHubConnectionMetadata = z.infer<typeof PersonalGitHubConnectionMetadata>;\n\nexport const PersonalGitHubOAuthStartRequest = z\n  .object({\n    /** Existing exact connection generation to re-authorize in place. */\n    connectionId: z.string().uuid().optional(),\n    /** Same-workspace UI path restored after the callback. */\n    returnPath: z.string().min(1).max(2048).optional(),\n  })\n  .strict();\nexport type PersonalGitHubOAuthStartRequest = z.infer<typeof PersonalGitHubOAuthStartRequest>;\n\nexport const PersonalGitHubOAuthStartResponse = z\n  .object({\n    authorizationUrl: z.string().url(),\n    expiresAt: z.string().datetime({ offset: true }),\n  })\n  .strict();\nexport type PersonalGitHubOAuthStartResponse = z.infer<typeof PersonalGitHubOAuthStartResponse>;\n\nexport const PersonalGitHubConnectionStatusResponse = z\n  .object({\n    enabled: z.boolean(),\n    connection: ConnectionMetadata.nullable(),\n    reviewUrl: z.string().url().nullable(),\n  })\n  .strict();\nexport type PersonalGitHubConnectionStatusResponse = z.infer<\n  typeof PersonalGitHubConnectionStatusResponse\n>;\n\nexport const PersonalGitHubDisconnectRequest = z\n  .object({\n    expectedVersion: z.number().int().positive(),\n    idempotencyKey: z.string().trim().min(1).max(200),\n  })\n  .strict();\nexport type PersonalGitHubDisconnectRequest = z.infer<typeof PersonalGitHubDisconnectRequest>;\n\nexport function isPersonalGitHubConnection(\n  connection: Pick<z.infer<typeof ConnectionMetadata>, \"providerDomain\" | \"kind\" | \"metadata\">,\n): boolean {\n  return (\n    connection.providerDomain.toLowerCase() === PERSONAL_GITHUB_PROVIDER_DOMAIN &&\n    connection.kind === \"oauth2\" &&\n    PersonalGitHubConnectionMetadata.safeParse(connection.metadata).success\n  );\n}\n\nexport function hasReservedPersonalGitHubMetadata(\n  metadata: Record<string, unknown> | undefined,\n): boolean {\n  return metadata?.credentialRole === PERSONAL_GITHUB_CREDENTIAL_ROLE;\n}\n"],"mappings":"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","names":[]}

package/dist/plugin-discovery.d.ts

@@ -0,0 +1,35 @@
+/** Public discovery metadata; listing does not imply runtime compatibility. */
+export { pluginMcpUnavailableReason } from "./mcp-endpoint.js";
+export type PluginDiscoveryItem = {
+    id: string;
+    name: string;
+    displayName: string;
+    description: string;
+    longDescription: string;
+    provider: string;
+    category: string | null;
+    logoUrl: string | null;
+    darkLogoUrl: string | null;
+    sourceUrl: string | null;
+    author: {
+        name?: string;
+    } | null;
+    version: string | null;
+    skills?: {
+        name: string;
+        sourceUrl: string;
+    }[] | null;
+    mcpServers?: {
+        name: string;
+        transport: string;
+        requiresConfiguration?: boolean;
+        endpoint: string | null;
+    }[] | null;
+    components: string[] | null;
+    installation: string;
+};
+export type PluginDiscoveryPage = {
+    items: PluginDiscoveryItem[];
+    total: number;
+    nextOffset: number | null;
+};

package/dist/plugin-discovery.js

@@ -0,0 +1,7 @@
+import {
+  pluginMcpUnavailableReason
+} from "./chunk-RKX3NQYS.js";
+export {
+  pluginMcpUnavailableReason
+};
+//# sourceMappingURL=plugin-discovery.js.map

package/dist/plugin-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/preference-registry.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export declare const PREFERENCE_REGISTRY_CONTENT_MAX_CHARS = 262144;
-export declare const PREFERENCE_REGISTRY_DESCRIPTOR_DESCRIPTION_MAX_CHARS = 240;
+export declare const PREFERENCE_REGISTRY_DESCRIPTOR_DESCRIPTION_MAX_CHARS = 1024;
 export declare const PREFERENCE_REGISTRY_DESCRIPTOR_MAX_COUNT = 64;
 export declare const PREFERENCE_REGISTRY_DESCRIPTOR_MAX_UTF8_BYTES = 16384;
 export declare const PREFERENCE_REGISTRY_REASON_MAX_CHARS = 4096;
@@ -23,12 +23,14 @@ export declare const PreferenceRegistryStatus: z.ZodEnum<{
 }>;
 export type PreferenceRegistryStatus = z.infer<typeof PreferenceRegistryStatus>;
 export declare const PreferenceRegistryProvenanceSource: z.ZodEnum<{
+    agent: "agent";
     call_transcript: "call_transcript";
     human: "human";
     imported_document: "imported_document";
     knowledge_proposal: "knowledge_proposal";
     meeting_transcript: "meeting_transcript";
     onboarding: "onboarding";
+    portable_skill: "portable_skill";
     slack: "slack";
 }>;
 export type PreferenceRegistryProvenanceSource = z.infer<typeof PreferenceRegistryProvenanceSource>;
@@ -87,12 +89,14 @@ export declare const PreferenceRegistryPrecedence: z.ZodObject<{
 export type PreferenceRegistryPrecedence = z.infer<typeof PreferenceRegistryPrecedence>;
 export declare const PreferenceRegistryProvenance: z.ZodObject<{
     source: z.ZodEnum<{
+        agent: "agent";
         call_transcript: "call_transcript";
         human: "human";
         imported_document: "imported_document";
         knowledge_proposal: "knowledge_proposal";
         meeting_transcript: "meeting_transcript";
         onboarding: "onboarding";
+        portable_skill: "portable_skill";
         slack: "slack";
     }>;
     sourceId: z.ZodNullable<z.ZodString>;
@@ -106,12 +110,14 @@ export declare const PreferenceRegistryProvenance: z.ZodObject<{
 export type PreferenceRegistryProvenance = z.infer<typeof PreferenceRegistryProvenance>;
 export declare const PreferenceRegistryDescriptorProvenance: z.ZodObject<{
     source: z.ZodEnum<{
+        agent: "agent";
         call_transcript: "call_transcript";
         human: "human";
         imported_document: "imported_document";
         knowledge_proposal: "knowledge_proposal";
         meeting_transcript: "meeting_transcript";
         onboarding: "onboarding";
+        portable_skill: "portable_skill";
         slack: "slack";
     }>;
     sourceIdHash: z.ZodNullable<z.ZodString>;
@@ -147,12 +153,14 @@ export declare const PreferenceRegistryRevisionSummary: z.ZodObject<{
     }, z.core.$strip>;
     provenance: z.ZodObject<{
         source: z.ZodEnum<{
+            agent: "agent";
             call_transcript: "call_transcript";
             human: "human";
             imported_document: "imported_document";
             knowledge_proposal: "knowledge_proposal";
             meeting_transcript: "meeting_transcript";
             onboarding: "onboarding";
+            portable_skill: "portable_skill";
             slack: "slack";
         }>;
         sourceId: z.ZodNullable<z.ZodString>;
@@ -216,12 +224,14 @@ export declare const PreferenceRegistryRecord: z.ZodObject<{
         }, z.core.$strip>;
         provenance: z.ZodObject<{
             source: z.ZodEnum<{
+                agent: "agent";
                 call_transcript: "call_transcript";
                 human: "human";
                 imported_document: "imported_document";
                 knowledge_proposal: "knowledge_proposal";
                 meeting_transcript: "meeting_transcript";
                 onboarding: "onboarding";
+                portable_skill: "portable_skill";
                 slack: "slack";
             }>;
             sourceId: z.ZodNullable<z.ZodString>;
@@ -283,6 +293,11 @@ export declare const PreferenceRegistryEvent: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export type PreferenceRegistryEvent = z.infer<typeof PreferenceRegistryEvent>;
+export declare const PreferenceRegistryActivationAuthority: z.ZodEnum<{
+    automatic: "automatic";
+    human_confirmed: "human_confirmed";
+}>;
+export type PreferenceRegistryActivationAuthority = z.infer<typeof PreferenceRegistryActivationAuthority>;
 export declare const PreferenceRegistryDescriptor: z.ZodObject<{
     id: z.ZodString;
     stableKey: z.ZodString;
@@ -313,12 +328,14 @@ export declare const PreferenceRegistryDescriptor: z.ZodObject<{
     }, z.core.$strip>;
     provenance: z.ZodObject<{
         source: z.ZodEnum<{
+            agent: "agent";
             call_transcript: "call_transcript";
             human: "human";
             imported_document: "imported_document";
             knowledge_proposal: "knowledge_proposal";
             meeting_transcript: "meeting_transcript";
             onboarding: "onboarding";
+            portable_skill: "portable_skill";
             slack: "slack";
         }>;
         sourceIdHash: z.ZodNullable<z.ZodString>;
@@ -329,6 +346,10 @@ export declare const PreferenceRegistryDescriptor: z.ZodObject<{
             workspace_managed: "workspace_managed";
         }>;
     }, z.core.$strip>;
+    activationAuthority: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        automatic: "automatic";
+        human_confirmed: "human_confirmed";
+    }>>>;
     expiresAt: z.ZodNullable<z.ZodString>;
     retrievalHandle: z.ZodString;
 }, z.core.$strip>;
@@ -372,12 +393,14 @@ export declare const PreferenceRegistrySnapshot: z.ZodObject<{
         }, z.core.$strip>;
         provenance: z.ZodObject<{
             source: z.ZodEnum<{
+                agent: "agent";
                 call_transcript: "call_transcript";
                 human: "human";
                 imported_document: "imported_document";
                 knowledge_proposal: "knowledge_proposal";
                 meeting_transcript: "meeting_transcript";
                 onboarding: "onboarding";
+                portable_skill: "portable_skill";
                 slack: "slack";
             }>;
             sourceIdHash: z.ZodNullable<z.ZodString>;
@@ -388,6 +411,10 @@ export declare const PreferenceRegistrySnapshot: z.ZodObject<{
                 workspace_managed: "workspace_managed";
             }>;
         }, z.core.$strip>;
+        activationAuthority: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            automatic: "automatic";
+            human_confirmed: "human_confirmed";
+        }>>>;
         expiresAt: z.ZodNullable<z.ZodString>;
         retrievalHandle: z.ZodString;
     }, z.core.$strip>>;
@@ -426,12 +453,14 @@ export declare const PreferenceRegistryFullContent: z.ZodObject<{
         }, z.core.$strip>;
         provenance: z.ZodObject<{
             source: z.ZodEnum<{
+                agent: "agent";
                 call_transcript: "call_transcript";
                 human: "human";
                 imported_document: "imported_document";
                 knowledge_proposal: "knowledge_proposal";
                 meeting_transcript: "meeting_transcript";
                 onboarding: "onboarding";
+                portable_skill: "portable_skill";
                 slack: "slack";
             }>;
             sourceIdHash: z.ZodNullable<z.ZodString>;
@@ -442,6 +471,10 @@ export declare const PreferenceRegistryFullContent: z.ZodObject<{
                 workspace_managed: "workspace_managed";
             }>;
         }, z.core.$strip>;
+        activationAuthority: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            automatic: "automatic";
+            human_confirmed: "human_confirmed";
+        }>>>;
         expiresAt: z.ZodNullable<z.ZodString>;
         retrievalHandle: z.ZodString;
     }, z.core.$strip>;
@@ -468,12 +501,14 @@ export declare const CreatePreferenceRegistryProposalRequest: z.ZodObject<{
         workspace: "workspace";
     }>;
     provenanceSource: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
         call_transcript: "call_transcript";
         human: "human";
         imported_document: "imported_document";
         knowledge_proposal: "knowledge_proposal";
         meeting_transcript: "meeting_transcript";
         onboarding: "onboarding";
+        portable_skill: "portable_skill";
         slack: "slack";
     }>>;
     provenanceSourceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -598,12 +633,14 @@ export declare const PreferenceRegistryListResponse: z.ZodObject<{
             }, z.core.$strip>;
             provenance: z.ZodObject<{
                 source: z.ZodEnum<{
+                    agent: "agent";
                     call_transcript: "call_transcript";
                     human: "human";
                     imported_document: "imported_document";
                     knowledge_proposal: "knowledge_proposal";
                     meeting_transcript: "meeting_transcript";
                     onboarding: "onboarding";
+                    portable_skill: "portable_skill";
                     slack: "slack";
                 }>;
                 sourceId: z.ZodNullable<z.ZodString>;
@@ -674,12 +711,14 @@ export declare const PreferenceRegistryDetailResponse: z.ZodObject<{
             }, z.core.$strip>;
             provenance: z.ZodObject<{
                 source: z.ZodEnum<{
+                    agent: "agent";
                     call_transcript: "call_transcript";
                     human: "human";
                     imported_document: "imported_document";
                     knowledge_proposal: "knowledge_proposal";
                     meeting_transcript: "meeting_transcript";
                     onboarding: "onboarding";
+                    portable_skill: "portable_skill";
                     slack: "slack";
                 }>;
                 sourceId: z.ZodNullable<z.ZodString>;
@@ -724,12 +763,14 @@ export declare const PreferenceRegistryDetailResponse: z.ZodObject<{
         }, z.core.$strip>;
         provenance: z.ZodObject<{
             source: z.ZodEnum<{
+                agent: "agent";
                 call_transcript: "call_transcript";
                 human: "human";
                 imported_document: "imported_document";
                 knowledge_proposal: "knowledge_proposal";
                 meeting_transcript: "meeting_transcript";
                 onboarding: "onboarding";
+                portable_skill: "portable_skill";
                 slack: "slack";
             }>;
             sourceId: z.ZodNullable<z.ZodString>;
@@ -834,12 +875,14 @@ export declare const PreferenceRegistryMutationResponse: z.ZodObject<{
             }, z.core.$strip>;
             provenance: z.ZodObject<{
                 source: z.ZodEnum<{
+                    agent: "agent";
                     call_transcript: "call_transcript";
                     human: "human";
                     imported_document: "imported_document";
                     knowledge_proposal: "knowledge_proposal";
                     meeting_transcript: "meeting_transcript";
                     onboarding: "onboarding";
+                    portable_skill: "portable_skill";
                     slack: "slack";
                 }>;
                 sourceId: z.ZodNullable<z.ZodString>;

package/dist/product-analytics.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+/**
+ * The product surface through which a turn's request entered OpenGeni.
+ *
+ * - `web`: the OpenGeni web app (managed cookie or the local browser context).
+ * - `slack`: a Slack mention, command, DM, shortcut, thread reply, or reaction.
+ * - `api_key`: an API key or configured key, including the SDK and scripts.
+ * - `embedded`: a host that embeds OpenGeni through signed delegation or an
+ *   organization key acting for an external user.
+ * - `scheduled`: a scheduled-task occurrence.
+ * - `agent`: another agent (a child session, an agent message, or Agent Steer).
+ * - `voice`: a realtime voice delegation or its end-of-call handoff.
+ * - `site`: a published workspace Site.
+ * - `automation`: an event-triggered automation run.
+ * - `mcp`: an external MCP client connected through workspace MCP OAuth.
+ * - `system`: OpenGeni's own maintenance work with no human entry.
+ *
+ * Turns that no new request entered (goal continuations, child results,
+ * command results, wait timeouts, compaction) inherit the surface of the
+ * session's latest started turn. Null means no surface was captured: rows
+ * written before capture existed, or machine work in a session that has
+ * never started a turn with one.
+ */
+export declare const SESSION_TURN_SURFACES: readonly ["web", "slack", "api_key", "embedded", "scheduled", "agent", "voice", "site", "automation", "mcp", "system"];
+export declare const SessionTurnSurface: z.ZodEnum<{
+    agent: "agent";
+    api_key: "api_key";
+    automation: "automation";
+    embedded: "embedded";
+    mcp: "mcp";
+    scheduled: "scheduled";
+    site: "site";
+    slack: "slack";
+    system: "system";
+    voice: "voice";
+    web: "web";
+}>;
+export type SessionTurnSurface = z.infer<typeof SessionTurnSurface>;
+/**
+ * Request header the first-party web console sends while its tab is visible
+ * and the person interacted with it in the last few minutes. The API records
+ * server-side presence (`opengeni_active_users`, `user.active`) only for
+ * canonical managed browser sessions carrying this exact value, so an idle open
+ * tab, background polling and stream re-authorization never count as activity.
+ * Analytics only: it never grants or narrows access.
+ */
+export declare const OPENGENI_USER_ACTIVITY_HEADER = "x-opengeni-user-activity";
+export declare const OPENGENI_USER_ACTIVITY_ACTIVE = "active";
+/** Interaction recency, in milliseconds, behind the activity header. */
+export declare const OPENGENI_USER_ACTIVITY_WINDOW_MS: number;
+/** Parse a stored value; anything outside the fixed list is treated as absent. */
+export declare function sessionTurnSurfaceOrNull(value: unknown): SessionTurnSurface | null;
+/**
+ * Model provider families exported for analytics. Reserved OpenGeni provider
+ * ids pass through unchanged; every operator-configured registry provider is
+ * reported as `registry` so a deployment's own naming never leaves it.
+ * `opengeni_private.analytics_model_provider` (migration 0533) mirrors this.
+ */
+export declare const ANALYTICS_MODEL_PROVIDERS: readonly ["openai", "azure", "codex-subscription", "supergrok-subscription", "opengeni-gateway", "workspace-gateway", "organization-gateway", "openrouter", "workspace-openrouter", "organization-openrouter", "registry"];
+export declare const AnalyticsModelProvider: z.ZodEnum<{
+    azure: "azure";
+    "codex-subscription": "codex-subscription";
+    openai: "openai";
+    "opengeni-gateway": "opengeni-gateway";
+    openrouter: "openrouter";
+    "organization-gateway": "organization-gateway";
+    "organization-openrouter": "organization-openrouter";
+    registry: "registry";
+    "supergrok-subscription": "supergrok-subscription";
+    "workspace-gateway": "workspace-gateway";
+    "workspace-openrouter": "workspace-openrouter";
+}>;
+export type AnalyticsModelProvider = z.infer<typeof AnalyticsModelProvider>;
+/** Map an accepted turn's execution-policy provider id to its analytics family. */
+export declare function analyticsModelProvider(providerId: string | null | undefined): AnalyticsModelProvider | null;
+/**
+ * Tool family on a tool-call fact: an OpenGeni first-party tool name,
+ * `integration:<catalog domain>` for a reviewed catalog integration, or
+ * `custom` for any other MCP server (a workspace's own server, a self-hosted
+ * provider, or an unreviewed catalog entry). The domain part is limited to
+ * {@link TOOL_FAMILY_INTEGRATION_DOMAINS}, so a tenant's own host name is
+ * never exported.
+ */
+export declare const ToolFamily: z.ZodString;
+export type ToolFamily = z.infer<typeof ToolFamily>;
+/**
+ * Reviewed integration domains that may appear as `integration:<domain>`:
+ * OpenGeni's native provider domains plus the MCP host of every curated
+ * catalog entry (`data/catalog/curated.json`). A test keeps the curated part
+ * in sync. Any other domain is reported as `custom`.
+ */
+export declare const TOOL_FAMILY_INTEGRATION_DOMAINS: readonly ["github.com", "gitlab.com", "dev.azure.com", "slack.com", "chatgpt.com", "x.com", "reddit.com", "fiken.no", "api.atlassian.com", "googleapis.com", "gmailmcp.googleapis.com", "mcp.slack.com", "api.mobbin.com", "mcp.linear.app", "mcp.asana.com", "mcp.stripe.com", "mcp.figma.com", "mcp.canva.com", "mcp.sentry.dev", "mcp.vercel.com", "bindings.mcp.cloudflare.com", "mcp.paypal.com", "mcp.monday.com", "mcp.airtable.com", "mcp.zapier.com", "mcp.webflow.com", "mcp.supabase.com", "mcp.clickup.com", "mcp.calendly.com", "mcp.box.com", "mcp.dropbox.com", "mcp.amplitude.com", "mcp.posthog.com", "mcp.pagerduty.com", "mcp.apollo.io", "api.ahrefs.com", "mcp.semrush.com", "mcp.frontapp.com", "mcp.otter.ai", "mcp.notion.com", "mcp.hubspot.com", "mcp.atlassian.com", "mcp.intercom.com"];
+/**
+ * Tool family for an MCP server that is not first-party. The first candidate
+ * domain on the reviewed list wins; otherwise the server is `custom`.
+ */
+export declare function integrationToolFamily(candidateDomains: readonly (string | null | undefined)[]): ToolFamily;
+/**
+ * First-party tools the runtime exposes outside any MCP server: base sandbox
+ * and runtime tools, progressive-disclosure routers, media generation, and
+ * provider-hosted tool calls as the event stream names them.
+ */
+export declare const FIRST_PARTY_FUNCTION_TOOL_FAMILY_NAMES: readonly ["exec_command", "write_stdin", "view_image", "apply_patch", "skill_read", "repository_skill_read", "request_human_input", "list_models", "code_search", "tool_search", "tool_list", "tool_invoke", "generate_image", "generate_video", "get_video_generation_capabilities", "computer_screenshot", "web_search_call", "image_generation_call", "code_interpreter_call", "file_search_call", "computer_call", "local_shell_call", "shell_call", "apply_patch_call"];
+/**
+ * First-party tools served by in-process attempt definitions or the dedicated
+ * `files` server rather than the public `opengeni` MCP catalog.
+ */
+export declare const FIRST_PARTY_ATTEMPT_TOOL_FAMILY_NAMES: readonly ["skill_checkout", "skill_publish", "skill_install", "skill_remove", "skill_save", "skill_search", "operation_read", "knowledge_source_fetch", "knowledge_source_read", "files_get_download_url"];
+/**
+ * OpenGeni's in-process integration tools that are not registry MCP servers,
+ * keyed by their catalog server id, with the provider domain they act on.
+ */
+export declare const IN_PROCESS_INTEGRATION_TOOL_FAMILY_DOMAINS: Readonly<Record<string, string>>;