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

package/dist/session/forkedAgent.d.ts

@@ -181,7 +181,8 @@ export type SubagentContextOverrides = {
  * - abortController: new controller linked to parent (parent abort propagates)
  * - getAppState: wrapped to set shouldAvoidPermissionPrompts
  * - All mutation callbacks (setAppState, etc.): no-op
- * - Fresh collections: nestedMemoryAttachmentTriggers, toolDecisions
+ * - Fresh collections: nestedMemoryAttachmentTriggers, toolDecisions,
+ *   permissionPreDecisions
  *
  * Callers can:
  * - Override specific fields via the overrides parameter

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

@@ -130,6 +130,12 @@ export type ToolRuntimeContext = {
          * nested subagents via agentOptions; the main loop never filters on it.
          */
         subagentDisallowedTools?: string[];
+        /**
+         * 权限决策前置开关（见 Options.preDecidePermissions）。开启后 runTools() 入口
+         * 对同批 tool_use 并发预调 canUseTool 并缓存到 permissionPreDecisions；
+         * 默认 undefined（关），由 host 显式开启。
+         */
+        preDecidePermissions?: boolean;
     };
     abortController: AbortController;
     readFileState: FileStateCache;
@@ -184,6 +190,17 @@ export type ToolRuntimeContext = {
         decision: 'accept' | 'reject';
         timestamp: number;
     }>;
+    /**
+     * 权限预决策缓存（options.preDecidePermissions 开启时由 runTools() 入口填充，
+     * 键为 tool_use id）。与 toolDecisions 审计快照不同：本缓存是一次性消费——
+     * 执行期 resolveHookPermissionDecision 取出即删，且仅当执行期 input 与缓存
+     * input 深比较一致时才采用缓存 promise，否则回退内联询问。预决策拿不到
+     * PreToolUse hook 的改写/ask 消息，故 hook 改写 input 后必然 miss 回退。
+     */
+    permissionPreDecisions?: Map<string, {
+        input: Record<string, unknown>;
+        promise: Promise<PermissionResult>;
+    }>;
     queryTracking?: QueryChainTracking;
     requestPrompt?: (sourceName: string, toolInputSummary?: string | null) => (request: PromptRequest) => Promise<PromptResponse>;
     toolUseId?: string;
@@ -233,6 +250,7 @@ export type ToolRuntime<Input extends AnyObject = AnyObject, Output = unknown, P
     readonly shouldDefer?: boolean;
     readonly alwaysLoad?: boolean;
     readonly strict?: boolean;
+    readonly unknownKeys?: 'strip' | 'reject';
     readonly inputSchema: Input;
     readonly inputJSONSchema?: ToolInputJSONSchema;
     outputSchema?: z.ZodType<unknown>;

package/package.json

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