@flomatai/core 0.1.0

package/dist/skill.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Skill — the atomic unit of work in flomatai.
+ *
+ * A Skill is a typed, composable function that can:
+ *  - Call an LLM (LLMSkill)
+ *  - Transform data (TransformSkill)
+ *  - Perform IO (IOSkill)
+ *  - Execute Python (PythonSkill via bridge)
+ *  - Wrap a sub-pipeline (CompositeSkill)
+ */
+import type { ZodSchema } from 'zod';
+import type { LLMProvider } from './llm-provider.js';
+import type { StateStore } from './state/types.js';
+import type { Logger } from './logger.js';
+/**
+ * Minimal interface that any MCP client must satisfy.
+ * Defined in core so OrchestratorConfig and SkillContext can reference it
+ * without hard-depending on @flomatai/mcp-client.
+ *
+ * @flomatai/mcp-client's MCPClient class implements this interface.
+ */
+export interface MCPClientLike {
+    /**
+     * List all tools exposed by the connected MCP server.
+     * Returns an array of tool descriptors (name, description, inputSchema).
+     */
+    listTools(): Promise<Array<{
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+    }>>;
+    /**
+     * Call a named tool on the connected MCP server.
+     * @param name  Tool name as returned by listTools().
+     * @param args  Arguments matching the tool's inputSchema.
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+export interface SkillMeta {
+    /** Unique identifier for this skill. Used in pipeline step names. */
+    name: string;
+    /** Human-readable description for agent routing and planning prompts. */
+    description: string;
+    /** Semantic version. */
+    version?: string;
+    /** Categorization tags (e.g. 'llm', 'transform', 'io'). */
+    tags?: string[];
+    /**
+     * Retry configuration.
+     * Defaults to 0 retries (fail immediately).
+     */
+    retries?: number;
+    /**
+     * Per-execution timeout in milliseconds.
+     * 0 or undefined means no timeout.
+     */
+    timeout?: number;
+    /**
+     * Cache configuration. If provided, identical inputs return cached results.
+     */
+    cache?: {
+        /** Time-to-live in seconds. */
+        ttl: number;
+        /** Function that derives a cache key from the input. */
+        key: (input: unknown) => string;
+    };
+}
+export interface SkillContext {
+    /** The LLM bound to this execution context. */
+    llm: LLMProvider;
+    /** Child logger scoped to this skill execution. */
+    logger: Logger;
+    /** State store for caching and cross-step communication. */
+    state: StateStore;
+    /** Emit a named event (for observability / side effects). */
+    emit: (event: string, data: unknown) => void;
+    /** Arbitrary config passed from the orchestrator. */
+    config: Record<string, unknown>;
+    /** Abort signal — check this for graceful cancellation. */
+    abortSignal: AbortSignal;
+    /** ID of the current run. */
+    runId: string;
+    /** LLM registry — retrieve a named LLM by key. */
+    getLLM: (key: string) => LLMProvider;
+    /**
+     * MCP client registry — retrieve a named MCP client by key.
+     * Only present when the Orchestrator is configured with an `mcp` registry.
+     */
+    getMCPClient?: (key: string) => MCPClientLike;
+}
+export interface Skill<TInput = unknown, TOutput = unknown> {
+    /** Metadata describing this skill. */
+    meta: SkillMeta;
+    /** Zod schema for validating input at runtime. */
+    inputSchema: ZodSchema<TInput>;
+    /** Zod schema for validating output at runtime. */
+    outputSchema: ZodSchema<TOutput>;
+    /**
+     * Execute the skill.
+     * @param input Validated input data.
+     * @param ctx   Execution context (LLM, logger, state, etc.).
+     * @returns     Validated output data.
+     */
+    execute(input: TInput, ctx: SkillContext): Promise<TOutput>;
+}
+export interface SkillResult<T = unknown> {
+    output: T;
+    tokensUsed: number;
+    durationMs: number;
+    cached: boolean;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC,CAAC;IACJ;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAID,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,+BAA+B;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,wDAAwD;QACxD,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;KACjC,CAAC;CACH;AAID,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,GAAG,EAAE,WAAW,CAAC;IACjB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,2DAA2D;IAC3D,WAAW,EAAE,WAAW,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;CAC/C;AAID,MAAM,WAAW,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACxD,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,mDAAmD;IACnD,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAID,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,CAAC,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/skill.js

@@ -0,0 +1,12 @@
+/**
+ * Skill — the atomic unit of work in flomatai.
+ *
+ * A Skill is a typed, composable function that can:
+ *  - Call an LLM (LLMSkill)
+ *  - Transform data (TransformSkill)
+ *  - Perform IO (IOSkill)
+ *  - Execute Python (PythonSkill via bridge)
+ *  - Wrap a sub-pipeline (CompositeSkill)
+ */
+export {};
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

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

package/dist/skills/io-skill.d.ts

@@ -0,0 +1,49 @@
+/**
+ * IOSkill — a skill that performs file, HTTP, or other IO operations.
+ *
+ * Thin wrapper around TransformSkill but with 'io' tag and
+ * helper factories for common patterns.
+ */
+import type { Skill } from '../skill.js';
+export declare function createHttpGetSkill(options: {
+    name: string;
+    description?: string;
+    /** URL factory from input. */
+    url: (input: Record<string, unknown>) => string;
+    /** Headers factory from input. */
+    headers?: (input: Record<string, unknown>) => Record<string, string>;
+    /** Parse the response. Default: parse as JSON. */
+    parseResponse?: (body: string, status: number) => unknown;
+    timeout?: number;
+    retries?: number;
+}): Skill;
+export declare function createHttpPostSkill(options: {
+    name: string;
+    description?: string;
+    url: (input: Record<string, unknown>) => string;
+    body: (input: Record<string, unknown>) => unknown;
+    headers?: (input: Record<string, unknown>) => Record<string, string>;
+    parseResponse?: (body: string, status: number) => unknown;
+    timeout?: number;
+}): Skill;
+export declare function createReadFileSkill(options: {
+    name: string;
+    description?: string;
+    path: (input: Record<string, unknown>) => string;
+    encoding?: BufferEncoding;
+}): Skill;
+export declare function createWriteFileSkill(options: {
+    name: string;
+    description?: string;
+    path: (input: Record<string, unknown>) => string;
+    content: (input: Record<string, unknown>) => string;
+    encoding?: BufferEncoding;
+}): Skill;
+/** Namespace export */
+export declare const IOSkill: {
+    httpGet: typeof createHttpGetSkill;
+    httpPost: typeof createHttpPostSkill;
+    readFile: typeof createReadFileSkill;
+    writeFile: typeof createWriteFileSkill;
+};
+//# sourceMappingURL=io-skill.d.ts.map

package/dist/skills/io-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-skill.d.ts","sourceRoot":"","sources":["../../src/skills/io-skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,aAAa,CAAC;AAKvD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IAChD,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrE,kDAAkD;IAClD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,KAAK,CAmBR;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,KAAK,CAoBR;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACjD,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,KAAK,CAaR;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACpD,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,KAAK,CAeR;AAED,uBAAuB;AACvB,eAAO,MAAM,OAAO;;;;;CAKnB,CAAC"}

package/dist/skills/io-skill.js

@@ -0,0 +1,103 @@
+/**
+ * IOSkill — a skill that performs file, HTTP, or other IO operations.
+ *
+ * Thin wrapper around TransformSkill but with 'io' tag and
+ * helper factories for common patterns.
+ */
+import { z } from 'zod';
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { dirname } from 'path';
+import { createTransformSkill } from './transform-skill.js';
+// ── HTTP GET ─────────────────────────────────────────────────────────────────
+export function createHttpGetSkill(options) {
+    return createTransformSkill({
+        name: options.name,
+        description: options.description ?? `HTTP GET skill: ${options.name}`,
+        tags: ['io', 'http'],
+        inputSchema: z.record(z.unknown()),
+        outputSchema: z.unknown(),
+        timeout: options.timeout,
+        async transform(input) {
+            const url = options.url(input);
+            const headers = options.headers?.(input) ?? {};
+            const res = await fetch(url, { headers });
+            const body = await res.text();
+            if (options.parseResponse) {
+                return options.parseResponse(body, res.status);
+            }
+            try {
+                return JSON.parse(body);
+            }
+            catch {
+                return body;
+            }
+        },
+    });
+}
+// ── HTTP POST ────────────────────────────────────────────────────────────────
+export function createHttpPostSkill(options) {
+    return createTransformSkill({
+        name: options.name,
+        description: options.description ?? `HTTP POST skill: ${options.name}`,
+        tags: ['io', 'http'],
+        inputSchema: z.record(z.unknown()),
+        outputSchema: z.unknown(),
+        timeout: options.timeout,
+        async transform(input) {
+            const url = options.url(input);
+            const headers = { 'Content-Type': 'application/json', ...(options.headers?.(input) ?? {}) };
+            const body = JSON.stringify(options.body(input));
+            const res = await fetch(url, { method: 'POST', headers, body });
+            const text = await res.text();
+            if (options.parseResponse) {
+                return options.parseResponse(text, res.status);
+            }
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return text;
+            }
+        },
+    });
+}
+// ── File Read ─────────────────────────────────────────────────────────────────
+export function createReadFileSkill(options) {
+    return createTransformSkill({
+        name: options.name,
+        description: options.description ?? `Read file skill: ${options.name}`,
+        tags: ['io', 'file'],
+        inputSchema: z.record(z.unknown()),
+        outputSchema: z.object({ content: z.string(), path: z.string() }),
+        async transform(input) {
+            const path = options.path(input);
+            const content = await readFile(path, options.encoding ?? 'utf-8');
+            return { content, path };
+        },
+    });
+}
+// ── File Write ────────────────────────────────────────────────────────────────
+export function createWriteFileSkill(options) {
+    return createTransformSkill({
+        name: options.name,
+        description: options.description ?? `Write file skill: ${options.name}`,
+        tags: ['io', 'file'],
+        inputSchema: z.record(z.unknown()),
+        outputSchema: z.object({ path: z.string(), bytesWritten: z.number() }),
+        async transform(input) {
+            const path = options.path(input);
+            const content = options.content(input);
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, content, options.encoding ?? 'utf-8');
+            return { path, bytesWritten: Buffer.byteLength(content) };
+        },
+    });
+}
+/** Namespace export */
+export const IOSkill = {
+    httpGet: createHttpGetSkill,
+    httpPost: createHttpPostSkill,
+    readFile: createReadFileSkill,
+    writeFile: createWriteFileSkill,
+};
+//# sourceMappingURL=io-skill.js.map

package/dist/skills/io-skill.js.map

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

package/dist/skills/llm-skill.d.ts

@@ -0,0 +1,64 @@
+/**
+ * LLMSkill — builds a Skill that calls an LLM with a prompt template.
+ *
+ * The primary skill type for LLM-backed operations.
+ */
+import { type ZodSchema } from 'zod';
+import type { Skill, SkillMeta } from '../skill.js';
+import type { Message } from '../types.js';
+export interface LLMSkillConfig<TInput, TOutput> {
+    /** Unique skill name. */
+    name: string;
+    /** Human-readable description used in agent routing/planning prompts. */
+    description: string;
+    /** Version string (default '1.0.0'). */
+    version?: string;
+    /** Tags for categorization. */
+    tags?: string[];
+    /**
+     * Which LLM from the Orchestrator registry to use.
+     * Defaults to 'default'. Can be overridden per-execution.
+     */
+    llm?: string;
+    /**
+     * Prompt factory. Receives validated input, returns prompt string or messages array.
+     */
+    prompt: (input: TInput) => string | Message[];
+    /**
+     * Optional system message prepended to every call.
+     */
+    systemMessage?: string | ((input: TInput) => string);
+    /**
+     * Zod schema for input validation.
+     */
+    inputSchema: ZodSchema<TInput>;
+    /**
+     * Zod schema for output validation.
+     */
+    outputSchema: ZodSchema<TOutput>;
+    /**
+     * Function to parse the raw LLM text response into TOutput.
+     * If not provided, the raw text is returned as-is (must match outputSchema).
+     */
+    parseOutput?: (raw: string, input: TInput) => TOutput;
+    /**
+     * LLM call options (temperature, maxTokens, etc.).
+     */
+    llmOptions?: {
+        temperature?: number;
+        maxTokens?: number;
+        responseFormat?: 'text' | 'json';
+    };
+    /** Number of retries on LLM failure (default 1). */
+    retries?: number;
+    /** Timeout in ms (default none). */
+    timeout?: number;
+    /** Cache config. */
+    cache?: SkillMeta['cache'];
+}
+export declare function createLLMSkill<TInput, TOutput>(config: LLMSkillConfig<TInput, TOutput>): Skill<TInput, TOutput>;
+/** Namespace export for ergonomic usage: LLMSkill.create(...) */
+export declare const LLMSkill: {
+    create: typeof createLLMSkill;
+};
+//# sourceMappingURL=llm-skill.d.ts.map

package/dist/skills/llm-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-skill.d.ts","sourceRoot":"","sources":["../../src/skills/llm-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,cAAc,CAAC,MAAM,EAAE,OAAO;IAC7C,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,EAAE,CAAC;IAC9C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACrD;;OAEG;IACH,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAClC,CAAC;IACF,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC5B;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAC5C,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAsIxB;AAED,iEAAiE;AACjE,eAAO,MAAM,QAAQ;;CAA6B,CAAC"}

package/dist/skills/llm-skill.js

@@ -0,0 +1,112 @@
+/**
+ * LLMSkill — builds a Skill that calls an LLM with a prompt template.
+ *
+ * The primary skill type for LLM-backed operations.
+ */
+import { SkillError, SkillValidationError } from '../errors.js';
+import { withRetry, withTimeout } from '../llm-provider.js';
+// ── LLMSkill Builder ──────────────────────────────────────────────────────────
+export function createLLMSkill(config) {
+    const meta = {
+        name: config.name,
+        description: config.description,
+        version: config.version ?? '1.0.0',
+        tags: config.tags ?? ['llm'],
+        retries: config.retries ?? 1,
+        timeout: config.timeout,
+        cache: config.cache,
+    };
+    return {
+        meta,
+        inputSchema: config.inputSchema,
+        outputSchema: config.outputSchema,
+        async execute(input, ctx) {
+            // ── Input validation ──
+            const parsed = config.inputSchema.safeParse(input);
+            if (!parsed.success) {
+                throw new SkillValidationError(config.name, 'input', `Input validation failed: ${parsed.error.message}`, parsed.error.issues);
+            }
+            const validInput = parsed.data;
+            // ── Cache lookup ──
+            if (config.cache) {
+                const cacheKey = `llmskill:${config.name}:${config.cache.key(validInput)}`;
+                const cached = await ctx.state.get(cacheKey);
+                if (cached !== null) {
+                    ctx.logger.debug(`Cache hit for skill "${config.name}"`);
+                    return cached;
+                }
+            }
+            // ── Resolve LLM ──
+            const llm = ctx.getLLM(config.llm ?? 'default');
+            // ── Build messages ──
+            const promptResult = config.prompt(validInput);
+            let messages;
+            if (typeof promptResult === 'string') {
+                messages = [{ role: 'user', content: promptResult }];
+            }
+            else {
+                messages = promptResult;
+            }
+            // Prepend system message if provided
+            if (config.systemMessage) {
+                const sysContent = typeof config.systemMessage === 'string'
+                    ? config.systemMessage
+                    : config.systemMessage(validInput);
+                messages = [{ role: 'system', content: sysContent }, ...messages];
+            }
+            // ── Execute with retry/timeout ──
+            const retries = config.retries ?? 1;
+            const timeout = config.timeout;
+            const doCall = () => llm.chat(messages, {
+                temperature: config.llmOptions?.temperature,
+                maxTokens: config.llmOptions?.maxTokens,
+                responseFormat: config.llmOptions?.responseFormat,
+                retries: 0, // retries handled here
+            });
+            const callWithRetry = () => withRetry(doCall, retries, (attempt, err) => ctx.logger.warn(`Skill "${config.name}" retry ${attempt}/${retries}: ${err.message}`));
+            const response = await (timeout
+                ? withTimeout(callWithRetry, timeout, config.name)
+                : callWithRetry());
+            ctx.emit('llm:response', {
+                skill: config.name,
+                tokens: response.usage.totalTokens,
+                model: response.model,
+            });
+            // ── Parse output ──
+            let output;
+            try {
+                if (config.parseOutput) {
+                    output = config.parseOutput(response.content, validInput);
+                }
+                else {
+                    // Try JSON parse if schema expects object, else return raw string
+                    try {
+                        output = JSON.parse(response.content);
+                    }
+                    catch {
+                        output = response.content;
+                    }
+                }
+            }
+            catch (err) {
+                throw new SkillError(config.name, `Output parsing failed: ${err instanceof Error ? err.message : String(err)}`, { raw: response.content.substring(0, 500) });
+            }
+            // ── Output validation ──
+            const outParsed = config.outputSchema.safeParse(output);
+            if (!outParsed.success) {
+                ctx.logger.warn(`Skill "${config.name}" output failed schema validation — returning raw`, outParsed.error.issues);
+                // Don't hard-fail on output validation — return what we have
+                // This matches real-world LLM usage where output schema is a guide not a gate
+            }
+            // ── Cache store ──
+            if (config.cache) {
+                const cacheKey = `llmskill:${config.name}:${config.cache.key(validInput)}`;
+                await ctx.state.set(cacheKey, output, config.cache.ttl);
+            }
+            return output;
+        },
+    };
+}
+/** Namespace export for ergonomic usage: LLMSkill.create(...) */
+export const LLMSkill = { create: createLLMSkill };
+//# sourceMappingURL=llm-skill.js.map

package/dist/skills/llm-skill.js.map

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

package/dist/skills/transform-skill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * TransformSkill — a pure data transformation skill (no LLM).
+ *
+ * Pure data transformation skill.
+ */
+import type { ZodSchema } from 'zod';
+import type { Skill, SkillContext } from '../skill.js';
+export interface TransformSkillConfig<TInput, TOutput> {
+    name: string;
+    description: string;
+    version?: string;
+    tags?: string[];
+    inputSchema: ZodSchema<TInput>;
+    outputSchema: ZodSchema<TOutput>;
+    /**
+     * The transformation function. Pure sync or async.
+     * The second argument (ctx) is optional — most transforms won't need it.
+     */
+    transform: (input: TInput, ctx?: SkillContext) => TOutput | Promise<TOutput>;
+    timeout?: number;
+}
+export declare function createTransformSkill<TInput, TOutput>(config: TransformSkillConfig<TInput, TOutput>): Skill<TInput, TOutput>;
+/** Namespace export: TransformSkill.create(...) */
+export declare const TransformSkill: {
+    create: typeof createTransformSkill;
+};
+//# sourceMappingURL=transform-skill.d.ts.map

package/dist/skills/transform-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-skill.d.ts","sourceRoot":"","sources":["../../src/skills/transform-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAa,YAAY,EAAE,MAAM,aAAa,CAAC;AAGlE,MAAM,WAAW,oBAAoB,CAAC,MAAM,EAAE,OAAO;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAClD,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BxB;AAED,mDAAmD;AACnD,eAAO,MAAM,cAAc;;CAAmC,CAAC"}

package/dist/skills/transform-skill.js

@@ -0,0 +1,32 @@
+/**
+ * TransformSkill — a pure data transformation skill (no LLM).
+ *
+ * Pure data transformation skill.
+ */
+import { SkillValidationError } from '../errors.js';
+export function createTransformSkill(config) {
+    const meta = {
+        name: config.name,
+        description: config.description,
+        version: config.version ?? '1.0.0',
+        tags: config.tags ?? ['transform'],
+        timeout: config.timeout,
+    };
+    return {
+        meta,
+        inputSchema: config.inputSchema,
+        outputSchema: config.outputSchema,
+        async execute(input, ctx) {
+            // Input validation
+            const parsed = config.inputSchema.safeParse(input);
+            if (!parsed.success) {
+                throw new SkillValidationError(config.name, 'input', `Input validation failed: ${parsed.error.message}`, parsed.error.issues);
+            }
+            const output = await config.transform(parsed.data, ctx);
+            return output;
+        },
+    };
+}
+/** Namespace export: TransformSkill.create(...) */
+export const TransformSkill = { create: createTransformSkill };
+//# sourceMappingURL=transform-skill.js.map

package/dist/skills/transform-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-skill.js","sourceRoot":"","sources":["../../src/skills/transform-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAiBpD,MAAM,UAAU,oBAAoB,CAClC,MAA6C;IAE7C,MAAM,IAAI,GAAc;QACtB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;QAClC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QAEjC,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,GAAiB;YAC5C,mBAAmB;YACnB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,IAAI,EACX,OAAO,EACP,4BAA4B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAClD,MAAM,CAAC,KAAK,CAAC,MAAM,CACpB,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/state/file-store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * File-based StateStore — persists data as JSON files.
+ * Good for development and small-scale use. No external dependencies.
+ */
+import type { StateStore, RunFilter } from './types.js';
+import type { PipelineRun } from '../types.js';
+export declare class FileStore implements StateStore {
+    private readonly dataFile;
+    private data;
+    constructor(dataDir?: string);
+    init(): Promise<void>;
+    close(): Promise<void>;
+    private flush;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    saveRun(run: PipelineRun): Promise<void>;
+    getRun(runId: string): Promise<PipelineRun | null>;
+    listRuns(filter?: RunFilter): Promise<PipelineRun[]>;
+    saveCheckpoint(runId: string, stepName: string, data: unknown): Promise<void>;
+    getCheckpoint(runId: string, stepName: string): Promise<unknown | null>;
+    clearCheckpoints(runId: string): Promise<void>;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/state/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/state/file-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa/C,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,IAAI,CAA2D;gBAE3D,OAAO,SAAc;IAI3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,KAAK;IAKb,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAUtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAIlD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAepD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIvE,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrD"}