codex-toys 0.140.13 → 0.140.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -50
- package/dist/cli/actions.d.ts +1 -1
- package/dist/cli/actions.d.ts.map +1 -1
- package/dist/cli/actions.js +0 -8
- package/dist/cli/actions.js.map +1 -1
- package/dist/cli/args.d.ts +11 -28
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +59 -97
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/help.d.ts.map +1 -1
- package/dist/cli/help.js +52 -61
- package/dist/cli/help.js.map +1 -1
- package/dist/cli/index.js +61 -67
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/mcp.d.ts.map +1 -1
- package/dist/cli/mcp.js +27 -85
- package/dist/cli/mcp.js.map +1 -1
- package/dist/cli/toybox.d.ts +1 -1
- package/dist/cli/toybox.d.ts.map +1 -1
- package/dist/cli/toybox.js +18 -23
- package/dist/cli/toybox.js.map +1 -1
- package/dist/index.d.ts +1 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -3
- package/dist/index.js.map +1 -1
- package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.js +3 -0
- package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.js +3 -0
- package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/AuthMode.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/AuthMode.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/ClientRequest.d.ts +61 -2
- package/dist/internal/bridge/app-server/generated/ClientRequest.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/ConversationTextRole.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/ConversationTextRole.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/ConversationTextRole.js +3 -0
- package/dist/internal/bridge/app-server/generated/ConversationTextRole.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/InitializeCapabilities.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/InitializeCapabilities.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.d.ts +10 -0
- package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.js +3 -0
- package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/LegacyAppPathString.d.ts +23 -0
- package/dist/internal/bridge/app-server/generated/LegacyAppPathString.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/LegacyAppPathString.js +3 -0
- package/dist/internal/bridge/app-server/generated/LegacyAppPathString.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/MultiAgentMode.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/MultiAgentMode.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/MultiAgentMode.js +3 -0
- package/dist/internal/bridge/app-server/generated/MultiAgentMode.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/ReasoningEffort.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/ReasoningEffort.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/ResponseItem.d.ts +38 -1
- package/dist/internal/bridge/app-server/generated/ResponseItem.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/ServerNotification.d.ts +16 -0
- package/dist/internal/bridge/app-server/generated/ServerNotification.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/ServerRequest.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/ServerRequest.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/WebSearchMode.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/WebSearchMode.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/index.d.ts +6 -0
- package/dist/internal/bridge/app-server/generated/index.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/index.js.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/Account.d.ts +3 -1
- package/dist/internal/bridge/app-server/generated/v2/Account.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/AccountRateLimitsUpdatedNotification.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountRateLimitsUpdatedNotification.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AdditionalFileSystemPermissions.d.ts +3 -3
- package/dist/internal/bridge/app-server/generated/v2/AdditionalFileSystemPermissions.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/AppSummary.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/v2/AppSummary.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.d.ts +13 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/AppsConfig.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/AppsConfig.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/AppsDefaultConfig.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/AppsDefaultConfig.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.d.ts +9 -0
- package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/CommandExecutionRequestApprovalParams.d.ts +6 -2
- package/dist/internal/bridge/app-server/generated/v2/CommandExecutionRequestApprovalParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ConfigLayerSource.d.ts +12 -0
- package/dist/internal/bridge/app-server/generated/v2/ConfigLayerSource.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ConfigRequirements.d.ts +5 -1
- package/dist/internal/bridge/app-server/generated/v2/ConfigRequirements.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolSpec.d.ts +6 -7
- package/dist/internal/bridge/app-server/generated/v2/DynamicToolSpec.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/EnvironmentAddParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/EnvironmentAddParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigDetectParams.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportCompletedNotification.d.ts +5 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportCompletedNotification.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.d.ts +9 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.d.ts +10 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.d.ts +6 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportResponse.d.ts +3 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportResponse.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.d.ts +9 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/FileSystemPath.d.ts +2 -2
- package/dist/internal/bridge/app-server/generated/v2/FileSystemPath.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/GetAccountRateLimitsResponse.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/GetAccountRateLimitsResponse.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.d.ts +12 -0
- package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/HookSource.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/v2/HookSource.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/McpServerElicitationRequestParams.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/McpServerElicitationRequestParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/McpServerStatusUpdatedNotification.d.ts +1 -0
- package/dist/internal/bridge/app-server/generated/v2/McpServerStatusUpdatedNotification.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.d.ts +6 -0
- package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.d.ts +10 -0
- package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/PermissionProfileSummary.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/PermissionProfileSummary.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/PermissionsRequestApprovalParams.d.ts +1 -0
- package/dist/internal/bridge/app-server/generated/v2/PermissionsRequestApprovalParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/PluginDetail.d.ts +3 -0
- package/dist/internal/bridge/app-server/generated/v2/PluginDetail.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/PluginInterface.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/PluginInterface.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/PluginListMarketplaceKind.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/v2/PluginListMarketplaceKind.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RateLimitSnapshot.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/RateLimitSnapshot.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.d.ts +11 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.d.ts +6 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.d.ts +15 -0
- package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/Thread.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/Thread.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.d.ts +11 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.d.ts +12 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.d.ts +10 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadForkParams.d.ts +3 -9
- package/dist/internal/bridge/app-server/generated/v2/ThreadForkParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadForkResponse.d.ts +8 -2
- package/dist/internal/bridge/app-server/generated/v2/ThreadForkResponse.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadItem.d.ts +18 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadItem.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadListParams.d.ts +4 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadListParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.d.ts +8 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendTextParams.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendTextParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeStartParams.d.ts +32 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeStartParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadResumeParams.d.ts +3 -9
- package/dist/internal/bridge/app-server/generated/v2/ThreadResumeParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadResumeResponse.d.ts +8 -2
- package/dist/internal/bridge/app-server/generated/v2/ThreadResumeResponse.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadSettings.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadSettings.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadSettingsUpdateParams.d.ts +5 -0
- package/dist/internal/bridge/app-server/generated/v2/ThreadSettingsUpdateParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadSortKey.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadSortKey.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadSource.d.ts +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadSource.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadStartParams.d.ts +13 -9
- package/dist/internal/bridge/app-server/generated/v2/ThreadStartParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ThreadStartResponse.d.ts +8 -2
- package/dist/internal/bridge/app-server/generated/v2/ThreadStartResponse.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/ToolRequestUserInputParams.d.ts +1 -0
- package/dist/internal/bridge/app-server/generated/v2/ToolRequestUserInputParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/TurnEnvironmentParams.d.ts +2 -2
- package/dist/internal/bridge/app-server/generated/v2/TurnEnvironmentParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.d.ts +7 -0
- package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/TurnStartParams.d.ts +16 -5
- package/dist/internal/bridge/app-server/generated/v2/TurnStartParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/TurnSteerParams.d.ts +7 -1
- package/dist/internal/bridge/app-server/generated/v2/TurnSteerParams.d.ts.map +1 -1
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.d.ts +15 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.d.ts +2 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.d.ts.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.js +3 -0
- package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.js.map +1 -0
- package/dist/internal/bridge/app-server/generated/v2/index.d.ts +52 -0
- package/dist/internal/bridge/app-server/generated/v2/index.d.ts.map +1 -1
- package/dist/internal/bridge/index.d.ts +1 -1
- package/dist/internal/bridge/index.d.ts.map +1 -1
- package/dist/internal/bridge/index.js +1 -1
- package/dist/internal/bridge/index.js.map +1 -1
- package/dist/internal/bridge/threads.d.ts +2 -0
- package/dist/internal/bridge/threads.d.ts.map +1 -1
- package/dist/internal/bridge/threads.js +6 -0
- package/dist/internal/bridge/threads.js.map +1 -1
- package/dist/internal/package.json +1 -1
- package/dist/internal/proxy/proxy.js +6 -6
- package/dist/internal/proxy/proxy.js.map +1 -1
- package/dist/internal/remote/remote-control.d.ts +2 -1
- package/dist/internal/remote/remote-control.d.ts.map +1 -1
- package/dist/internal/remote/remote-control.js +19 -17
- package/dist/internal/remote/remote-control.js.map +1 -1
- package/dist/internal/remote/remote-preflight.js +4 -4
- package/dist/internal/remote/remote-preflight.js.map +1 -1
- package/dist/internal/remote/remote-provider.d.ts.map +1 -1
- package/dist/internal/remote/remote-provider.js +9 -8
- package/dist/internal/remote/remote-provider.js.map +1 -1
- package/dist/internal/toybox/protocol.d.ts +1 -1
- package/dist/internal/toybox/protocol.d.ts.map +1 -1
- package/dist/internal/toybox/protocol.js +0 -1
- package/dist/internal/toybox/protocol.js.map +1 -1
- package/dist/internal/workbench/fetch.d.ts +5 -6
- package/dist/internal/workbench/fetch.d.ts.map +1 -1
- package/dist/internal/workbench/fetch.js +22 -23
- package/dist/internal/workbench/fetch.js.map +1 -1
- package/dist/internal/workbench/host-overview.d.ts +2 -2
- package/dist/internal/workbench/host-overview.d.ts.map +1 -1
- package/dist/internal/workbench/host-overview.js +1 -1
- package/dist/internal/workbench/host-overview.js.map +1 -1
- package/dist/internal/workbench/index.d.ts +0 -3
- package/dist/internal/workbench/index.d.ts.map +1 -1
- package/dist/internal/workbench/index.js +0 -3
- package/dist/internal/workbench/index.js.map +1 -1
- package/dist/internal/workbench/workbench-overview.d.ts +7 -7
- package/dist/internal/workbench/workbench-overview.d.ts.map +1 -1
- package/dist/internal/workbench/workbench-overview.js +16 -16
- package/dist/internal/workbench/workbench-overview.js.map +1 -1
- package/dist/internal/workbench/workflow-module-runner.js +0 -7
- package/dist/internal/workbench/workflow-module-runner.js.map +1 -1
- package/dist/internal/workbench/workflow.d.ts +1 -45
- package/dist/internal/workbench/workflow.d.ts.map +1 -1
- package/dist/internal/workbench/workflow.js +5 -117
- package/dist/internal/workbench/workflow.js.map +1 -1
- package/dist/runtime.d.ts +11 -0
- package/dist/runtime.d.ts.map +1 -0
- package/dist/runtime.js +6 -0
- package/dist/runtime.js.map +1 -0
- package/docs/pages/components/cli.md +23 -29
- package/docs/pages/components/runtime.md +112 -0
- package/docs/pages/guides/dashboard-over-runtime.md +87 -0
- package/docs/pages/guides/remote-runtime.md +109 -0
- package/docs/pages/index.md +33 -35
- package/docs/pages/operations/plugins.md +7 -7
- package/docs/pages/primitives/dispatch-queues.md +4 -4
- package/docs/pages/primitives/feed.md +3 -3
- package/docs/pages/primitives/workbench.md +3 -2
- package/docs/pages/primitives/workflow.md +19 -18
- package/docs/pages/reference/packages.md +18 -25
- package/package.json +6 -23
- package/dist/internal/proxy/bin/codex-toys-proxy.js +0 -837
- package/dist/internal/workbench/delegation-methods.d.ts +0 -40
- package/dist/internal/workbench/delegation-methods.d.ts.map +0 -1
- package/dist/internal/workbench/delegation-methods.js +0 -473
- package/dist/internal/workbench/delegation-methods.js.map +0 -1
- package/dist/internal/workbench/delegation.d.ts +0 -128
- package/dist/internal/workbench/delegation.d.ts.map +0 -1
- package/dist/internal/workbench/delegation.js +0 -345
- package/dist/internal/workbench/delegation.js.map +0 -1
- package/dist/internal/workbench/workbench-delegation.d.ts +0 -45
- package/dist/internal/workbench/workbench-delegation.d.ts.map +0 -1
- package/dist/internal/workbench/workbench-delegation.js +0 -100
- package/dist/internal/workbench/workbench-delegation.js.map +0 -1
- package/dist/proxy/browser.d.ts +0 -2
- package/dist/proxy/browser.d.ts.map +0 -1
- package/dist/proxy/browser.js +0 -2
- package/dist/proxy/browser.js.map +0 -1
- package/dist/proxy/index.d.ts +0 -2
- package/dist/proxy/index.d.ts.map +0 -1
- package/dist/proxy/index.js +0 -2
- package/dist/proxy/index.js.map +0 -1
- package/dist/proxy/vite.d.ts +0 -2
- package/dist/proxy/vite.d.ts.map +0 -1
- package/dist/proxy/vite.js +0 -2
- package/dist/proxy/vite.js.map +0 -1
- package/dist/remote.d.ts +0 -2
- package/dist/remote.d.ts.map +0 -1
- package/dist/remote.js +0 -2
- package/dist/remote.js.map +0 -1
- package/dist/toybox.d.ts +0 -2
- package/dist/toybox.d.ts.map +0 -1
- package/dist/toybox.js +0 -2
- package/dist/toybox.js.map +0 -1
- package/docs/pages/components/proxy.md +0 -62
- package/docs/pages/components/toybox.md +0 -108
- package/docs/pages/guides/dashboard-over-toybox.md +0 -145
- package/docs/pages/guides/delegated-repo-work.md +0 -119
- package/docs/pages/guides/remote-codex-workbench.md +0 -147
- package/docs/pages/primitives/delegation.md +0 -74
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Dashboard Over Runtime
|
|
3
|
+
description: Build a browser dashboard backed by the codex-toys runtime HTTP edge and workspace functions.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Dashboard Over Runtime
|
|
7
|
+
|
|
8
|
+
A dashboard over runtime is a browser UI that talks to `codex-toys runtime http`.
|
|
9
|
+
The HTTP edge forwards generic app, workbench, and function calls to the same
|
|
10
|
+
runtime used by CLI and SSH operation. It does not create a separate durable
|
|
11
|
+
dashboard surface or custom thread registry.
|
|
12
|
+
|
|
13
|
+
## Serve Static Files
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
codex-toys runtime http --cwd . --static ./dashboard
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
The dashboard can call same-origin `/api/*` routes:
|
|
20
|
+
|
|
21
|
+
```text
|
|
22
|
+
GET /api/status
|
|
23
|
+
GET /api/schema
|
|
24
|
+
POST /api/rpc
|
|
25
|
+
POST /api/app/:method
|
|
26
|
+
POST /api/workbench/:method
|
|
27
|
+
POST /api/workbench/overview
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Browser Client
|
|
31
|
+
|
|
32
|
+
```ts
|
|
33
|
+
import { createCodexToysBrowserClient } from "codex-toys/runtime";
|
|
34
|
+
|
|
35
|
+
const codexToys = createCodexToysBrowserClient();
|
|
36
|
+
const overview = await codexToys.workbench.call("workbench.overview", {});
|
|
37
|
+
const threads = await codexToys.app.call("thread/list", {
|
|
38
|
+
limit: 20,
|
|
39
|
+
sourceKinds: [],
|
|
40
|
+
});
|
|
41
|
+
const functions = await codexToys.functions.list();
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Prefer workspace functions for product-specific data. They keep dashboard
|
|
45
|
+
semantics in the workspace instead of baking product routes into codex-toys.
|
|
46
|
+
|
|
47
|
+
## Vite Middleware
|
|
48
|
+
|
|
49
|
+
```ts
|
|
50
|
+
import { codexToysRuntime } from "codex-toys/runtime";
|
|
51
|
+
|
|
52
|
+
export default {
|
|
53
|
+
plugins: [
|
|
54
|
+
codexToysRuntime({
|
|
55
|
+
cwd: ".",
|
|
56
|
+
}),
|
|
57
|
+
],
|
|
58
|
+
};
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
The Vite plugin serves the runtime API under `/__codex_toys/api`. Point the
|
|
62
|
+
browser client at that base path:
|
|
63
|
+
|
|
64
|
+
```ts
|
|
65
|
+
const codexToys = createCodexToysBrowserClient({
|
|
66
|
+
basePath: "/__codex_toys/api",
|
|
67
|
+
});
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Remote Runtime Without Remote HTTP
|
|
71
|
+
|
|
72
|
+
Run the HTTP edge locally and connect it to a remote runtime over SSH:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
codex-toys runtime http \
|
|
76
|
+
--ssh workbox \
|
|
77
|
+
--cwd /srv/codex/workspaces/ops \
|
|
78
|
+
--static ./dashboard
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
The browser talks to localhost. The remote host exposes no HTTP port.
|
|
82
|
+
|
|
83
|
+
## Boundary
|
|
84
|
+
|
|
85
|
+
The runtime HTTP edge owns transport, schema discovery, browser helpers, and
|
|
86
|
+
forwarding. The workspace owns dashboard data through functions. Native Codex
|
|
87
|
+
owns thread creation, thread opening, archive/delete, and app UI updates.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Remote Runtime
|
|
3
|
+
description: Operate a Codex workspace on an SSH host through codex-toys runtime stdio.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Remote Runtime
|
|
7
|
+
|
|
8
|
+
A remote runtime is a Codex environment on a VPS or SSH host that is controlled
|
|
9
|
+
from local commands. The remote machine owns Codex auth, config, sessions,
|
|
10
|
+
memories, and workspace state. The local machine starts a short-lived
|
|
11
|
+
`codex-toys runtime serve` process over SSH stdio for each command.
|
|
12
|
+
|
|
13
|
+
## Prepare The Host
|
|
14
|
+
|
|
15
|
+
Install these on the remote host:
|
|
16
|
+
|
|
17
|
+
- Node 24
|
|
18
|
+
- Codex CLI
|
|
19
|
+
- `codex-toys`
|
|
20
|
+
- a working shell for non-interactive SSH
|
|
21
|
+
|
|
22
|
+
Authenticate Codex on the remote host. Commands sent through `--ssh` use the
|
|
23
|
+
remote Codex home and remote config; they do not use local Codex auth.
|
|
24
|
+
|
|
25
|
+
## Check Connectivity
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
codex-toys --ssh <host-or-alias> --cwd /srv/codex/workspaces/ops runtime preflight --json
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Preflight checks SSH, cwd, Node, Codex, codex-toys, runtime startup, and native
|
|
32
|
+
app-server initialization.
|
|
33
|
+
|
|
34
|
+
## Configure PATH
|
|
35
|
+
|
|
36
|
+
Non-interactive SSH shells often have a smaller PATH than login shells. Use
|
|
37
|
+
explicit command paths or prepend entries:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
codex-toys --ssh workbox \
|
|
41
|
+
--cwd /srv/codex/workspaces/ops \
|
|
42
|
+
--remote-path-prepend /opt/node/bin:/usr/local/bin \
|
|
43
|
+
--runtime-command /usr/local/bin/codex-toys \
|
|
44
|
+
--codex-command /usr/local/bin/codex \
|
|
45
|
+
runtime preflight --json
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Environment equivalents:
|
|
49
|
+
|
|
50
|
+
```text
|
|
51
|
+
CODEX_TOYS_REMOTE_SSH_TARGET=workbox
|
|
52
|
+
CODEX_TOYS_REMOTE_CWD=/srv/codex/workspaces/ops
|
|
53
|
+
CODEX_TOYS_REMOTE_PATH_PREPEND=/opt/node/bin:/usr/local/bin
|
|
54
|
+
CODEX_TOYS_RUNTIME_COMMAND=/usr/local/bin/codex-toys
|
|
55
|
+
CODEX_TOYS_REMOTE_CODEX_COMMAND=/usr/local/bin/codex
|
|
56
|
+
CODEX_TOYS_REMOTE_CODEX_ARGS=["-s","danger-full-access"]
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Run Remote Work
|
|
60
|
+
|
|
61
|
+
Use direct remote calls for quick checks:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops fetch
|
|
65
|
+
codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops functions list --json
|
|
66
|
+
codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops workflow run release-check --event event.json
|
|
67
|
+
codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops turn run "Scan current folder" --wait
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
SSH-backed `turn run` must wait because the remote runtime exits when the
|
|
71
|
+
command exits. Use prompt queues, dispatch queues, workflows, or native Codex
|
|
72
|
+
threads for work that should continue independently.
|
|
73
|
+
|
|
74
|
+
## Inspect Remote State
|
|
75
|
+
|
|
76
|
+
Remote state stays remote:
|
|
77
|
+
|
|
78
|
+
```text
|
|
79
|
+
<remote-workspace>/.codex/workbench/local/
|
|
80
|
+
<remote-workspace>/.codex/feed/local/
|
|
81
|
+
<remote-codex-home>/sessions/
|
|
82
|
+
<remote-codex-home>/memories/
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
`codex-toys` does not copy remote Codex sessions, memories, or workbench state.
|
|
86
|
+
Use the Codex App and native thread links for app-native thread discovery.
|
|
87
|
+
|
|
88
|
+
## Browser Access
|
|
89
|
+
|
|
90
|
+
For a browser UI, run the HTTP edge locally and let it speak SSH to the remote
|
|
91
|
+
runtime:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
codex-toys runtime http \
|
|
95
|
+
--ssh workbox \
|
|
96
|
+
--cwd /srv/codex/workspaces/ops \
|
|
97
|
+
--static ./dashboard
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
The browser talks to localhost. The remote host still exposes no HTTP port.
|
|
101
|
+
|
|
102
|
+
## Troubleshooting
|
|
103
|
+
|
|
104
|
+
- `runtime preflight` fails before runtime startup: SSH target, remote cwd,
|
|
105
|
+
remote PATH, Node, Codex, or codex-toys is missing.
|
|
106
|
+
- Runtime starts but app calls fail: inspect remote Codex auth and remote Codex
|
|
107
|
+
config.
|
|
108
|
+
- SSH prompt turns need `--wait`: use native Codex threads, queues, or workflows
|
|
109
|
+
for supervised background work.
|
package/docs/pages/index.md
CHANGED
|
@@ -1,26 +1,26 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: codex-toys
|
|
3
|
-
description: Primitive-first documentation for codex-toys workflow,
|
|
3
|
+
description: Primitive-first documentation for codex-toys workflow, runtime, feed, templates, and Codex state helpers.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# codex-toys
|
|
7
7
|
|
|
8
|
-
`codex-toys` is a
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
8
|
+
`codex-toys` is a small workspace layer around native Codex. Native Codex owns
|
|
9
|
+
threads, turns, app UI, plugins, skills, hooks, auth, model settings, and app
|
|
10
|
+
automations. `codex-toys` owns workspace templates, workspace functions,
|
|
11
|
+
workflow execution, feed intake, explicit queues, Actions/runtime scaffolding,
|
|
12
|
+
runtime transports, and Codex state utilities.
|
|
12
13
|
|
|
13
14
|
The public npm package is `codex-toys`. Internal `@codex-toys/*` packages are
|
|
14
|
-
|
|
15
|
-
`codex-toys/*` subpaths.
|
|
15
|
+
implementation boundaries that are embedded into the public tarball and exposed
|
|
16
|
+
through focused `codex-toys/*` subpaths.
|
|
16
17
|
|
|
17
18
|
## Primitive Map
|
|
18
19
|
|
|
19
20
|
| Primitive | Owns | Start here |
|
|
20
21
|
|-----------|------|------------|
|
|
21
|
-
| Workflow | A script that inspects state and can start, read, wait on
|
|
22
|
+
| Workflow | A script that inspects state and can start, read, or wait on native Codex turns. | [Workflow](primitives/workflow) |
|
|
22
23
|
| Workbench | Repo-local config, modes, explicit tasks, functions, health, and overview. | [Workbench](primitives/workbench) |
|
|
23
|
-
| Delegation | Starting and tracking Codex work in another workbench-relative cwd. | [Delegation](primitives/delegation) |
|
|
24
24
|
| Dispatch And Queues | Durable future intents, prompt queues, handoff queues, attempts, and collection. | [Dispatch and queues](primitives/dispatch-queues) |
|
|
25
25
|
| Feed | RSS/Atom and manual intake, item storage, cursors, and ack-aware dispatch. | [Feed](primitives/feed) |
|
|
26
26
|
|
|
@@ -28,9 +28,8 @@ feature boundaries that are embedded into the public tarball and exposed through
|
|
|
28
28
|
|
|
29
29
|
| Component | Owns | Start here |
|
|
30
30
|
|-----------|------|------------|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
| Kits | Repo-local copies of skills, plugins, and workflow templates. | [Kits](components/kits) |
|
|
31
|
+
| Runtime | Local stdio, SSH stdio, and optional HTTP/browser transport over the same app/workbench/function methods. | [Runtime](components/runtime) |
|
|
32
|
+
| Kits | Workspace templates installed from local or Git sources. | [Kits](components/kits) |
|
|
34
33
|
| CLI | Command porcelain over primitives and components. | [CLI](components/cli) |
|
|
35
34
|
|
|
36
35
|
## Guides
|
|
@@ -38,12 +37,11 @@ feature boundaries that are embedded into the public tarball and exposed through
|
|
|
38
37
|
| Guide | Use it when |
|
|
39
38
|
|-------|-------------|
|
|
40
39
|
| [Repository autonomy](guides/repository-autonomy) | A repo should run its workbench on a GitHub Actions schedule and commit durable Codex state back to itself. |
|
|
41
|
-
| [Remote
|
|
40
|
+
| [Remote runtime](guides/remote-runtime) | A VPS or SSH host should run Codex work while local commands control it over SSH stdio. |
|
|
42
41
|
| [Local scheduled workbench](guides/local-scheduled-workbench) | A trusted local machine should run explicit workbench or feed commands on systemd user timers. |
|
|
43
|
-
| [Dashboard over
|
|
42
|
+
| [Dashboard over runtime](guides/dashboard-over-runtime) | A browser UI should inspect or operate a local or SSH-backed workspace through the runtime HTTP edge. |
|
|
44
43
|
| [Feed to workflow](guides/feed-to-workflow) | RSS or Atom items should dispatch into workflow-backed workbench tasks. |
|
|
45
|
-
| [Capability kit setup](guides/capability-kit-setup) | A
|
|
46
|
-
| [Delegated repo work](guides/delegated-repo-work) | A controlling workbench should start and track Codex work in another checkout. |
|
|
44
|
+
| [Capability kit setup](guides/capability-kit-setup) | A workspace should install checked-in local templates from a kit. |
|
|
47
45
|
|
|
48
46
|
## Operations
|
|
49
47
|
|
|
@@ -56,45 +54,46 @@ feature boundaries that are embedded into the public tarball and exposed through
|
|
|
56
54
|
|
|
57
55
|
```bash
|
|
58
56
|
codex-toys fetch
|
|
59
|
-
codex-toys
|
|
57
|
+
codex-toys runtime serve --cwd <workspace>
|
|
58
|
+
codex-toys runtime http --cwd <workspace> --static ./dashboard
|
|
60
59
|
codex-toys workflow list
|
|
61
60
|
codex-toys workflow run <name> --event event.json
|
|
62
61
|
codex-toys workbench doctor
|
|
62
|
+
codex-toys functions list --json
|
|
63
63
|
codex-toys feed poll --json
|
|
64
64
|
codex-toys workbench prompt enqueue "Review this later."
|
|
65
65
|
codex-toys workbench dispatch list --json
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
Run the same
|
|
68
|
+
Run the same workspace over SSH without opening a remote port:
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
72
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
73
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
71
|
+
codex-toys --ssh <target> --cwd <remote-workspace> fetch
|
|
72
|
+
codex-toys --ssh <target> --cwd <remote-workspace> runtime preflight --json
|
|
73
|
+
codex-toys --ssh <target> --cwd <remote-workspace> workflow run <name> --event event.json
|
|
74
|
+
codex-toys --ssh <target> --cwd <remote-workspace> functions list --json
|
|
75
|
+
codex-toys --ssh <target> --cwd <remote-workspace> turn run "Scan current folder" --wait
|
|
74
76
|
```
|
|
75
77
|
|
|
76
78
|
## Runtime Shape
|
|
77
79
|
|
|
78
|
-
Local CLI commands spawn `codex-toys
|
|
79
|
-
|
|
80
|
-
speak JSON-RPC over SSH stdio.
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
Browser dashboards opt into HTTP explicitly with `codex-toys-proxy`. The proxy
|
|
84
|
-
forwards generic app and workbench calls to the toybox instead of creating a
|
|
85
|
-
second product model.
|
|
80
|
+
Local CLI commands spawn `codex-toys runtime serve` over stdio when they need
|
|
81
|
+
workspace methods. SSH commands start that same stdio runtime on the remote
|
|
82
|
+
host and speak JSON-RPC over SSH stdio. Browser dashboards opt into HTTP with
|
|
83
|
+
`codex-toys runtime http`, which forwards generic app, workbench, and function
|
|
84
|
+
calls to the runtime instead of creating a second product API.
|
|
86
85
|
|
|
87
86
|
## Boundary
|
|
88
87
|
|
|
89
88
|
`codex-toys` owns reusable mechanics:
|
|
90
89
|
|
|
91
90
|
- Codex app-server bridge helpers
|
|
92
|
-
-
|
|
91
|
+
- runtime transport and method metadata
|
|
93
92
|
- workflow script execution and host helpers
|
|
94
93
|
- feed intake and cursor state
|
|
95
|
-
- workbench tasks, functions, queues,
|
|
94
|
+
- workbench tasks, functions, queues, and overview
|
|
96
95
|
- memory and thread rollout file moves
|
|
97
|
-
- kit inspection and
|
|
96
|
+
- kit inspection and workspace-template installation
|
|
98
97
|
|
|
99
98
|
Installing products own domain completion: credentials, source catalogs, scoring,
|
|
100
99
|
prompt policy, deployment decisions, branch or release policy, external writes,
|
|
@@ -113,9 +112,8 @@ Install Codex-facing guidance from the shared plugin marketplace:
|
|
|
113
112
|
```bash
|
|
114
113
|
codex plugin marketplace add peezy-tech/skills --ref main
|
|
115
114
|
codex plugin add codex-toys-author@peezy-tech
|
|
116
|
-
codex plugin add codex-toys-local-
|
|
115
|
+
codex plugin add codex-toys-local-workspace@peezy-tech
|
|
117
116
|
codex plugin add codex-toys-remote-control@peezy-tech
|
|
118
117
|
```
|
|
119
118
|
|
|
120
|
-
Use kits only when a
|
|
121
|
-
plugins, or workflow templates.
|
|
119
|
+
Use kits only when a workspace intentionally wants repo-local templates.
|
|
@@ -6,15 +6,15 @@ description: Install codex-toys Codex-facing guidance from a Git-backed marketpl
|
|
|
6
6
|
# Plugins
|
|
7
7
|
|
|
8
8
|
The npm package installs the CLI and runtime APIs. Codex plugins install
|
|
9
|
-
Codex-facing guidance such as workflow authoring, local
|
|
10
|
-
remote
|
|
9
|
+
Codex-facing guidance such as workflow authoring, local runtime operation, and
|
|
10
|
+
remote workspace operation.
|
|
11
11
|
|
|
12
12
|
## Shared Marketplace
|
|
13
13
|
|
|
14
14
|
```bash
|
|
15
15
|
codex plugin marketplace add peezy-tech/skills --ref main
|
|
16
16
|
codex plugin add codex-toys-author@peezy-tech
|
|
17
|
-
codex plugin add codex-toys-local-
|
|
17
|
+
codex plugin add codex-toys-local-workspace@peezy-tech
|
|
18
18
|
codex plugin add codex-toys-remote-control@peezy-tech
|
|
19
19
|
```
|
|
20
20
|
|
|
@@ -26,8 +26,8 @@ is reloaded.
|
|
|
26
26
|
| Plugin | Use it for |
|
|
27
27
|
|--------|------------|
|
|
28
28
|
| `codex-toys-author` | Writing or reviewing workflow scripts. |
|
|
29
|
-
| `codex-toys-local-
|
|
30
|
-
| `codex-toys-remote-control` | Operating SSH-backed
|
|
29
|
+
| `codex-toys-local-workspace` | Operating local runtimes and HTTP dashboards. |
|
|
30
|
+
| `codex-toys-remote-control` | Operating SSH-backed workspaces from a local Codex App. |
|
|
31
31
|
|
|
32
32
|
The root `codex-toys` plugin is for product-local development against this repo.
|
|
33
33
|
Prefer the granular plugins for normal use.
|
|
@@ -39,7 +39,7 @@ When iterating on this checkout, add the checkout root as a local marketplace:
|
|
|
39
39
|
```bash
|
|
40
40
|
codex plugin marketplace add <codex-toys-checkout>
|
|
41
41
|
codex plugin add codex-toys-author@codex-toys
|
|
42
|
-
codex plugin add codex-toys-local-
|
|
42
|
+
codex plugin add codex-toys-local-workspace@codex-toys
|
|
43
43
|
codex plugin add codex-toys-remote-control@codex-toys
|
|
44
44
|
```
|
|
45
45
|
|
|
@@ -49,4 +49,4 @@ upgrade the affected plugin and start a new thread.
|
|
|
49
49
|
## Runtime Boundary
|
|
50
50
|
|
|
51
51
|
Plugin install does not start a service. The CLI, MCP server, workflow runs,
|
|
52
|
-
functions,
|
|
52
|
+
functions, and optional HTTP edge all use the normal runtime paths.
|
|
@@ -110,10 +110,10 @@ codex-toys workbench handoff drain \
|
|
|
110
110
|
## SSH
|
|
111
111
|
|
|
112
112
|
SSH is transport, not a third queue. With `--ssh`, queue commands operate on the
|
|
113
|
-
remote
|
|
113
|
+
remote workspace's local queue through the remote runtime.
|
|
114
114
|
|
|
115
115
|
```bash
|
|
116
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
117
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
118
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
116
|
+
codex-toys --ssh <target> --cwd <remote-workspace> workbench dispatch list --json
|
|
117
|
+
codex-toys --ssh <target> --cwd <remote-workspace> workbench prompt run-due --limit 1
|
|
118
|
+
codex-toys --ssh <target> --cwd <remote-workspace> workbench handoff collect --cursor operator --json
|
|
119
119
|
```
|
|
@@ -51,12 +51,12 @@ codex-toys feed dispatch --source project-releases --cursor radar --target workb
|
|
|
51
51
|
codex-toys feed prune --older-than-days 90 --dry-run
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
With `--ssh`, the local CLI starts the remote
|
|
54
|
+
With `--ssh`, the local CLI starts the remote runtime and calls the same feed
|
|
55
55
|
methods in the remote root selected by `--cwd`.
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
59
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
58
|
+
codex-toys --ssh <target> --cwd <remote-workspace> feed poll --json
|
|
59
|
+
codex-toys --ssh <target> --cwd <remote-workspace> feed collect --cursor radar --json
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
## State
|
|
@@ -131,6 +131,7 @@ where that history belongs in git.
|
|
|
131
131
|
- functions
|
|
132
132
|
- recent cwd threads
|
|
133
133
|
- git state
|
|
134
|
-
- health checks for Node, codex-toys, Codex,
|
|
134
|
+
- health checks for Node, codex-toys, Codex, runtime transport, app-server, and config
|
|
135
135
|
|
|
136
|
-
The
|
|
136
|
+
The runtime HTTP edge exposes the same data through
|
|
137
|
+
`POST /api/workbench/overview`.
|
|
@@ -8,14 +8,13 @@ description: The codex-toys primitive for running script code before composing n
|
|
|
8
8
|
Workflow is the pre-turn orchestration primitive. A workflow runs a JavaScript or
|
|
9
9
|
TypeScript module, gives it a JSON context, and records the JSON object returned
|
|
10
10
|
by the module. The script can decide to skip, return data, start a Codex turn,
|
|
11
|
-
wait on several
|
|
11
|
+
or wait on several native Codex turns.
|
|
12
12
|
|
|
13
13
|
```text
|
|
14
14
|
event, schedule, or operator command
|
|
15
15
|
-> workflow script
|
|
16
16
|
-> return JSON
|
|
17
17
|
-> optionally call context.turn.*
|
|
18
|
-
-> optionally call context.delegate.*
|
|
19
18
|
```
|
|
20
19
|
|
|
21
20
|
The CLI does not interpret returned `action` fields. The script owns its own
|
|
@@ -63,7 +62,7 @@ codex-toys workflow run --script ./check.ts --event event.json
|
|
|
63
62
|
printf '%s\n' 'export default () => ({ status: "ok" })' | codex-toys workflow run --script-stdin
|
|
64
63
|
```
|
|
65
64
|
|
|
66
|
-
By default, workflow turns use the workbench
|
|
65
|
+
By default, workflow turns use the workbench runtime surface. Use `--via app`
|
|
67
66
|
only when deliberately targeting direct app-server calls without workbench
|
|
68
67
|
helpers.
|
|
69
68
|
|
|
@@ -75,8 +74,8 @@ codex-toys workflow run release-check --event event.json --via app
|
|
|
75
74
|
Run the workflow on a remote host through SSH stdio:
|
|
76
75
|
|
|
77
76
|
```bash
|
|
78
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
79
|
-
codex-toys --ssh <target> --cwd <remote-
|
|
77
|
+
codex-toys --ssh <target> --cwd <remote-workspace> workflow list --json
|
|
78
|
+
codex-toys --ssh <target> --cwd <remote-workspace> workflow run release-check --event event.json
|
|
80
79
|
```
|
|
81
80
|
|
|
82
81
|
With `--ssh`, discovery, named resolution, event loading, and script execution
|
|
@@ -114,14 +113,11 @@ The context includes:
|
|
|
114
113
|
Host helpers include:
|
|
115
114
|
|
|
116
115
|
- `context.app.call(method, params)`
|
|
117
|
-
- `context.workbench.call(method, params)`, only through the
|
|
116
|
+
- `context.workbench.call(method, params)`, only through the runtime surface
|
|
118
117
|
- `context.turn.start(params)`
|
|
119
118
|
- `context.turn.read(turn)`
|
|
120
119
|
- `context.turn.wait(turn, options)`
|
|
121
120
|
- `context.turn.waitAll(turns, options)`
|
|
122
|
-
- `context.delegate.start(params)`, only through the toybox surface
|
|
123
|
-
- `context.delegate.read(delegation)`
|
|
124
|
-
- `context.delegate.wait(delegation, options)`
|
|
125
121
|
|
|
126
122
|
## Turn Fields
|
|
127
123
|
|
|
@@ -143,25 +139,30 @@ Host helpers include:
|
|
|
143
139
|
Do not combine a sandbox mode with a permissions profile unless the target Codex
|
|
144
140
|
host explicitly supports that combination.
|
|
145
141
|
|
|
146
|
-
##
|
|
142
|
+
## Background Work
|
|
147
143
|
|
|
148
|
-
|
|
149
|
-
|
|
144
|
+
Workflow does not create a second thread registry. When background work belongs
|
|
145
|
+
in another checkout, start or resume native Codex turns directly through
|
|
146
|
+
`context.turn.*`, dispatch queues, or explicit app-server calls, then return the
|
|
147
|
+
thread id and `codex://thread/<id>` link from the script result.
|
|
150
148
|
|
|
151
149
|
```ts
|
|
152
150
|
export default async function run(context) {
|
|
153
|
-
const
|
|
151
|
+
const turn = await context.turn.start({
|
|
154
152
|
cwd: "@/repos/example",
|
|
155
|
-
prompt: "Inspect this repository and summarize risks."
|
|
156
|
-
returnMode: "wake_on_done"
|
|
153
|
+
prompt: "Inspect this repository and summarize risks."
|
|
157
154
|
});
|
|
158
155
|
|
|
159
|
-
return {
|
|
156
|
+
return {
|
|
157
|
+
status: "started",
|
|
158
|
+
threadId: turn.threadId,
|
|
159
|
+
threadUrl: turn.threadId ? `codex://thread/${turn.threadId}` : undefined
|
|
160
|
+
};
|
|
160
161
|
}
|
|
161
162
|
```
|
|
162
163
|
|
|
163
|
-
|
|
164
|
-
|
|
164
|
+
Native Codex owns thread discovery, open links, archive/delete, fork, resume,
|
|
165
|
+
and app UI control.
|
|
165
166
|
|
|
166
167
|
## Workbench Tasks
|
|
167
168
|
|
|
@@ -26,11 +26,6 @@ import { v2 } from "codex-toys/bridge/generated";
|
|
|
26
26
|
import { parseJsonText } from "codex-toys/bridge/json";
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
## `codex-toys/toybox`
|
|
30
|
-
|
|
31
|
-
Stdio JSON-RPC protocol, client, and server primitives for local and SSH-backed
|
|
32
|
-
toyboxes. Use it when another process needs to host or call a toybox directly.
|
|
33
|
-
|
|
34
29
|
## `codex-toys/feed`
|
|
35
30
|
|
|
36
31
|
Feed intake helpers:
|
|
@@ -42,7 +37,7 @@ Feed intake helpers:
|
|
|
42
37
|
- durable feed item storage
|
|
43
38
|
- collection cursors
|
|
44
39
|
- dispatch and pruning
|
|
45
|
-
-
|
|
40
|
+
- runtime method factories and metadata
|
|
46
41
|
|
|
47
42
|
```ts
|
|
48
43
|
import {
|
|
@@ -59,10 +54,9 @@ import {
|
|
|
59
54
|
Workbench runtime and policy helpers:
|
|
60
55
|
|
|
61
56
|
- workflow script execution and workflow host helpers
|
|
62
|
-
- remote workflow
|
|
57
|
+
- remote workflow runtime methods
|
|
63
58
|
- workbench doctor, task execution, dispatch drains, and Actions scaffolding
|
|
64
59
|
- dispatch runs, prompt queue, and local handoff queue
|
|
65
|
-
- delegation methods and state
|
|
66
60
|
- workbench functions
|
|
67
61
|
- workbench and host overview
|
|
68
62
|
- thread presentation helpers and request descriptors
|
|
@@ -100,22 +94,21 @@ system packages. The generated Actions-mode workflow uses
|
|
|
100
94
|
release feed publishes `codex-<codex-version>` tags that bake native Codex into
|
|
101
95
|
the image before the bindings workflow runs.
|
|
102
96
|
|
|
103
|
-
## `codex-toys/
|
|
104
|
-
|
|
105
|
-
SSH-backed transport and preflight helpers. This package creates toybox
|
|
106
|
-
transports over SSH stdio, resolves remote options, performs remote preflight,
|
|
107
|
-
and supports remote-control status helpers without exposing remote HTTP ports.
|
|
108
|
-
|
|
109
|
-
## `codex-toys/proxy`
|
|
97
|
+
## `codex-toys/runtime`
|
|
110
98
|
|
|
111
|
-
|
|
99
|
+
Runtime/connect helpers for local stdio, SSH stdio, browser clients, and the
|
|
100
|
+
optional HTTP edge. This is the public surface for all codex-toys transport
|
|
101
|
+
paths.
|
|
112
102
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
103
|
+
```ts
|
|
104
|
+
import {
|
|
105
|
+
CodexRuntimeClient,
|
|
106
|
+
createSshRuntimeTransport,
|
|
107
|
+
createCodexToysRuntimeHttpHandler,
|
|
108
|
+
createCodexToysBrowserClient,
|
|
109
|
+
codexToysRuntime
|
|
110
|
+
} from "codex-toys/runtime";
|
|
111
|
+
```
|
|
119
112
|
|
|
120
113
|
## `codex-toys/kits`
|
|
121
114
|
|
|
@@ -126,6 +119,6 @@ workflow templates. Kits read optional `codex-kit.toml` manifests, write
|
|
|
126
119
|
|
|
127
120
|
## `codex-toys`
|
|
128
121
|
|
|
129
|
-
The CLI package and umbrella runtime export. It publishes the `codex-toys`
|
|
130
|
-
|
|
131
|
-
|
|
122
|
+
The CLI package and umbrella runtime export. It publishes the `codex-toys`
|
|
123
|
+
binary, re-exports the focused runtime surfaces, and ships a version-matched
|
|
124
|
+
Markdown docs snapshot under `docs/pages`.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "codex-toys",
|
|
3
|
-
"version": "0.140.
|
|
4
|
-
"description": "Codex CLI and umbrella runtime export for bridge,
|
|
3
|
+
"version": "0.140.15",
|
|
4
|
+
"description": "Codex CLI and umbrella runtime export for bridge, runtime, feed, workbench, actions, and kits.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
|
7
7
|
"repository": {
|
|
@@ -18,8 +18,7 @@
|
|
|
18
18
|
"sideEffects": false,
|
|
19
19
|
"types": "./dist/index.d.ts",
|
|
20
20
|
"bin": {
|
|
21
|
-
"codex-toys": "dist/cli/index.js"
|
|
22
|
-
"codex-toys-proxy": "dist/internal/proxy/bin/codex-toys-proxy.js"
|
|
21
|
+
"codex-toys": "dist/cli/index.js"
|
|
23
22
|
},
|
|
24
23
|
"files": [
|
|
25
24
|
"dist",
|
|
@@ -74,25 +73,9 @@
|
|
|
74
73
|
"types": "./dist/kits.d.ts",
|
|
75
74
|
"import": "./dist/kits.js"
|
|
76
75
|
},
|
|
77
|
-
"./
|
|
78
|
-
"types": "./dist/
|
|
79
|
-
"import": "./dist/
|
|
80
|
-
},
|
|
81
|
-
"./proxy/browser": {
|
|
82
|
-
"types": "./dist/proxy/browser.d.ts",
|
|
83
|
-
"import": "./dist/proxy/browser.js"
|
|
84
|
-
},
|
|
85
|
-
"./proxy/vite": {
|
|
86
|
-
"types": "./dist/proxy/vite.d.ts",
|
|
87
|
-
"import": "./dist/proxy/vite.js"
|
|
88
|
-
},
|
|
89
|
-
"./remote": {
|
|
90
|
-
"types": "./dist/remote.d.ts",
|
|
91
|
-
"import": "./dist/remote.js"
|
|
92
|
-
},
|
|
93
|
-
"./toybox": {
|
|
94
|
-
"types": "./dist/toybox.d.ts",
|
|
95
|
-
"import": "./dist/toybox.js"
|
|
76
|
+
"./runtime": {
|
|
77
|
+
"types": "./dist/runtime.d.ts",
|
|
78
|
+
"import": "./dist/runtime.js"
|
|
96
79
|
},
|
|
97
80
|
"./workbench": {
|
|
98
81
|
"types": "./dist/workbench.d.ts",
|