@agentuity/opencode 0.1.40 → 0.1.41

package/dist/skills/loader.js

@@ -0,0 +1,152 @@
+import { homedir } from 'node:os';
+import { basename, join, resolve, sep } from 'node:path';
+import { readdir, realpath } from 'node:fs/promises';
+import { parseFrontmatter } from './frontmatter';
+const SKILL_FILENAME = 'SKILL.md';
+/**
+ * Load skills from standard directories.
+ * Priority order (later overrides earlier):
+ * 1. User OpenCode: ~/.config/opencode/skills/
+ * 2. User Agentuity: ~/.config/agentuity/opencode/skills/
+ * 3. User Claude Code compat: ~/.claude/skills/
+ * 4. Project OpenCode: ./.opencode/skills/
+ * 5. Project Claude Code compat: ./.claude/skills/
+ */
+export async function loadAllSkills(config) {
+    if (config?.enabled === false) {
+        return [];
+    }
+    const skillDirs = [
+        { dir: join(homedir(), '.config', 'opencode', 'skills'), scope: 'user' },
+        { dir: join(homedir(), '.config', 'agentuity', 'opencode', 'skills'), scope: 'user' },
+        { dir: join(homedir(), '.claude', 'skills'), scope: 'user' },
+        { dir: join(process.cwd(), '.opencode', 'skills'), scope: 'project' },
+        { dir: join(process.cwd(), '.claude', 'skills'), scope: 'project' },
+    ];
+    if (config?.paths?.length) {
+        for (const skillPath of config.paths) {
+            const resolvedPath = resolve(skillPath);
+            skillDirs.push({ dir: resolvedPath, scope: inferScope(resolvedPath) });
+        }
+    }
+    const disabled = new Set(config?.disabled ?? []);
+    const skillsByName = new Map();
+    for (const { dir, scope } of skillDirs) {
+        const skills = await loadSkillsFromDir(dir, scope);
+        for (const skill of skills) {
+            if (disabled.has(skill.name)) {
+                continue;
+            }
+            skillsByName.set(skill.name, skill);
+        }
+    }
+    return Array.from(skillsByName.values());
+}
+/**
+ * Load skills from a single directory
+ */
+export async function loadSkillsFromDir(dir, scope) {
+    const results = [];
+    const resolvedDir = await safeRealpath(dir);
+    let entries;
+    try {
+        entries = await readdir(resolvedDir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry.isFile() && entry.name.toLowerCase().endsWith('.md')) {
+            const skillPath = join(dir, entry.name);
+            const skill = await loadSkillFromPath(skillPath, resolvedDir, basename(entry.name, '.md'), scope);
+            if (skill) {
+                results.push(skill);
+            }
+            continue;
+        }
+        if (entry.isDirectory()) {
+            const subdirPath = join(dir, entry.name);
+            const resolvedSubdir = await safeRealpath(subdirPath);
+            const candidates = [
+                join(subdirPath, SKILL_FILENAME),
+                join(subdirPath, `${entry.name}.md`),
+            ];
+            for (const candidate of candidates) {
+                const skill = await loadSkillFromPath(candidate, resolvedSubdir, entry.name, scope);
+                if (skill) {
+                    results.push(skill);
+                    break;
+                }
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Load a single skill file (supports both .md files and SKILL.md in directories)
+ */
+async function loadSkillFromPath(skillPath, resolvedPath, defaultName, scope) {
+    const file = Bun.file(skillPath);
+    if (!(await file.exists())) {
+        return null;
+    }
+    const content = await file.text();
+    const parsed = parseFrontmatter(content);
+    const metadata = parsed.data ?? {};
+    const name = metadata.name?.trim() || defaultName;
+    if (!name) {
+        return null;
+    }
+    const allowedTools = normalizeAllowedTools(metadata['allowed-tools']);
+    return {
+        name,
+        path: skillPath,
+        resolvedPath,
+        content: parsed.body,
+        metadata,
+        scope,
+        ...(allowedTools ? { allowedTools } : {}),
+    };
+}
+/**
+ * Get skill by name from loaded skills
+ */
+export function getSkillByName(skills, name) {
+    return skills.find((skill) => skill.name === name);
+}
+function normalizeAllowedTools(value) {
+    if (!value)
+        return undefined;
+    if (Array.isArray(value)) {
+        const tools = value.filter((tool) => typeof tool === 'string');
+        return tools.length > 0 ? tools : undefined;
+    }
+    if (typeof value === 'string') {
+        const tool = value.trim();
+        return tool ? [tool] : undefined;
+    }
+    return undefined;
+}
+function inferScope(skillPath) {
+    const resolved = resolve(skillPath);
+    const cwd = resolve(process.cwd());
+    const home = resolve(homedir());
+    if (isWithin(cwd, resolved))
+        return 'project';
+    if (isWithin(home, resolved))
+        return 'user';
+    return 'opencode';
+}
+function isWithin(base, target) {
+    const baseWithSep = base.endsWith(sep) ? base : `${base}${sep}`;
+    return target === base || target.startsWith(baseWithSep);
+}
+async function safeRealpath(path) {
+    try {
+        return await realpath(path);
+    }
+    catch {
+        return path;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"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"}

package/dist/skills/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Skill scope determines where the skill was loaded from
+ * Priority order: project > user > opencode
+ */
+export type SkillScope = 'project' | 'user' | 'opencode';
+/**
+ * Frontmatter metadata parsed from skill files
+ */
+export interface SkillMetadata {
+    name?: string;
+    description?: string;
+    model?: string;
+    agent?: string;
+    subtask?: boolean;
+    'argument-hint'?: string;
+    'allowed-tools'?: string | string[];
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * A loaded skill ready for use
+ */
+export interface LoadedSkill {
+    name: string;
+    path: string;
+    resolvedPath: string;
+    content: string;
+    metadata: SkillMetadata;
+    scope: SkillScope;
+    allowedTools?: string[];
+}
+/**
+ * Configuration for skills loading
+ */
+export interface SkillsConfig {
+    enabled: boolean;
+    paths?: string[];
+    disabled?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/dist/tmux/decision-engine.d.ts

@@ -0,0 +1,24 @@
+import type { CapacityConfig, SessionMapping, SpawnDecision, WindowState } from './types';
+/**
+ * Extended capacity config that includes maxPanes limit
+ */
+export interface ExtendedCapacityConfig extends CapacityConfig {
+    maxPanes?: number;
+}
+/**
+ * Decide what actions to take to spawn a new agent pane
+ *
+ * Respects maxPanes limit with LRU rotation:
+ * - If current agent panes >= maxPanes, close oldest pane before spawning new one
+ * - This implements LRU (Least Recently Used) rotation
+ */
+export declare function decideSpawnActions(state: WindowState, sessionId: string, description: string, config: ExtendedCapacityConfig, sessionMappings: SessionMapping[]): SpawnDecision;
+/**
+ * Calculate grid capacity based on window size
+ */
+export declare function calculateCapacity(windowWidth: number, windowHeight: number): {
+    cols: number;
+    rows: number;
+    total: number;
+};
+//# sourceMappingURL=decision-engine.d.ts.map

package/dist/tmux/decision-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-engine.d.ts","sourceRoot":"","sources":["../../src/tmux/decision-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAEd,cAAc,EACd,aAAa,EACb,WAAW,EACX,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB,EAC9B,eAAe,EAAE,cAAc,EAAE,GAC/B,aAAa,CAkIf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAU/C"}

package/dist/tmux/decision-engine.js

@@ -0,0 +1,193 @@
+import { MIN_PANE_HEIGHT, MIN_PANE_WIDTH } from './types';
+/**
+ * Decide what actions to take to spawn a new agent pane
+ *
+ * Respects maxPanes limit with LRU rotation:
+ * - If current agent panes >= maxPanes, close oldest pane before spawning new one
+ * - This implements LRU (Least Recently Used) rotation
+ */
+export function decideSpawnActions(state, sessionId, description, config, sessionMappings) {
+    if (!state.mainPane) {
+        return { canSpawn: false, actions: [], reason: 'Main pane not found.' };
+    }
+    if (state.windowWidth < config.mainPaneMinWidth + config.agentPaneMinWidth) {
+        return { canSpawn: false, actions: [], reason: 'Window too small for split.' };
+    }
+    const capacity = calculateCapacity(state.windowWidth, state.windowHeight);
+    if (capacity.total <= 0) {
+        return { canSpawn: false, actions: [], reason: 'Window too small for agent panes.' };
+    }
+    // Determine effective max panes (user config or calculated capacity)
+    const effectiveMaxPanes = config.maxPanes ?? capacity.total;
+    const currentPaneCount = state.agentPanes.length;
+    // Check if we need LRU rotation (at or over maxPanes limit)
+    if (currentPaneCount >= effectiveMaxPanes) {
+        // Find oldest pane to close (LRU rotation)
+        const oldestMapping = pickOldestPane(sessionMappings);
+        if (!oldestMapping) {
+            // No tracked sessions, try replacement instead
+            const replacement = pickReplacementPane(state, sessionMappings);
+            if (!replacement) {
+                return { canSpawn: false, actions: [], reason: 'No pane available to replace.' };
+            }
+            return {
+                canSpawn: true,
+                actions: [
+                    {
+                        type: 'replace',
+                        paneId: replacement.paneId,
+                        oldSessionId: replacement.sessionId,
+                        newSessionId: sessionId,
+                        description,
+                    },
+                ],
+            };
+        }
+        // Close oldest pane, then spawn new one
+        const actions = [
+            {
+                type: 'close',
+                paneId: oldestMapping.paneId,
+                sessionId: oldestMapping.sessionId,
+            },
+        ];
+        // After closing, we'll have room to spawn
+        // Determine where to spawn the new pane
+        if (currentPaneCount === 1) {
+            // After closing the only agent pane, split from main
+            actions.push({
+                type: 'spawn',
+                sessionId,
+                description,
+                targetPaneId: state.mainPane.paneId,
+                splitDirection: '-h',
+            });
+        }
+        else {
+            // Find a remaining pane to split (not the one being closed)
+            const remainingPanes = state.agentPanes.filter((p) => p.paneId !== oldestMapping.paneId);
+            const targetPane = pickBestSplitPane(remainingPanes);
+            if (targetPane) {
+                const splitDirection = chooseSplitDirection(targetPane, config.agentPaneMinWidth);
+                actions.push({
+                    type: 'spawn',
+                    sessionId,
+                    description,
+                    targetPaneId: targetPane.paneId,
+                    splitDirection,
+                });
+            }
+            else {
+                // Fallback: split from main pane
+                actions.push({
+                    type: 'spawn',
+                    sessionId,
+                    description,
+                    targetPaneId: state.mainPane.paneId,
+                    splitDirection: '-h',
+                });
+            }
+        }
+        return { canSpawn: true, actions };
+    }
+    // Under maxPanes limit - normal spawn logic
+    if (state.agentPanes.length === 0) {
+        if (!canSplitHorizontally(state.mainPane, config.agentPaneMinWidth)) {
+            return { canSpawn: false, actions: [], reason: 'Main pane too narrow to split.' };
+        }
+        return {
+            canSpawn: true,
+            actions: [
+                {
+                    type: 'spawn',
+                    sessionId,
+                    description,
+                    targetPaneId: state.mainPane.paneId,
+                    splitDirection: '-h',
+                },
+            ],
+        };
+    }
+    const targetPane = pickBestSplitPane(state.agentPanes);
+    if (!targetPane) {
+        return { canSpawn: false, actions: [], reason: 'No suitable pane to split.' };
+    }
+    const splitDirection = chooseSplitDirection(targetPane, config.agentPaneMinWidth);
+    if (!canSplitPane(targetPane, splitDirection, config.agentPaneMinWidth)) {
+        return { canSpawn: false, actions: [], reason: 'No suitable pane to split.' };
+    }
+    return {
+        canSpawn: true,
+        actions: [
+            {
+                type: 'spawn',
+                sessionId,
+                description,
+                targetPaneId: targetPane.paneId,
+                splitDirection,
+            },
+        ],
+    };
+}
+/**
+ * Calculate grid capacity based on window size
+ */
+export function calculateCapacity(windowWidth, windowHeight) {
+    const reservedWidth = Math.floor(windowWidth * 0.5);
+    const agentWidth = Math.max(0, windowWidth - reservedWidth);
+    const cols = Math.floor(agentWidth / MIN_PANE_WIDTH);
+    const rows = Math.floor(windowHeight / MIN_PANE_HEIGHT);
+    return {
+        cols: Math.max(0, cols),
+        rows: Math.max(0, rows),
+        total: Math.max(0, cols * rows),
+    };
+}
+function pickBestSplitPane(panes) {
+    if (panes.length === 0) {
+        return undefined;
+    }
+    return panes.reduce((best, pane) => {
+        const bestArea = best.width * best.height;
+        const area = pane.width * pane.height;
+        return area > bestArea ? pane : best;
+    });
+}
+function chooseSplitDirection(pane, minAgentWidth) {
+    const canSplitHorizontally = pane.width >= minAgentWidth * 2;
+    const canSplitVertically = pane.height >= MIN_PANE_HEIGHT * 2;
+    if (canSplitHorizontally && canSplitVertically) {
+        return pane.width >= pane.height ? '-h' : '-v';
+    }
+    if (canSplitHorizontally)
+        return '-h';
+    if (canSplitVertically)
+        return '-v';
+    return '-h';
+}
+function canSplitPane(pane, direction, minAgentWidth) {
+    if (direction === '-h') {
+        return canSplitHorizontally(pane, minAgentWidth);
+    }
+    return pane.height >= MIN_PANE_HEIGHT * 2;
+}
+function canSplitHorizontally(pane, minAgentWidth) {
+    return pane.width >= minAgentWidth * 2;
+}
+function pickReplacementPane(state, sessionMappings) {
+    const panesById = new Set(state.agentPanes.map((pane) => pane.paneId));
+    const candidates = sessionMappings.filter((mapping) => panesById.has(mapping.paneId));
+    if (candidates.length === 0)
+        return null;
+    return candidates.reduce((oldest, entry) => entry.createdAt.getTime() < oldest.createdAt.getTime() ? entry : oldest);
+}
+/**
+ * Pick the oldest pane from session mappings (LRU - Least Recently Used)
+ * Used for rotation when maxPanes limit is reached
+ */
+function pickOldestPane(sessionMappings) {
+    if (sessionMappings.length === 0)
+        return null;
+    return sessionMappings.reduce((oldest, entry) => entry.createdAt.getTime() < oldest.createdAt.getTime() ? entry : oldest);
+}
+//# sourceMappingURL=decision-engine.js.map

package/dist/tmux/decision-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-engine.js","sourceRoot":"","sources":["../../src/tmux/decision-engine.ts"],"names":[],"mappings":"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"}

package/dist/tmux/executor.d.ts

@@ -0,0 +1,56 @@
+import type { PaneAction, WindowState, TmuxConfig } from './types';
+export interface ActionResult {
+    success: boolean;
+    paneId?: string;
+    windowId?: string;
+    error?: string;
+}
+/**
+ * Execute a single pane action
+ *
+ * All agents spawn in a dedicated "Agents" window with tiled grid layout.
+ */
+export declare function executeAction(action: PaneAction, ctx: {
+    config: TmuxConfig;
+    serverUrl: string;
+    windowState: WindowState;
+}): Promise<ActionResult>;
+/**
+ * Execute multiple actions in sequence
+ */
+export declare function executeActions(actions: PaneAction[], ctx: {
+    config: TmuxConfig;
+    serverUrl: string;
+    windowState: WindowState;
+}): Promise<{
+    success: boolean;
+    spawnedPaneId?: string;
+    results: Array<{
+        action: PaneAction;
+        result: ActionResult;
+    }>;
+}>;
+/**
+ * Close a pane by its ID
+ * Exported for use by TmuxSessionManager when sessions complete
+ */
+export declare function closePaneById(paneId: string): Promise<ActionResult>;
+/**
+ * Reset the agents window state (for cleanup)
+ */
+export declare function resetAgentsWindow(): void;
+/**
+ * Close the agents window if it exists
+ * This kills the entire window, which closes all panes within it
+ */
+export declare function closeAgentsWindow(): Promise<void>;
+/**
+ * Synchronously close the agents window (for shutdown)
+ * Uses spawnSync to ensure it completes before process exit
+ */
+export declare function closeAgentsWindowSync(): void;
+/**
+ * Get the current agents window ID (for testing/debugging)
+ */
+export declare function getAgentsWindowId(): string | undefined;
+//# sourceMappingURL=executor.d.ts.map

package/dist/tmux/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tmux/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAenE,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAOD;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,GACtE,OAAO,CAAC,YAAY,CAAC,CASvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,GACtE,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CAC7D,CAAC,CAgBD;AAcD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAMzE;AAyJD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD"}