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

package/dist/session/branding.d.ts

@@ -4,6 +4,10 @@ export declare function runWithBranding<T>(branding: ResolvedBranding, fn: () =>
 export declare function getBranding(): ResolvedBranding;
 export declare function getAssistantIdentityPrompt(): string;
 export declare function getMcpClientInfo(): {
+    readonly name: string;
     readonly title: string;
     readonly description: string;
+    readonly websiteUrl?: string;
 };
+/** 第三方 MCP 服务器与网页抓取看到的 UA 前缀 */
+export declare function getProductUserAgentToken(): string;

package/dist/session/brandingConfig.d.ts

@@ -1,12 +1,28 @@
 export interface BrandingOptions {
     /** Product name shown in client display metadata and used as the assistant fallback. */
     productName?: string;
+    /**
+     * ASCII identifier for User-Agent and MCP clientInfo.name. Derived from productName
+     * when omitted; hosts with non-ASCII names should set it explicitly.
+     */
+    productSlug?: string;
     /** Assistant identity used in model-facing prompts. Defaults to productName. */
     assistantName?: string;
+    /**
+     * Host-hosted CIMD (SEP-991) client metadata URL for MCP OAuth. When omitted,
+     * the SDK does not send CIMD and MCP OAuth uses Dynamic Client Registration.
+     */
+    mcpOAuthClientMetadataUrl?: string;
+    /** Product website reported to MCP servers as clientInfo.websiteUrl. Must be an absolute http(s) URL. */
+    productUrl?: string;
 }
 export interface ResolvedBranding {
     readonly productName: string;
+    /** Lowercase identifier derived from productName; used in User-Agent and MCP clientInfo.name. */
+    readonly productSlug: string;
     readonly assistantName: string;
+    readonly mcpOAuthClientMetadataUrl?: string;
+    readonly productUrl?: string;
 }
 export declare const DEFAULT_BRANDING: ResolvedBranding;
 export declare function resolveBranding(options?: BrandingOptions): ResolvedBranding;

package/dist/session/contextSnapshot.d.ts

@@ -0,0 +1,14 @@
+import type { Message } from '../types/message.js';
+import type { SDKContextSnapshot } from '../types/contextSnapshot.js';
+export declare function buildContextSnapshot(messages: readonly Message[]): SDKContextSnapshot | undefined;
+/**
+ * Validates a persisted snapshot and restores its token baseline marker.
+ *
+ * Invalid snapshots throw instead of silently falling back to a smaller
+ * context: a corrupt persisted snapshot is a host data problem that must be
+ * visible, not converted into a different model context.
+ */
+export declare function normalizeContextSnapshot(raw: unknown): {
+    messages: Message[];
+    baselineTokens: number;
+};

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

@@ -28,7 +28,7 @@ export { clearBetaHeaderLatches, getAfkModeHeaderLatched, getCacheEditingHeaderL
 export { getAllowedChannels, getAllowedSettingSources, getClientType, getDirectConnectServerUrl, getFileSystemLayer, getFlagSettingsInline, getHasDevChannels, getIsNonInteractiveSession, getQueryEnvForSpawn, getQueryEnvOverrides, getHostProvidedEnvVar, getQueryEnvVar, getQuestionPreviewFormat, getRuntimeMode, getSdkBetas, getSessionSource, isInteractive, isRemoteMode, preferThirdPartyAuthentication, setAllowedChannels, setAllowedSettingSources, setDirectConnectServerUrl, setFlagSettingsInline, setHasDevChannels, setSdkBetas, } from './config.js';
 export { deleteEnvVar, resolveEnvVar, setEnvVar, } from '../../constants/envVars.js';
 export type { EnvVarKey } from '../../constants/envVars.js';
-export { addInvokedSkill, clearInvokedSkills, clearInvokedSkillsForAgent, clearRegisteredHooks, clearRegisteredPluginHooks, clearSystemPromptSectionState, getAgentColorMap, getCachedClaudeMdContent, getInitJsonSchema, getInvokedSkills, getInvokedSkillsForAgent, getPlanSlugCache, getRegisteredHooks, getSystemPromptSectionCache, registerHookCallbacks, resetSdkInitState, setCachedClaudeMdContent, setExplicitPluginRuntimeContext, setInitJsonSchema, setSystemPromptSectionCacheEntry, tryGetExplicitPluginDataPath, tryGetSessionLspManager, } from './registries.js';
+export { addInvokedSkill, clearInvokedSkills, clearInvokedSkillsForAgent, clearRegisteredHooks, clearRegisteredPluginHooks, clearSystemPromptSectionState, getAgentColorMap, getCachedClaudeMdContent, getInitJsonSchema, getInvokedSkills, getInvokedSkillsForAgent, getPlanSlugCache, getRegisteredHooks, getSystemPromptSectionCache, registerHookCallbacks, resetSdkInitState, setCachedClaudeMdContent, setExplicitPluginRuntimeBundle, setExplicitPluginRuntimeContext, setInitJsonSchema, setSystemPromptSectionCacheEntry, tryGetExplicitPluginDataPath, tryGetPluginContentVariables, tryGetSessionLspManager, } from './registries.js';
 export { getProvider } from './provider.js';
 export { addToInMemoryErrorLog, getInMemoryErrorLog, getLastEmittedDate, getTeleportedSessionInfo, handleAutoModeTransition, handlePlanModeTransition, hasExitedPlanModeInSession, hasShownLspRecommendationThisSession, markFirstTeleportMessageLogged, needsAutoModeExitAttachment, needsPlanModeExitAttachment, setHasExitedPlanMode, setLastEmittedDate, setLspRecommendationShownThisSession, setNeedsAutoModeExitAttachment, setNeedsPlanModeExitAttachment, setTeleportedSessionInfo, } from './diagnostics.js';
 export { getFeatureFlags, getKairosActive, getScheduledTasksEnabled, getSdkAgentProgressSummariesEnabled, getSessionBypassPermissionsMode, getSessionTrustAccepted, getStrictToolResultPairing, getUserMsgOptIn, isSessionPersistenceDisabled, setScheduledTasksEnabled, } from './featureFlags.js';

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

@@ -45,7 +45,14 @@ export declare function setInitJsonSchema(schema: Record<string, unknown>): void
  * hooks/hooksConfigSnapshot.ts before re-establishing the hook registry.
  */
 export declare function resetSdkInitState(): void;
-export declare function setExplicitPluginRuntimeContext(dataPaths: ReadonlyMap<string, string>, lspManager: LSPServerManager | null): void;
+export declare function setExplicitPluginRuntimeContext(dataPaths: ReadonlyMap<string, string>, lspManager: LSPServerManager | null, contentVariables: Readonly<Record<string, string>>): void;
+/** 会话装配插件 bundle 的唯一入口（sdkRuntime 与 SessionRuntime 共用），避免某一处漏传 contentVariables。 */
+export declare function setExplicitPluginRuntimeBundle(bundle: {
+    readonly dataPaths: ReadonlyMap<string, string>;
+    readonly lspManager: LSPServerManager | null;
+    readonly contentVariables?: Readonly<Record<string, string>>;
+}): void;
+export declare function tryGetPluginContentVariables(): Readonly<Record<string, string>>;
 export declare function tryGetExplicitPluginDataPath(pluginId: string): string | undefined;
 export declare function tryGetSessionLspManager(): LSPServerManager | undefined;
 export declare function addInvokedSkill(skillName: string, skillPath: string, content: string, agentId?: string | null): void;

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

@@ -288,6 +288,8 @@ export interface QueryRegistries {
     dynamicSkills: import('../../capabilities/skills/loadSkillsDir.js').DynamicSkillsState;
     /** Host-managed plugin data roots keyed by stable plugin id. */
     pluginDataPaths: Map<string, string>;
+    /** Host-defined `${NAME}` values for managed plugin skill / command bodies. */
+    pluginContentVariables: Readonly<Record<string, string>>;
     /** Session-scoped LSP manager for explicit SDK plugins; null uses CLI fallback. */
     lspManager: import('../../capabilities/lsp/LSPServerManager.js').LSPServerManager | null;
 }

package/dist/types/contextSnapshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Versioned, host-persistable snapshot of the post-compact model context.
+ *
+ * `messages` intentionally stays opaque at the public boundary: the SDK owns
+ * the internal canonical message shapes, while hosts only persist and return
+ * the snapshot unchanged.
+ */
+export type SDKContextSnapshot = {
+    schemaVersion: 1;
+    messages: readonly unknown[];
+    /**
+     * Estimated or API-reported size of `messages` at snapshot creation time.
+     * Used as the context baseline until a later assistant response carries real
+     * usage.
+     */
+    baselineTokens: number;
+};

package/package.json

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

package/dist/capabilities/tools/AgentTool/built-in/claudeCodeGuideAgent.d.ts

@@ -1,3 +0,0 @@
-import type { BuiltInAgentDefinition } from '../loadAgentsDir.js';
-export declare const CLAUDE_CODE_GUIDE_AGENT_TYPE = "claude-code-guide";
-export declare const CLAUDE_CODE_GUIDE_AGENT: BuiltInAgentDefinition;