@opencow-ai/opencow-agent-sdk 0.4.21 → 0.4.23

package/dist/session/layout/schemas.d.ts

@@ -124,14 +124,14 @@ export declare const SdkRuleSchema: z.ZodObject<{
     name?: string;
     id?: string;
     content?: string;
+    origin?: "local" | "user" | "project" | "managed" | "host-injected";
     globs?: string[];
-    origin?: "user" | "project" | "local" | "managed" | "host-injected";
 }, {
     name?: string;
     id?: string;
     content?: string;
+    origin?: "local" | "user" | "project" | "managed" | "host-injected";
     globs?: string[];
-    origin?: "user" | "project" | "local" | "managed" | "host-injected";
 }>;
 /**
  * Validates ONLY the three v4-new fields of Options. Existing Options
@@ -215,24 +215,24 @@ export declare const OptionsPatchSchema: z.ZodEffects<z.ZodObject<{
         name?: string;
         id?: string;
         content?: string;
+        origin?: "local" | "user" | "project" | "managed" | "host-injected";
         globs?: string[];
-        origin?: "user" | "project" | "local" | "managed" | "host-injected";
     }, {
         name?: string;
         id?: string;
         content?: string;
+        origin?: "local" | "user" | "project" | "managed" | "host-injected";
         globs?: string[];
-        origin?: "user" | "project" | "local" | "managed" | "host-injected";
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     rules?: {
         name?: string;
         id?: string;
         content?: string;
+        origin?: "local" | "user" | "project" | "managed" | "host-injected";
         globs?: string[];
-        origin?: "user" | "project" | "local" | "managed" | "host-injected";
     }[];
-    fileSystemLayer?: "disabled" | "auto";
+    fileSystemLayer?: "auto" | "disabled";
     layoutProfile?: "agents" | "claude" | "gemini" | {
         reads?: ("agents" | "claude" | "gemini" | {
             instructionFile?: string;
@@ -252,10 +252,10 @@ export declare const OptionsPatchSchema: z.ZodEffects<z.ZodObject<{
         name?: string;
         id?: string;
         content?: string;
+        origin?: "local" | "user" | "project" | "managed" | "host-injected";
         globs?: string[];
-        origin?: "user" | "project" | "local" | "managed" | "host-injected";
     }[];
-    fileSystemLayer?: "disabled" | "auto";
+    fileSystemLayer?: "auto" | "disabled";
     layoutProfile?: "agents" | "claude" | "gemini" | {
         reads?: ("agents" | "claude" | "gemini" | {
             instructionFile?: string;
@@ -275,10 +275,10 @@ export declare const OptionsPatchSchema: z.ZodEffects<z.ZodObject<{
         name?: string;
         id?: string;
         content?: string;
+        origin?: "local" | "user" | "project" | "managed" | "host-injected";
         globs?: string[];
-        origin?: "user" | "project" | "local" | "managed" | "host-injected";
     }[];
-    fileSystemLayer?: "disabled" | "auto";
+    fileSystemLayer?: "auto" | "disabled";
     layoutProfile?: "agents" | "claude" | "gemini" | {
         reads?: ("agents" | "claude" | "gemini" | {
             instructionFile?: string;
@@ -298,10 +298,10 @@ export declare const OptionsPatchSchema: z.ZodEffects<z.ZodObject<{
         name?: string;
         id?: string;
         content?: string;
+        origin?: "local" | "user" | "project" | "managed" | "host-injected";
         globs?: string[];
-        origin?: "user" | "project" | "local" | "managed" | "host-injected";
     }[];
-    fileSystemLayer?: "disabled" | "auto";
+    fileSystemLayer?: "auto" | "disabled";
     layoutProfile?: "agents" | "claude" | "gemini" | {
         reads?: ("agents" | "claude" | "gemini" | {
             instructionFile?: string;

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

@@ -20,8 +20,8 @@ export declare const PermissionsSchema: () => z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
         auto: "auto";
     }>>;
     disableBypassPermissionsMode: z.ZodOptional<z.ZodEnum<{
@@ -234,8 +234,8 @@ export declare const SettingsSchema: () => z.ZodObject<{
             default: "default";
             acceptEdits: "acceptEdits";
             bypassPermissions: "bypassPermissions";
-            plan: "plan";
             dontAsk: "dontAsk";
+            plan: "plan";
             auto: "auto";
         }>>;
         disableBypassPermissionsMode: z.ZodOptional<z.ZodEnum<{
@@ -339,8 +339,8 @@ export declare const SettingsSchema: () => z.ZodObject<{
     allowManagedPermissionRulesOnly: z.ZodOptional<z.ZodBoolean>;
     allowManagedMcpServersOnly: z.ZodOptional<z.ZodBoolean>;
     strictPluginOnlyCustomization: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
-        skills: "skills";
         agents: "agents";
+        skills: "skills";
         hooks: "hooks";
         mcp: "mcp";
     }>>]>>>>;

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/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, setInitJsonSchema, setSystemPromptSectionCacheEntry, } from './registries.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 { 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

@@ -22,6 +22,7 @@
 import type { HookEvent } from '../../entrypoints/sdk/coreTypes.js';
 import type { AgentColorName } from 'src/capabilities/tools/AgentTool/agentColorManager.js';
 import type { InvokedSkillInfo, RegisteredHookMatcher } from './types.js';
+import type { LSPServerManager } from '../../capabilities/lsp/LSPServerManager.js';
 export declare function getRegisteredHooks(): Partial<Record<HookEvent, RegisteredHookMatcher[]>> | null;
 /**
  * Append matcher entries to the hook registry. Multiple calls accumulate
@@ -44,6 +45,9 @@ 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 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;
 export declare function getInvokedSkills(): Map<string, InvokedSkillInfo>;
 export declare function getInvokedSkillsForAgent(agentId: string | undefined | null): Map<string, InvokedSkillInfo>;

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

@@ -286,6 +286,10 @@ export interface QueryRegistries {
      * Inline `import(...)` avoids cycles.
      */
     dynamicSkills: import('../../capabilities/skills/loadSkillsDir.js').DynamicSkillsState;
+    /** Host-managed plugin data roots keyed by stable plugin id. */
+    pluginDataPaths: Map<string, string>;
+    /** Session-scoped LSP manager for explicit SDK plugins; null uses CLI fallback. */
+    lspManager: import('../../capabilities/lsp/LSPServerManager.js').LSPServerManager | null;
 }
 export interface QueryDiagnostics {
     inMemoryErrorLog: Array<{

package/dist/session/tasks.d.ts

@@ -24,8 +24,8 @@ export declare function notifyTasksUpdated(): void;
 export declare const TASK_STATUSES: readonly ["pending", "in_progress", "completed"];
 export declare const TaskStatusSchema: () => z.ZodEnum<{
     pending: "pending";
-    completed: "completed";
     in_progress: "in_progress";
+    completed: "completed";
 }>;
 export type TaskStatus = z.infer<ReturnType<typeof TaskStatusSchema>>;
 export declare const TaskSchema: () => z.ZodObject<{
@@ -36,8 +36,8 @@ export declare const TaskSchema: () => z.ZodObject<{
     owner: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
         pending: "pending";
-        completed: "completed";
         in_progress: "in_progress";
+        completed: "completed";
     }>;
     blocks: z.ZodArray<z.ZodString>;
     blockedBy: z.ZodArray<z.ZodString>;

package/dist/session/teammateMailbox.d.ts

@@ -250,8 +250,8 @@ export declare const PlanApprovalResponseMessageSchema: () => z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>>;
 }, z.core.$strip>;
 export type PlanApprovalResponseMessage = z.infer<ReturnType<typeof PlanApprovalResponseMessageSchema>>;
@@ -397,8 +397,8 @@ export declare const ModeSetRequestMessageSchema: () => z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>;
     from: z.ZodString;
 }, z.core.$strip>;

package/dist/types/command.d.ts

@@ -137,6 +137,8 @@ export type CommandBase = {
     /** Defaults to false. Only set when the command should be hidden from typeahead/help. */
     isHidden?: boolean;
     name: string;
+    /** Absolute source markdown path when the command was loaded from disk. */
+    sourcePath?: string;
     aliases?: string[];
     isMcp?: boolean;
     argumentHint?: string;

package/dist/types/plugin.d.ts

@@ -42,6 +42,8 @@ export type LoadedPlugin = {
     path: string;
     source: string;
     repository: string;
+    /** Session-owned data directory for explicitly managed plugins. */
+    dataPath?: string;
     enabled?: boolean;
     isBuiltin?: boolean;
     sha?: string;

package/package.json

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