@projectarachne/core 0.1.0

package/dist/schemas/workflow.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+// --- Chain configuration ------------------------------------------------------
+// mode:
+//  - 'auto_append': previous step's output is appended as context to the next prompt
+//  - 'auto_replace': next prompt is *replaced* by an extracted string (e.g., JSON path)
+//  - 'manual': no automatic carry-forward; UI may still show/allow manual paste
+export const ChainConfigSchema = z.object({
+    mode: z.enum(['auto_append', 'auto_replace', 'manual']).default('auto_append'),
+    // If output.format==='json', where to pull the *string* to use as the next prompt.
+    // Examples: '$.next_prompt', '$.plan.steps[0].instruction'
+    nextPromptPath: z.string().optional(),
+});
+// --- Output configuration -----------------------------------------------------
+// If format==='json', 'schema' may hold a JSON Schema object we will enforce at runtime.
+// (Validation will be done in executionEngine; here we just accept the object.)
+export const OutputConfigSchema = z.object({
+    format: z.enum(['text', 'json']).default('text'),
+    schema: z.unknown().optional(),
+});
+// --- Loop configuration -------------------------------------------------------
+// maxIterations: repeat linear steps up to N times (default: 1)
+// stopOnHalt: stop looping early if a step output contains HALT
+export const LoopConfigSchema = z.object({
+    maxIterations: z.number().int().min(1).max(100).default(1),
+    stopOnHalt: z.boolean().default(true),
+});
+// --- Step schema --------------------------------------------------------------
+export const StepSchema = z.object({
+    id: z.string(),
+    // Optional execution kind (default: LLM prompt)
+    kind: z.enum(['llm', 'http']).default('llm'),
+    // Optional concept hint for graph context (if you use Neo4j later)
+    conceptLabel: z.string().optional().nullable(),
+    // Allow empty prompts so downstream steps can be auto-filled.
+    // (Previously min(1) caused 400s when step prompts were intentionally blank.)
+    prompt: z.string().optional().default(''),
+    // Optional server-side template; e.g. "Summarize:\n{{ steps.s1.output }}"
+    // The execution engine will render this using prior step outputs if provided.
+    promptTemplate: z.string().optional(),
+    agentId: z.string(), // e.g., 'Analyst', 'Architect', etc.
+    // Keep model flexible; default remains OpenAI gpt-4o
+    model: z.string().optional().default('openai:gpt-4o'),
+    // New optional chain & output controls
+    chain: ChainConfigSchema.optional(),
+    output: OutputConfigSchema.optional(),
+    // HTTP node config (used when kind === 'http' or when http.url is provided)
+    http: z
+        .object({
+        url: z.string().url(),
+        method: z.string().optional().default('GET'),
+        allowMutations: z.boolean().optional().default(false),
+        headers: z.record(z.string()).optional(),
+        body: z.unknown().optional(),
+        timeoutMs: z.number().int().positive().optional(),
+    })
+        .optional(),
+    retry: z
+        .object({
+        attempts: z.number().int().min(1).max(5).default(1),
+        backoffMs: z.number().int().min(0).max(60000).default(1000),
+    })
+        .optional(),
+});
+// --- Graph edge schema (for branching) ----------------------------------------
+export const EdgeSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+});
+// --- Workflow schema ----------------------------------------------------------
+export const WorkflowRunSchema = z
+    .object({
+    workflowId: z.string(),
+    steps: z.array(StepSchema).optional(),
+    nodes: z.array(StepSchema).optional(),
+    edges: z.array(EdgeSchema).optional(),
+    loop: LoopConfigSchema.optional(),
+    resumeFromStep: z.union([z.number().int().nonnegative(), z.string().min(1)]).optional(),
+    resumeFromNodeId: z.string().min(1).optional(),
+})
+    .refine((val) => {
+    const hasSteps = Array.isArray(val.steps) && val.steps.length > 0;
+    const hasNodes = Array.isArray(val.nodes) && val.nodes.length > 0;
+    return hasSteps || hasNodes;
+}, { message: 'Provide at least one step or graph node.' });
+//# sourceMappingURL=workflow.js.map

package/dist/schemas/workflow.js.map

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

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,65 @@
+export type RunStatus = 'running' | 'success' | 'failed';
+export type StepStatus = 'running' | 'success' | 'failed';
+export interface RunRecord {
+    id: string;
+    workflowPath: string;
+    status: RunStatus;
+    stepsTotal: number | null;
+    startedAt: string;
+    completedAt: string | null;
+    errorMessage: string | null;
+}
+export interface StepRecord {
+    id: string;
+    runId: string;
+    stepId: string;
+    stepIndex: number | null;
+    status: StepStatus;
+    output: string | null;
+    startedAt: string;
+    completedAt: string | null;
+    errorMessage: string | null;
+}
+export interface TemplateRecord {
+    id: string;
+    name: string;
+    description: string | null;
+    yaml: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateRunInput {
+    workflowPath: string;
+    stepsTotal?: number | null;
+}
+export interface CompleteRunInput {
+    status: Exclude<RunStatus, 'running'>;
+    errorMessage?: string | null;
+}
+export interface SaveTemplateInput {
+    name: string;
+    yaml: string;
+    description?: string | null;
+}
+export declare const DEFAULT_SQLITE_FILENAME = "arachne.sqlite";
+export declare const resolveDefaultSqlitePath: () => string;
+export declare class SqliteStorage {
+    private db;
+    constructor(filename?: string);
+    private ensureSchema;
+    createRun(input: CreateRunInput): RunRecord;
+    completeRun(runId: string, input: CompleteRunInput): void;
+    recordStepStart(runId: string, stepId: string, stepIndex?: number): StepRecord;
+    recordStepResult(stepId: string, runId: string, input: {
+        status: StepStatus;
+        output?: string | null;
+        errorMessage?: string | null;
+    }): void;
+    getRunHistory(limit?: number): RunRecord[];
+    saveTemplate(input: SaveTemplateInput): TemplateRecord;
+    getTemplate(name: string): TemplateRecord | null;
+    listTemplates(): TemplateRecord[];
+    close(): void;
+}
+export declare const createSqliteStorage: (filename?: string) => SqliteStorage;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/storage/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD,eAAO,MAAM,wBAAwB,QAAO,MAE3C,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoC;gBAElC,QAAQ,GAAE,MAAmC;IAQzD,OAAO,CAAC,YAAY;IAsCpB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS;IAuB3C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAWzD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU;IAyB9E,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QACrD,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,GAAG,IAAI;IAWR,aAAa,CAAC,KAAK,SAAK,GAAG,SAAS,EAAE;IActC,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc;IAiCtD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAYhD,aAAa,IAAI,cAAc,EAAE;IAWjC,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,KAAG,aAEvD,CAAC"}

package/dist/storage/sqlite.js

@@ -0,0 +1,177 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+// Lazy-loaded to avoid import-time crashes on Node versions without prebuilt binaries
+let Database = null;
+const loadDatabase = () => {
+    if (!Database) {
+        const require = createRequire(import.meta.url);
+        Database = require('better-sqlite3');
+    }
+    return Database;
+};
+export const DEFAULT_SQLITE_FILENAME = 'arachne.sqlite';
+export const resolveDefaultSqlitePath = () => {
+    return join(homedir(), '.arachne', DEFAULT_SQLITE_FILENAME);
+};
+export class SqliteStorage {
+    db;
+    constructor(filename = resolveDefaultSqlitePath()) {
+        mkdirSync(dirname(filename), { recursive: true });
+        const DB = loadDatabase();
+        this.db = new DB(filename);
+        this.db.pragma('journal_mode = WAL');
+        this.ensureSchema();
+    }
+    ensureSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS runs (
+        id TEXT PRIMARY KEY,
+        workflow_path TEXT NOT NULL,
+        status TEXT NOT NULL,
+        steps_total INTEGER,
+        started_at TEXT NOT NULL,
+        completed_at TEXT,
+        error_message TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS run_steps (
+        id TEXT PRIMARY KEY,
+        run_id TEXT NOT NULL,
+        step_id TEXT NOT NULL,
+        step_index INTEGER,
+        status TEXT NOT NULL,
+        output TEXT,
+        started_at TEXT NOT NULL,
+        completed_at TEXT,
+        error_message TEXT,
+        FOREIGN KEY (run_id) REFERENCES runs(id)
+      );
+
+      CREATE INDEX IF NOT EXISTS run_steps_run_id ON run_steps(run_id);
+
+      CREATE TABLE IF NOT EXISTS templates (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL UNIQUE,
+        description TEXT,
+        yaml TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `);
+    }
+    createRun(input) {
+        const id = randomUUID();
+        const startedAt = new Date().toISOString();
+        const stepsTotal = input.stepsTotal ?? null;
+        this.db
+            .prepare(`INSERT INTO runs (id, workflow_path, status, steps_total, started_at, completed_at, error_message)
+         VALUES (?, ?, ?, ?, ?, NULL, NULL)`)
+            .run(id, input.workflowPath, 'running', stepsTotal, startedAt);
+        return {
+            id,
+            workflowPath: input.workflowPath,
+            status: 'running',
+            stepsTotal,
+            startedAt,
+            completedAt: null,
+            errorMessage: null,
+        };
+    }
+    completeRun(runId, input) {
+        const completedAt = new Date().toISOString();
+        this.db
+            .prepare(`UPDATE runs
+         SET status = ?, completed_at = ?, error_message = ?
+         WHERE id = ?`)
+            .run(input.status, completedAt, input.errorMessage ?? null, runId);
+    }
+    recordStepStart(runId, stepId, stepIndex) {
+        const id = randomUUID();
+        const startedAt = new Date().toISOString();
+        const stepIndexValue = stepIndex ?? null;
+        this.db
+            .prepare(`INSERT INTO run_steps (id, run_id, step_id, step_index, status, output, started_at, completed_at, error_message)
+         VALUES (?, ?, ?, ?, ?, NULL, ?, NULL, NULL)`)
+            .run(id, runId, stepId, stepIndexValue, 'running', startedAt);
+        return {
+            id,
+            runId,
+            stepId,
+            stepIndex: stepIndexValue,
+            status: 'running',
+            output: null,
+            startedAt,
+            completedAt: null,
+            errorMessage: null,
+        };
+    }
+    recordStepResult(stepId, runId, input) {
+        const completedAt = new Date().toISOString();
+        this.db
+            .prepare(`UPDATE run_steps
+         SET status = ?, output = ?, completed_at = ?, error_message = ?
+         WHERE run_id = ? AND step_id = ?`)
+            .run(input.status, input.output ?? null, completedAt, input.errorMessage ?? null, runId, stepId);
+    }
+    getRunHistory(limit = 50) {
+        const rows = this.db
+            .prepare(`SELECT id, workflow_path as workflowPath, status, steps_total as stepsTotal,
+                started_at as startedAt, completed_at as completedAt, error_message as errorMessage
+         FROM runs
+         ORDER BY started_at DESC
+         LIMIT ?`)
+            .all(limit);
+        return rows;
+    }
+    saveTemplate(input) {
+        const existing = this.getTemplate(input.name);
+        const now = new Date().toISOString();
+        if (existing) {
+            this.db
+                .prepare(`UPDATE templates
+           SET description = ?, yaml = ?, updated_at = ?
+           WHERE name = ?`)
+                .run(input.description ?? null, input.yaml, now, input.name);
+            return { ...existing, description: input.description ?? null, yaml: input.yaml, updatedAt: now };
+        }
+        const id = randomUUID();
+        this.db
+            .prepare(`INSERT INTO templates (id, name, description, yaml, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(id, input.name, input.description ?? null, input.yaml, now, now);
+        return {
+            id,
+            name: input.name,
+            description: input.description ?? null,
+            yaml: input.yaml,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    getTemplate(name) {
+        const row = this.db
+            .prepare(`SELECT id, name, description, yaml, created_at as createdAt, updated_at as updatedAt
+         FROM templates
+         WHERE name = ?`)
+            .get(name);
+        return row ? row : null;
+    }
+    listTemplates() {
+        const rows = this.db
+            .prepare(`SELECT id, name, description, yaml, created_at as createdAt, updated_at as updatedAt
+         FROM templates
+         ORDER BY name ASC`)
+            .all();
+        return rows;
+    }
+    close() {
+        this.db.close();
+    }
+}
+export const createSqliteStorage = (filename) => {
+    return new SqliteStorage(filename);
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/storage/sqlite.js.map

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

package/dist/yaml/index.d.ts

@@ -0,0 +1,3 @@
+export { loadWorkflowYaml, parseWorkflowYaml } from './parseWorkflowYaml.js';
+export type { WorkflowYaml } from './parseWorkflowYaml.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/yaml/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/yaml/index.js

@@ -0,0 +1,2 @@
+export { loadWorkflowYaml, parseWorkflowYaml } from './parseWorkflowYaml.js';
+//# sourceMappingURL=index.js.map

package/dist/yaml/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/yaml/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/yaml/parseWorkflowYaml.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { WorkflowYamlSchema } from '../schemas/workflow-yaml.js';
+export type WorkflowYaml = z.infer<typeof WorkflowYamlSchema>;
+export declare const parseWorkflowYaml: (rawYaml: string, sourceName?: string) => WorkflowYaml;
+export declare const loadWorkflowYaml: (filePath: string) => Promise<WorkflowYaml>;
+//# sourceMappingURL=parseWorkflowYaml.d.ts.map

package/dist/yaml/parseWorkflowYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseWorkflowYaml.d.ts","sourceRoot":"","sources":["../../src/yaml/parseWorkflowYaml.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAkB9D,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,mBAA4B,KAAG,YAqBjF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,YAAY,CAG7E,CAAC"}

package/dist/yaml/parseWorkflowYaml.js

@@ -0,0 +1,41 @@
+import { readFile } from 'node:fs/promises';
+import { parse } from 'yaml';
+import { WorkflowYamlSchema } from '../schemas/workflow-yaml.js';
+const formatValidationIssues = (issues) => {
+    return issues
+        .map((issue) => {
+        if (issue.path.length === 0) {
+            return `- root: ${issue.message}`;
+        }
+        const path = issue.path
+            .map((segment) => (typeof segment === 'number' ? `[${segment}]` : segment))
+            .join('.')
+            .replace('.[', '[');
+        return `- ${path}: ${issue.message}`;
+    })
+        .join('\n');
+};
+export const parseWorkflowYaml = (rawYaml, sourceName = 'workflow.yaml') => {
+    let parsed;
+    try {
+        parsed = parse(rawYaml);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse YAML in ${sourceName}: ${message}`);
+    }
+    if (parsed === null || parsed === undefined) {
+        throw new Error(`Invalid workflow YAML in ${sourceName}: file is empty.`);
+    }
+    const validation = WorkflowYamlSchema.safeParse(parsed);
+    if (!validation.success) {
+        const details = formatValidationIssues(validation.error.issues);
+        throw new Error(`Invalid workflow YAML in ${sourceName}:\n${details}`);
+    }
+    return validation.data;
+};
+export const loadWorkflowYaml = async (filePath) => {
+    const rawYaml = await readFile(filePath, 'utf8');
+    return parseWorkflowYaml(rawYaml, filePath);
+};
+//# sourceMappingURL=parseWorkflowYaml.js.map

package/dist/yaml/parseWorkflowYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseWorkflowYaml.js","sourceRoot":"","sources":["../../src/yaml/parseWorkflowYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAIjE,MAAM,sBAAsB,GAAG,CAAC,MAAoB,EAAU,EAAE;IAC9D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,WAAW,KAAK,CAAC,OAAO,EAAE,CAAC;QACpC,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI;aACpB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;aAC1E,IAAI,CAAC,GAAG,CAAC;aACT,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtB,OAAO,KAAK,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,UAAU,GAAG,eAAe,EAAgB,EAAE;IAC/F,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,sBAAsB,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,MAAM,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,QAAgB,EAAyB,EAAE;IAChF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@projectarachne/core",
+  "version": "0.1.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.10.0",
+    "yaml": "^2.8.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.10.1",
+    "typescript": "^5.5.4"
+  }
+}