@zaalipro/dsh-workflows 0.1.0-rc.3

package/lib/types/supervisor/types.d.ts.map

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

package/lib/types/supervisor/types.js

@@ -0,0 +1,3 @@
+/** Success coverage sentence required by 6.5 / SH8; never a live-tool claim. */
+export const VALIDATION_NOTE = 'Validated one args-selected path with canned agent results; other branches, live tools, and live schema responses were not covered.';
+//# sourceMappingURL=types.js.map

package/lib/types/supervisor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/supervisor/types.ts"],"names":[],"mappings":"AAmGA,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,qIAAqI,CAAA"}

package/lib/types/supervisor/value-view.d.ts

@@ -0,0 +1,19 @@
+import type { JsonValue } from './storage/manifest-types.js';
+import type { WorkflowRunValueView } from './types.js';
+/** Project a detached, complete JSON value or a UTF-8-safe bounded preview. */
+export declare function workflowRunValueView(value: unknown, maxBytes: number): WorkflowRunValueView;
+/** Backwards-compatible spelling used by early package previews. */
+export declare const workflowValueView: typeof workflowRunValueView;
+/** Validate that a value is lossless JSON data and return a deep snapshot. */
+export declare function snapshotWorkflowJsonValue(value: unknown): JsonValue;
+/** Last non-empty assistant/message text in a child session log. */
+export declare function lastAssistantText(events: unknown): string | undefined;
+/** Recover a stock child agent's reply when journal-commit never fired. */
+export declare function childTranscriptValue(ctx: unknown, childId: unknown): JsonValue | undefined;
+/** Promote a stored not-produced/pending member when a child transcript is still reachable. */
+export declare function memberOutcomeWithTranscript(ctx: unknown, member: {
+    readonly outcome: 'pending' | 'available' | 'not-produced' | 'evicted';
+    readonly status: string;
+    readonly childSessionId?: string;
+}): 'pending' | 'available' | 'not-produced' | 'evicted';
+//# sourceMappingURL=value-view.d.ts.map

package/lib/types/supervisor/value-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-view.d.ts","sourceRoot":"","sources":["../../../src/supervisor/value-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAgBtD,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAqB3F;AAED,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,6BAAuB,CAAA;AAErD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAyDnE;AAqBD,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYrE;AAiBD,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAY1F;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5I,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,SAAS,CAKtD"}

package/lib/types/supervisor/value-view.js

@@ -0,0 +1,183 @@
+const encoder = new TextEncoder();
+function utf8Prefix(text, maxBytes) {
+    let result = '';
+    let retainedBytes = 0;
+    for (const codePoint of text) {
+        const codePointBytes = encoder.encode(codePoint).byteLength;
+        if (retainedBytes + codePointBytes > maxBytes)
+            break;
+        result += codePoint;
+        retainedBytes += codePointBytes;
+    }
+    return result;
+}
+/** Project a detached, complete JSON value or a UTF-8-safe bounded preview. */
+export function workflowRunValueView(value, maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+        throw new TypeError('workflow member outcome maxBytes must be a positive safe integer');
+    }
+    const snapshot = snapshotWorkflowJsonValue(value);
+    const text = JSON.stringify(snapshot, null, 2);
+    const totalBytes = encoder.encode(text).byteLength;
+    if (totalBytes <= maxBytes) {
+        return {
+            state: 'available',
+            content: { kind: 'value', value: snapshot },
+            totalBytes,
+            truncated: false,
+        };
+    }
+    return {
+        state: 'available',
+        content: { kind: 'preview', text: utf8Prefix(text, maxBytes) },
+        totalBytes,
+        truncated: true,
+    };
+}
+/** Backwards-compatible spelling used by early package previews. */
+export const workflowValueView = workflowRunValueView;
+/** Validate that a value is lossless JSON data and return a deep snapshot. */
+export function snapshotWorkflowJsonValue(value) {
+    const stack = new Set();
+    const invalid = () => {
+        throw new TypeError('workflow value is not lossless JSON');
+    };
+    const walk = (input) => {
+        if (input === null || typeof input === 'string' || typeof input === 'boolean')
+            return input;
+        if (typeof input === 'number') {
+            if (!Number.isFinite(input) || Object.is(input, -0))
+                return invalid();
+            return input;
+        }
+        if (typeof input !== 'object')
+            return invalid();
+        if (stack.has(input))
+            throw new TypeError('workflow value is cyclic');
+        stack.add(input);
+        try {
+            if (Array.isArray(input)) {
+                const keys = Object.keys(input);
+                if (keys.length !== input.length
+                    || keys.some((key, index) => key !== String(index))
+                    || Reflect.ownKeys(input).some(key => typeof key === 'symbol')) {
+                    throw new TypeError('workflow array is sparse or decorated');
+                }
+                const output = [];
+                for (let index = 0; index < input.length; index += 1) {
+                    const descriptor = Object.getOwnPropertyDescriptor(input, String(index));
+                    if (descriptor === undefined || !('value' in descriptor)) {
+                        throw new TypeError('workflow array is sparse or decorated');
+                    }
+                    output.push(walk(descriptor.value));
+                }
+                return output;
+            }
+            const prototype = Object.getPrototypeOf(input);
+            if (prototype !== Object.prototype && prototype !== null)
+                return invalid();
+            const output = Object.create(null);
+            for (const key of Reflect.ownKeys(input)) {
+                if (typeof key !== 'string')
+                    return invalid();
+                const descriptor = Object.getOwnPropertyDescriptor(input, key);
+                if (descriptor === undefined || !descriptor.enumerable || !('value' in descriptor))
+                    return invalid();
+                Object.defineProperty(output, key, {
+                    value: walk(descriptor.value),
+                    enumerable: true,
+                    configurable: true,
+                    writable: true,
+                });
+            }
+            return output;
+        }
+        finally {
+            stack.delete(input);
+        }
+    };
+    return walk(value);
+}
+function assistantTextBlocks(message) {
+    const content = message?.content;
+    if (typeof content === 'string')
+        return content.trim();
+    if (!Array.isArray(content)) {
+        return typeof message?.text === 'string'
+            ? String(message.text).trim()
+            : '';
+    }
+    const parts = [];
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        if (block.type !== 'text')
+            continue;
+        if (typeof block.text !== 'string')
+            continue;
+        const text = block.text.trim();
+        if (text.length > 0)
+            parts.push(text);
+    }
+    return parts.join('\n');
+}
+/** Last non-empty assistant/message text in a child session log. */
+export function lastAssistantText(events) {
+    if (!Array.isArray(events))
+        return undefined;
+    let last;
+    for (const event of events) {
+        if (typeof event !== 'object' || event === null)
+            continue;
+        if (event.type !== 'assistant/message')
+            continue;
+        const data = event.data;
+        const message = data?.message ?? data;
+        const text = assistantTextBlocks(message);
+        if (text.length > 0)
+            last = text;
+    }
+    return last;
+}
+function serviceGet(ctx, name) {
+    const record = ctx;
+    if (record?.[name] != null)
+        return record[name];
+    if (typeof record?.get === 'function')
+        return record.get(name);
+    return undefined;
+}
+function eventsFromAgent(record) {
+    return record?.session?.events;
+}
+function eventsFromSession(record) {
+    return record?.events;
+}
+/** Recover a stock child agent's reply when journal-commit never fired. */
+export function childTranscriptValue(ctx, childId) {
+    if (typeof childId !== 'string' || childId.length === 0)
+        return undefined;
+    try {
+        const agents = serviceGet(ctx, 'agents');
+        const sessions = serviceGet(ctx, 'sessions');
+        const text = lastAssistantText(eventsFromAgent(agents?.get?.(childId)))
+            ?? lastAssistantText(eventsFromSession(sessions?.get?.(childId)));
+        if (text === undefined)
+            return undefined;
+        return snapshotWorkflowJsonValue(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Promote a stored not-produced/pending member when a child transcript is still reachable. */
+export function memberOutcomeWithTranscript(ctx, member) {
+    if (member.outcome === 'available' || member.outcome === 'evicted')
+        return member.outcome;
+    if (member.outcome === 'pending' && member.status === 'running')
+        return 'pending';
+    if (childTranscriptValue(ctx, member.childSessionId) !== undefined)
+        return 'available';
+    return member.outcome;
+}
+//# sourceMappingURL=value-view.js.map

package/lib/types/supervisor/value-view.js.map

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

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

@@ -0,0 +1,86 @@
+import type { WorkflowRegistry } from '../registry/index.js';
+import type { WorkflowDefinitionEnvelope } from '../registry/types.js';
+import { VALIDATION_NOTE } from '../supervisor/index.js';
+import type { WorkflowSupervisor } from '../supervisor/index.js';
+import type { JsonValue } from '@deepseek-ai/dsh-session';
+import { parseWorkflowToolRequest } from './schema.js';
+export * from './schema.js';
+export { VALIDATION_NOTE };
+/**
+ * Opaque contribution identities for a Host that exposes atomic replacement.
+ * Until the Host exports these exact objects, identity matching uses this
+ * package freeze plus an explicit official marker; a same-name custom tool is
+ * never treated as official.
+ */
+export declare const WORKFLOW_TOOL_DEFINITION: any;
+export declare const WORKFLOW_PROMPT_SECTION: any;
+/** Public-fingerprint check used only for stock's Agent-scoped shadow seam. */
+export declare function isStockOfficialWorkflowTool(value: unknown): boolean;
+type WorkflowToolOutput = {
+    status: 'started';
+    displayName: string;
+    runId: string;
+    script_path?: string;
+} | {
+    status: 'resumed';
+    displayName: string;
+    runId: string;
+} | {
+    status: 'validated';
+    ok: true;
+    result?: JsonValue;
+    saved_path?: string;
+};
+export interface WorkflowToolServices {
+    readonly registry: WorkflowRegistry;
+    readonly supervisor: WorkflowSupervisor;
+    readonly recorder?: {
+        launch(session: any, start: () => Promise<any>): Promise<any>;
+    };
+    readonly fs?: HostWorkflowFs;
+    readonly definitionMaxBytes?: number;
+    readonly maxResultChars?: number;
+}
+interface HostWorkflowFs {
+    readBytesNoFollow?(path: string, options: {
+        cwd?: string;
+    }, signal?: AbortSignal, maxBytes?: number): Promise<Uint8Array>;
+    resolve?(path: string, options?: {
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    lstat?(path: string, options?: {
+        cwd?: string;
+    }, signal?: AbortSignal): Promise<unknown>;
+    processPath?(target: unknown): string;
+    fileUrl?(target: unknown): string;
+    readBytes?(target: unknown, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>;
+}
+/** Verified identity/marker or stock fingerprint; custom same-name tools are not official. */
+export declare function isOfficialWorkflowTool(definition: unknown): boolean;
+/** Render the launch/validate outcome for the tool result. */
+export declare function renderLaunch(value: WorkflowToolOutput, maxChars?: number): string;
+/** Shadow one Agent via atomic CAS or rollback-safe scoped registrations. */
+export declare function installWorkflowShadow(agent: any, servicesOrTool: WorkflowToolServices | any): () => void;
+export interface ToolShadowConfig {
+    readonly enabled?: boolean;
+    readonly services?: WorkflowToolServices;
+}
+/** Reconcile exact-Agent shadows on Agent/tool lifecycle changes. */
+export declare function applyToolShadow(ctx: any, config?: ToolShadowConfig): (() => void) | undefined;
+export interface ResolvedWorkflowSource {
+    readonly script: string;
+    readonly meta: WorkflowDefinitionEnvelope['meta'];
+    readonly args: Record<string, unknown>;
+    readonly filename: string;
+}
+interface ResolveOptions {
+    readonly agent?: any;
+    readonly signal?: AbortSignal;
+    readonly definitionMaxBytes?: number;
+}
+/** Resolve exactly one validated model source without following its final path component. */
+export declare function resolveWorkflowSource(ctx: any, request: ReturnType<typeof parseWorkflowToolRequest>, options?: ResolveOptions): Promise<ResolvedWorkflowSource>;
+/** Create the exact model-facing background workflow operation. */
+export declare function createWorkflowTool(services: WorkflowToolServices): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//# sourceMappingURL=index.d.ts.map

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

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