@amodalai/core 0.1.0

package/dist/src/repo/store-loader.js

@@ -0,0 +1,94 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import * as path from 'node:path';
+import { StoreJsonSchema, STORE_NAME_REGEX } from './store-schemas.js';
+import { RepoError } from './repo-types.js';
+/**
+ * List .json files in a directory. Returns [] if dir doesn't exist.
+ */
+async function listJsonFiles(dirPath) {
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isFile() && e.name.endsWith('.json'))
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse a store JSON string into a LoadedStore.
+ */
+export function parseStoreJson(jsonString, fileName, location) {
+    let raw;
+    try {
+        raw = JSON.parse(jsonString);
+    }
+    catch (err) {
+        throw new RepoError('CONFIG_PARSE_FAILED', `Invalid JSON in store file "${fileName}"`, err);
+    }
+    const parsed = StoreJsonSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        throw new RepoError('CONFIG_VALIDATION_FAILED', `Invalid store definition "${fileName}": ${issues}`);
+    }
+    const storeJson = parsed.data;
+    const name = storeJson.name ?? fileName.replace(/\.json$/, '');
+    // Validate name derived from filename
+    if (!storeJson.name && !STORE_NAME_REGEX.test(name)) {
+        throw new RepoError('CONFIG_VALIDATION_FAILED', `Store filename "${fileName}" is not a valid store name. ` +
+            'Store names must be kebab-case (lowercase letters, digits, hyphens), starting with a letter.');
+    }
+    // If name is provided, verify it matches filename
+    if (storeJson.name && storeJson.name !== fileName.replace(/\.json$/, '')) {
+        throw new RepoError('CONFIG_VALIDATION_FAILED', `Store name "${storeJson.name}" in ${fileName} does not match filename. ` +
+            'Either remove the name field (filename is used) or make them match.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return {
+        name,
+        entity: storeJson.entity,
+        ttl: storeJson.ttl,
+        failure: storeJson.failure,
+        history: storeJson.history,
+        trace: storeJson.trace,
+        location,
+    };
+}
+/**
+ * Load all store definitions from the stores/ directory.
+ *
+ * Each .json file in stores/ defines a store. The filename (without extension)
+ * becomes the store name unless overridden by a "name" field in the JSON.
+ *
+ * Missing stores/ directory returns [].
+ */
+export async function loadStores(repoPath) {
+    const storesDir = path.join(repoPath, 'stores');
+    const files = await listJsonFiles(storesDir);
+    if (files.length === 0) {
+        return [];
+    }
+    const results = await Promise.all(files.map(async (filename) => {
+        const filePath = path.join(storesDir, filename);
+        const content = await readFile(filePath, 'utf-8');
+        return parseStoreJson(content, filename, filePath);
+    }));
+    // Check for duplicate store names
+    const seen = new Set();
+    for (const store of results) {
+        if (seen.has(store.name)) {
+            throw new RepoError('CONFIG_VALIDATION_FAILED', `Duplicate store name "${store.name}"`);
+        }
+        seen.add(store.name);
+    }
+    return results;
+}
+//# sourceMappingURL=store-loader.js.map

package/dist/src/repo/store-loader.js.map

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

package/dist/src/repo/store-schemas.d.ts

@@ -0,0 +1,313 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/** Regex for valid store names — kebab-case, starts with lowercase letter */
+export declare const STORE_NAME_REGEX: RegExp;
+/**
+ * Zod schema for a store field definition (recursive for nested types).
+ */
+export declare const StoreFieldDefinitionSchema: z.ZodType<{
+    type: string;
+    nullable?: boolean;
+    values?: string[];
+    min?: number;
+    max?: number;
+    item?: unknown;
+    fields?: Record<string, unknown>;
+    store?: string;
+}>;
+/**
+ * Zod schema for a store entity definition.
+ */
+export declare const StoreEntitySchema: z.ZodObject<{
+    /** TypeScript type name (e.g., "ClassifiedAlert") */
+    name: z.ZodString;
+    /** Key template (e.g., "{event_id}") */
+    key: z.ZodString;
+    /** Field definitions */
+    schema: z.ZodRecord<z.ZodString, z.ZodType<{
+        type: string;
+        nullable?: boolean;
+        values?: string[];
+        min?: number;
+        max?: number;
+        item?: unknown;
+        fields?: Record<string, unknown>;
+        store?: string;
+    }, z.ZodTypeDef, {
+        type: string;
+        nullable?: boolean;
+        values?: string[];
+        min?: number;
+        max?: number;
+        item?: unknown;
+        fields?: Record<string, unknown>;
+        store?: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    name: string;
+    schema: Record<string, {
+        type: string;
+        nullable?: boolean;
+        values?: string[];
+        min?: number;
+        max?: number;
+        item?: unknown;
+        fields?: Record<string, unknown>;
+        store?: string;
+    }>;
+}, {
+    key: string;
+    name: string;
+    schema: Record<string, {
+        type: string;
+        nullable?: boolean;
+        values?: string[];
+        min?: number;
+        max?: number;
+        item?: unknown;
+        fields?: Record<string, unknown>;
+        store?: string;
+    }>;
+}>;
+/**
+ * Zod schema for TTL configuration — either a number or conditional config.
+ */
+export declare const StoreTtlConfigSchema: z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+    default: z.ZodNumber;
+    override: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        condition: z.ZodString;
+        ttl: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        ttl: number;
+        condition: string;
+    }, {
+        ttl: number;
+        condition: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    default: number;
+    override?: {
+        ttl: number;
+        condition: string;
+    }[] | undefined;
+}, {
+    default: number;
+    override?: {
+        ttl: number;
+        condition: string;
+    }[] | undefined;
+}>]>;
+/**
+ * Zod schema for failure handling configuration.
+ */
+export declare const StoreFailureConfigSchema: z.ZodObject<{
+    mode: z.ZodEnum<["partial", "all-or-nothing", "skip"]>;
+    retries: z.ZodOptional<z.ZodNumber>;
+    backoff: z.ZodOptional<z.ZodEnum<["exponential", "linear", "none"]>>;
+    deadLetter: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mode: "partial" | "all-or-nothing" | "skip";
+    retries?: number | undefined;
+    backoff?: "exponential" | "linear" | "none" | undefined;
+    deadLetter?: boolean | undefined;
+}, {
+    mode: "partial" | "all-or-nothing" | "skip";
+    retries?: number | undefined;
+    backoff?: "exponential" | "linear" | "none" | undefined;
+    deadLetter?: boolean | undefined;
+}>;
+/**
+ * Zod schema for history configuration.
+ */
+export declare const StoreHistoryConfigSchema: z.ZodObject<{
+    versions: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    versions: number;
+}, {
+    versions: number;
+}>;
+/**
+ * Zod schema for a store JSON file (stores/*.json).
+ */
+export declare const StoreJsonSchema: z.ZodObject<{
+    /** Store name — kebab-case. Optional; defaults to filename. */
+    name: z.ZodOptional<z.ZodString>;
+    /** Entity definition */
+    entity: z.ZodObject<{
+        /** TypeScript type name (e.g., "ClassifiedAlert") */
+        name: z.ZodString;
+        /** Key template (e.g., "{event_id}") */
+        key: z.ZodString;
+        /** Field definitions */
+        schema: z.ZodRecord<z.ZodString, z.ZodType<{
+            type: string;
+            nullable?: boolean;
+            values?: string[];
+            min?: number;
+            max?: number;
+            item?: unknown;
+            fields?: Record<string, unknown>;
+            store?: string;
+        }, z.ZodTypeDef, {
+            type: string;
+            nullable?: boolean;
+            values?: string[];
+            min?: number;
+            max?: number;
+            item?: unknown;
+            fields?: Record<string, unknown>;
+            store?: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        name: string;
+        schema: Record<string, {
+            type: string;
+            nullable?: boolean;
+            values?: string[];
+            min?: number;
+            max?: number;
+            item?: unknown;
+            fields?: Record<string, unknown>;
+            store?: string;
+        }>;
+    }, {
+        key: string;
+        name: string;
+        schema: Record<string, {
+            type: string;
+            nullable?: boolean;
+            values?: string[];
+            min?: number;
+            max?: number;
+            item?: unknown;
+            fields?: Record<string, unknown>;
+            store?: string;
+        }>;
+    }>;
+    /** TTL configuration */
+    ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+        default: z.ZodNumber;
+        override: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            condition: z.ZodString;
+            ttl: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ttl: number;
+            condition: string;
+        }, {
+            ttl: number;
+            condition: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        default: number;
+        override?: {
+            ttl: number;
+            condition: string;
+        }[] | undefined;
+    }, {
+        default: number;
+        override?: {
+            ttl: number;
+            condition: string;
+        }[] | undefined;
+    }>]>>;
+    /** Failure handling */
+    failure: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<["partial", "all-or-nothing", "skip"]>;
+        retries: z.ZodOptional<z.ZodNumber>;
+        backoff: z.ZodOptional<z.ZodEnum<["exponential", "linear", "none"]>>;
+        deadLetter: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "partial" | "all-or-nothing" | "skip";
+        retries?: number | undefined;
+        backoff?: "exponential" | "linear" | "none" | undefined;
+        deadLetter?: boolean | undefined;
+    }, {
+        mode: "partial" | "all-or-nothing" | "skip";
+        retries?: number | undefined;
+        backoff?: "exponential" | "linear" | "none" | undefined;
+        deadLetter?: boolean | undefined;
+    }>>;
+    /** Version history */
+    history: z.ZodOptional<z.ZodObject<{
+        versions: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        versions: number;
+    }, {
+        versions: number;
+    }>>;
+    /** Whether to store reasoning traces */
+    trace: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    entity: {
+        key: string;
+        name: string;
+        schema: Record<string, {
+            type: string;
+            nullable?: boolean;
+            values?: string[];
+            min?: number;
+            max?: number;
+            item?: unknown;
+            fields?: Record<string, unknown>;
+            store?: string;
+        }>;
+    };
+    name?: string | undefined;
+    ttl?: number | {
+        default: number;
+        override?: {
+            ttl: number;
+            condition: string;
+        }[] | undefined;
+    } | undefined;
+    trace?: boolean | undefined;
+    failure?: {
+        mode: "partial" | "all-or-nothing" | "skip";
+        retries?: number | undefined;
+        backoff?: "exponential" | "linear" | "none" | undefined;
+        deadLetter?: boolean | undefined;
+    } | undefined;
+    history?: {
+        versions: number;
+    } | undefined;
+}, {
+    entity: {
+        key: string;
+        name: string;
+        schema: Record<string, {
+            type: string;
+            nullable?: boolean;
+            values?: string[];
+            min?: number;
+            max?: number;
+            item?: unknown;
+            fields?: Record<string, unknown>;
+            store?: string;
+        }>;
+    };
+    name?: string | undefined;
+    ttl?: number | {
+        default: number;
+        override?: {
+            ttl: number;
+            condition: string;
+        }[] | undefined;
+    } | undefined;
+    trace?: boolean | undefined;
+    failure?: {
+        mode: "partial" | "all-or-nothing" | "skip";
+        retries?: number | undefined;
+        backoff?: "exponential" | "linear" | "none" | undefined;
+        deadLetter?: boolean | undefined;
+    } | undefined;
+    history?: {
+        versions: number;
+    } | undefined;
+}>;
+export type StoreJson = z.infer<typeof StoreJsonSchema>;

package/dist/src/repo/store-schemas.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/** Regex for valid store names — kebab-case, starts with lowercase letter */
+export const STORE_NAME_REGEX = /^[a-z][a-z0-9-]*$/;
+/**
+ * Zod schema for a store field definition (recursive for nested types).
+ */
+export const StoreFieldDefinitionSchema = z.lazy(() => z.object({
+    type: z.enum(['string', 'number', 'boolean', 'datetime', 'enum', 'array', 'object', 'ref']),
+    nullable: z.boolean().optional(),
+    values: z.array(z.string()).optional(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+    item: StoreFieldDefinitionSchema.optional(),
+    fields: z.record(StoreFieldDefinitionSchema).optional(),
+    store: z.string().optional(),
+}).superRefine((field, ctx) => {
+    if (field.type === 'enum' && (!field.values || field.values.length === 0)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Enum fields must have a non-empty "values" array',
+        });
+    }
+    if (field.type === 'array' && !field.item) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Array fields must have an "item" definition',
+        });
+    }
+    if (field.type === 'object' && !field.fields) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Object fields must have a "fields" definition',
+        });
+    }
+    if (field.type === 'ref' && !field.store) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Ref fields must have a "store" target',
+        });
+    }
+}));
+/**
+ * Zod schema for a store entity definition.
+ */
+export const StoreEntitySchema = z.object({
+    /** TypeScript type name (e.g., "ClassifiedAlert") */
+    name: z.string().min(1),
+    /** Key template (e.g., "{event_id}") */
+    key: z.string().min(1),
+    /** Field definitions */
+    schema: z.record(StoreFieldDefinitionSchema),
+});
+/**
+ * Zod schema for TTL configuration — either a number or conditional config.
+ */
+export const StoreTtlConfigSchema = z.union([
+    z.number().int().positive(),
+    z.object({
+        default: z.number().int().positive(),
+        override: z.array(z.object({
+            condition: z.string().min(1),
+            ttl: z.number().int().positive(),
+        })).optional(),
+    }),
+]);
+/**
+ * Zod schema for failure handling configuration.
+ */
+export const StoreFailureConfigSchema = z.object({
+    mode: z.enum(['partial', 'all-or-nothing', 'skip']),
+    retries: z.number().int().nonnegative().optional(),
+    backoff: z.enum(['exponential', 'linear', 'none']).optional(),
+    deadLetter: z.boolean().optional(),
+});
+/**
+ * Zod schema for history configuration.
+ */
+export const StoreHistoryConfigSchema = z.object({
+    versions: z.number().int().positive(),
+});
+/**
+ * Zod schema for a store JSON file (stores/*.json).
+ */
+export const StoreJsonSchema = z.object({
+    /** Store name — kebab-case. Optional; defaults to filename. */
+    name: z.string().regex(STORE_NAME_REGEX, 'Store name must be kebab-case (lowercase letters, digits, hyphens), starting with a letter').optional(),
+    /** Entity definition */
+    entity: StoreEntitySchema,
+    /** TTL configuration */
+    ttl: StoreTtlConfigSchema.optional(),
+    /** Failure handling */
+    failure: StoreFailureConfigSchema.optional(),
+    /** Version history */
+    history: StoreHistoryConfigSchema.optional(),
+    /** Whether to store reasoning traces */
+    trace: z.boolean().optional(),
+});
+//# sourceMappingURL=store-schemas.js.map

package/dist/src/repo/store-schemas.js.map

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

package/dist/src/repo/store-tool-schema.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { StoreFieldDefinition, LoadedStore } from './store-types.js';
+/**
+ * Convert a StoreFieldDefinition to a JSON Schema property.
+ */
+export declare function fieldToJsonSchema(field: StoreFieldDefinition): Record<string, unknown>;
+/**
+ * Convert a LoadedStore into a JSON Schema suitable for an LLM tool's `parameters`.
+ *
+ * The resulting schema has `type: 'object'` with `properties` derived from the
+ * entity schema, and `required` listing all non-nullable fields.
+ */
+export declare function storeToJsonSchema(store: LoadedStore): Record<string, unknown>;
+/**
+ * Convert a store name (kebab-case) to a tool name for writes.
+ *
+ * Example: "active-alerts" → "store_active_alerts"
+ */
+export declare function storeToToolName(storeName: string): string;
+/**
+ * Find a LoadedStore by its generated tool name.
+ *
+ * Returns undefined if no store matches.
+ */
+export declare function findStoreByToolName(stores: LoadedStore[], toolName: string): LoadedStore | undefined;

package/dist/src/repo/store-tool-schema.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Convert a StoreFieldDefinition to a JSON Schema property.
+ */
+export function fieldToJsonSchema(field) {
+    switch (field.type) {
+        case 'string':
+            return { type: 'string' };
+        case 'number': {
+            const schema = { type: 'number' };
+            if (field.min !== undefined)
+                schema['minimum'] = field.min;
+            if (field.max !== undefined)
+                schema['maximum'] = field.max;
+            return schema;
+        }
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'datetime':
+            return { type: 'string', format: 'date-time' };
+        case 'enum':
+            return { type: 'string', enum: field.values ?? [] };
+        case 'array': {
+            const items = field.item ? fieldToJsonSchema(field.item) : { type: 'string' };
+            return { type: 'array', items };
+        }
+        case 'object': {
+            if (!field.fields) {
+                return { type: 'object' };
+            }
+            const properties = {};
+            const required = [];
+            for (const [name, subField] of Object.entries(field.fields)) {
+                properties[name] = fieldToJsonSchema(subField);
+                if (!subField.nullable) {
+                    required.push(name);
+                }
+            }
+            const schema = { type: 'object', properties };
+            if (required.length > 0)
+                schema['required'] = required;
+            return schema;
+        }
+        case 'ref':
+            // Refs are stored as the key string of the referenced entity
+            return { type: 'string' };
+        default:
+            return { type: 'string' };
+    }
+}
+/**
+ * Wrap a JSON Schema property to allow null if the field is nullable.
+ */
+function wrapNullable(schema, field) {
+    if (!field.nullable)
+        return schema;
+    return { oneOf: [schema, { type: 'null' }] };
+}
+/**
+ * Convert a LoadedStore into a JSON Schema suitable for an LLM tool's `parameters`.
+ *
+ * The resulting schema has `type: 'object'` with `properties` derived from the
+ * entity schema, and `required` listing all non-nullable fields.
+ */
+export function storeToJsonSchema(store) {
+    const properties = {};
+    const required = [];
+    for (const [name, field] of Object.entries(store.entity.schema)) {
+        properties[name] = wrapNullable(fieldToJsonSchema(field), field);
+        if (!field.nullable) {
+            required.push(name);
+        }
+    }
+    const schema = {
+        type: 'object',
+        properties,
+    };
+    if (required.length > 0) {
+        schema['required'] = required;
+    }
+    return schema;
+}
+/**
+ * Convert a store name (kebab-case) to a tool name for writes.
+ *
+ * Example: "active-alerts" → "store_active_alerts"
+ */
+export function storeToToolName(storeName) {
+    return `store_${storeName.replace(/-/g, '_')}`;
+}
+/**
+ * Find a LoadedStore by its generated tool name.
+ *
+ * Returns undefined if no store matches.
+ */
+export function findStoreByToolName(stores, toolName) {
+    return stores.find((s) => storeToToolName(s.name) === toolName);
+}
+//# sourceMappingURL=store-tool-schema.js.map

package/dist/src/repo/store-tool-schema.js.map

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