@clowder-ai/plugin-contract 0.1.0-beta.2 → 0.1.0-beta.21

package/dist/conformance/stdio-harness/windows-sentinel.js

@@ -0,0 +1,160 @@
+import { spawn, } from 'node:child_process';
+const WINDOWS_SENTINEL_SOURCE = String.raw `
+const { spawn } = require('node:child_process');
+
+let target;
+let targetExitSent = false;
+const keepAlive = setInterval(() => {}, 0x3fffffff);
+
+function send(message) {
+  if (process.connected) {
+    process.send(message, () => {});
+  }
+}
+
+function sendError(error) {
+  send({
+    type: 'target-error',
+    name: error && error.name ? String(error.name) : 'Error',
+    message: error && error.message ? String(error.message) : String(error),
+    code: error && error.code !== undefined ? String(error.code) : undefined,
+  });
+}
+
+function sendExit(code, signal) {
+  if (!targetExitSent) {
+    targetExitSent = true;
+    send({ type: 'target-exit', code, signal });
+  }
+}
+
+process.on('message', (message) => {
+  if (!message || typeof message !== 'object') return;
+  if (message.type === 'launch' && target === undefined) {
+    try {
+      target = spawn(message.command, message.args, {
+        stdio: ['inherit', 'inherit', 'inherit'],
+      });
+      target.once('error', (error) => {
+        sendError(error);
+        sendExit(null, null);
+      });
+      target.once('exit', sendExit);
+    } catch (error) {
+      sendError(error);
+      sendExit(null, null);
+    }
+    return;
+  }
+  if (message.type === 'signal' && target !== undefined) {
+    try {
+      target.kill(message.signal);
+    } catch (error) {
+      sendError(error);
+    }
+  }
+});
+
+process.on('disconnect', () => {
+  clearInterval(keepAlive);
+  if (process.platform === 'win32') {
+    const cleanup = spawn(
+      'taskkill',
+      ['/pid', String(process.pid), '/t', '/f'],
+      { detached: true, stdio: 'ignore', windowsHide: true },
+    );
+    cleanup.unref();
+  } else if (target !== undefined) {
+    target.kill('SIGKILL');
+  }
+});
+`;
+export function spawnWindowsSentinel(options) {
+    const root = spawn(process.execPath, ['-e', WINDOWS_SENTINEL_SOURCE], {
+        cwd: options.cwd,
+        env: options.env,
+        stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        windowsHide: true,
+    });
+    let targetExit;
+    let targetError;
+    const exitListeners = [];
+    const errorListeners = [];
+    const publishTargetError = (error) => {
+        targetError ??= error;
+        for (const listener of errorListeners.splice(0)) {
+            listener(targetError);
+        }
+    };
+    const publishTargetExit = (code, signal) => {
+        if (targetExit !== undefined) {
+            return;
+        }
+        targetExit = { code, signal };
+        for (const listener of exitListeners.splice(0)) {
+            listener(code, signal);
+        }
+    };
+    root.on('message', (message) => {
+        if (!isSentinelMessage(message)) {
+            return;
+        }
+        if (message.type === 'target-error') {
+            const error = new Error(message.message ?? 'Windows sentinel target failed');
+            error.name = message.name ?? 'Error';
+            if (message.code !== undefined) {
+                Object.assign(error, { code: message.code });
+            }
+            publishTargetError(error);
+            return;
+        }
+        publishTargetExit(typeof message.code === 'number' ? message.code : null, message.signal ?? null);
+    });
+    root.once('error', publishTargetError);
+    root.once('close', (code, signal) => publishTargetExit(code, signal));
+    root.once('spawn', () => {
+        root.send({ type: 'launch', command: options.command, args: [...options.args] }, (error) => {
+            if (error !== null) {
+                publishTargetError(error);
+                publishTargetExit(null, null);
+            }
+        });
+    });
+    return {
+        root,
+        onTargetError: (listener) => {
+            if (targetError === undefined) {
+                errorListeners.push(listener);
+            }
+            else {
+                const error = targetError;
+                queueMicrotask(() => listener(error));
+            }
+        },
+        onTargetExit: (listener) => {
+            if (targetExit === undefined) {
+                exitListeners.push(listener);
+            }
+            else {
+                const exit = targetExit;
+                queueMicrotask(() => listener(exit.code, exit.signal));
+            }
+        },
+        signalTarget: (signal) => {
+            if (root.connected) {
+                root.send({ type: 'signal', signal }, (error) => {
+                    if (error !== null) {
+                        publishTargetError(error);
+                    }
+                });
+            }
+        },
+    };
+}
+function isSentinelMessage(message) {
+    return (typeof message === 'object' &&
+        message !== null &&
+        'type' in message &&
+        (message.type === 'target-error' || message.type === 'target-exit'));
+}
+//# sourceMappingURL=windows-sentinel.js.map

package/dist/conformance/stdio-harness/windows-sentinel.js.map

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

package/dist/conformance/stdio-harness/wire-shape.d.ts

@@ -0,0 +1,18 @@
+import type { HarnessChild } from './child-process-harness.js';
+import type { DecodedNdjsonFrame, JsonObject } from './ndjson-frame.js';
+/**
+ * Deliberate seam for the P-1a contract output.
+ *
+ * This skeleton owns process and frame transport only. The #1165 frozen
+ * shape (rev11) is now shape-approved; the wire module mechanizes its
+ * 13-row registry, disposition table, and closed error envelopes. This
+ * seam will be replaced by a concrete codec backed by those wire types
+ * when the handshake rows (1, 2) reach CLOSED leaf closure.
+ */
+export interface HarnessWireShape<Outbound, Inbound> {
+    readonly status: 'shape-approved';
+    encode(message: Outbound): JsonObject;
+    decode(frame: DecodedNdjsonFrame): Inbound;
+    performHelloReady(child: HarnessChild): Promise<void>;
+}
+//# sourceMappingURL=wire-shape.d.ts.map

package/dist/conformance/stdio-harness/wire-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-shape.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/wire-shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ,EAAE,OAAO;IACjD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAC3C,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/conformance/stdio-harness/wire-shape.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wire-shape.js.map

package/dist/conformance/stdio-harness/wire-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-shape.js","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/wire-shape.ts"],"names":[],"mappings":""}

package/dist/docx-materialization.d.ts

@@ -0,0 +1,8 @@
+/** Browser-safe policy and generated types for the closed materializer boundary. */
+import { type DocxMaterializationOperation } from './generated/contract.generated.js';
+/** Defensive pre-parse worker check, derived from the same public schema as Host validation. */
+export declare function hasLosslessDocxOperationText(operation: DocxMaterializationOperation): boolean;
+export declare const DOCX_MATERIALIZATION_MAX_BYTES: number;
+export declare const DOCX_MATERIALIZATION_MAX_WIRE_BYTES: number;
+export type { DocxMaterializationAnchor, DocxMaterializationAttribution, DocxMaterializationOperation, DocxMaterializationRequest, DocxMaterializationResponse, DocxMaterializationResult, } from './generated/contract.generated.js';
+//# sourceMappingURL=docx-materialization.d.ts.map

package/dist/docx-materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-materialization.d.ts","sourceRoot":"","sources":["../src/docx-materialization.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAC;AAK3C,gGAAgG;AAChG,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,4BAA4B,GAAG,OAAO,CAQ7F;AAED,eAAO,MAAM,8BAA8B,QAAkB,CAAC;AAC9D,eAAO,MAAM,mCAAmC,QAAmB,CAAC;AACpE,YAAY,EACV,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,mCAAmC,CAAC"}

package/dist/docx-materialization.js

@@ -0,0 +1,19 @@
+/** Browser-safe policy and generated types for the closed materializer boundary. */
+import { DOCX_MATERIALIZATION_AUTHOR_PATTERN, DOCX_MATERIALIZATION_TEXT_PATTERN, } from './generated/contract.generated.js';
+const text = new RegExp(DOCX_MATERIALIZATION_TEXT_PATTERN, 'u');
+const author = new RegExp(DOCX_MATERIALIZATION_AUTHOR_PATTERN, 'u');
+/** Defensive pre-parse worker check, derived from the same public schema as Host validation. */
+export function hasLosslessDocxOperationText(operation) {
+    if (operation?.kind === 'inspect')
+        return true;
+    if (operation?.kind !== 'tracked-change' && operation?.kind !== 'comment')
+        return false;
+    const value = operation.kind === 'tracked-change' ? operation.replacement : operation.body;
+    const attribution = operation.attribution;
+    return typeof value === 'string' && text.test(value)
+        && typeof attribution?.author === 'string' && author.test(attribution.author)
+        && typeof attribution.timestamp === 'string' && author.test(attribution.timestamp);
+}
+export const DOCX_MATERIALIZATION_MAX_BYTES = 8 * 1024 * 1024;
+export const DOCX_MATERIALIZATION_MAX_WIRE_BYTES = 12 * 1024 * 1024;
+//# sourceMappingURL=docx-materialization.js.map

package/dist/docx-materialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-materialization.js","sourceRoot":"","sources":["../src/docx-materialization.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EACL,mCAAmC,EACnC,iCAAiC,GAElC,MAAM,mCAAmC,CAAC;AAE3C,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;AAChE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;AAEpE,gGAAgG;AAChG,MAAM,UAAU,4BAA4B,CAAC,SAAuC;IAClF,IAAI,SAAS,EAAE,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,SAAS,EAAE,IAAI,KAAK,gBAAgB,IAAI,SAAS,EAAE,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxF,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;IAC3F,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;WAC/C,OAAO,WAAW,EAAE,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;WAC1E,OAAO,WAAW,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC"}