@jrkropp/codex-js 0.1.4 → 0.2.0

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpElicitationTitledEnumItems.d.ts

@@ -0,0 +1,4 @@
+import type { McpElicitationConstOption } from "./McpElicitationConstOption.js";
+export type McpElicitationTitledEnumItems = {
+    anyOf: Array<McpElicitationConstOption>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpElicitationTitledMultiSelectEnumSchema.d.ts

@@ -0,0 +1,11 @@
+import type { McpElicitationArrayType } from "./McpElicitationArrayType.js";
+import type { McpElicitationTitledEnumItems } from "./McpElicitationTitledEnumItems.js";
+export type McpElicitationTitledMultiSelectEnumSchema = {
+    type: McpElicitationArrayType;
+    title?: string;
+    description?: string;
+    minItems?: bigint;
+    maxItems?: bigint;
+    items: McpElicitationTitledEnumItems;
+    default?: Array<string>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpElicitationTitledSingleSelectEnumSchema.d.ts

@@ -0,0 +1,9 @@
+import type { McpElicitationConstOption } from "./McpElicitationConstOption.js";
+import type { McpElicitationStringType } from "./McpElicitationStringType.js";
+export type McpElicitationTitledSingleSelectEnumSchema = {
+    type: McpElicitationStringType;
+    title?: string;
+    description?: string;
+    oneOf: Array<McpElicitationConstOption>;
+    default?: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpElicitationUntitledEnumItems.d.ts

@@ -0,0 +1,5 @@
+import type { McpElicitationStringType } from "./McpElicitationStringType.js";
+export type McpElicitationUntitledEnumItems = {
+    type: McpElicitationStringType;
+    enum: Array<string>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpElicitationUntitledMultiSelectEnumSchema.d.ts

@@ -0,0 +1,11 @@
+import type { McpElicitationArrayType } from "./McpElicitationArrayType.js";
+import type { McpElicitationUntitledEnumItems } from "./McpElicitationUntitledEnumItems.js";
+export type McpElicitationUntitledMultiSelectEnumSchema = {
+    type: McpElicitationArrayType;
+    title?: string;
+    description?: string;
+    minItems?: bigint;
+    maxItems?: bigint;
+    items: McpElicitationUntitledEnumItems;
+    default?: Array<string>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpElicitationUntitledSingleSelectEnumSchema.d.ts

@@ -0,0 +1,8 @@
+import type { McpElicitationStringType } from "./McpElicitationStringType.js";
+export type McpElicitationUntitledSingleSelectEnumSchema = {
+    type: McpElicitationStringType;
+    title?: string;
+    description?: string;
+    enum: Array<string>;
+    default?: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpResourceReadParams.d.ts

@@ -0,0 +1,5 @@
+export type McpResourceReadParams = {
+    threadId?: string | null;
+    server: string;
+    uri: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpResourceReadResponse.d.ts

@@ -0,0 +1,4 @@
+import type { ResourceContent } from "../ResourceContent.js";
+export type McpResourceReadResponse = {
+    contents: Array<ResourceContent>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerElicitationAction.d.ts

@@ -0,0 +1 @@
+export type McpServerElicitationAction = "accept" | "decline" | "cancel";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerElicitationRequestParams.d.ts

@@ -0,0 +1,26 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+import type { McpElicitationSchema } from "./McpElicitationSchema.js";
+export type McpServerElicitationRequestParams = {
+    threadId: string;
+    /**
+     * Active Codex turn when this elicitation was observed, if app-server could correlate one.
+     *
+     * This is nullable because MCP models elicitation as a standalone server-to-client request
+     * identified by the MCP server request id. It may be triggered during a turn, but turn
+     * context is app-server correlation rather than part of the protocol identity of the
+     * elicitation itself.
+     */
+    turnId: string | null;
+    serverName: string;
+} & ({
+    "mode": "form";
+    _meta: JsonValue | null;
+    message: string;
+    requestedSchema: McpElicitationSchema;
+} | {
+    "mode": "url";
+    _meta: JsonValue | null;
+    message: string;
+    url: string;
+    elicitationId: string;
+});

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerElicitationRequestResponse.d.ts

@@ -0,0 +1,15 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+import type { McpServerElicitationAction } from "./McpServerElicitationAction.js";
+export type McpServerElicitationRequestResponse = {
+    action: McpServerElicitationAction;
+    /**
+     * Structured user input for accepted elicitations, mirroring RMCP `CreateElicitationResult`.
+     *
+     * This is nullable because decline/cancel responses have no content.
+     */
+    content: JsonValue | null;
+    /**
+     * Optional client metadata for form-mode action handling.
+     */
+    _meta: JsonValue | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerMigration.d.ts

@@ -0,0 +1,3 @@
+export type McpServerMigration = {
+    name: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerOauthLoginCompletedNotification.d.ts

@@ -0,0 +1,5 @@
+export type McpServerOauthLoginCompletedNotification = {
+    name: string;
+    success: boolean;
+    error?: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerOauthLoginParams.d.ts

@@ -0,0 +1,5 @@
+export type McpServerOauthLoginParams = {
+    name: string;
+    scopes?: Array<string> | null;
+    timeoutSecs?: bigint | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerOauthLoginResponse.d.ts

@@ -0,0 +1,3 @@
+export type McpServerOauthLoginResponse = {
+    authorizationUrl: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerRefreshResponse.d.ts

@@ -0,0 +1 @@
+export type McpServerRefreshResponse = Record<string, never>;

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerStartupState.d.ts

@@ -0,0 +1 @@
+export type McpServerStartupState = "starting" | "ready" | "failed" | "cancelled";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerStatus.d.ts

@@ -0,0 +1,13 @@
+import type { Resource } from "../Resource.js";
+import type { ResourceTemplate } from "../ResourceTemplate.js";
+import type { Tool } from "../Tool.js";
+import type { McpAuthStatus } from "./McpAuthStatus.js";
+export type McpServerStatus = {
+    name: string;
+    tools: {
+        [key in string]?: Tool;
+    };
+    resources: Array<Resource>;
+    resourceTemplates: Array<ResourceTemplate>;
+    authStatus: McpAuthStatus;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerStatusDetail.d.ts

@@ -0,0 +1 @@
+export type McpServerStatusDetail = "full" | "toolsAndAuthOnly";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerStatusUpdatedNotification.d.ts

@@ -0,0 +1,6 @@
+import type { McpServerStartupState } from "./McpServerStartupState.js";
+export type McpServerStatusUpdatedNotification = {
+    name: string;
+    status: McpServerStartupState;
+    error: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerToolCallParams.d.ts

@@ -0,0 +1,8 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+export type McpServerToolCallParams = {
+    threadId: string;
+    server: string;
+    tool: string;
+    arguments?: JsonValue;
+    _meta?: JsonValue;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpServerToolCallResponse.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+export type McpServerToolCallResponse = {
+    content: Array<JsonValue>;
+    structuredContent?: JsonValue;
+    isError?: boolean;
+    _meta?: JsonValue;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpToolCallError.d.ts

@@ -0,0 +1,3 @@
+export type McpToolCallError = {
+    message: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpToolCallProgressNotification.d.ts

@@ -0,0 +1,6 @@
+export type McpToolCallProgressNotification = {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    message: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpToolCallResult.d.ts

@@ -0,0 +1,6 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+export type McpToolCallResult = {
+    content: Array<JsonValue>;
+    structuredContent: JsonValue | null;
+    _meta: JsonValue | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/McpToolCallStatus.d.ts

@@ -0,0 +1 @@
+export type McpToolCallStatus = "inProgress" | "completed" | "failed";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/MemoryCitation.d.ts

@@ -0,0 +1,5 @@
+import type { MemoryCitationEntry } from "./MemoryCitationEntry.js";
+export type MemoryCitation = {
+    entries: Array<MemoryCitationEntry>;
+    threadIds: Array<string>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/MemoryCitationEntry.d.ts

@@ -0,0 +1,6 @@
+export type MemoryCitationEntry = {
+    path: string;
+    lineStart: number;
+    lineEnd: number;
+    note: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/MergeStrategy.d.ts

@@ -0,0 +1 @@
+export type MergeStrategy = "replace" | "upsert";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/MigrationDetails.d.ts

@@ -0,0 +1,14 @@
+import type { CommandMigration } from "./CommandMigration.js";
+import type { HookMigration } from "./HookMigration.js";
+import type { McpServerMigration } from "./McpServerMigration.js";
+import type { PluginsMigration } from "./PluginsMigration.js";
+import type { SessionMigration } from "./SessionMigration.js";
+import type { SubagentMigration } from "./SubagentMigration.js";
+export type MigrationDetails = {
+    plugins: Array<PluginsMigration>;
+    sessions: Array<SessionMigration>;
+    mcpServers: Array<McpServerMigration>;
+    hooks: Array<HookMigration>;
+    subagents: Array<SubagentMigration>;
+    commands: Array<CommandMigration>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/Model.d.ts

@@ -0,0 +1,26 @@
+import type { InputModality } from "../InputModality.js";
+import type { ReasoningEffort } from "../ReasoningEffort.js";
+import type { ModelAvailabilityNux } from "./ModelAvailabilityNux.js";
+import type { ModelServiceTier } from "./ModelServiceTier.js";
+import type { ModelUpgradeInfo } from "./ModelUpgradeInfo.js";
+import type { ReasoningEffortOption } from "./ReasoningEffortOption.js";
+export type Model = {
+    id: string;
+    model: string;
+    upgrade: string | null;
+    upgradeInfo: ModelUpgradeInfo | null;
+    availabilityNux: ModelAvailabilityNux | null;
+    displayName: string;
+    description: string;
+    hidden: boolean;
+    supportedReasoningEfforts: Array<ReasoningEffortOption>;
+    defaultReasoningEffort: ReasoningEffort;
+    inputModalities: Array<InputModality>;
+    supportsPersonality: boolean;
+    /**
+     * Deprecated: use `serviceTiers` instead.
+     */
+    additionalSpeedTiers: Array<string>;
+    serviceTiers: Array<ModelServiceTier>;
+    isDefault: boolean;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelAvailabilityNux.d.ts

@@ -0,0 +1,3 @@
+export type ModelAvailabilityNux = {
+    message: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelListParams.d.ts

@@ -0,0 +1,14 @@
+export type ModelListParams = {
+    /**
+     * Opaque pagination cursor returned by a previous call.
+     */
+    cursor?: string | null;
+    /**
+     * Optional page size; defaults to a reasonable server-side value.
+     */
+    limit?: number | null;
+    /**
+     * When true, include models that are hidden from the default picker list.
+     */
+    includeHidden?: boolean | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelListResponse.d.ts

@@ -0,0 +1,9 @@
+import type { Model } from "./Model.js";
+export type ModelListResponse = {
+    data: Array<Model>;
+    /**
+     * Opaque cursor to pass to the next call to continue after the last item.
+     * If None, there are no more items to return.
+     */
+    nextCursor: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelProviderCapabilitiesReadParams.d.ts

@@ -0,0 +1 @@
+export type ModelProviderCapabilitiesReadParams = Record<string, never>;

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelProviderCapabilitiesReadResponse.d.ts

@@ -0,0 +1,5 @@
+export type ModelProviderCapabilitiesReadResponse = {
+    namespaceTools: boolean;
+    imageGeneration: boolean;
+    webSearch: boolean;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelRerouteReason.d.ts

@@ -0,0 +1 @@
+export type ModelRerouteReason = "highRiskCyberActivity";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelReroutedNotification.d.ts

@@ -0,0 +1,8 @@
+import type { ModelRerouteReason } from "./ModelRerouteReason.js";
+export type ModelReroutedNotification = {
+    threadId: string;
+    turnId: string;
+    fromModel: string;
+    toModel: string;
+    reason: ModelRerouteReason;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelServiceTier.d.ts

@@ -0,0 +1,5 @@
+export type ModelServiceTier = {
+    id: string;
+    name: string;
+    description: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelUpgradeInfo.d.ts

@@ -0,0 +1,6 @@
+export type ModelUpgradeInfo = {
+    model: string;
+    upgradeCopy: string | null;
+    modelLink: string | null;
+    migrationMarkdown: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelVerification.d.ts

@@ -0,0 +1 @@
+export type ModelVerification = "trustedAccessForCyber";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ModelVerificationNotification.d.ts

@@ -0,0 +1,6 @@
+import type { ModelVerification } from "./ModelVerification.js";
+export type ModelVerificationNotification = {
+    threadId: string;
+    turnId: string;
+    verifications: Array<ModelVerification>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkAccess.d.ts

@@ -0,0 +1 @@
+export type NetworkAccess = "restricted" | "enabled";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkApprovalContext.d.ts

@@ -0,0 +1,5 @@
+import type { NetworkApprovalProtocol } from "./NetworkApprovalProtocol.js";
+export type NetworkApprovalContext = {
+    host: string;
+    protocol: NetworkApprovalProtocol;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkApprovalProtocol.d.ts

@@ -0,0 +1 @@
+export type NetworkApprovalProtocol = "http" | "https" | "socks5Tcp" | "socks5Udp";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkDomainPermission.d.ts

@@ -0,0 +1 @@
+export type NetworkDomainPermission = "allow" | "deny";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkPolicyAmendment.d.ts

@@ -0,0 +1,5 @@
+import type { NetworkPolicyRuleAction } from "./NetworkPolicyRuleAction.js";
+export type NetworkPolicyAmendment = {
+    host: string;
+    action: NetworkPolicyRuleAction;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkPolicyRuleAction.d.ts

@@ -0,0 +1 @@
+export type NetworkPolicyRuleAction = "allow" | "deny";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkRequirements.d.ts

@@ -0,0 +1,40 @@
+import type { NetworkDomainPermission } from "./NetworkDomainPermission.js";
+import type { NetworkUnixSocketPermission } from "./NetworkUnixSocketPermission.js";
+export type NetworkRequirements = {
+    enabled: boolean | null;
+    httpPort: number | null;
+    socksPort: number | null;
+    allowUpstreamProxy: boolean | null;
+    dangerouslyAllowNonLoopbackProxy: boolean | null;
+    dangerouslyAllowAllUnixSockets: boolean | null;
+    /**
+     * Canonical network permission map for `experimental_network`.
+     */
+    domains: {
+        [key in string]?: NetworkDomainPermission;
+    } | null;
+    /**
+     * When true, only managed allowlist entries are respected while managed
+     * network enforcement is active.
+     */
+    managedAllowedDomainsOnly: boolean | null;
+    /**
+     * Legacy compatibility view derived from `domains`.
+     */
+    allowedDomains: Array<string> | null;
+    /**
+     * Legacy compatibility view derived from `domains`.
+     */
+    deniedDomains: Array<string> | null;
+    /**
+     * Canonical unix socket permission map for `experimental_network`.
+     */
+    unixSockets: {
+        [key in string]?: NetworkUnixSocketPermission;
+    } | null;
+    /**
+     * Legacy compatibility view derived from `unix_sockets`.
+     */
+    allowUnixSockets: Array<string> | null;
+    allowLocalBinding: boolean | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NetworkUnixSocketPermission.d.ts

@@ -0,0 +1 @@
+export type NetworkUnixSocketPermission = "allow" | "none";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/NonSteerableTurnKind.d.ts

@@ -0,0 +1 @@
+export type NonSteerableTurnKind = "review" | "compact";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/OverriddenMetadata.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+import type { ConfigLayerMetadata } from "./ConfigLayerMetadata.js";
+export type OverriddenMetadata = {
+    message: string;
+    overridingLayer: ConfigLayerMetadata;
+    effectiveValue: JsonValue;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PatchApplyStatus.d.ts

@@ -0,0 +1 @@
+export type PatchApplyStatus = "inProgress" | "completed" | "failed" | "declined";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PatchChangeKind.d.ts

@@ -0,0 +1,8 @@
+export type PatchChangeKind = {
+    "type": "add";
+} | {
+    "type": "delete";
+} | {
+    "type": "update";
+    move_path: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionGrantScope.d.ts

@@ -0,0 +1 @@
+export type PermissionGrantScope = "turn" | "session";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionProfile.d.ts

@@ -0,0 +1,12 @@
+import type { PermissionProfileFileSystemPermissions } from "./PermissionProfileFileSystemPermissions.js";
+import type { PermissionProfileNetworkPermissions } from "./PermissionProfileNetworkPermissions.js";
+export type PermissionProfile = {
+    "type": "managed";
+    network: PermissionProfileNetworkPermissions;
+    fileSystem: PermissionProfileFileSystemPermissions;
+} | {
+    "type": "disabled";
+} | {
+    "type": "external";
+    network: PermissionProfileNetworkPermissions;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionProfileFileSystemPermissions.d.ts

@@ -0,0 +1,8 @@
+import type { FileSystemSandboxEntry } from "./FileSystemSandboxEntry.js";
+export type PermissionProfileFileSystemPermissions = {
+    "type": "restricted";
+    entries: Array<FileSystemSandboxEntry>;
+    globScanMaxDepth?: number;
+} | {
+    "type": "unrestricted";
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionProfileModificationParams.d.ts

@@ -0,0 +1,5 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+export type PermissionProfileModificationParams = {
+    "type": "additionalWritableRoot";
+    path: AbsolutePathBuf;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionProfileNetworkPermissions.d.ts

@@ -0,0 +1,3 @@
+export type PermissionProfileNetworkPermissions = {
+    enabled: boolean;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionProfileSelectionParams.d.ts

@@ -0,0 +1,6 @@
+import type { PermissionProfileModificationParams } from "./PermissionProfileModificationParams.js";
+export type PermissionProfileSelectionParams = {
+    "type": "profile";
+    id: string;
+    modifications?: Array<PermissionProfileModificationParams> | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionsRequestApprovalParams.d.ts

@@ -0,0 +1,10 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+import type { RequestPermissionProfile } from "./RequestPermissionProfile.js";
+export type PermissionsRequestApprovalParams = {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    cwd: AbsolutePathBuf;
+    reason: string | null;
+    permissions: RequestPermissionProfile;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PermissionsRequestApprovalResponse.d.ts

@@ -0,0 +1,10 @@
+import type { GrantedPermissionProfile } from "./GrantedPermissionProfile.js";
+import type { PermissionGrantScope } from "./PermissionGrantScope.js";
+export type PermissionsRequestApprovalResponse = {
+    permissions: GrantedPermissionProfile;
+    scope: PermissionGrantScope;
+    /**
+     * Review every subsequent command in this turn before normal sandboxed execution.
+     */
+    strictAutoReview?: boolean;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PlanDeltaNotification.d.ts

@@ -0,0 +1,10 @@
+/**
+ * EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should
+ * not assume concatenated deltas match the completed plan item content.
+ */
+export type PlanDeltaNotification = {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    delta: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginAuthPolicy.d.ts

@@ -0,0 +1 @@
+export type PluginAuthPolicy = "ON_INSTALL" | "ON_USE";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginAvailability.d.ts

@@ -0,0 +1 @@
+export type PluginAvailability = "AVAILABLE" | "DISABLED_BY_ADMIN";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginDetail.d.ts

@@ -0,0 +1,13 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+import type { AppSummary } from "./AppSummary.js";
+import type { PluginSummary } from "./PluginSummary.js";
+import type { SkillSummary } from "./SkillSummary.js";
+export type PluginDetail = {
+    marketplaceName: string;
+    marketplacePath: AbsolutePathBuf | null;
+    summary: PluginSummary;
+    description: string | null;
+    skills: Array<SkillSummary>;
+    apps: Array<AppSummary>;
+    mcpServers: Array<string>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginInstallParams.d.ts

@@ -0,0 +1,6 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+export type PluginInstallParams = {
+    marketplacePath?: AbsolutePathBuf | null;
+    remoteMarketplaceName?: string | null;
+    pluginName: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginInstallPolicy.d.ts

@@ -0,0 +1 @@
+export type PluginInstallPolicy = "NOT_AVAILABLE" | "AVAILABLE" | "INSTALLED_BY_DEFAULT";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginInstallResponse.d.ts

@@ -0,0 +1,6 @@
+import type { AppSummary } from "./AppSummary.js";
+import type { PluginAuthPolicy } from "./PluginAuthPolicy.js";
+export type PluginInstallResponse = {
+    authPolicy: PluginAuthPolicy;
+    appsNeedingAuth: Array<AppSummary>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/PluginInterface.d.ts

@@ -0,0 +1,42 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+export type PluginInterface = {
+    displayName: string | null;
+    shortDescription: string | null;
+    longDescription: string | null;
+    developerName: string | null;
+    category: string | null;
+    capabilities: Array<string>;
+    websiteUrl: string | null;
+    privacyPolicyUrl: string | null;
+    termsOfServiceUrl: string | null;
+    /**
+     * Starter prompts for the plugin. Capped at 3 entries with a maximum of
+     * 128 characters per entry.
+     */
+    defaultPrompt: Array<string> | null;
+    brandColor: string | null;
+    /**
+     * Local composer icon path, resolved from the installed plugin package.
+     */
+    composerIcon: AbsolutePathBuf | null;
+    /**
+     * Remote composer icon URL from the plugin catalog.
+     */
+    composerIconUrl: string | null;
+    /**
+     * Local logo path, resolved from the installed plugin package.
+     */
+    logo: AbsolutePathBuf | null;
+    /**
+     * Remote logo URL from the plugin catalog.
+     */
+    logoUrl: string | null;
+    /**
+     * Local screenshot paths, resolved from the installed plugin package.
+     */
+    screenshots: Array<AbsolutePathBuf>;
+    /**
+     * Remote screenshot URLs from the plugin catalog.
+     */
+    screenshotUrls: Array<string>;
+};