@zaalipro/dsh-workflows 0.1.0-rc.3

package/lib/types/registry/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/registry/definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAG1B,aAAa,EACd,MAAM,YAAY,CAAC;AA8GpB;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,kBAAkB,CAmBpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAStH;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,SAAwB,GAC7B,0BAA0B,CAmB5B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,UAAU,CAG5F;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,CAEhF;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/lib/types/registry/definition.js

@@ -0,0 +1,189 @@
+import { posix } from 'node:path';
+import { assertWorkflowDefinitionName, isWorkflowDefinitionName } from './names.js';
+const ENVELOPE_KEYS = new Set(['meta', 'script']);
+const META_KEYS = new Set(['name', 'description', 'whenToUse', 'phases']);
+const PHASE_KEYS = new Set(['title', 'detail', 'provider', 'model']);
+const utf8Decoder = new TextDecoder('utf-8', { fatal: true });
+const utf8Encoder = new TextEncoder();
+function own(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function record(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function fail(path, message, cause) {
+    throw new Error(`${path}: ${message}`, cause === undefined ? undefined : { cause });
+}
+function renderThrown(error) {
+    try {
+        return String(error);
+        /* c8 ignore start -- JSON.parse never throws an unrenderable value */
+    }
+    catch {
+        return '[unrenderable thrown value]';
+    }
+    /* c8 ignore stop */
+}
+function requireString(value, field, path, nonEmpty = false) {
+    if (typeof value !== 'string' || (nonEmpty && value.length === 0)) {
+        fail(path, `${field} must be ${nonEmpty ? 'a non-empty' : 'a'} string`);
+    }
+    return value;
+}
+function unknownFields(value, allowed) {
+    return Object.keys(value).filter(key => !allowed.has(key));
+}
+/** Validate the official workflow metadata data shape and return a detached copy. */
+function validateMeta(value, path) {
+    if (!record(value))
+        fail(path, 'meta must be a plain object');
+    const extraMeta = unknownFields(value, META_KEYS);
+    if (extraMeta.length > 0)
+        fail(path, `unknown metadata field(s) ${extraMeta.join(', ')}`);
+    const name = requireString(value.name, 'meta.name', path, true);
+    assertWorkflowDefinitionName(name, path);
+    const description = requireString(value.description, 'meta.description', path, true);
+    const result = { name, description };
+    // Official validateMeta treats explicit undefined optional values as absent.
+    if (value.whenToUse !== undefined) {
+        result.whenToUse = requireString(value.whenToUse, 'meta.whenToUse', path);
+    }
+    if (value.phases !== undefined) {
+        if (!Array.isArray(value.phases))
+            fail(path, 'meta.phases must be an array');
+        result.phases = value.phases.map((phase, index) => {
+            const label = `meta.phases[${index}]`;
+            if (!record(phase))
+                fail(path, `${label} must be a plain object`);
+            const extraPhase = unknownFields(phase, PHASE_KEYS);
+            if (extraPhase.length > 0)
+                fail(path, `unknown phase field(s) ${extraPhase.join(', ')}`);
+            const normalized = {
+                title: requireString(phase.title, `${label}.title`, path, true),
+            };
+            for (const key of ['detail', 'provider', 'model']) {
+                if (phase[key] !== undefined)
+                    normalized[key] = requireString(phase[key], `${label}.${key}`, path);
+            }
+            return normalized;
+        });
+    }
+    return result;
+}
+function parseEnvelope(value, path, expectedName) {
+    if (!record(value))
+        fail(path, 'a workflow envelope must be a JSON object with { meta, script }');
+    const extra = unknownFields(value, ENVELOPE_KEYS);
+    if (extra.length > 0)
+        fail(path, `unknown envelope field(s) ${extra.join(', ')} (expected { meta, script })`);
+    if (!own(value, 'meta') || !own(value, 'script')) {
+        fail(path, 'a workflow envelope must be a JSON object with { meta, script }');
+    }
+    if (typeof value.script !== 'string')
+        fail(path, 'envelope "script" must be a string');
+    if (!isWorkflowDefinitionName(expectedName)) {
+        fail(path, `filename stem "${expectedName}" is not a valid workflow name`);
+    }
+    const expected = assertWorkflowDefinitionName(expectedName, path);
+    const meta = validateMeta(value.meta, path);
+    if (meta.name !== expected) {
+        fail(path, `filename "${expected}.workflow.json" must match meta.name "${meta.name}"`);
+    }
+    return {
+        name: meta.name,
+        description: meta.description,
+        ...(meta.whenToUse === undefined ? {} : { whenToUse: meta.whenToUse }),
+        ...(meta.phases === undefined ? {} : { phases: meta.phases }),
+        path,
+        script: value.script,
+    };
+}
+/**
+ * Parse a byte-bounded, fatal-UTF-8 workflow envelope and verify that its
+ * metadata name equals the filename-derived expected name.
+ */
+export function parseWorkflowDefinition(bytes, path, scope, expectedName, maxBytes) {
+    if (!(bytes instanceof Uint8Array))
+        fail(path, 'workflow definition bytes must be a Uint8Array');
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)
+        fail(path, 'definition byte limit must be a positive safe integer');
+    if (bytes.byteLength > maxBytes)
+        fail(path, `definition exceeds the ${maxBytes}-byte limit`);
+    let raw;
+    try {
+        raw = utf8Decoder.decode(bytes);
+    }
+    catch (error) {
+        fail(path, 'definition is not valid UTF-8', error);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        fail(path, `not valid JSON — ${renderThrown(error)}`, error);
+    }
+    return { ...parseEnvelope(parsed, path, expectedName), scope };
+}
+/**
+ * Compatibility parser for already-decoded definition text. Filesystem
+ * callers should prefer {@link parseWorkflowDefinition} so the byte cap and
+ * fatal UTF-8 decoding occur at the same boundary.
+ */
+export function parseDefinitionFile(raw, path, expectedName) {
+    if (typeof raw !== 'string')
+        fail(path, 'workflow definition text must be a string');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        fail(path, `not valid JSON — ${renderThrown(error)}`, error);
+    }
+    return parseEnvelope(parsed, path, expectedName);
+}
+/** Validate an in-memory envelope and return a normalized detached copy. */
+export function validateDefinitionEnvelope(envelope, source = 'workflow definition') {
+    if (!record(envelope))
+        fail(source, 'a workflow envelope must be a JSON object with { meta, script }');
+    const extra = unknownFields(envelope, ENVELOPE_KEYS);
+    if (extra.length > 0)
+        fail(source, `unknown envelope field(s) ${extra.join(', ')} (expected { meta, script })`);
+    if (!own(envelope, 'meta') || !own(envelope, 'script')) {
+        fail(source, 'a workflow envelope must be a JSON object with { meta, script }');
+    }
+    if (typeof envelope.script !== 'string')
+        fail(source, 'envelope "script" must be a string');
+    const meta = validateMeta(envelope.meta, source);
+    const script = envelope.script;
+    return {
+        meta: {
+            name: meta.name,
+            description: meta.description,
+            ...(meta.whenToUse === undefined ? {} : { whenToUse: meta.whenToUse }),
+            ...(meta.phases === undefined ? {} : { phases: meta.phases }),
+        },
+        script,
+    };
+}
+/**
+ * Serialize a revalidated envelope to canonical UTF-8 bytes. Key order is
+ * `meta`, then `script`, indentation is two spaces, and exactly one LF follows.
+ */
+export function serializeWorkflowDefinition(envelope) {
+    const normalized = validateDefinitionEnvelope(envelope);
+    return utf8Encoder.encode(`${JSON.stringify({ meta: normalized.meta, script: normalized.script }, null, 2)}\n`);
+}
+/** Legacy string serializer retained for source compatibility. */
+export function serializeDefinition(envelope) {
+    return utf8Decoder.decode(serializeWorkflowDefinition(envelope));
+}
+/** Extract the name candidate from one direct definition entry. */
+export function filenameStem(path) {
+    const value = posix.basename(path.replaceAll('\\', '/'));
+    return value.endsWith('.workflow.json') ? value.slice(0, -'.workflow.json'.length) : value;
+}
+//# sourceMappingURL=definition.js.map

package/lib/types/registry/definition.js.map

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

package/lib/types/registry/index.d.ts

@@ -0,0 +1,100 @@
+import type { RegistryConfig, WorkflowCatalogSnapshot, WorkflowDefinition, WorkflowDefinitionEnvelope, WorkflowDefinitionSummary, WorkflowLookupOptions, WorkflowSaveOptions } from './types.js';
+export * from './types.js';
+export * from './names.js';
+export * from './definition.js';
+export * from './roots.js';
+export * from './watchers.js';
+/** Stable package error for malformed/unsafe registry observations. */
+export declare class WorkflowRegistryError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string, options?: ErrorOptions);
+}
+interface HostDirectory {
+    openDirectory?: (name: string, signal?: AbortSignal) => Promise<HostDirectory>;
+    readBytes: (name: string, signal: AbortSignal | undefined, maxBytes: number) => Promise<Uint8Array>;
+    writeText: (name: string, content: string, expected: HostWriteIntent, signal?: AbortSignal) => Promise<unknown>;
+    assertIdentity(signal?: AbortSignal): Promise<void>;
+    close(): Promise<void>;
+}
+type HostWriteIntent = {
+    readonly kind: 'createIfAbsent';
+} | {
+    readonly kind: 'replaceIfVersion';
+    readonly version: unknown;
+};
+interface HostFileSystem {
+    resolve(path: string, options?: {
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    processPath?: (target: unknown) => string;
+    contains(parent: unknown, child: unknown): boolean;
+    lstat(path: string, options?: {
+        cwd?: string;
+    }, signal?: AbortSignal): Promise<{
+        readonly type: string;
+        readonly size?: number;
+        readonly version?: unknown;
+    } | undefined>;
+    stat(target: unknown, signal?: AbortSignal): Promise<{
+        readonly type: string;
+        readonly version: unknown;
+    } | undefined>;
+    listDir(target: unknown, signal?: AbortSignal): Promise<readonly {
+        readonly name: string;
+        readonly type: string;
+        readonly target?: unknown;
+    }[]>;
+    readBytesNoFollow(path: string, options: {
+        cwd?: string;
+    }, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>;
+    writeTextNoFollow?: (path: string, options: {
+        cwd?: string;
+    }, content: string, expected: HostWriteIntent, signal?: AbortSignal) => Promise<unknown>;
+    openPrivateDirectory?: (path: string, options: {
+        cwd?: string;
+        create?: boolean;
+    }, signal?: AbortSignal) => Promise<HostDirectory>;
+}
+interface RegistryContext {
+    fs?: HostFileSystem;
+    emit?: (event: string, ...args: unknown[]) => void;
+    logger?: {
+        warn(...args: unknown[]): void;
+    };
+}
+/** Saved-definition registry. Host capability I/O is authoritative when supplied. */
+export declare class WorkflowRegistry {
+    static readonly inject: readonly ["fs"];
+    readonly config: Required<Pick<RegistryConfig, 'enabled' | 'definitionWatch' | 'definitionMaxBytes' | 'maxDefinitionsPerRoot' | 'watchMaxProjects' | 'watchStabilityThresholdMs' | 'watchPollIntervalMs'>> & RegistryConfig;
+    private readonly ctx?;
+    private readonly dshHome;
+    private readonly fs?;
+    private readonly watchers?;
+    private revision;
+    private disposed;
+    private watcherGeneration;
+    constructor(ctxOrConfig?: RegistryContext | RegistryConfig, config?: RegistryConfig);
+    private roots;
+    private ensureWatchers;
+    private discoverRoot;
+    private requireLookupCwd;
+    /** List all winning definitions, sorted by UTF-16 code units. */
+    list(options?: WorkflowLookupOptions): Promise<readonly WorkflowDefinitionSummary[]>;
+    /** Return a bounded catalog snapshot; complete is false if a watcher raced it. */
+    snapshot(options?: WorkflowLookupOptions): Promise<WorkflowCatalogSnapshot>;
+    /** Resolve one full winning definition (script is never exposed by list). */
+    get(name: string, options?: WorkflowLookupOptions): Promise<WorkflowDefinition | undefined>;
+    /**
+     * Save a canonical definition through the Host descriptor capability. The
+     * guarded local path is also the stock RC2 compatibility seam when its Host
+     * filesystem does not expose retained private-directory descriptors.
+     */
+    save(envelope: WorkflowDefinitionEnvelope, options: WorkflowSaveOptions): Promise<WorkflowDefinition>;
+    private saveHost;
+    private saveLocal;
+    private emitChange;
+    /** Await watcher teardown; no late callback can publish a change hint. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/types/registry/index.d.ts.map

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