@opencow-ai/opencow-agent-sdk 0.4.20 → 0.4.22

package/dist/session/branding.d.ts

@@ -0,0 +1,9 @@
+import { type ResolvedBranding } from './brandingConfig.js';
+export { DEFAULT_BRANDING, resolveBranding, type BrandingOptions, type ResolvedBranding, } from './brandingConfig.js';
+export declare function runWithBranding<T>(branding: ResolvedBranding, fn: () => T): T;
+export declare function getBranding(): ResolvedBranding;
+export declare function getAssistantIdentityPrompt(): string;
+export declare function getMcpClientInfo(): {
+    readonly title: string;
+    readonly description: string;
+};

package/dist/session/brandingConfig.d.ts

@@ -0,0 +1,12 @@
+export interface BrandingOptions {
+    /** Product name shown in client display metadata and used as the assistant fallback. */
+    productName?: string;
+    /** Assistant identity used in model-facing prompts. Defaults to productName. */
+    assistantName?: string;
+}
+export interface ResolvedBranding {
+    readonly productName: string;
+    readonly assistantName: string;
+}
+export declare const DEFAULT_BRANDING: ResolvedBranding;
+export declare function resolveBranding(options?: BrandingOptions): ResolvedBranding;

package/dist/session/state/als.d.ts

@@ -105,6 +105,22 @@ export interface ChildContextOverrides {
  * config).
  */
 export declare function runWithChildQueryContext<T>(parent: QueryRuntime, overrides: ChildContextOverrides, fn: () => T): T;
+/**
+ * Iterate an async iterable inside a child scope whose ONLY deviation from
+ * the parent is `config.env` — every other slot stays reference-shared
+ * (unlike `deriveChildQueryContext`, which also resets turn/diagnostics/
+ * registries and is therefore the wrong tool for a request-param override).
+ *
+ * Motivation: provider request params (extra_body, transport) are read from
+ * the query-scoped env at request-build time. A subagent with its own
+ * `extraBody` must override that env entry for exactly the span of its query
+ * iteration, without forking turn/cost accounting.
+ *
+ * The override wraps each `next()` call rather than iterable creation
+ * because async-generator bodies execute during iteration, not at
+ * construction.
+ */
+export declare function iterateWithQueryEnvOverrides<T>(iterable: AsyncIterable<T>, envOverrides: Record<string, string>): AsyncGenerator<T, void>;
 /**
  * Construct a child QueryRuntime from a parent. The per-slot
  * inheritance policy is the v3 §6.2 contract:

package/dist/session/state/types.d.ts

@@ -31,6 +31,7 @@ import type { ModelStrings } from 'src/providers/shared/model/modelStrings.js';
 import type { SettingSource } from 'src/session/settings/constants.js';
 import type { PluginHookMatcher } from 'src/session/settings/types.js';
 import type { AgentColorName } from 'src/capabilities/tools/AgentTool/agentColorManager.js';
+import type { ResolvedBranding } from '../brandingConfig.js';
 export type RegisteredHookMatcher = HookCallbackMatcher | PluginHookMatcher;
 /**
  * Tracked invocation of a skill (from the SkillTool / SDK skill loading).
@@ -154,6 +155,7 @@ export interface PromptCacheState {
 export type RuntimeMode = 'sdk' | 'cli-interactive' | 'cli-print' | 'cli-remote' | 'cli-direct-connect' | 'subagent';
 export interface QueryConfig {
     readonly runtimeMode: RuntimeMode;
+    readonly branding: ResolvedBranding;
     readonly sessionSource: string | undefined;
     /**
      * Granular entrypoint identifier for telemetry — `'cli'`, `'sdk-cli'`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencow-ai/opencow-agent-sdk",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",