@moxxy/core 0.3.0

package/dist/setup-agent.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `setupAgent` — the one-call ergonomic entry to the moxxy runtime.
+ *
+ * Constructing a {@link Session}, registering a mode + provider plugins + tools,
+ * activating a provider, and calling {@link runTurn} is the standard boilerplate.
+ * This wraps all of it in a single SYNCHRONOUS call and hands back a small
+ * {@link Agent} you destructure:
+ *
+ *   import { setupAgent } from '@moxxy/core';
+ *   import defaultMode from '@moxxy/mode-default';
+ *   import openai from '@moxxy/plugin-provider-openai';
+ *
+ *   const { ask, stream, session } = setupAgent({
+ *     plugins: [defaultMode, openai],
+ *     provider: { name: 'openai', config: { apiKey: process.env.OPENAI_API_KEY } },
+ *     tools: [myTool],
+ *   });
+ *
+ *   console.log(await ask('Hello!'));               // final reply text (async)
+ *   for await (const e of stream('Go on…')) { … }   // event stream (async generator)
+ *
+ * Two ways to run a turn: `stream()` is a proper async generator that YIELDS each
+ * {@link MoxxyEvent} as it happens; `ask()`/`collect()` are async — the final
+ * text, or every event. The methods close over the session (no `this`), so
+ * destructuring is safe. `session` is the LIVE session — hot-change blocks
+ * between turns through it (or the `setProvider`/`setMode`/`use`/`addTool` sugar).
+ * It stays block-agnostic: you pass the provider/mode PLUGINS in, so `@moxxy/core`
+ * never depends on a vendor.
+ */
+import type { MoxxyEvent, PermissionResolver, Plugin, RunTurnOptions, ToolDef } from '@moxxy/sdk';
+import { Session, type SessionOptions } from './session.js';
+export interface SetupAgentOptions {
+    /** Working directory the agent operates in. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+    /** Plugins to register up front — modes, providers, tool-packs, … (order kept). */
+    readonly plugins?: readonly Plugin[];
+    /** Tools to register directly (sugar over authoring a one-tool plugin). */
+    readonly tools?: readonly ToolDef[];
+    /** Activate a provider after registration: its registered `name` + the config
+     *  its `createClient` needs (e.g. `{ apiKey }`). */
+    readonly provider?: {
+        readonly name: string;
+        readonly config?: Record<string, unknown>;
+    };
+    /** Permission policy: `'auto'` (approve every tool call — frictionless headless
+     *  default), `'deny'` (refuse all), or a custom {@link PermissionResolver}. */
+    readonly permissions?: 'auto' | 'deny' | PermissionResolver;
+    /** Any other {@link SessionOptions} (logger, secretResolver, pluginLoader,
+     *  pluginDiscoveryPaths, …). */
+    readonly session?: Omit<SessionOptions, 'cwd' | 'permissionResolver'>;
+}
+export interface Agent {
+    /** The underlying live {@link Session} — full control + hot-change escape hatch
+     *  (`session.providers`, `session.tools`, `session.modes`, `session.pluginHost`). */
+    readonly session: Session;
+    /** Run one turn as an async generator, YIELDING each event as it happens:
+     *  `for await (const e of stream(prompt)) …`. */
+    stream(prompt: string, opts?: RunTurnOptions): AsyncGenerator<MoxxyEvent, void, void>;
+    /** Run one turn; resolve with the final assistant text (`''` if none). */
+    ask(prompt: string, opts?: RunTurnOptions): Promise<string>;
+    /** Run one turn; resolve with every emitted event. */
+    collect(prompt: string, opts?: RunTurnOptions): Promise<ReadonlyArray<MoxxyEvent>>;
+    /** Discover + load plugins from `node_modules` (and `pluginDiscoveryPaths`).
+     *  Async; resolves with this agent for chaining. */
+    discover(): Promise<Agent>;
+    /** Register another plugin (mode / provider / tool-pack) on the live session. */
+    use(plugin: Plugin): Agent;
+    /** Register a tool on the live session. */
+    addTool(tool: ToolDef): Agent;
+    /** Remove a registered tool by name. */
+    removeTool(name: string): Agent;
+    /** Swap the active provider (and its config) for subsequent turns. */
+    setProvider(name: string, config?: Record<string, unknown>): Agent;
+    /** Swap the active loop strategy (mode) for subsequent turns. */
+    setMode(name: string): Agent;
+}
+/** A reusable, pre-filled chunk of {@link SetupAgentOptions} — e.g. a provider
+ *  "preset" that bundles a provider plugin + the default mode + its config, so
+ *  `setupAgent(openaiPreset({ apiKey }))` is a one-line drop-in. A preset is just
+ *  an options object, so presets compose: pass an array and they merge. */
+export type AgentPreset = SetupAgentOptions;
+/**
+ * Build a ready-to-run {@link Agent}. Synchronous — destructure the result.
+ * Accepts a full options object, a single {@link AgentPreset}, or an ARRAY of
+ * presets that are merged (see {@link mergePresets}):
+ *
+ *   setupAgent(openaiPreset({ apiKey }))
+ *   setupAgent([openaiPreset({ apiKey }), anthropicPreset({ apiKey })]) // both; openai active
+ */
+export declare function setupAgent(input?: SetupAgentOptions | readonly SetupAgentOptions[]): Agent;
+//# sourceMappingURL=setup-agent.d.ts.map

package/dist/setup-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-agent.d.ts","sourceRoot":"","sources":["../src/setup-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAElG,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAI5D,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC;wDACoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACzF;mFAC+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,CAAC;IAC5D;oCACgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,oBAAoB,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,KAAK;IACpB;yFACqF;IACrF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;qDACiD;IACjD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtF,0EAA0E;IAC1E,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,sDAAsD;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACnF;wDACoD;IACpD,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAG3B,iFAAiF;IACjF,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,2CAA2C;IAC3C,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAC9B,wCAAwC;IACxC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,sEAAsE;IACtE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IACnE,iEAAiE;IACjE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CAC9B;AAgBD;;;2EAG2E;AAC3E,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AA8B5C;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAO,GAAG,KAAK,CAiD9F"}

package/dist/setup-agent.js

@@ -0,0 +1,138 @@
+/**
+ * `setupAgent` — the one-call ergonomic entry to the moxxy runtime.
+ *
+ * Constructing a {@link Session}, registering a mode + provider plugins + tools,
+ * activating a provider, and calling {@link runTurn} is the standard boilerplate.
+ * This wraps all of it in a single SYNCHRONOUS call and hands back a small
+ * {@link Agent} you destructure:
+ *
+ *   import { setupAgent } from '@moxxy/core';
+ *   import defaultMode from '@moxxy/mode-default';
+ *   import openai from '@moxxy/plugin-provider-openai';
+ *
+ *   const { ask, stream, session } = setupAgent({
+ *     plugins: [defaultMode, openai],
+ *     provider: { name: 'openai', config: { apiKey: process.env.OPENAI_API_KEY } },
+ *     tools: [myTool],
+ *   });
+ *
+ *   console.log(await ask('Hello!'));               // final reply text (async)
+ *   for await (const e of stream('Go on…')) { … }   // event stream (async generator)
+ *
+ * Two ways to run a turn: `stream()` is a proper async generator that YIELDS each
+ * {@link MoxxyEvent} as it happens; `ask()`/`collect()` are async — the final
+ * text, or every event. The methods close over the session (no `this`), so
+ * destructuring is safe. `session` is the LIVE session — hot-change blocks
+ * between turns through it (or the `setProvider`/`setMode`/`use`/`addTool` sugar).
+ * It stays block-agnostic: you pass the provider/mode PLUGINS in, so `@moxxy/core`
+ * never depends on a vendor.
+ */
+import { Session } from './session.js';
+import { runTurn, collectTurn } from './run-turn.js';
+import { autoAllowResolver, denyByDefaultResolver } from './permissions/resolvers.js';
+function resolvePermissions(p) {
+    if (p === 'deny')
+        return denyByDefaultResolver;
+    if (p === undefined || p === 'auto')
+        return autoAllowResolver;
+    return p;
+}
+function finalText(events) {
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const e = events[i];
+        if (e.type === 'assistant_message')
+            return e.content;
+    }
+    return '';
+}
+/** Merge an array of presets into one options object: plugins concatenate
+ *  (de-duped by name, so two presets both bringing the default mode register it
+ *  once), tools concatenate, and the FIRST preset that names a provider wins as
+ *  the active one (the others are still registered, so you can `setProvider` to
+ *  swap). cwd/permissions take the first set; session options shallow-merge. */
+function mergePresets(presets) {
+    const plugins = [];
+    const seen = new Set();
+    const tools = [];
+    let provider;
+    let cwd;
+    let permissions;
+    let session;
+    for (const p of presets) {
+        for (const pl of p.plugins ?? []) {
+            if (seen.has(pl.name))
+                continue;
+            seen.add(pl.name);
+            plugins.push(pl);
+        }
+        if (p.tools)
+            tools.push(...p.tools);
+        if (!provider && p.provider)
+            provider = p.provider;
+        cwd ??= p.cwd;
+        permissions ??= p.permissions;
+        if (p.session)
+            session = { ...session, ...p.session };
+    }
+    return { plugins, tools, provider, cwd, permissions, session };
+}
+/**
+ * Build a ready-to-run {@link Agent}. Synchronous — destructure the result.
+ * Accepts a full options object, a single {@link AgentPreset}, or an ARRAY of
+ * presets that are merged (see {@link mergePresets}):
+ *
+ *   setupAgent(openaiPreset({ apiKey }))
+ *   setupAgent([openaiPreset({ apiKey }), anthropicPreset({ apiKey })]) // both; openai active
+ */
+export function setupAgent(input = {}) {
+    const opts = Array.isArray(input) ? mergePresets(input) : input;
+    const session = new Session({
+        cwd: opts.cwd ?? process.cwd(),
+        permissionResolver: resolvePermissions(opts.permissions),
+        ...opts.session,
+    });
+    for (const plugin of opts.plugins ?? [])
+        session.pluginHost.registerStatic(plugin);
+    for (const tool of opts.tools ?? [])
+        session.tools.register(tool);
+    if (opts.provider)
+        session.providers.setActive(opts.provider.name, opts.provider.config);
+    const agent = {
+        session,
+        async *stream(prompt, runOpts) {
+            yield* runTurn(session, prompt, runOpts);
+        },
+        async ask(prompt, runOpts) {
+            return finalText(await collectTurn(session, prompt, runOpts));
+        },
+        collect(prompt, runOpts) {
+            return collectTurn(session, prompt, runOpts);
+        },
+        async discover() {
+            await session.pluginHost.discoverAndLoad();
+            return agent;
+        },
+        use(plugin) {
+            session.pluginHost.registerStatic(plugin);
+            return agent;
+        },
+        addTool(tool) {
+            session.tools.register(tool);
+            return agent;
+        },
+        removeTool(name) {
+            session.tools.unregister(name);
+            return agent;
+        },
+        setProvider(name, config) {
+            session.providers.setActive(name, config);
+            return agent;
+        },
+        setMode(name) {
+            session.modes.setActive(name);
+            return agent;
+        },
+    };
+    return agent;
+}
+//# sourceMappingURL=setup-agent.js.map

package/dist/setup-agent.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,4 @@
+export { parseSkillFile, parseFrontmatter } from './parse.js';
+export { discoverSkills, defaultUserSkillsDir, defaultProjectSkillsDir, type SkillLoadOptions, type DiscoveredSkill, } from './loader.js';
+export { synthesizeSkill, buildSynthesizeSkillPlugin, type SynthesizeOptions, type SynthesizedSkill, } from './synthesize.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,4 @@
+export { parseSkillFile, parseFrontmatter } from './parse.js';
+export { discoverSkills, defaultUserSkillsDir, defaultProjectSkillsDir, } from './loader.js';
+export { synthesizeSkill, buildSynthesizeSkillPlugin, } from './synthesize.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,0BAA0B,GAG3B,MAAM,iBAAiB,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,16 @@
+import { type Skill, type SkillScope } from '@moxxy/sdk';
+import type { Logger } from '../logger.js';
+export interface SkillLoadOptions {
+    readonly projectDir?: string;
+    readonly userDir?: string;
+    readonly pluginDirs?: ReadonlyArray<string>;
+    readonly builtinDir?: string;
+    readonly logger?: Logger;
+}
+export interface DiscoveredSkill extends Skill {
+    readonly scope: SkillScope;
+}
+export declare function discoverSkills(opts?: SkillLoadOptions): Promise<ReadonlyArray<DiscoveredSkill>>;
+export declare function defaultUserSkillsDir(): string;
+export declare function defaultProjectSkillsDir(cwd: string): string;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAczG;AA0ED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/skills/loader.js

@@ -0,0 +1,99 @@
+import { promises as fs } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { skillFrontmatterSchema, asSkillId } from '@moxxy/sdk';
+import { parseSkillFile } from './parse.js';
+export async function discoverSkills(opts = {}) {
+    const sources = [];
+    if (opts.builtinDir)
+        sources.push({ dir: opts.builtinDir, scope: 'builtin' });
+    for (const dir of opts.pluginDirs ?? [])
+        sources.push({ dir, scope: 'plugin' });
+    const userDir = opts.userDir ?? defaultUserSkillsDir();
+    sources.push({ dir: userDir, scope: 'user' });
+    if (opts.projectDir)
+        sources.push({ dir: opts.projectDir, scope: 'project' });
+    const seenNames = new Map();
+    for (const source of sources) {
+        const skills = await loadDir(source.dir, source.scope, opts.logger);
+        for (const skill of skills)
+            seenNames.set(skill.frontmatter.name, skill);
+    }
+    return [...seenNames.values()];
+}
+async function loadDir(dir, scope, logger) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            out.push(...(await loadDir(path.join(dir, entry.name), scope, logger)));
+            continue;
+        }
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const full = path.join(dir, entry.name);
+        let raw;
+        try {
+            raw = await fs.readFile(full, 'utf8');
+        }
+        catch (err) {
+            // One unreadable .md (permission, race-deleted, symlink loop) must not
+            // abort discovery of every remaining skill across every source — degrade
+            // to skipping just this file, like the invalid-frontmatter case below.
+            logger?.warn('skill: unreadable file, skipping', {
+                path: full,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        const { frontmatter, body } = parseSkillFile(raw);
+        const parsed = skillFrontmatterSchema.safeParse(frontmatter);
+        if (!parsed.success) {
+            logger?.warn('skill: invalid frontmatter, skipping', { path: full, issues: parsed.error.issues });
+            continue;
+        }
+        // Auto-derive trigger fallbacks from the skill name when the
+        // frontmatter `triggers:` field is missing/empty. Without this,
+        // user-authored skills (or model-synthesized ones that skipped the
+        // field) have no triggers at all — they're effectively invisible
+        // to the trigger-match router and confusing in /skills listings.
+        // We split the kebab-case name into words and also keep the full
+        // slug as a literal trigger.
+        const fm = parsed.data;
+        const finalTriggers = fm.triggers && fm.triggers.length > 0 ? fm.triggers : deriveTriggers(fm.name);
+        out.push({
+            id: asSkillId(`${scope}/${fm.name}`),
+            path: full,
+            scope,
+            frontmatter: { ...fm, triggers: finalTriggers },
+            body: body.trimEnd(),
+        });
+    }
+    return out;
+}
+/**
+ * Derive trigger-like phrases from a kebab-case skill name. Best-effort
+ * fallback for skills whose frontmatter omits the `triggers:` field —
+ * gives the router and `/skills` listing *something* to show.
+ */
+function deriveTriggers(name) {
+    const parts = name.split('-').filter((p) => p.length > 1);
+    const out = new Set();
+    out.add(name.replace(/-/g, ' '));
+    for (const p of parts)
+        out.add(p);
+    return [...out];
+}
+export function defaultUserSkillsDir() {
+    return path.join(os.homedir(), '.moxxy', 'skills');
+}
+export function defaultProjectSkillsDir(cwd) {
+    return path.join(cwd, '.moxxy', 'skills');
+}
+//# 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/parse.d.ts

@@ -0,0 +1,5 @@
+import { parseFrontmatterFile, type ParsedFrontmatter } from '@moxxy/sdk';
+export type ParsedSkillFile = ParsedFrontmatter;
+export declare const parseSkillFile: typeof parseFrontmatterFile;
+export { parseFrontmatter } from '@moxxy/sdk';
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/skills/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEhD,eAAO,MAAM,cAAc,6BAAuB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/skills/parse.js

@@ -0,0 +1,8 @@
+// The skill frontmatter parser now lives canonically in @moxxy/sdk
+// (`parseFrontmatterFile`/`parseFrontmatter`), shared with plugin-memory so the
+// previously-copy-pasted copies can't diverge. This module keeps the historical
+// `parseSkillFile`/`ParsedSkillFile` names as thin re-exports.
+import { parseFrontmatterFile } from '@moxxy/sdk';
+export const parseSkillFile = parseFrontmatterFile;
+export { parseFrontmatter } from '@moxxy/sdk';
+//# sourceMappingURL=parse.js.map

package/dist/skills/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/skills/parse.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,gFAAgF;AAChF,gFAAgF;AAChF,+DAA+D;AAC/D,OAAO,EAAE,oBAAoB,EAA0B,MAAM,YAAY,CAAC;AAI1E,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/skills/synthesize-draft.d.ts

@@ -0,0 +1,8 @@
+import type { LLMProvider } from '@moxxy/sdk';
+export interface DraftedSkill {
+    raw: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function draftSkill(provider: LLMProvider, model: string, intent: string, signal: AbortSignal): Promise<DraftedSkill>;
+//# sourceMappingURL=synthesize-draft.d.ts.map

package/dist/skills/synthesize-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-draft.d.ts","sourceRoot":"","sources":["../../src/skills/synthesize-draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAkBvB"}

package/dist/skills/synthesize-draft.js

@@ -0,0 +1,32 @@
+import { parseSkillFile } from './parse.js';
+const DRAFT_SYSTEM_PROMPT = `You are a skill-author. Output ONLY a Markdown file with YAML frontmatter. No prose outside the Markdown. Frontmatter MUST include:
+- name (kebab-case slug, <=60 chars, lowercase letters/numbers/hyphens only, starting with a letter)
+- description (1 sentence, <=120 chars)
+- triggers (array of 2-5 short phrases the user might say)
+- allowed-tools (array of tool names, e.g. ["Read", "Edit", "Bash"])
+
+The body is the instructions for future invocations. Keep it under 30 lines. Numbered steps preferred.`;
+export async function draftSkill(provider, model, intent, signal) {
+    let accumulated = '';
+    for await (const event of provider.stream({
+        model,
+        system: DRAFT_SYSTEM_PROMPT,
+        messages: [{ role: 'user', content: [{ type: 'text', text: `User intent: ${intent}` }] }],
+        maxTokens: 2000,
+        signal,
+    })) {
+        if (event.type === 'text_delta')
+            accumulated += event.delta;
+        if (event.type === 'error') {
+            throw new Error(`synthesizeSkill: provider error: ${event.message}`);
+        }
+    }
+    const raw = extractMarkdownBlock(accumulated);
+    const { frontmatter, body } = parseSkillFile(raw);
+    return { raw, frontmatter: frontmatter, body };
+}
+function extractMarkdownBlock(s) {
+    const fence = /```(?:markdown|md)?\n([\s\S]*?)```/.exec(s);
+    return fence ? fence[1] : s;
+}
+//# sourceMappingURL=synthesize-draft.js.map

package/dist/skills/synthesize-draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-draft.js","sourceRoot":"","sources":["../../src/skills/synthesize-draft.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQ5C,MAAM,mBAAmB,GAAG;;;;;;uGAM2E,CAAC;AAExG,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAqB,EACrB,KAAa,EACb,MAAc,EACd,MAAmB;IAEnB,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;QACxC,KAAK;QACL,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACzF,SAAS,EAAE,IAAI;QACf,MAAM;KACP,CAAC,EAAE,CAAC;QACH,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC;QAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,WAAsC,EAAE,IAAI,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,oBAAoB,CAAC,CAAS;IACrC,MAAM,KAAK,GAAG,oCAAoC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/skills/synthesize.d.ts

@@ -0,0 +1,33 @@
+import { type Plugin, type Skill, type SkillScope, type TurnId } from '@moxxy/sdk';
+import type { Session } from '../session.js';
+export interface SynthesizeOptions {
+    readonly userDir?: string;
+    readonly projectDir?: string;
+    readonly model?: string;
+    readonly auditPath?: string;
+    /**
+     * Directory holding builtin skills (`@moxxy/skills-builtin`). Threaded
+     * through so `reload_skills` can rescan the same source set as the boot
+     * loader — otherwise reload silently drops the builtins, observed when
+     * a session called `reload_skills` and lost every shipped skill.
+     */
+    readonly builtinDir?: string;
+    /** Extra plugin-supplied skill directories. Same boot-vs-reload story. */
+    readonly pluginDirs?: ReadonlyArray<string>;
+}
+export interface SynthesizedSkill {
+    readonly skill: Skill;
+    readonly path: string;
+    readonly scope: SkillScope;
+}
+export declare function synthesizeSkill(session: Session, intent: string, scope: 'user' | 'project', opts?: SynthesizeOptions, 
+/**
+ * The active turn's id, threaded from the tool's `ctx.turnId`. The
+ * `skill_created` event MUST carry it so run-turn's per-turn subscriber
+ * (`event.turnId !== turnId → drop`) doesn't filter the event out of the
+ * running turn's stream. Falls back to a fresh turn only for legacy callers
+ * that invoke this outside a turn.
+ */
+turnId?: TurnId): Promise<SynthesizedSkill>;
+export declare function buildSynthesizeSkillPlugin(session: Session, opts?: SynthesizeOptions): Plugin;
+//# sourceMappingURL=synthesize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../src/skills/synthesize.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,GAAE,iBAAsB;AAC5B;;;;;;GAMG;AACH,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAwE3B;AAkCD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,iBAAsB,GAC3B,MAAM,CA8IR"}