@clowder-ai/plugin-sdk 0.1.0-beta.10

package/dist/feature-context.js

@@ -0,0 +1,210 @@
+import { validateManifest, } from '@clowder-ai/plugin-contract';
+export class FeatureContextRevokedError extends Error {
+    constructor() {
+        super('feature context has been revoked');
+        this.name = 'FeatureContextRevokedError';
+    }
+}
+export class ContributionConflictError extends Error {
+    constructor(key) {
+        super(`contribution ${key} is already registered with a different payload`);
+        this.name = 'ContributionConflictError';
+    }
+}
+function canonicalJson(value, ancestors = new Set()) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return JSON.stringify(value);
+    if (typeof value === 'number' && Number.isFinite(value))
+        return JSON.stringify(value);
+    if (typeof value !== 'object')
+        throw new TypeError('contribution payload must contain only JSON values');
+    if (ancestors.has(value))
+        throw new TypeError('contribution payload must not contain JSON cycles');
+    if (Object.getOwnPropertySymbols(value).length > 0) {
+        throw new TypeError('contribution payload must contain only JSON string keys');
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (Array.isArray(value) ? prototype !== Array.prototype : prototype !== Object.prototype && prototype !== null) {
+        throw new TypeError('contribution payload must contain only plain JSON objects or arrays');
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            if (Object.keys(value).some((key) => !/^(0|[1-9][0-9]*)$/.test(key) || Number(key) >= value.length)) {
+                throw new TypeError('contribution payload must contain only JSON array elements');
+            }
+            const elements = [];
+            const length = value.length;
+            for (let index = 0; index < length; index += 1) {
+                if (!Object.hasOwn(value, index))
+                    throw new TypeError('contribution payload must not contain JSON array holes');
+                elements.push(canonicalJson(value[index], ancestors));
+            }
+            return `[${elements.join(',')}]`;
+        }
+        const object = value;
+        return `{${Object.keys(object)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${canonicalJson(object[key], ancestors)}`)
+            .join(',')}}`;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
+        for (const nested of Object.values(value))
+            deepFreeze(nested);
+        Object.freeze(value);
+    }
+    return value;
+}
+/**
+ * Creates the author-facing context around a Host-issued binding.
+ *
+ * This helper does not grant authority: every adapter operation carries the opaque lease and the Host
+ * remains responsible for verifying its signature, revisions, grants, integrity epoch, and liveness.
+ */
+export function createFeatureContextSession(binding, adapter) {
+    let revoked = false;
+    let revokePromise;
+    const active = new Map();
+    const assertActive = () => {
+        if (revoked)
+            throw new FeatureContextRevokedError();
+    };
+    const register = async (type, input) => {
+        assertActive();
+        const digest = canonicalJson({ ...input, type });
+        // Dispatch exactly the JSON snapshot used for identity; cloning first can
+        // silently erase non-JSON keys, while reading twice can invoke changing getters.
+        const contribution = deepFreeze(JSON.parse(digest));
+        const key = `${type}:${contribution.id}`;
+        const existing = active.get(key);
+        if (existing !== undefined) {
+            if (existing.disposePromise !== undefined) {
+                await existing.disposePromise.catch(() => undefined);
+                assertActive();
+                return register(type, input);
+            }
+            if (existing.digest !== digest)
+                throw new ContributionConflictError(key);
+            const registration = await existing.promise;
+            if (revoked) {
+                await registration.dispose().catch(() => undefined);
+                throw new FeatureContextRevokedError();
+            }
+            return registration;
+        }
+        let entry;
+        const promise = adapter.registerContribution(binding, contribution).then((receipt) => {
+            const registration = {
+                key,
+                receipt,
+                dispose: () => {
+                    if (entry.disposePromise !== undefined)
+                        return entry.disposePromise;
+                    entry.disposePromise = adapter.disposeContribution(binding, receipt).then(() => {
+                        if (active.get(key) === entry)
+                            active.delete(key);
+                    }, (error) => {
+                        entry.disposePromise = undefined;
+                        throw error;
+                    });
+                    return entry.disposePromise;
+                },
+            };
+            return registration;
+        });
+        entry = { digest, promise };
+        active.set(key, entry);
+        let registered = false;
+        try {
+            const registration = await promise;
+            registered = true;
+            if (revoked) {
+                await registration.dispose().catch(() => undefined);
+                throw new FeatureContextRevokedError();
+            }
+            return registration;
+        }
+        catch (error) {
+            if (!registered && active.get(key) === entry)
+                active.delete(key);
+            throw error;
+        }
+    };
+    const registrar = (type) => ({
+        register: (input) => register(type, input),
+    });
+    const runWhileActive = async (operation) => {
+        assertActive();
+        const result = await operation();
+        assertActive();
+        return result;
+    };
+    const readConfig = async (key) => {
+        return runWhileActive(() => adapter.readConfig(binding, key));
+    };
+    const readSecret = async (key) => {
+        return runWhileActive(() => adapter.readSecret(binding, key));
+    };
+    const readState = async (key) => {
+        return runWhileActive(() => adapter.readState(binding, key));
+    };
+    const writeState = async (key, value) => {
+        return runWhileActive(() => adapter.writeState(binding, key, value));
+    };
+    const subscriptions = registrar('message-subscription');
+    const context = {
+        featureId: binding.featureId,
+        config: { get: readConfig },
+        secrets: { get: readSecret },
+        state: { get: readState, set: writeState },
+        identity: registrar('identity'),
+        scheduler: registrar('schedule'),
+        tools: registrar('tool'),
+        mcp: registrar('mcp'),
+        skills: registrar('skill'),
+        limbs: registrar('limb'),
+        webhooks: registrar('webhook'),
+        messaging: { subscribe: subscriptions.register },
+        services: registrar('service'),
+        connectors: registrar('connector'),
+        ui: registrar('ui'),
+        contentEditors: registrar('content-editor-provider'),
+    };
+    return {
+        context,
+        revoke: () => {
+            revoked = true;
+            if (revokePromise !== undefined)
+                return revokePromise;
+            revokePromise = Promise.all([...active.values()].map(async (entry) => (await entry.promise).dispose())).then(() => undefined, (error) => {
+                revokePromise = undefined;
+                throw error;
+            });
+            return revokePromise;
+        },
+    };
+}
+/** Validate one manifest truth and bind only activators for declared feature IDs. */
+export function definePlugin(input) {
+    const validation = validateManifest(input.manifest);
+    if (!validation.valid) {
+        throw new TypeError(`plugin manifest is invalid: ${validation.errors[0]?.message ?? 'unknown error'}`);
+    }
+    const featureIds = new Set(validation.manifest.features.map((feature) => feature.id));
+    const activate = input.activate === undefined ? {} : input.activate;
+    for (const featureId of Object.keys(activate)) {
+        if (!featureIds.has(featureId)) {
+            throw new TypeError(`activator ${featureId} is not declared by the plugin manifest`);
+        }
+    }
+    const manifest = deepFreeze(structuredClone(validation.manifest));
+    return Object.freeze({ manifest, activate: Object.freeze({ ...activate }) });
+}
+//# sourceMappingURL=feature-context.js.map

package/dist/feature-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-context.js","sourceRoot":"","sources":["../src/feature-context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAgBjB,MAAM,6BAA6B,CAAC;AA+BrC,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD;QACE,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,GAAW;QACrB,KAAK,CAAC,gBAAgB,GAAG,iDAAiD,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAiDD,SAAS,aAAa,CAAC,KAAc,EAAE,YAAY,IAAI,GAAG,EAAU;IAClE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1F,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IACzG,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IACnG,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAChH,MAAM,IAAI,SAAS,CAAC,qEAAqE,CAAC,CAAC;IAC7F,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpG,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;oBAAE,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;gBAChH,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QACnC,CAAC;QACD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC3B,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;aAC/E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAuB,EACvB,OAA2B;IAE3B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,aAAwC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAErD,MAAM,YAAY,GAAG,GAAS,EAAE;QAC9B,IAAI,OAAO;YAAE,MAAM,IAAI,0BAA0B,EAAE,CAAC;IACtD,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EACpB,IAAe,EACf,KAA2B,EACQ,EAAE;QACrC,YAAY,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,0EAA0E;QAC1E,iFAAiF;QACjF,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAiB,CAAC;QACpE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,YAAY,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,QAAQ,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBAC1C,MAAM,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACrD,YAAY,EAAE,CAAC;gBACf,OAAO,QAAQ,CAAI,IAAI,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM;gBAAE,MAAM,IAAI,yBAAyB,CAAC,GAAG,CAAC,CAAC;YACzE,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;YAC5C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACpD,MAAM,IAAI,0BAA0B,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,IAAI,KAAyB,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACnF,MAAM,YAAY,GAA6B;gBAC7C,GAAG;gBACH,OAAO;gBACP,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS;wBAAE,OAAO,KAAK,CAAC,cAAc,CAAC;oBACpE,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CACvE,GAAG,EAAE;wBACH,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK;4BAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACpD,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;wBACjB,KAAK,CAAC,cAAc,GAAG,SAAS,CAAC;wBACjC,MAAM,KAAK,CAAC;oBACd,CAAC,CACF,CAAC;oBACF,OAAO,KAAK,CAAC,cAAc,CAAC;gBAC9B,CAAC;aACF,CAAC;YACF,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,KAAK,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC;YACnC,UAAU,GAAG,IAAI,CAAC;YAClB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACpD,MAAM,IAAI,0BAA0B,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK;gBAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAA+B,IAAe,EAA4B,EAAE,CAAC,CAAC;QAC9F,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAI,IAAI,EAAE,KAAK,CAAC;KAC9C,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,KAAK,EAAK,SAA2B,EAAc,EAAE;QAC1E,YAAY,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,YAAY,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE;QACzD,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAmB,EAAE;QACxD,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE;QACxD,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAE,KAAc,EAAiB,EAAE;QACtE,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,SAAS,CAAkC,sBAAsB,CAAC,CAAC;IACzF,MAAM,OAAO,GAAmB;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE;QAC3B,OAAO,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE;QAC5B,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE;QAC1C,QAAQ,EAAE,SAAS,CAAuB,UAAU,CAAC;QACrD,SAAS,EAAE,SAAS,CAAuB,UAAU,CAAC;QACtD,KAAK,EAAE,SAAS,CAAyB,MAAM,CAAC;QAChD,GAAG,EAAE,SAAS,CAAkB,KAAK,CAAC;QACtC,MAAM,EAAE,SAAS,CAAoB,OAAO,CAAC;QAC7C,KAAK,EAAE,SAAS,CAAmB,MAAM,CAAC;QAC1C,QAAQ,EAAE,SAAS,CAAsB,SAAS,CAAC;QACnD,SAAS,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,QAAQ,EAAE;QAChD,QAAQ,EAAE,SAAS,CAAsB,SAAS,CAAC;QACnD,UAAU,EAAE,SAAS,CAAwB,WAAW,CAAC;QACzD,EAAE,EAAE,SAAS,CAAiB,IAAI,CAAC;QACnC,cAAc,EAAE,SAAS,CAAoC,yBAAyB,CAAC;KACxF,CAAC;IAEF,OAAO;QACL,OAAO;QACP,MAAM,EAAE,GAAG,EAAE;YACX,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,aAAa,KAAK,SAAS;gBAAE,OAAO,aAAa,CAAC;YACtD,aAAa,GAAG,OAAO,CAAC,GAAG,CACzB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAC3E,CAAC,IAAI,CACJ,GAAG,EAAE,CAAC,SAAS,EACf,CAAC,KAAc,EAAE,EAAE;gBACjB,aAAa,GAAG,SAAS,CAAC;gBAC1B,MAAM,KAAK,CAAC;YACd,CAAC,CACF,CAAC;YACF,OAAO,aAAa,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAcD,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,KAA4B;IACvD,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,+BAA+B,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IACpE,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,SAAS,CAAC,aAAa,SAAS,yCAAyC,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/handshake-client.d.ts

@@ -0,0 +1,66 @@
+import { type BrokerReadyParams, type CandidateHello, type HandshakeRejectReason, type SessionBinding } from '@clowder-ai/plugin-contract';
+export type HandshakePhase = 'candidate' | 'bound' | 'activated' | 'rejected';
+export interface CandidateHandshakeState {
+    readonly phase: 'candidate';
+    readonly candidate: CandidateHello;
+}
+export interface BoundHandshakeState {
+    readonly phase: 'bound';
+    readonly candidate: CandidateHello;
+    readonly binding: SessionBinding;
+}
+export interface ActivatedHandshakeState {
+    readonly phase: 'activated';
+    readonly candidate: CandidateHello;
+    readonly binding: SessionBinding;
+    readonly activation: BrokerReadyParams;
+}
+export interface RejectedHandshakeState {
+    readonly phase: 'rejected';
+    readonly reason: HandshakeRejectReason;
+}
+export type LocalHandshakeState = CandidateHandshakeState | BoundHandshakeState | ActivatedHandshakeState | RejectedHandshakeState;
+export interface HandshakeValidationLevels {
+    /** All H1–H9 fields use the published beta.8 closed grammar. */
+    readonly contractFields: 'full';
+}
+export interface CandidateHandshakeIntent {
+    readonly kind: 'candidate';
+    readonly transport: 'local-only';
+    readonly candidate: CandidateHello;
+    readonly validation: HandshakeValidationLevels;
+}
+export interface BindingHandshakeIntent {
+    readonly kind: 'binding';
+    readonly transport: 'local-only';
+    readonly binding: SessionBinding;
+    readonly validation: HandshakeValidationLevels;
+}
+export interface ActivationHandshakeIntent {
+    readonly kind: 'activation';
+    readonly transport: 'local-only';
+    readonly ready: BrokerReadyParams;
+    readonly validation: HandshakeValidationLevels;
+}
+/**
+ * Objects in this union are deliberately codec-free. They retain the future
+ * HarnessWireShape outbound/inbound orientation without constructing wire
+ * frames. The published contract now owns the complete beta.8 grammar.
+ */
+export type LocalHandshakeIntent = CandidateHandshakeIntent | BindingHandshakeIntent | ActivationHandshakeIntent;
+export type LocalHandshakeTransition = {
+    readonly accepted: true;
+    readonly state: CandidateHandshakeState | BoundHandshakeState | ActivatedHandshakeState;
+    readonly intent: LocalHandshakeIntent;
+} | {
+    readonly accepted: false;
+    readonly reason: HandshakeRejectReason;
+    readonly state: RejectedHandshakeState;
+};
+/** Starts a local-only handshake by validating the candidate claims. */
+export declare function beginLocalHandshake(candidate: unknown): LocalHandshakeTransition;
+/** Accepts a Host-provided binding only from the local candidate state. */
+export declare function acceptSessionBinding(state: LocalHandshakeState, binding: unknown): LocalHandshakeTransition;
+/** Creates the local activation intent after the binding nonce oracle passes. */
+export declare function prepareActivation(state: LocalHandshakeState, ready: unknown): LocalHandshakeTransition;
+//# sourceMappingURL=handshake-client.d.ts.map

package/dist/handshake-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake-client.d.ts","sourceRoot":"","sources":["../src/handshake-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED,MAAM,MAAM,mBAAmB,GAC3B,uBAAuB,GACvB,mBAAmB,GACnB,uBAAuB,GACvB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,sBAAsB,GACtB,yBAAyB,CAAC;AAE9B,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;IACxF,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC,CAAC;AAsEN,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,wBAAwB,CAgBhF;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,OAAO,GACf,wBAAwB,CAuB1B;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,OAAO,GACb,wBAAwB,CAqB1B"}

package/dist/handshake-client.js

@@ -0,0 +1,124 @@
+import { HANDSHAKE_REJECT_REASONS, validateBrokerReadyParams, validateCandidateHello, validateSessionBinding, } from '@clowder-ai/plugin-contract';
+const HANDSHAKE_REASON_SET = new Set(HANDSHAKE_REJECT_REASONS);
+const CLOSED_CONTRACT = {
+    contractFields: 'full',
+};
+function reject(reason) {
+    if (!HANDSHAKE_REASON_SET.has(reason)) {
+        throw new RangeError(`unknown handshake rejection reason: ${reason}`);
+    }
+    return { accepted: false, reason, state: { phase: 'rejected', reason } };
+}
+function snapshotCandidate(candidate) {
+    return {
+        pluginId: candidate.pluginId,
+        packageDigest: candidate.packageDigest,
+        contractVersion: candidate.contractVersion,
+        wireVersion: candidate.wireVersion,
+    };
+}
+function snapshotBinding(binding) {
+    return {
+        pluginId: binding.pluginId,
+        packageDigest: binding.packageDigest,
+        contractVersion: binding.contractVersion,
+        wireVersion: binding.wireVersion,
+        pluginInstanceId: binding.pluginInstanceId,
+        brokerSessionId: binding.brokerSessionId,
+        grantRevision: binding.grantRevision,
+        effectiveGrants: [...binding.effectiveGrants],
+        bindingNonce: binding.bindingNonce,
+    };
+}
+function snapshotReady(ready) {
+    return { bindingNonce: ready.bindingNonce };
+}
+function isCandidateHello(value) {
+    return validateCandidateHello(value);
+}
+function validateBinding(candidate, value) {
+    if (!validateSessionBinding(value)) {
+        return { valid: false, reason: 'AUTHORITY_VIOLATION' };
+    }
+    if (value.pluginId !== candidate.pluginId || value.packageDigest !== candidate.packageDigest) {
+        return { valid: false, reason: 'PACKAGE_MISMATCH' };
+    }
+    if (value.contractVersion !== candidate.contractVersion) {
+        return { valid: false, reason: 'CONTRACT_INCOMPATIBLE' };
+    }
+    if (value.wireVersion !== candidate.wireVersion) {
+        return { valid: false, reason: 'WIRE_INCOMPATIBLE' };
+    }
+    return { valid: true, binding: snapshotBinding(value) };
+}
+function validateReady(value, binding) {
+    return (validateBrokerReadyParams(value) &&
+        value.bindingNonce === binding.bindingNonce);
+}
+/** Starts a local-only handshake by validating the candidate claims. */
+export function beginLocalHandshake(candidate) {
+    if (!isCandidateHello(candidate)) {
+        return reject('MALFORMED_HELLO');
+    }
+    const candidateSnapshot = snapshotCandidate(candidate);
+    const state = { phase: 'candidate', candidate: candidateSnapshot };
+    return {
+        accepted: true,
+        state,
+        intent: {
+            kind: 'candidate',
+            transport: 'local-only',
+            candidate: candidateSnapshot,
+            validation: CLOSED_CONTRACT,
+        },
+    };
+}
+/** Accepts a Host-provided binding only from the local candidate state. */
+export function acceptSessionBinding(state, binding) {
+    if (state.phase !== 'candidate') {
+        return reject('BINDING_REPLAY');
+    }
+    const result = validateBinding(state.candidate, binding);
+    if (!result.valid) {
+        return reject(result.reason);
+    }
+    const next = {
+        phase: 'bound',
+        candidate: state.candidate,
+        binding: result.binding,
+    };
+    return {
+        accepted: true,
+        state: next,
+        intent: {
+            kind: 'binding',
+            transport: 'local-only',
+            binding: result.binding,
+            validation: CLOSED_CONTRACT,
+        },
+    };
+}
+/** Creates the local activation intent after the binding nonce oracle passes. */
+export function prepareActivation(state, ready) {
+    if (state.phase !== 'bound' || !validateReady(ready, state.binding)) {
+        return reject('BINDING_REPLAY');
+    }
+    const readySnapshot = snapshotReady(ready);
+    const next = {
+        phase: 'activated',
+        candidate: state.candidate,
+        binding: state.binding,
+        activation: readySnapshot,
+    };
+    return {
+        accepted: true,
+        state: next,
+        intent: {
+            kind: 'activation',
+            transport: 'local-only',
+            ready: readySnapshot,
+            validation: CLOSED_CONTRACT,
+        },
+    };
+}
+//# sourceMappingURL=handshake-client.js.map

package/dist/handshake-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Public SDK entrypoint.
+ *
+ * This package exposes:
+ *   1. Schema-neutral NDJSON transport (stdio-runtime, S0/#12)
+ *   2. Wire dispatch classifier (wire-dispatch, S1)
+ *
+ * The beta.8 handshake, beta.9 events.publish, beta.10 lifecycle, and beta.11
+ * messaging rows are executable. SDK beta.10 adds the content editor provider
+ * registrar to the Train B author facade without widening the frozen M0 wire registry.
+ * The dispatch classifier gates every method before standalone callbacks or
+ * Host-bound transport behavior can run.
+ */
+export { NdjsonFrameError, StdioRuntimeFatalError, createStdioChannel, startStdioRuntime, type StdioChannel, type StdioChannelOptions, type JsonObject, type StdioFrame, type StdioFrameErrorCode, type StdioFrameHandler, type StdioRuntimeFatalReason, type StdioRuntimeFatalErrorOptions, type StdioRuntimeOptions, } from './stdio-runtime.js';
+export { loadStandaloneManifest, ManifestStartupError, startStandaloneHost, type StandaloneHost, type StandaloneHostOptions, type StandaloneMessageDisposition, type StandaloneMessageHandler, } from './standalone-host.js';
+export { acceptSessionBinding, beginLocalHandshake, prepareActivation, type ActivatedHandshakeState, type ActivationHandshakeIntent, type BindingHandshakeIntent, type BoundHandshakeState, type CandidateHandshakeIntent, type CandidateHandshakeState, type HandshakePhase, type HandshakeValidationLevels, type LocalHandshakeIntent, type LocalHandshakeState, type LocalHandshakeTransition, type RejectedHandshakeState, } from './handshake-client.js';
+export { classifyFrame, type DispatchResult, type InFlightEntry, type RequestSnapshot, } from './wire-dispatch.js';
+export { EventsPublishError, createEventsPublisher, type EventsPublishErrorCode, type EventsPublishHostTransport, type StdioSessionLiveness, type EventsPublisherOptions, type EventsPublisher, } from './events-publisher.js';
+export { ContributionConflictError, FeatureContextRevokedError, createFeatureContextSession, definePlugin, type ContributionRegistration, type ContributionRegistrar, type DefinedPlugin, type FeatureActivator, type FeatureBinding, type FeatureContext, type FeatureContextSession, type FeatureHostAdapter, type HostContributionReceipt, type PluginDefinitionInput, } from './feature-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Public SDK entrypoint.
+ *
+ * This package exposes:
+ *   1. Schema-neutral NDJSON transport (stdio-runtime, S0/#12)
+ *   2. Wire dispatch classifier (wire-dispatch, S1)
+ *
+ * The beta.8 handshake, beta.9 events.publish, beta.10 lifecycle, and beta.11
+ * messaging rows are executable. SDK beta.10 adds the content editor provider
+ * registrar to the Train B author facade without widening the frozen M0 wire registry.
+ * The dispatch classifier gates every method before standalone callbacks or
+ * Host-bound transport behavior can run.
+ */
+export { NdjsonFrameError, StdioRuntimeFatalError, createStdioChannel, startStdioRuntime, } from './stdio-runtime.js';
+export { loadStandaloneManifest, ManifestStartupError, startStandaloneHost, } from './standalone-host.js';
+export { acceptSessionBinding, beginLocalHandshake, prepareActivation, } from './handshake-client.js';
+export { classifyFrame, } from './wire-dispatch.js';
+export { EventsPublishError, createEventsPublisher, } from './events-publisher.js';
+export { ContributionConflictError, FeatureContextRevokedError, createFeatureContextSession, definePlugin, } from './feature-context.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAUlB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAalB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,GAId,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GAMtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,YAAY,GAWb,MAAM,sBAAsB,CAAC"}

package/dist/standalone-host.d.ts

@@ -0,0 +1,55 @@
+import type { Readable, Writable } from 'node:stream';
+import { type DeliverInput, type DeliveryRejectReason, type ManifestValidationError, type PluginManifest } from '@clowder-ai/plugin-contract';
+import { type StdioChannel, type StdioRuntimeFatalError } from './stdio-runtime.js';
+export declare class ManifestStartupError extends Error {
+    readonly errors: readonly ManifestValidationError[];
+    constructor(errors: readonly ManifestValidationError[]);
+}
+export interface StandaloneHostOptions {
+    /** Untrusted manifest content; it is validated before stdio starts. */
+    readonly manifest: unknown;
+    /** Caller-owned streams are useful for embedding and tests; provide both or neither. */
+    readonly input?: Readable;
+    readonly output?: Writable;
+    /**
+     * Runs before the closed drain row is acknowledged with `result: null`.
+     * A cleanup that outlives its drain deadline is acknowledged as expired;
+     * callers that need cancellation must arrange it within their callback.
+     */
+    readonly onDrain?: (input: {
+        readonly deadlineUnixMs: number;
+    }) => void | Promise<void>;
+    /**
+     * Handles the ready Host-to-plugin messaging callback and reports only the
+     * plugin-observed delivery fact. Retry and dead-letter policy remain Host-owned.
+     */
+    readonly onMessage?: StandaloneMessageHandler;
+    readonly onFatal?: (error: StdioRuntimeFatalError) => void;
+}
+export type StandaloneMessageDisposition = {
+    readonly accepted: true;
+} | {
+    readonly accepted: false;
+    readonly reason: DeliveryRejectReason;
+};
+export type StandaloneMessageHandler = (input: DeliverInput) => StandaloneMessageDisposition | Promise<StandaloneMessageDisposition>;
+export interface StandaloneHost extends StdioChannel {
+    readonly manifest: PluginManifest;
+}
+/**
+ * Loads and contract-validates a manifest file for a standalone plugin.
+ *
+ * File and JSON parsing errors deliberately propagate: callers have not yet
+ * started a transport, so no protocol peer can observe a partial startup.
+ */
+export declare function loadStandaloneManifest(path: string | URL): Promise<PluginManifest>;
+/**
+ * Starts the fail-closed plugin-side standalone shell.
+ *
+ * A manifest is validated by the published contract runtime before any stdio
+ * listener is attached. Lifecycle rows execute locally. beta.8 handshake
+ * requests reach the handler only to receive a conservative standard error;
+ * no Broker behavior is present in this shell.
+ */
+export declare function startStandaloneHost(options: StandaloneHostOptions): StandaloneHost;
+//# sourceMappingURL=standalone-host.d.ts.map

package/dist/standalone-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-host.d.ts","sourceRoot":"","sources":["../src/standalone-host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAWL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAIL,KAAK,YAAY,EAEjB,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAG5B,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;gBAExC,MAAM,EAAE,SAAS,uBAAuB,EAAE;CAKvD;AAED,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,YAAY,KAChB,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;AAE1E,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAyBD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAExF;AAiND;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAsBlF"}