Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 18 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,26 @@
# CLIProxy Providers

This public repository is the future standalone owner of the CordisX
CLIProxyAPI provider sessions plugin.
This public repository is the standalone owner of the CordisX CLIProxyAPI
provider sessions plugin.

## Migration status

The repository currently contains an inert, private-package scaffold. It does
not yet provide the Provider sessions UI or provider configuration. The active
implementation remains in `cordisx/cordisx` until the migration is complete.

The renderer can move to the existing public `cordisx/contracts`,
`cordisx/react`, and `cordisx/ui` entries. Provider configuration requires a
new versioned Protocol service declaration and a matching Host-owned Provider
Fleet adapter. Until both are formally merged, this repository will not copy
Host launcher configuration, credentials, persistence, app-server transport,
or private service APIs.

The planned plugin will preserve composite provider identity and use only the
permission-brokered `ctx.platform` service. It will not create a second Provider
Fleet, replace the native Codex Desktop connection, or fall back to it.
This branch contains the extracted renderer and an executable package-v9
`platform-provider` service candidate. The renderer uses only public Host React,
UI, and `ctx.platform` contracts. The Node service uses only the public Protocol
broker and `ctx.platformProviders.register`; CLIProxy method declarations,
response projection, lifecycle, and approval adaptation live here.

The Host still owns endpoint and credential resolution, process startup, opaque
workspace handles, method/schema policy, configuration persistence, and the
single Provider Fleet. The plugin receives no endpoint, credential, process,
filesystem path, raw transport, or Fleet handle.

The candidate pins Protocol `f9b57a6dc665ff471c9bda06d4923be6e2e03b6a`.
It remains private and unmerged until the matching Host service loader and
broker authority are formally merged. The branch consumes the formal Protocol v2 safe factory projection so each
Host-validated provider model mapping reaches the plugin without exposing raw
service configuration. Protocol v2 is pinned at `cbfd15ef4d2f51bcffa659f393cd65730bbe5f0d`; the matching Host v2 implementation must still be formalized before this plugin can merge.

## Development

Expand Down
18 changes: 9 additions & 9 deletions README.zh-Hans.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,17 @@

## 迁移状态

仓库目前只有惰性的私有 package scaffold,尚未提供 Provider 会话界面或
Provider 配置。迁移完成前,正在生效的实现仍位于 `cordisx/cordisx`。
当前分支已经包含拆出的 renderer,以及可执行的 package-v9
`platform-provider` 服务候选。Renderer 只使用公开的 Host React、UI 和
`ctx.platform` 合同;Node 服务只使用公开 Protocol broker 与
`ctx.platformProviders.register`。CLIProxy 的方法声明、响应投影、生命周期和审批适配均由本仓库维护。

renderer 可迁移到现有公开入口 `cordisx/contracts`、`cordisx/react` 和
`cordisx/ui`。Provider 配置还需要新的 versioned Protocol service declaration
以及对应的 Host-owned Provider Fleet adapter。在二者正式合并前,本仓不会复制
Host launcher 配置、凭据、持久化、app-server transport 或 private service API。
Host 继续负责 endpoint 与凭据解析、进程启动、不透明 workspace handle、方法/Schema
策略、配置持久化和唯一的 Provider Fleet。插件不会获得 endpoint、凭据、进程、文件系统路径、原始 transport 或 Fleet handle。

计划中的插件会保留复合 Provider 身份,并且只使用经过权限 broker 的
`ctx.platform` 服务。它不会创建第二个 Provider Fleet、替换 Codex Desktop
原生连接,或在失败时回退到原生连接
候选精确固定 Protocol `f9b57a6dc665ff471c9bda06d4923be6e2e03b6a`。
在匹配的 Host 服务装载器和 broker authority 正式合入前,包保持 private 且 PR 不合入。
当前分支消费正式的 Protocol v2 安全 factory projection,让 Host 校验后的模型映射进入插件,同时不暴露原始服务配置。Protocol v2 已精确固定为 `cbfd15ef4d2f51bcffa659f393cd65730bbe5f0d`;匹配的 Host v2 实现正式合入后,本插件才可合入

## 开发

Expand Down
25 changes: 25 additions & 0 deletions cordisx-package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
{
"$schema": "https://raw.githubusercontent.com/cordisx/cordisx-protocol/main/schemas/plugin-package.v9.schema.json",
"schemaVersion": 9,
"id": "cli-proxy-api",
"version": "0.1.0",
"entry": "./dist/runtime/module.js",
"readme": "./README.md",
"canonicalSource": "https://github.com/cordisx/plugin-cli-proxy-api",
"distribution": {
"mode": "explicit-local-v1",
"signature": "unsupported"
},
"compatibility": {
"runtimeAbi": 1,
"protocolSchemas": [
"https://raw.githubusercontent.com/cordisx/cordisx-protocol/main/schemas/plugin-manifest.v9.schema.json"
]
},
"dependencies": [],
"runtimeManifest": {
"path": "./runtime-manifest.json",
"schema": "https://raw.githubusercontent.com/cordisx/cordisx-protocol/main/schemas/plugin-manifest.v9.schema.json",
"digest": "sha256:206164ae3566fe02a47f9aad6efac038d7531196860f03c6c156cacfd203bf0f"
}
}
Loading
Loading