@substrate-ai/factory 0.19.54

package/dist/twins/registry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Twin Registry — Discovery, validation, and health polling for twin definitions.
+ *
+ * Story 47-1.
+ */
+import type { TwinDefinition, HealthPollResult } from './types.js';
+export declare class TwinRegistry {
+    private _twins;
+    /**
+     * Discovers and validates all *.yaml and *.yml twin definition files in the given directory.
+     * Non-recursive — only top-level files are processed.
+     *
+     * @throws {TwinDefinitionError} if a file contains invalid YAML or fails schema validation
+     * @throws {TwinRegistryError} if two files declare the same twin name
+     */
+    discover(dir: string): Promise<void>;
+    /**
+     * Returns all discovered twin definitions.
+     */
+    list(): TwinDefinition[];
+    /**
+     * Returns a twin definition by name, or undefined if not found.
+     */
+    get(name: string): TwinDefinition | undefined;
+    /**
+     * Polls the health endpoint of a twin definition until healthy or timed out.
+     *
+     * @param twin - The twin definition to poll
+     * @param options - Optional overrides (e.g., mock fetch for testing)
+     * @returns HealthPollResult indicating success or timeout
+     */
+    pollHealth(twin: TwinDefinition, options?: {
+        fetch?: typeof fetch;
+    }): Promise<HealthPollResult>;
+}
+/**
+ * Factory function that creates a new TwinRegistry instance.
+ */
+export declare function createTwinRegistry(): TwinRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/twins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/twins/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElE,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAyC;IAEvD;;;;;;OAMG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoH1C;;OAEG;IACH,IAAI,IAAI,cAAc,EAAE;IAIxB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;;;;;OAMG;IACG,UAAU,CACd,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;KAAE,GACjC,OAAO,CAAC,gBAAgB,CAAC;CA4C7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD"}

package/dist/twins/registry.js

@@ -0,0 +1,175 @@
+/**
+ * Twin Registry — Discovery, validation, and health polling for twin definitions.
+ *
+ * Story 47-1.
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import yaml from 'js-yaml';
+import { TwinDefinitionSchema } from './schema.js';
+import { TwinDefinitionError, TwinRegistryError } from './types.js';
+export class TwinRegistry {
+    _twins = new Map();
+    /**
+     * Discovers and validates all *.yaml and *.yml twin definition files in the given directory.
+     * Non-recursive — only top-level files are processed.
+     *
+     * @throws {TwinDefinitionError} if a file contains invalid YAML or fails schema validation
+     * @throws {TwinRegistryError} if two files declare the same twin name
+     */
+    async discover(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch (err) {
+            throw new TwinDefinitionError(`Failed to read directory: ${dir} — ${err.message}`);
+        }
+        const yamlFiles = entries.filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'));
+        // Collect per-file validation errors so that valid siblings are still discovered (AC3).
+        // TwinRegistryError (duplicate names) is still thrown immediately as a consistency error.
+        const perFileErrors = [];
+        for (const filename of yamlFiles) {
+            const filePath = resolve(join(dir, filename));
+            let raw;
+            try {
+                raw = await readFile(filePath, 'utf-8');
+            }
+            catch (err) {
+                perFileErrors.push(new TwinDefinitionError(`Failed to read file: ${filePath} — ${err.message}`, filePath));
+                continue;
+            }
+            // Parse YAML
+            let parsed;
+            try {
+                parsed = yaml.load(raw);
+            }
+            catch (err) {
+                perFileErrors.push(new TwinDefinitionError(`Twin definition at ${filePath} contains invalid YAML: ${err.message}`, filePath));
+                continue;
+            }
+            // Validate with Zod schema
+            const result = TwinDefinitionSchema.safeParse(parsed);
+            if (!result.success) {
+                const firstIssue = result.error.issues[0];
+                const fieldPath = firstIssue?.path?.join('.') ?? 'unknown';
+                const fieldMessage = firstIssue?.message ?? result.error.message;
+                // Provide a descriptive error distinguishing missing required fields from unknown fields
+                let message;
+                const issueCode = firstIssue?.code;
+                if (issueCode === 'unrecognized_keys') {
+                    // Zod v3: unrecognized_keys issue
+                    const keys = firstIssue.keys ?? [];
+                    message = `Twin definition at ${filePath} contains unrecognised field(s): ${keys.join(', ')}`;
+                }
+                else if (issueCode === 'unrecognized_key') {
+                    // Zod v4: single unrecognized_key issue
+                    const key = firstIssue.key ?? fieldPath;
+                    message = `Twin definition at ${filePath} contains unrecognised field(s): ${key}`;
+                }
+                else {
+                    // Determine if this is a missing required field by checking the parsed input directly
+                    const parsedObj = parsed;
+                    const isMissingField = parsedObj &&
+                        typeof parsedObj === 'object' &&
+                        fieldPath !== 'unknown' &&
+                        !(fieldPath in parsedObj);
+                    if (isMissingField) {
+                        message = `Twin definition at ${filePath} is missing required field: ${fieldPath}`;
+                    }
+                    else {
+                        message = `Twin definition at ${filePath} failed validation — ${fieldPath}: ${fieldMessage}`;
+                    }
+                }
+                perFileErrors.push(new TwinDefinitionError(message, filePath));
+                continue;
+            }
+            // Construct TwinDefinition manually to satisfy exactOptionalPropertyTypes —
+            // Zod types optional fields as `T | undefined` but TwinDefinition uses `T?` (absent).
+            const data = result.data;
+            const twin = {
+                name: data.name,
+                image: data.image,
+                ports: data.ports,
+                environment: data.environment,
+                sourceFile: filePath,
+                ...(data.healthcheck !== undefined && { healthcheck: data.healthcheck }),
+            };
+            // Check for duplicate names — throw immediately as a registry consistency error (AC4).
+            if (this._twins.has(twin.name)) {
+                const existing = this._twins.get(twin.name);
+                throw new TwinRegistryError(`Duplicate twin name "${twin.name}" found in: ${existing.sourceFile} and ${filePath}`);
+            }
+            this._twins.set(twin.name, twin);
+        }
+        // After processing all files, surface the first per-file validation error (AC3).
+        // Valid siblings have already been added to the registry above.
+        if (perFileErrors.length > 0) {
+            throw perFileErrors[0];
+        }
+    }
+    /**
+     * Returns all discovered twin definitions.
+     */
+    list() {
+        return Array.from(this._twins.values());
+    }
+    /**
+     * Returns a twin definition by name, or undefined if not found.
+     */
+    get(name) {
+        return this._twins.get(name);
+    }
+    /**
+     * Polls the health endpoint of a twin definition until healthy or timed out.
+     *
+     * @param twin - The twin definition to poll
+     * @param options - Optional overrides (e.g., mock fetch for testing)
+     * @returns HealthPollResult indicating success or timeout
+     */
+    async pollHealth(twin, options) {
+        const { healthcheck } = twin;
+        if (!healthcheck) {
+            return { healthy: true, attempts: 0 };
+        }
+        const fetchFn = options?.fetch ?? globalThis.fetch;
+        const { url, interval_ms = 500, timeout_ms = 10000 } = healthcheck;
+        const startTime = Date.now();
+        let attempts = 0;
+        while (true) {
+            attempts++;
+            try {
+                const response = await fetchFn(url);
+                if (response.ok) {
+                    return { healthy: true, attempts };
+                }
+            }
+            catch {
+                // Network error — treat as non-2xx, continue looping
+            }
+            const elapsed = Date.now() - startTime;
+            if (elapsed >= timeout_ms) {
+                return {
+                    healthy: false,
+                    error: `Health check timed out after ${timeout_ms}ms`,
+                };
+            }
+            // Wait before next attempt
+            await new Promise((resolve) => setTimeout(resolve, interval_ms));
+            // Check timeout again after sleep
+            if (Date.now() - startTime >= timeout_ms) {
+                return {
+                    healthy: false,
+                    error: `Health check timed out after ${timeout_ms}ms`,
+                };
+            }
+        }
+    }
+}
+/**
+ * Factory function that creates a new TwinRegistry instance.
+ */
+export function createTwinRegistry() {
+    return new TwinRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/twins/registry.js.map

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

package/dist/twins/run-state.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Run state management for digital twin sessions.
+ *
+ * Persists the compose directory path and started twin names to
+ * `.substrate/twins/.run-state.json` so that `twins stop` and `twins status`
+ * can locate the active session without Docker inspection.
+ *
+ * Story 47-5.
+ */
+/**
+ * Serialized state written by `twins start` and read by `twins stop`/`twins status`.
+ */
+export interface TwinRunState {
+    /** Absolute path to the temp directory containing the active docker-compose.yml */
+    composeDir: string;
+    /** Names of all twins included in this run */
+    twinNames: string[];
+    /** ISO 8601 timestamp of when the twins were started */
+    startedAt: string;
+}
+/**
+ * Returns the absolute path to the run-state JSON file for the given project.
+ *
+ * @param projectDir - Absolute path to the project root (usually `process.cwd()`)
+ */
+export declare function runStatePath(projectDir: string): string;
+/**
+ * Reads and JSON-parses the run-state file.
+ *
+ * @returns The parsed `TwinRunState`, or `null` if the file does not exist.
+ * @throws If any I/O error other than ENOENT occurs, or if the JSON is invalid.
+ */
+export declare function readRunState(projectDir: string): Promise<TwinRunState | null>;
+/**
+ * Writes the given run state to disk, creating parent directories as needed.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param state - The `TwinRunState` to persist
+ */
+export declare function writeRunState(projectDir: string, state: TwinRunState): Promise<void>;
+/**
+ * Deletes the run-state file. No-op if the file does not exist.
+ *
+ * @param projectDir - Absolute path to the project root
+ */
+export declare function clearRunState(projectDir: string): Promise<void>;
+//# sourceMappingURL=run-state.d.ts.map

package/dist/twins/run-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/twins/run-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAA;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAMD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CASnF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1F;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrE"}

package/dist/twins/run-state.js

@@ -0,0 +1,70 @@
+/**
+ * Run state management for digital twin sessions.
+ *
+ * Persists the compose directory path and started twin names to
+ * `.substrate/twins/.run-state.json` so that `twins stop` and `twins status`
+ * can locate the active session without Docker inspection.
+ *
+ * Story 47-5.
+ */
+import { readFile, writeFile, unlink, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Path helper
+// ---------------------------------------------------------------------------
+/**
+ * Returns the absolute path to the run-state JSON file for the given project.
+ *
+ * @param projectDir - Absolute path to the project root (usually `process.cwd()`)
+ */
+export function runStatePath(projectDir) {
+    return path.join(projectDir, '.substrate', 'twins', '.run-state.json');
+}
+// ---------------------------------------------------------------------------
+// Read / write / clear
+// ---------------------------------------------------------------------------
+/**
+ * Reads and JSON-parses the run-state file.
+ *
+ * @returns The parsed `TwinRunState`, or `null` if the file does not exist.
+ * @throws If any I/O error other than ENOENT occurs, or if the JSON is invalid.
+ */
+export async function readRunState(projectDir) {
+    const filePath = runStatePath(projectDir);
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Writes the given run state to disk, creating parent directories as needed.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param state - The `TwinRunState` to persist
+ */
+export async function writeRunState(projectDir, state) {
+    const filePath = runStatePath(projectDir);
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(state, null, 2), 'utf-8');
+}
+/**
+ * Deletes the run-state file. No-op if the file does not exist.
+ *
+ * @param projectDir - Absolute path to the project root
+ */
+export async function clearRunState(projectDir) {
+    const filePath = runStatePath(projectDir);
+    try {
+        await unlink(filePath);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+}
+//# sourceMappingURL=run-state.js.map

package/dist/twins/run-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.js","sourceRoot":"","sources":["../../src/twins/run-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,IAAI,MAAM,WAAW,CAAA;AAkB5B,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAA;AACxE,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAA;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACjE,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,KAAmB;IACzE,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACzC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAA;IACjE,CAAC;AACH,CAAC"}

package/dist/twins/schema.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Twin Registry — Zod validation schema for twin definition YAML files.
+ *
+ * Story 47-1.
+ */
+import { z } from 'zod';
+/**
+ * Validates a full twin definition. Unknown fields are rejected via `.strict()`.
+ */
+declare const twinDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    image: z.ZodString;
+    ports: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<{
+        host: number;
+        container: number;
+    }, string>>>>;
+    environment: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    healthcheck: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        interval_ms: z.ZodDefault<z.ZodNumber>;
+        timeout_ms: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const TwinDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    image: z.ZodString;
+    ports: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<{
+        host: number;
+        container: number;
+    }, string>>>>;
+    environment: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    healthcheck: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        interval_ms: z.ZodDefault<z.ZodNumber>;
+        timeout_ms: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type TwinDefinitionInput = z.input<typeof twinDefinitionSchema>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/twins/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/twins/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAyBvB;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;cAfgB,MAAM;mBAAa,MAAM;;;;;;;;kBAuBxD,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;;cAzBS,MAAM;mBAAa,MAAM;;;;;;;;kBAyBX,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/twins/schema.js

@@ -0,0 +1,46 @@
+/**
+ * Twin Registry — Zod validation schema for twin definition YAML files.
+ *
+ * Story 47-1.
+ */
+import { z } from 'zod';
+/**
+ * Validates and transforms a "host:container" port string into a PortMapping object.
+ */
+const portMappingStringSchema = z
+    .string()
+    .regex(/^\d+:\d+$/, 'Port mapping must be in "host:container" format (e.g., "5432:5432")')
+    .transform((val) => {
+    const parts = val.split(':');
+    const host = Number(parts[0]);
+    const container = Number(parts[1]);
+    return { host, container };
+});
+/**
+ * Validates a healthcheck configuration object.
+ */
+const twinHealthcheckSchema = z.object({
+    url: z.string().url('Healthcheck URL must be a valid URL'),
+    interval_ms: z.number().int().positive().default(500),
+    timeout_ms: z.number().int().positive().default(10000),
+});
+/**
+ * Validates a full twin definition. Unknown fields are rejected via `.strict()`.
+ */
+const twinDefinitionSchema = z
+    .object({
+    name: z.string().min(1, 'Twin name must not be empty'),
+    image: z.string().min(1, 'Twin image must not be empty'),
+    ports: z.array(portMappingStringSchema).default([]),
+    environment: z.record(z.string(), z.string()).default({}),
+    healthcheck: twinHealthcheckSchema.optional(),
+})
+    .strict();
+export const TwinDefinitionSchema = twinDefinitionSchema;
+// Compile-time assertion: schema output must be assignable to TwinDefinition (minus sourceFile
+// and healthcheck). The healthcheck field is excluded because Zod's `.optional()` produces
+// `T | undefined` which conflicts with exactOptionalPropertyTypes (which requires the field
+// to be absent, not explicitly undefined). The registry.ts constructor handles this mismatch
+// with a spread-based conditional assignment.
+const _schemaCompatCheck = {};
+//# sourceMappingURL=schema.js.map

package/dist/twins/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/twins/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;GAEG;AACH,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,KAAK,CAAC,WAAW,EAAE,qEAAqE,CAAC;KACzF,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAyC,CAAA;AACnE,CAAC,CAAC,CAAA;AAEJ;;GAEG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,qCAAqC,CAAC;IAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvD,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzD,WAAW,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAA;AAIxD,+FAA+F;AAC/F,2FAA2F;AAC3F,4FAA4F;AAC5F,6FAA6F;AAC7F,8CAA8C;AAC9C,MAAM,kBAAkB,GACtB,EAAgE,CAAA"}

package/dist/twins/templates.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Twin Template Catalog — pre-built twin definition templates for common external services.
+ *
+ * Story 47-4.
+ */
+import type { TwinDefinitionInput } from './schema.js';
+/**
+ * A single entry in the twin template catalog.
+ */
+export interface TwinTemplateEntry {
+    name: string;
+    description: string;
+    definition: TwinDefinitionInput;
+}
+/**
+ * Map of all built-in twin templates, keyed by template name.
+ */
+export declare const TWIN_TEMPLATES: Map<string, TwinTemplateEntry>;
+/**
+ * Returns all available twin template entries.
+ */
+export declare function listTwinTemplates(): TwinTemplateEntry[];
+/**
+ * Returns the twin template entry for the given name, or `undefined` if not found.
+ */
+export declare function getTwinTemplate(name: string): TwinTemplateEntry | undefined;
+//# sourceMappingURL=templates.d.ts.map

package/dist/twins/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/twins/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,mBAAmB,CAAA;CAChC;AA4CD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAGxD,CAAA;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAEvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE3E"}

package/dist/twins/templates.js

@@ -0,0 +1,63 @@
+/**
+ * Twin Template Catalog — pre-built twin definition templates for common external services.
+ *
+ * Story 47-4.
+ */
+// ---------------------------------------------------------------------------
+// Built-in templates
+// ---------------------------------------------------------------------------
+const localstackTemplate = {
+    name: 'localstack',
+    description: 'LocalStack — AWS cloud service emulator (S3, SQS, DynamoDB)',
+    definition: {
+        name: 'localstack',
+        image: 'localstack/localstack:latest',
+        ports: ['4566:4566'],
+        environment: {
+            SERVICES: 's3,sqs,dynamodb',
+        },
+        healthcheck: {
+            url: 'http://localhost:4566/_localstack/health',
+            interval_ms: 500,
+            timeout_ms: 10000,
+        },
+    },
+};
+const wiremockTemplate = {
+    name: 'wiremock',
+    description: 'WireMock — HTTP API mock and stub server',
+    definition: {
+        name: 'wiremock',
+        image: 'wiremock/wiremock:latest',
+        ports: ['8080:8080'],
+        environment: {},
+        healthcheck: {
+            url: 'http://localhost:8080/__admin/health',
+            interval_ms: 500,
+            timeout_ms: 10000,
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Template catalog
+// ---------------------------------------------------------------------------
+/**
+ * Map of all built-in twin templates, keyed by template name.
+ */
+export const TWIN_TEMPLATES = new Map([
+    [localstackTemplate.name, localstackTemplate],
+    [wiremockTemplate.name, wiremockTemplate],
+]);
+/**
+ * Returns all available twin template entries.
+ */
+export function listTwinTemplates() {
+    return Array.from(TWIN_TEMPLATES.values());
+}
+/**
+ * Returns the twin template entry for the given name, or `undefined` if not found.
+ */
+export function getTwinTemplate(name) {
+    return TWIN_TEMPLATES.get(name);
+}
+//# sourceMappingURL=templates.js.map

package/dist/twins/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/twins/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,kBAAkB,GAAsB;IAC5C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6DAA6D;IAC1E,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,8BAA8B;QACrC,KAAK,EAAE,CAAC,WAAW,CAAC;QACpB,WAAW,EAAE;YACX,QAAQ,EAAE,iBAAiB;SAC5B;QACD,WAAW,EAAE;YACX,GAAG,EAAE,0CAA0C;YAC/C,WAAW,EAAE,GAAG;YAChB,UAAU,EAAE,KAAK;SAClB;KACF;CACF,CAAA;AAED,MAAM,gBAAgB,GAAsB;IAC1C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,0CAA0C;IACvD,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,0BAA0B;QACjC,KAAK,EAAE,CAAC,WAAW,CAAC;QACpB,WAAW,EAAE,EAAE;QACf,WAAW,EAAE;YACX,GAAG,EAAE,sCAAsC;YAC3C,WAAW,EAAE,GAAG;YAChB,UAAU,EAAE,KAAK;SAClB;KACF;CACF,CAAA;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmC,IAAI,GAAG,CAAC;IACpE,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAC7C,CAAC,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC;CAC1C,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC"}

package/dist/twins/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Twin Registry — Type definitions for TwinDefinition and related interfaces.
+ *
+ * Story 47-1.
+ */
+/**
+ * Represents a host:container port mapping for a digital twin service.
+ */
+export interface PortMapping {
+    host: number;
+    container: number;
+}
+/**
+ * Healthcheck configuration for a digital twin service.
+ */
+export interface TwinHealthcheck {
+    url: string;
+    interval_ms?: number;
+    timeout_ms?: number;
+}
+/**
+ * Full definition of a digital twin service, parsed from a YAML file.
+ */
+export interface TwinDefinition {
+    name: string;
+    image: string;
+    ports: PortMapping[];
+    environment: Record<string, string>;
+    healthcheck?: TwinHealthcheck;
+    sourceFile?: string;
+}
+/**
+ * Result of polling a twin's health endpoint.
+ */
+export type HealthPollResult = {
+    healthy: true;
+    attempts: number;
+} | {
+    healthy: false;
+    error: string;
+};
+/**
+ * Thrown when a single twin definition file fails validation or parsing.
+ */
+export declare class TwinDefinitionError extends Error {
+    readonly sourceFile?: string | undefined;
+    constructor(message: string, sourceFile?: string | undefined);
+}
+/**
+ * Thrown when a registry-level constraint is violated (e.g., duplicate twin names).
+ */
+export declare class TwinRegistryError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/twins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/twins/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/twins/types.js

@@ -0,0 +1,26 @@
+/**
+ * Twin Registry — Type definitions for TwinDefinition and related interfaces.
+ *
+ * Story 47-1.
+ */
+/**
+ * Thrown when a single twin definition file fails validation or parsing.
+ */
+export class TwinDefinitionError extends Error {
+    sourceFile;
+    constructor(message, sourceFile) {
+        super(message);
+        this.sourceFile = sourceFile;
+        this.name = 'TwinDefinitionError';
+    }
+}
+/**
+ * Thrown when a registry-level constraint is violated (e.g., duplicate twin names).
+ */
+export class TwinRegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TwinRegistryError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/twins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/twins/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsCH;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG1B;IAFlB,YACE,OAAe,EACC,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF"}