@hybridaione/hybridclaw 0.1.5

package/dist/scheduler.js

@@ -0,0 +1,165 @@
+/**
+ * Scheduler — timer-based, arms for exact next-fire time.
+ *
+ * Instead of polling every 60s, computes when the next task is due and
+ * sets a single setTimeout for that moment.  Re-arms after every tick
+ * and whenever a task is added/removed via rearmScheduler().
+ */
+import { CronExpressionParser } from 'cron-parser';
+import { deleteTask, getAllEnabledTasks, updateTaskLastRun } from './db.js';
+import { logger } from './logger.js';
+const MAX_TIMER_DELAY_MS = 300_000; // 5 min safety net for clock drift
+let timer = null;
+let taskRunner = null;
+let ticking = false;
+// --- Prompt framing (OpenClaw style) ---
+function formatFireTime() {
+    return new Date().toLocaleString('en-US', {
+        weekday: 'short',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        timeZoneName: 'short',
+    });
+}
+export function wrapCronPrompt(taskId, taskName, message) {
+    const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return `[cron:#${taskId} ${taskName}] ${message}\nCurrent time: ${formatFireTime()} (${tz})\n\nReturn your response as plain text; it will be delivered automatically. If the task explicitly calls for messaging a specific external recipient, note who/where it should go instead of sending it yourself.`;
+}
+// --- Timer logic ---
+function computeNextFireMs() {
+    const tasks = getAllEnabledTasks();
+    let earliest = null;
+    for (const task of tasks) {
+        if (task.run_at) {
+            if (!task.last_run) {
+                const ms = new Date(task.run_at).getTime();
+                if (earliest === null || ms < earliest)
+                    earliest = ms;
+            }
+            continue;
+        }
+        if (task.every_ms) {
+            const lastRunMs = task.last_run ? new Date(task.last_run).getTime() : 0;
+            const nextMs = lastRunMs > 0 ? lastRunMs + task.every_ms : Date.now();
+            if (earliest === null || nextMs < earliest)
+                earliest = nextMs;
+            continue;
+        }
+        if (!task.cron_expr)
+            continue;
+        try {
+            const ms = CronExpressionParser.parse(task.cron_expr).next().toDate().getTime();
+            if (earliest === null || ms < earliest)
+                earliest = ms;
+        }
+        catch { /* skip invalid */ }
+    }
+    return earliest;
+}
+function arm() {
+    if (timer)
+        clearTimeout(timer);
+    timer = null;
+    const nextFireMs = computeNextFireMs();
+    if (nextFireMs === null)
+        return; // nothing scheduled
+    const delay = Math.max(nextFireMs - Date.now(), 0);
+    const clamped = Math.min(delay, MAX_TIMER_DELAY_MS);
+    logger.debug({ delayMs: clamped, nextFire: new Date(nextFireMs).toISOString() }, 'Scheduler armed');
+    timer = setTimeout(() => {
+        void tick().catch((err) => {
+            logger.error({ err }, 'Scheduler tick failed');
+            arm(); // re-arm even on error
+        });
+    }, clamped);
+}
+async function tick() {
+    if (ticking) {
+        arm(); // re-check later
+        return;
+    }
+    ticking = true;
+    try {
+        const tasks = getAllEnabledTasks();
+        const now = new Date();
+        for (const task of tasks) {
+            try {
+                // --- One-shot task ---
+                if (task.run_at) {
+                    const runAt = new Date(task.run_at);
+                    if (runAt.getTime() <= now.getTime() && !task.last_run) {
+                        logger.info({ taskId: task.id, runAt: task.run_at, prompt: task.prompt }, 'One-shot task firing');
+                        updateTaskLastRun(task.id); // prevents re-fire
+                        const prompt = wrapCronPrompt(task.id, task.prompt, task.prompt);
+                        taskRunner(task.session_id, task.channel_id, prompt, task.id)
+                            .then(() => deleteTask(task.id)) // cleanup on success
+                            .catch((err) => {
+                            logger.error({ taskId: task.id, err }, 'One-shot task failed (task preserved)');
+                        });
+                    }
+                    continue;
+                }
+                // --- Interval task ---
+                if (task.every_ms) {
+                    const lastRunMs = task.last_run ? new Date(task.last_run).getTime() : 0;
+                    const dueAt = lastRunMs > 0 ? lastRunMs + task.every_ms : 0; // fire immediately if never run
+                    if (dueAt <= now.getTime()) {
+                        logger.info({ taskId: task.id, everyMs: task.every_ms, prompt: task.prompt }, 'Interval task firing');
+                        updateTaskLastRun(task.id);
+                        const prompt = wrapCronPrompt(task.id, task.prompt, task.prompt);
+                        taskRunner(task.session_id, task.channel_id, prompt, task.id).catch((err) => {
+                            logger.error({ taskId: task.id, err }, 'Interval task failed');
+                        });
+                    }
+                    continue;
+                }
+                // --- Recurring cron task ---
+                if (!task.cron_expr)
+                    continue;
+                const cron = CronExpressionParser.parse(task.cron_expr);
+                const prev = cron.prev();
+                const lastRun = task.last_run ? new Date(task.last_run) : new Date(0);
+                if (prev.toDate() > lastRun) {
+                    logger.info({ taskId: task.id, cron: task.cron_expr, prompt: task.prompt }, 'Cron task firing');
+                    updateTaskLastRun(task.id);
+                    const prompt = wrapCronPrompt(task.id, task.prompt, task.prompt);
+                    taskRunner(task.session_id, task.channel_id, prompt, task.id).catch((err) => {
+                        logger.error({ taskId: task.id, err }, 'Cron task failed');
+                    });
+                }
+            }
+            catch (err) {
+                logger.error({ taskId: task.id, cron: task.cron_expr, err }, 'Scheduler error for task');
+            }
+        }
+    }
+    finally {
+        ticking = false;
+        arm(); // re-arm for next task
+    }
+}
+// --- Public API ---
+export function startScheduler(runner) {
+    logger.info('Scheduler started');
+    taskRunner = runner;
+    arm();
+}
+/**
+ * Re-arm the scheduler timer.  Call after creating or deleting tasks
+ * so newly scheduled work is picked up immediately.
+ */
+export function rearmScheduler() {
+    if (taskRunner)
+        arm();
+}
+export function stopScheduler() {
+    if (timer) {
+        clearTimeout(timer);
+        timer = null;
+    }
+    taskRunner = null;
+    logger.info('Scheduler stopped');
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/session-maintenance.d.ts

@@ -0,0 +1,9 @@
+export declare function maybeCompactSession(params: {
+    sessionId: string;
+    agentId: string;
+    chatbotId: string;
+    enableRag: boolean;
+    model: string;
+    channelId: string;
+}): Promise<void>;
+//# sourceMappingURL=session-maintenance.d.ts.map

package/dist/session-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-maintenance.d.ts","sourceRoot":"","sources":["../src/session-maintenance.ts"],"names":[],"mappings":"AAsNA,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyChB"}

package/dist/session-maintenance.js

@@ -0,0 +1,168 @@
+import { PRE_COMPACTION_MEMORY_FLUSH_ENABLED, PRE_COMPACTION_MEMORY_FLUSH_MAX_CHARS, PRE_COMPACTION_MEMORY_FLUSH_MAX_MESSAGES, SESSION_COMPACTION_ENABLED, SESSION_COMPACTION_KEEP_RECENT, SESSION_COMPACTION_SUMMARY_MAX_CHARS, SESSION_COMPACTION_THRESHOLD, } from './config.js';
+import { deleteMessagesBeforeId, getCompactionCandidateMessages, getSessionById, markSessionMemoryFlush, updateSessionSummary, } from './db.js';
+import { logger } from './logger.js';
+import { loadSkills } from './skills.js';
+import { runAgent } from './agent.js';
+import { buildSystemPromptFromHooks } from './prompt-hooks.js';
+const COMPACTION_SOURCE_MAX_MESSAGES = 240;
+const COMPACTION_SOURCE_MAX_CHARS = 80_000;
+function formatDateStampInLocalTimezone(now) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    }).formatToParts(now);
+    const year = parts.find((part) => part.type === 'year')?.value;
+    const month = parts.find((part) => part.type === 'month')?.value;
+    const day = parts.find((part) => part.type === 'day')?.value;
+    if (year && month && day) {
+        return `${year}-${month}-${day}`;
+    }
+    return now.toISOString().slice(0, 10);
+}
+function normalizeSummary(summary) {
+    let text = summary.trim();
+    if (text.startsWith('```')) {
+        text = text.replace(/^```[a-z0-9_-]*\s*/i, '').replace(/```$/i, '').trim();
+    }
+    if (text.length > SESSION_COMPACTION_SUMMARY_MAX_CHARS) {
+        text = `${text.slice(0, SESSION_COMPACTION_SUMMARY_MAX_CHARS)}\n\n...[truncated]`;
+    }
+    return text;
+}
+function formatMessagesForPrompt(messages, maxMessages, maxChars) {
+    const selected = messages.slice(-Math.max(1, maxMessages));
+    const lines = [];
+    let usedChars = 0;
+    for (const msg of selected) {
+        const role = (msg.role || 'unknown').toUpperCase();
+        const compact = msg.content.replace(/\r/g, '').trim();
+        const bounded = compact.length > 1_200 ? `${compact.slice(0, 1_200)}\n...[truncated]` : compact;
+        const entry = `[${role}] ${bounded}`;
+        const bytes = entry.length + 2;
+        if (usedChars + bytes > maxChars)
+            break;
+        usedChars += bytes;
+        lines.push(entry);
+    }
+    return lines.join('\n\n');
+}
+function buildSystemPrompt(agentId, sessionSummary, extra) {
+    return buildSystemPromptFromHooks({
+        agentId,
+        sessionSummary,
+        skills: loadSkills(agentId),
+        purpose: 'memory-flush',
+        extraSafetyText: extra,
+    });
+}
+async function runPreCompactionMemoryFlush(params) {
+    if (!PRE_COMPACTION_MEMORY_FLUSH_ENABLED)
+        return;
+    const transcript = formatMessagesForPrompt(params.olderMessages, PRE_COMPACTION_MEMORY_FLUSH_MAX_MESSAGES, PRE_COMPACTION_MEMORY_FLUSH_MAX_CHARS);
+    if (!transcript)
+        return;
+    const now = new Date();
+    const dateStamp = formatDateStampInLocalTimezone(now);
+    const flushPrompt = [
+        'Pre-compaction memory flush.',
+        `Store durable memories now using MEMORY.md and memory/${dateStamp}.md (create memory/ if needed).`,
+        'IMPORTANT: If a file already exists, append new content only and do not overwrite existing entries.',
+        'Capture only stable, durable facts, preferences, and decisions worth preserving after compaction.',
+        'If there is nothing worth saving, reply MEMORY_FLUSH_SKIPPED.',
+        '',
+        `Current time: ${now.toISOString()}`,
+        '',
+        'Conversation excerpt (about to be compacted):',
+        transcript,
+    ].join('\n');
+    const systemPrompt = buildSystemPrompt(params.agentId, params.sessionSummary, 'Pre-compaction memory flush turn. The session is near auto-compaction; write durable memory to disk.');
+    const messages = [];
+    if (systemPrompt) {
+        messages.push({ role: 'system', content: systemPrompt });
+    }
+    messages.push({ role: 'user', content: flushPrompt });
+    try {
+        const output = await runAgent(`memory-flush:${params.sessionId}:${Date.now()}`, messages, params.chatbotId, params.enableRag, params.model, params.agentId, params.channelId, undefined, ['memory']);
+        if (output.status === 'error') {
+            logger.warn({ sessionId: params.sessionId, error: output.error }, 'Pre-compaction memory flush failed');
+            return;
+        }
+        markSessionMemoryFlush(params.sessionId);
+    }
+    catch (err) {
+        logger.warn({ sessionId: params.sessionId, err }, 'Pre-compaction memory flush crashed');
+    }
+}
+async function generateCompactionSummary(params) {
+    const transcript = formatMessagesForPrompt(params.olderMessages, COMPACTION_SOURCE_MAX_MESSAGES, COMPACTION_SOURCE_MAX_CHARS);
+    if (!transcript)
+        return null;
+    const previous = params.previousSummary?.trim() || '(none)';
+    const systemPrompt = [
+        'You are compressing conversation history for a long-running AI session.',
+        'Return an updated markdown summary that preserves durable context only.',
+        'Focus on goals, decisions, constraints, preferences, and open follow-ups.',
+        'Do not include low-value chatter, greetings, or transient details.',
+        'Return summary text only.',
+    ].join(' ');
+    const userPrompt = [
+        'Existing summary:',
+        previous,
+        '',
+        'Messages to compact:',
+        transcript,
+        '',
+        'Return a single merged summary that should replace the existing summary.',
+    ].join('\n');
+    const output = await runAgent(`compact:${params.sessionId}:${Date.now()}`, [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userPrompt },
+    ], params.chatbotId, params.enableRag, params.model, params.agentId, params.channelId, undefined, []);
+    if (output.status === 'error' || !output.result) {
+        logger.warn({ sessionId: params.sessionId, error: output.error }, 'Session compaction summary failed');
+        return null;
+    }
+    const normalized = normalizeSummary(output.result);
+    if (!normalized)
+        return null;
+    return normalized;
+}
+export async function maybeCompactSession(params) {
+    if (!SESSION_COMPACTION_ENABLED)
+        return;
+    const session = getSessionById(params.sessionId);
+    if (!session)
+        return;
+    const threshold = Math.max(SESSION_COMPACTION_THRESHOLD, 20);
+    const keepRecent = Math.max(1, Math.min(SESSION_COMPACTION_KEEP_RECENT, threshold - 1));
+    if (session.message_count < threshold)
+        return;
+    const candidate = getCompactionCandidateMessages(params.sessionId, keepRecent);
+    if (!candidate || candidate.olderMessages.length === 0)
+        return;
+    await runPreCompactionMemoryFlush({
+        ...params,
+        sessionSummary: session.session_summary,
+        olderMessages: candidate.olderMessages,
+    });
+    const summary = await generateCompactionSummary({
+        ...params,
+        previousSummary: session.session_summary,
+        olderMessages: candidate.olderMessages,
+    });
+    if (!summary)
+        return;
+    const deleted = deleteMessagesBeforeId(params.sessionId, candidate.cutoffId);
+    if (deleted <= 0)
+        return;
+    updateSessionSummary(params.sessionId, summary);
+    logger.info({
+        sessionId: params.sessionId,
+        deleted,
+        cutoffId: candidate.cutoffId,
+        threshold,
+        keepRecent,
+    }, 'Session compacted');
+}
+//# sourceMappingURL=session-maintenance.js.map

package/dist/session-maintenance.js.map

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

package/dist/session-transcripts.d.ts

@@ -0,0 +1,11 @@
+export interface TranscriptEntry {
+    sessionId: string;
+    channelId: string;
+    role: string;
+    userId: string;
+    username: string | null;
+    content: string;
+    createdAt?: string;
+}
+export declare function appendSessionTranscript(agentId: string, entry: TranscriptEntry): void;
+//# sourceMappingURL=session-transcripts.d.ts.map

package/dist/session-transcripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-transcripts.d.ts","sourceRoot":"","sources":["../src/session-transcripts.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAqBrF"}

package/dist/session-transcripts.js

@@ -0,0 +1,32 @@
+import fs from 'fs';
+import path from 'path';
+import { agentWorkspaceDir, ensureAgentDirs } from './ipc.js';
+import { logger } from './logger.js';
+const TRANSCRIPTS_DIR_NAME = '.session-transcripts';
+function safeSessionFilename(sessionId) {
+    const normalized = sessionId.trim().replace(/[^a-zA-Z0-9_-]/g, '_');
+    return normalized || 'session';
+}
+export function appendSessionTranscript(agentId, entry) {
+    try {
+        ensureAgentDirs(agentId);
+        const workspace = agentWorkspaceDir(agentId);
+        const transcriptDir = path.join(workspace, TRANSCRIPTS_DIR_NAME);
+        fs.mkdirSync(transcriptDir, { recursive: true });
+        const filePath = path.join(transcriptDir, `${safeSessionFilename(entry.sessionId)}.jsonl`);
+        const row = {
+            sessionId: entry.sessionId,
+            channelId: entry.channelId,
+            role: entry.role,
+            userId: entry.userId,
+            username: entry.username,
+            content: entry.content,
+            createdAt: entry.createdAt || new Date().toISOString(),
+        };
+        fs.appendFileSync(filePath, JSON.stringify(row) + '\n', 'utf-8');
+    }
+    catch (err) {
+        logger.debug({ agentId, sessionId: entry.sessionId, err }, 'Failed to append session transcript');
+    }
+}
+//# sourceMappingURL=session-transcripts.js.map

package/dist/session-transcripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-transcripts.js","sourceRoot":"","sources":["../src/session-transcripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAYpD,SAAS,mBAAmB,CAAC,SAAiB;IAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,KAAsB;IAC7E,IAAI,CAAC;QACH,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QACjE,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3F,MAAM,GAAG,GAAG;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvD,CAAC;QACF,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,qCAAqC,CAAC,CAAC;IACpG,CAAC;AACH,CAAC"}

package/dist/side-effects.d.ts

@@ -0,0 +1,3 @@
+import type { ContainerOutput } from './types.js';
+export declare function processSideEffects(output: ContainerOutput, sessionId: string, channelId: string): void;
+//# sourceMappingURL=side-effects.d.ts.map

package/dist/side-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effects.d.ts","sourceRoot":"","sources":["../src/side-effects.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI,CA+BN"}

package/dist/side-effects.js

@@ -0,0 +1,30 @@
+import { createTask, deleteTask } from './db.js';
+import { logger } from './logger.js';
+import { rearmScheduler } from './scheduler.js';
+export function processSideEffects(output, sessionId, channelId) {
+    const schedules = output.sideEffects?.schedules;
+    if (!schedules || schedules.length === 0)
+        return;
+    let changed = false;
+    for (const effect of schedules) {
+        try {
+            if (effect.action === 'add') {
+                const taskId = createTask(sessionId, channelId, effect.cronExpr || '', effect.prompt, effect.runAt, effect.everyMs);
+                logger.info({ taskId, sessionId, channelId, cronExpr: effect.cronExpr, runAt: effect.runAt, everyMs: effect.everyMs }, 'Side-effect: created task');
+                changed = true;
+            }
+            else if (effect.action === 'remove') {
+                deleteTask(effect.taskId);
+                logger.info({ taskId: effect.taskId, sessionId }, 'Side-effect: removed task');
+                changed = true;
+            }
+        }
+        catch (err) {
+            logger.error({ effect, err }, 'Failed to process side-effect');
+        }
+    }
+    // Re-arm scheduler so new tasks are picked up immediately
+    if (changed)
+        rearmScheduler();
+}
+//# sourceMappingURL=side-effects.js.map

package/dist/side-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effects.js","sourceRoot":"","sources":["../src/side-effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,UAAU,kBAAkB,CAChC,MAAuB,EACvB,SAAiB,EACjB,SAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC;IAChD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,UAAU,CACvB,SAAS,EACT,SAAS,EACT,MAAM,CAAC,QAAQ,IAAI,EAAE,EACrB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,OAAO,CACf,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,2BAA2B,CAAC,CAAC;gBACpJ,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACtC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,2BAA2B,CAAC,CAAC;gBAC/E,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,+BAA+B,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,IAAI,OAAO;QAAE,cAAc,EAAE,CAAC;AAChC,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,32 @@
+type SkillSource = 'workspace' | 'project' | 'codex' | 'claude';
+export interface Skill {
+    name: string;
+    description: string;
+    userInvocable: boolean;
+    disableModelInvocation: boolean;
+    filePath: string;
+    baseDir: string;
+    source: SkillSource;
+    location: string;
+}
+/**
+ * Expand explicit skill command invocations into a deterministic user payload.
+ * Supports:
+ * - /skill <name> [input]
+ * - /skill:<name> [input]
+ * - /<name> [input] (user-invocable skills)
+ */
+export declare function expandSkillInvocation(content: string, skills: Skill[]): string;
+/**
+ * Load all skills with precedence:
+ * codex/claude managed < project skills < agent workspace skills.
+ * Any non-workspace skill selected by precedence is mirrored into workspace so
+ * the container can read it via /workspace/... paths.
+ */
+export declare function loadSkills(agentId: string): Skill[];
+/**
+ * Build compact CLAUDE/OpenClaw-style skill prompt metadata.
+ */
+export declare function buildSkillsPrompt(skills: Skill[]): string;
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAaA,KAAK,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAYhE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,sBAAsB,EAAE,OAAO,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoRD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAyB9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAuCnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAkCzD"}