@opencow-ai/opencow-agent-sdk 0.4.24 → 0.4.26

package/dist/capabilities/mcp/codexConfigFields.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Codex 插件把第三方授权写成「按名引用」的宿主专属字段：`env_vars`、
+ * `bearer_token_env_var`、`env_http_headers`、`http_headers`。MCP 协议与本运行时
+ * 都不读这些键，`McpServerConfigSchema` 会把它们当未知字段静默丢弃 —— 结果是插件
+ * MCP 启动时没有 Authorization / env，请求必然失败。
+ *
+ * 因此在校验前把它们翻译成运行时真正读取的 `env` / `headers`，值写成 `${VAR}`
+ * 引用，交由 `resolvePluginMcpEnvironment` 展开（值来源见 `SdkManagedPlugin.env`）。
+ *
+ * 与 Host 侧 `src/shared/mcpConfigConvert.ts` 同一语义；Host 的渲染层依赖使它无法
+ * 引用 SDK，两份实现必须同步修改。差异：Host 还要把 mcpb/Claude 的占位写法
+ * （`${input:…}`、`${user_config.…}`、`${{ secrets.… }}`）改写成待配置变量，
+ * 那是无 user-config 通道时的兜底；这里 `${user_config.…}` 由运行时原生支持，
+ * 不做改写。
+ */
+/**
+ * 翻译单个 MCP server 配置（不是 `{ mcpServers: … }` 包装层）。
+ * 输入不被修改；非对象输入原样返回。
+ */
+export declare function normalizeCodexMcpFields(input: unknown): Record<string, unknown>;

package/dist/capabilities/mcp/envExpansion.d.ts

@@ -4,9 +4,12 @@
 /**
  * Expand environment variables in a string value
  * Handles ${VAR} and ${VAR:-default} syntax
+ * @param env Lookup source for variable values. Defaults to `process.env`;
+ *   callers pass a per-plugin overlay so plugin-scoped values (e.g. credentials
+ *   the host collected for that plugin) win over the ambient process env.
  * @returns Object with expanded string and list of missing variables
  */
-export declare function expandEnvVarsInString(value: string): {
+export declare function expandEnvVarsInString(value: string, env?: Record<string, string | undefined>): {
     expanded: string;
     missingVars: string[];
 };

package/dist/capabilities/plugins/lspPluginIntegration.d.ts

@@ -21,6 +21,7 @@ export declare function resolvePluginLspEnvironment(config: LspServerConfig, plu
     path: string;
     source: string;
     dataPath?: string;
+    env?: Record<string, string>;
 }, userConfig?: PluginOptionValues, _errors?: PluginError[]): LspServerConfig;
 /**
  * Add plugin scope to LSP server configs

package/dist/capabilities/plugins/mcpPluginIntegration.d.ts

@@ -48,6 +48,7 @@ export declare function resolvePluginMcpEnvironment(config: McpServerConfig, plu
     path: string;
     source: string;
     dataPath?: string;
+    env?: Record<string, string>;
 }, userConfig?: UserConfigValues, errors?: PluginError[], pluginName?: string, serverName?: string): McpServerConfig;
 /**
  * Get MCP servers from a specific plugin with environment variable resolution and scoping