actoviq-agent-sdk 0.4.0 → 0.4.2

package/dist/src/runtime/agentClient.js

@@ -23,7 +23,7 @@ import { createGitWorktreeWorkspace, } from '../workspace/actoviqWorkspace.js';
 import { ActoviqAgentsApi, createActoviqTaskTool, summarizeActoviqAgentDefinition, } from './actoviqAgents.js';
 import { getDefaultActoviqAgents } from './defaultActoviqAgents.js';
 import { loadActoviqAgentDefinitions } from './actoviqAgentDefinitions.js';
-import { ActoviqSkillsApi, loadActoviqSkillDefinitions, resolveActoviqSkillPrompt, summarizeActoviqSkillDefinition, } from './actoviqSkills.js';
+import { ActoviqSkillsApi, loadActoviqSkillDefinitions, resolveActoviqSkillPrompt, skillPathsMatch, summarizeActoviqSkillDefinition, } from './actoviqSkills.js';
 import { ActoviqBackgroundTaskManager, ActoviqBackgroundTasksApi, } from './actoviqBackgroundTasks.js';
 import { ActoviqContextApi, ActoviqSlashCommandsApi, } from './actoviqSlashCommands.js';
 import { compactActoviqSession, getPersistedActoviqCompactHistory, getPersistedActoviqCompactState, isActoviqPromptTooLongError, recordActoviqLoopCompactionsOnSession, trackRecentFile, trackRecentSkill, } from './actoviqCompact.js';
@@ -371,6 +371,8 @@ export class ActoviqAgentClient {
     sessionManager;
     agentDefinitions;
     skillDefinitions;
+    /** Names of `paths:`-conditional skills activated by touching matching files. */
+    activatedConditionalSkills = new Set();
     pendingDelegations = new Map();
     pendingRuntimeNotifications = new Map();
     subagentInputQueues = new Map();
@@ -705,6 +707,17 @@ export class ActoviqAgentClient {
     async maybeAutoDream(options = {}) {
         return this.dream.maybeAutoDream(options);
     }
+    // ── v0.5.0: Model Team ──────────────────────────────────────────
+    /**
+     * Create a multi-model team for collaborative deliberation.
+     * Supports panel-analysis and reviewer modes (`panel`/`analysis`/
+     * `executor-reviewer` are backward-compatible aliases). Model routing lives
+     * separately under the /model router layer.
+     */
+    async createTeam(definition) {
+        const { createModelTeam } = await import('../team/modelTeam.js');
+        return createModelTeam(definition);
+    }
     async close() {
         const errors = [];
         try {
@@ -763,6 +776,47 @@ export class ActoviqAgentClient {
     listSkillDefinitions() {
         return [...this.skillDefinitions.values()].map(summarizeActoviqSkillDefinition);
     }
+    /**
+     * Activate `paths:`-conditional skills whose patterns match any of the given
+     * (cwd-relative or absolute) file paths. Activated skills become visible to
+     * the model on the next request — matching claude-code's conditional skills.
+     */
+    activateConditionalSkillsForPaths(filePaths) {
+        if (filePaths.length === 0) {
+            return;
+        }
+        for (const definition of this.skillDefinitions.values()) {
+            if (!definition.paths?.length || this.activatedConditionalSkills.has(definition.name)) {
+                continue;
+            }
+            for (const filePath of filePaths) {
+                const rel = path.isAbsolute(filePath)
+                    ? path.relative(this.config.workDir, filePath)
+                    : filePath;
+                const normalized = rel.replace(/\\/gu, '/');
+                if (!normalized || normalized.startsWith('..')) {
+                    continue;
+                }
+                if (skillPathsMatch(definition.paths, normalized)) {
+                    this.activatedConditionalSkills.add(definition.name);
+                    break;
+                }
+            }
+        }
+    }
+    activateConditionalSkillsFromEvent(event) {
+        if (event.type !== 'tool.call') {
+            return;
+        }
+        const input = event.call?.input;
+        if (!isRecord(input)) {
+            return;
+        }
+        const candidates = [input.file_path, input.path, input.notebook_path].filter((value) => typeof value === 'string' && value.length > 0);
+        if (candidates.length > 0) {
+            this.activateConditionalSkillsForPaths(candidates);
+        }
+    }
     getSkillDefinition(skillName) {
         const definition = this.skillDefinitions.get(skillName);
         return definition ? cloneSkillDefinition(definition) : undefined;
@@ -868,15 +922,29 @@ export class ActoviqAgentClient {
             isReadOnly: () => true,
             prompt: () => {
                 const names = this.listSkillDefinitions()
-                    .filter((definition) => definition.disableModelInvocation !== true)
-                    .map((definition) => definition.description
-                    ? `- ${definition.name}: ${definition.description}`
-                    : `- ${definition.name}`);
+                    .filter((definition) => definition.disableModelInvocation !== true &&
+                    // Conditional (paths-gated) skills stay hidden until a matching
+                    // file is touched, then appear on the next request.
+                    (!definition.paths?.length ||
+                        this.activatedConditionalSkills.has(definition.name)))
+                    .map((definition) => {
+                    const parts = [`- ${definition.name}`];
+                    if (definition.description)
+                        parts.push(`: ${definition.description}`);
+                    if (definition.whenToUse)
+                        parts.push(` (use when: ${definition.whenToUse})`);
+                    if (definition.argumentHint)
+                        parts.push(` [args: ${definition.argumentHint}]`);
+                    return parts.join('');
+                });
                 if (names.length === 0) {
                     return '';
                 }
                 return [
-                    'Use the Skill tool to load a registered skill when the task matches its description.',
+                    'You can autonomously load a registered skill with the Skill tool whenever the current task',
+                    'matches its purpose — decide for yourself from each skill\'s description and "use when" guidance',
+                    'below, then call Skill({ skill, args? }) without waiting to be asked. Prefer a matching skill over',
+                    'improvising when one applies.',
                     'Available skills:',
                     ...names,
                 ].join('\n');
@@ -1349,7 +1417,12 @@ export class ActoviqAgentClient {
             ...(augmentations?.metadata ?? {}),
             ...(options.metadata ?? {}),
         };
-        const workDir = options.__actoviqWorkDir ?? options.workDir ?? this.config.workDir;
+        // Resolve working directory: sessionWorkDir (from worktree) takes priority
+        // unless inheritWorktree is explicitly false.
+        const inheritWorktree = options.inheritWorktree !== false;
+        const workDir = inheritWorktree
+            ? (options.__actoviqWorkDir ?? options.sessionWorkDir ?? options.workDir ?? this.config.workDir)
+            : (options.__actoviqWorkDir ?? options.workDir ?? this.config.workDir);
         const mergedTools = filterAgentTools(mergeUniqueByName(options.__actoviqUseDefaultTools === false ? [] : this.defaultTools, options.tools ?? []), options.__actoviqAllowedTools, options.__actoviqDisallowedTools);
         // Collect tool prompts for system prompt assembly
         const toolPromptParts = await collectToolPrompts(mergedTools, {
@@ -1398,9 +1471,15 @@ export class ActoviqAgentClient {
             hooks: augmentations?.hooks,
             drainQueuedInputs,
             streaming,
-            emit,
+            // Activate paths-conditional skills when the agent touches matching files.
+            emit: (event) => {
+                this.activateConditionalSkillsFromEvent(event);
+                emit?.(event);
+            },
             skipRunStartedEvent,
-            modelApi: this.modelApi,
+            // Per-run model client override (the /model router uses this to route a
+            // turn to a different model/provider); falls back to the SDK default.
+            modelApi: options.modelApi ?? this.modelApi,
             config: runtimeConfig,
             mcpManager: this.mcpManager,
         }).then(result => ({
@@ -2589,6 +2668,7 @@ export class ActoviqAgentClient {
         return {
             ...options,
             model: options.model ?? definition.model,
+            effort: options.effort ?? definition.effort,
             metadata: {
                 ...(definition.metadata ?? {}),
                 ...(options.metadata ?? {}),