@opencow-ai/opencow-agent-sdk 0.4.25 → 0.4.27

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/mcp/types.d.ts

@@ -25,6 +25,7 @@ export declare const McpStdioServerConfigSchema: () => z.ZodObject<{
     command: z.ZodString;
     args: z.ZodDefault<z.ZodArray<z.ZodString>>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const McpSSEServerConfigSchema: () => z.ZodObject<{
     type: z.ZodLiteral<"sse">;
@@ -83,6 +84,7 @@ export declare const McpServerConfigSchema: () => z.ZodUnion<readonly [z.ZodObje
     command: z.ZodString;
     args: z.ZodDefault<z.ZodArray<z.ZodString>>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"sse">;
     url: z.ZodString;
@@ -148,6 +150,7 @@ export declare const McpJsonConfigSchema: () => z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"sse">;
         url: z.ZodString;

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

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

@@ -86,6 +86,12 @@ export declare function substitutePluginVariables(value: string, plugin: {
     source?: string;
     dataPath?: string;
 }): string;
+/**
+ * Substitute host-defined `${NAME}` content variables from the session's
+ * managed plugin snapshot. Single pass, so substituted values are never
+ * re-expanded; names the host did not define stay literal.
+ */
+export declare function substitutePluginContentVariables(value: string, variables?: Readonly<Record<string, string>>): string;
 /**
  * Substitute ${user_config.KEY} with saved option values.
  *

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

@@ -262,6 +262,7 @@ export declare const PluginManifestSchema: () => z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"sse">;
         url: z.ZodString;
@@ -312,6 +313,7 @@ export declare const PluginManifestSchema: () => z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"sse">;
         url: z.ZodString;
@@ -759,6 +761,7 @@ export declare const PluginMarketplaceEntrySchema: () => z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"sse">;
         url: z.ZodString;
@@ -809,6 +812,7 @@ export declare const PluginMarketplaceEntrySchema: () => z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"sse">;
         url: z.ZodString;
@@ -1147,6 +1151,7 @@ export declare const PluginMarketplaceSchema: () => z.ZodObject<{
             command: z.ZodString;
             args: z.ZodDefault<z.ZodArray<z.ZodString>>;
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"sse">;
             url: z.ZodString;
@@ -1197,6 +1202,7 @@ export declare const PluginMarketplaceSchema: () => z.ZodObject<{
             command: z.ZodString;
             args: z.ZodDefault<z.ZodArray<z.ZodString>>;
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"sse">;
             url: z.ZodString;

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

@@ -15,6 +15,8 @@ export type ExplicitPluginRuntimeBundle = {
     lspManager: LSPServerManager | null;
     outputStyles: readonly OutputStyleConfig[];
     dataPaths: ReadonlyMap<string, string>;
+    /** Host-defined content variables from the managed snapshot. */
+    contentVariables?: Readonly<Record<string, string>>;
     state: SdkPluginState;
     dispose(): Promise<void>;
 };