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

package/dist/contract-mirror.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Contract-mirror constants — runtime key sets and enum values that
+ * mirror @clowder-ai/plugin-contract TypeScript interfaces and types.
+ *
+ * These exist because the contract expresses certain closed constraints
+ * (additionalProperties: false, enum unions) only at the type level,
+ * with no runtime array/set export.
+ *
+ * ## DELETION TARGET
+ *
+ * Every constant in this module is scheduled for deletion when the
+ * contract exports a runtime equivalent (beta.5 delta scope, Fable
+ * ruling on S1 R3 contract seam). Each constant documents which
+ * contract source it mirrors.
+ *
+ * ## Drift prevention
+ *
+ * contract-mirror.test.ts verifies each constant against the contract
+ * source (schema JSON enum where available, structural assertions
+ * against contract types elsewhere). Drift = CI red.
+ *
+ * Pattern precedent: #10 MAX_FRAME_BYTES alias + drift test → Fable
+ * ruling 1 (fixtures test-only import) → this ruling (systematic).
+ */
+/**
+ * MessagingErrorCode runtime values.
+ *
+ * Mirror of: messaging.schema.json → definitions.MessagingErrorCode.enum
+ * Contract type: MessagingErrorCode (contract.generated.ts:217)
+ * Drift test: automated, vs schema JSON enum (exact member + order match)
+ */
+export declare const MESSAGING_ERROR_CODES: readonly ["VALIDATION", "PERMISSION", "NOT_FOUND", "CONFLICT", "RETRYABLE_INFLIGHT", "STALE_CURSOR"];
+export declare const MESSAGING_ERROR_CODE_SET: Set<string>;
+/**
+ * Mirror of: WireSuccessResponse interface (envelope.ts:108-113)
+ * Keys: jsonrpc, id, result — additionalProperties: false
+ */
+export declare const RESPONSE_SUCCESS_KEYS: Set<string>;
+/**
+ * Mirror of: WireApplicationErrorResponse / WireStandardErrorResponse
+ * (envelope.ts:129-166). Keys: jsonrpc, id, error — additionalProperties: false
+ */
+export declare const RESPONSE_ERROR_KEYS: Set<string>;
+/**
+ * Mirror of: WireNotification interface (envelope.ts:89-96)
+ * Keys: jsonrpc, method, params — additionalProperties: false
+ */
+export declare const NOTIFICATION_ALLOWED_KEYS: Set<string>;
+/**
+ * Mirror of: WireRequest interface (envelope.ts:66-75)
+ * Keys: jsonrpc, id, method, params — additionalProperties: false
+ */
+export declare const REQUEST_ALLOWED_KEYS: Set<string>;
+/**
+ * Mirror of: WireRequest.params / WireNotification.params (envelope.ts:71-74, 93-95)
+ * Keys: meta, input — additionalProperties: false
+ */
+export declare const PARAMS_ALLOWED_KEYS: Set<string>;
+/**
+ * Mirror of: CallMeta interface (envelope.ts:43-52)
+ * Keys: deadlineUnixMs — additionalProperties: false, v0 single field
+ */
+export declare const META_ALLOWED_KEYS: Set<string>;
+/** Mirror of: PingInput (row-shapes.ts:144-147). Keys: {nonce} */
+export declare const PING_INPUT_KEYS: Set<string>;
+/** Mirror of: DrainInput (row-shapes.ts:183-193). Keys: {deadlineUnixMs} */
+export declare const DRAIN_INPUT_KEYS: Set<string>;
+/** Mirror of: SubscribeInput (row-shapes.ts:27-30). Keys: {handle} */
+export declare const SUBSCRIBE_INPUT_KEYS: Set<string>;
+/** Mirror of: MessagingAckRequest (row-shapes.ts:76-81). Keys: {subscriptionId, ackToken} */
+export declare const ACK_INPUT_KEYS: Set<string>;
+/** Mirror of: GrantsChangedInput = GrantSnapshot (row-shapes.ts:128, grants.ts). Keys: {grantRevision, effectiveGrants} */
+export declare const GRANTS_CHANGED_INPUT_KEYS: Set<string>;
+/** Mirror of: CandidateHello (handshake.ts:62-71). */
+export declare const CANDIDATE_HELLO_KEYS: Set<string>;
+/** Mirror of: SessionBinding (handshake.ts:82-101). */
+export declare const SESSION_BINDING_KEYS: Set<string>;
+/** Mirror of: BrokerReadyParams (handshake.ts:113-116). */
+export declare const BROKER_READY_PARAMS_KEYS: Set<string>;
+/** Mirror of: PingResult (row-shapes.ts:152-158). Keys: {nonce} */
+export declare const PING_RESULT_KEYS: Set<string>;
+/** Mirror of: SubscribeResult (row-shapes.ts:35-39). Keys: {subscriptionId} */
+export declare const SUBSCRIBE_RESULT_KEYS: Set<string>;
+/**
+ * Mirror of: deliver acknowledgement result closed member set.
+ * Row 9 (host.messaging.deliver) has a frozen ack result shape
+ * {deliveryId: string, length 1..128 code points} — additionalProperties: false.
+ *
+ * Despite row 9 being RESERVED overall (DeliverResult = never in types),
+ * the ack shape is frozen per the #1165 protocol specification. The
+ * deliveryId echo is the fundamental delivery acknowledgement mechanism.
+ *
+ * Maintainer requirement: enforce closed member set + string bounds.
+ */
+export declare const DELIVER_RESULT_KEYS: Set<string>;
+/** Minimum deliveryId code-point length (frozen row 9 ack shape). */
+export declare const DELIVER_DELIVERY_ID_MIN_LENGTH: 1;
+/** Maximum deliveryId code-point length (frozen row 9 ack shape). */
+export declare const DELIVER_DELIVERY_ID_MAX_LENGTH: 128;
+/**
+ * Mirror of: StandardWireError body keys (errors.ts:240-299)
+ * Standard errors: {code, message} — no data field.
+ */
+export declare const ERROR_BODY_STANDARD_KEYS: Set<string>;
+/**
+ * Mirror of: ApplicationWireError body keys (errors.ts:182-234)
+ * Application errors: {code, message, data} — data required.
+ */
+export declare const ERROR_BODY_APPLICATION_KEYS: Set<string>;
+/**
+ * Mirror of: HandshakeRejectedError.data / DeliveryRejectedError.data /
+ * SnapshotUnavailableError.data — all {reason: <enum>}
+ */
+export declare const REASON_DATA_KEYS: Set<string>;
+/**
+ * Mirror of: DomainError.data (errors.ts:205-206)
+ * Keys: {code: MessagingErrorCode} — additionalProperties: false
+ */
+export declare const CODE_DATA_KEYS: Set<string>;
+//# sourceMappingURL=contract-mirror.d.ts.map

package/dist/contract-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-mirror.d.ts","sourceRoot":"","sources":["../src/contract-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,sGAOxB,CAAC;AAEX,eAAO,MAAM,wBAAwB,aAAyC,CAAC;AAM/E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAAuC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAAsC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAA2C,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aAAiD,CAAC;AAMnF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAA6B,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAA8B,CAAC;AAM7D,kEAAkE;AAClE,eAAO,MAAM,eAAe,aAAqB,CAAC;AAElD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,aAA8B,CAAC;AAE5D,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,aAAsB,CAAC;AAExD,6FAA6F;AAC7F,eAAO,MAAM,cAAc,aAA0C,CAAC;AAEtE,2HAA2H;AAC3H,eAAO,MAAM,yBAAyB,aAAgD,CAAC;AAMvF,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,aAK/B,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,aAU/B,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,aAA4B,CAAC;AAMlE,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,aAAqB,CAAC;AAEnD,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,aAA8B,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,aAA0B,CAAC;AAE3D,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AAEzD,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,EAAG,GAAY,CAAC;AAM3D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,aAA+B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,2BAA2B,aAAuC,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAAsB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,cAAc,aAAoB,CAAC"}

package/dist/contract-mirror.js

@@ -0,0 +1,179 @@
+/**
+ * Contract-mirror constants — runtime key sets and enum values that
+ * mirror @clowder-ai/plugin-contract TypeScript interfaces and types.
+ *
+ * These exist because the contract expresses certain closed constraints
+ * (additionalProperties: false, enum unions) only at the type level,
+ * with no runtime array/set export.
+ *
+ * ## DELETION TARGET
+ *
+ * Every constant in this module is scheduled for deletion when the
+ * contract exports a runtime equivalent (beta.5 delta scope, Fable
+ * ruling on S1 R3 contract seam). Each constant documents which
+ * contract source it mirrors.
+ *
+ * ## Drift prevention
+ *
+ * contract-mirror.test.ts verifies each constant against the contract
+ * source (schema JSON enum where available, structural assertions
+ * against contract types elsewhere). Drift = CI red.
+ *
+ * Pattern precedent: #10 MAX_FRAME_BYTES alias + drift test → Fable
+ * ruling 1 (fixtures test-only import) → this ruling (systematic).
+ */
+// ═══════════════════════════════════════════════════════════════════════════
+// Enum mirrors — contract has type-only unions, no runtime arrays
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * MessagingErrorCode runtime values.
+ *
+ * Mirror of: messaging.schema.json → definitions.MessagingErrorCode.enum
+ * Contract type: MessagingErrorCode (contract.generated.ts:217)
+ * Drift test: automated, vs schema JSON enum (exact member + order match)
+ */
+export const MESSAGING_ERROR_CODES = [
+    'VALIDATION',
+    'PERMISSION',
+    'NOT_FOUND',
+    'CONFLICT',
+    'RETRYABLE_INFLIGHT',
+    'STALE_CURSOR',
+];
+export const MESSAGING_ERROR_CODE_SET = new Set(MESSAGING_ERROR_CODES);
+// ═══════════════════════════════════════════════════════════════════════════
+// Envelope outer key sets (additionalProperties: false)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Mirror of: WireSuccessResponse interface (envelope.ts:108-113)
+ * Keys: jsonrpc, id, result — additionalProperties: false
+ */
+export const RESPONSE_SUCCESS_KEYS = new Set(['jsonrpc', 'id', 'result']);
+/**
+ * Mirror of: WireApplicationErrorResponse / WireStandardErrorResponse
+ * (envelope.ts:129-166). Keys: jsonrpc, id, error — additionalProperties: false
+ */
+export const RESPONSE_ERROR_KEYS = new Set(['jsonrpc', 'id', 'error']);
+/**
+ * Mirror of: WireNotification interface (envelope.ts:89-96)
+ * Keys: jsonrpc, method, params — additionalProperties: false
+ */
+export const NOTIFICATION_ALLOWED_KEYS = new Set(['jsonrpc', 'method', 'params']);
+/**
+ * Mirror of: WireRequest interface (envelope.ts:66-75)
+ * Keys: jsonrpc, id, method, params — additionalProperties: false
+ */
+export const REQUEST_ALLOWED_KEYS = new Set(['jsonrpc', 'id', 'method', 'params']);
+// ═══════════════════════════════════════════════════════════════════════════
+// Params / meta key sets (closed nested objects)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Mirror of: WireRequest.params / WireNotification.params (envelope.ts:71-74, 93-95)
+ * Keys: meta, input — additionalProperties: false
+ */
+export const PARAMS_ALLOWED_KEYS = new Set(['meta', 'input']);
+/**
+ * Mirror of: CallMeta interface (envelope.ts:43-52)
+ * Keys: deadlineUnixMs — additionalProperties: false, v0 single field
+ */
+export const META_ALLOWED_KEYS = new Set(['deadlineUnixMs']);
+// ═══════════════════════════════════════════════════════════════════════════
+// Per-method CLOSED-row input key sets (additionalProperties: false)
+// ═══════════════════════════════════════════════════════════════════════════
+/** Mirror of: PingInput (row-shapes.ts:144-147). Keys: {nonce} */
+export const PING_INPUT_KEYS = new Set(['nonce']);
+/** Mirror of: DrainInput (row-shapes.ts:183-193). Keys: {deadlineUnixMs} */
+export const DRAIN_INPUT_KEYS = new Set(['deadlineUnixMs']);
+/** Mirror of: SubscribeInput (row-shapes.ts:27-30). Keys: {handle} */
+export const SUBSCRIBE_INPUT_KEYS = new Set(['handle']);
+/** Mirror of: MessagingAckRequest (row-shapes.ts:76-81). Keys: {subscriptionId, ackToken} */
+export const ACK_INPUT_KEYS = new Set(['subscriptionId', 'ackToken']);
+/** Mirror of: GrantsChangedInput = GrantSnapshot (row-shapes.ts:128, grants.ts). Keys: {grantRevision, effectiveGrants} */
+export const GRANTS_CHANGED_INPUT_KEYS = new Set(['grantRevision', 'effectiveGrants']);
+// ═══════════════════════════════════════════════════════════════════════════
+// Handshake object key sets (type-only structural contract)
+// ═══════════════════════════════════════════════════════════════════════════
+/** Mirror of: CandidateHello (handshake.ts:62-71). */
+export const CANDIDATE_HELLO_KEYS = new Set([
+    'pluginId',
+    'packageDigest',
+    'contractVersion',
+    'wireVersion',
+]);
+/** Mirror of: SessionBinding (handshake.ts:82-101). */
+export const SESSION_BINDING_KEYS = new Set([
+    'pluginId',
+    'packageDigest',
+    'contractVersion',
+    'wireVersion',
+    'pluginInstanceId',
+    'brokerSessionId',
+    'grantRevision',
+    'effectiveGrants',
+    'bindingNonce',
+]);
+/** Mirror of: BrokerReadyParams (handshake.ts:113-116). */
+export const BROKER_READY_PARAMS_KEYS = new Set(['bindingNonce']);
+// ═══════════════════════════════════════════════════════════════════════════
+// Per-method CLOSED-row result key sets (additionalProperties: false)
+// ═══════════════════════════════════════════════════════════════════════════
+/** Mirror of: PingResult (row-shapes.ts:152-158). Keys: {nonce} */
+export const PING_RESULT_KEYS = new Set(['nonce']);
+/** Mirror of: SubscribeResult (row-shapes.ts:35-39). Keys: {subscriptionId} */
+export const SUBSCRIBE_RESULT_KEYS = new Set(['subscriptionId']);
+/**
+ * Mirror of: deliver acknowledgement result closed member set.
+ * Row 9 (host.messaging.deliver) has a frozen ack result shape
+ * {deliveryId: string, length 1..128 code points} — additionalProperties: false.
+ *
+ * Despite row 9 being RESERVED overall (DeliverResult = never in types),
+ * the ack shape is frozen per the #1165 protocol specification. The
+ * deliveryId echo is the fundamental delivery acknowledgement mechanism.
+ *
+ * Maintainer requirement: enforce closed member set + string bounds.
+ */
+export const DELIVER_RESULT_KEYS = new Set(['deliveryId']);
+/** Minimum deliveryId code-point length (frozen row 9 ack shape). */
+export const DELIVER_DELIVERY_ID_MIN_LENGTH = 1;
+/** Maximum deliveryId code-point length (frozen row 9 ack shape). */
+export const DELIVER_DELIVERY_ID_MAX_LENGTH = 128;
+// ═══════════════════════════════════════════════════════════════════════════
+// Error body key sets (closed per error variant)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Mirror of: StandardWireError body keys (errors.ts:240-299)
+ * Standard errors: {code, message} — no data field.
+ */
+export const ERROR_BODY_STANDARD_KEYS = new Set(['code', 'message']);
+/**
+ * Mirror of: ApplicationWireError body keys (errors.ts:182-234)
+ * Application errors: {code, message, data} — data required.
+ */
+export const ERROR_BODY_APPLICATION_KEYS = new Set(['code', 'message', 'data']);
+// ═══════════════════════════════════════════════════════════════════════════
+// Per-arm application error data key sets (additionalProperties: false)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Mirror of: HandshakeRejectedError.data / DeliveryRejectedError.data /
+ * SnapshotUnavailableError.data — all {reason: <enum>}
+ */
+export const REASON_DATA_KEYS = new Set(['reason']);
+/**
+ * Mirror of: DomainError.data (errors.ts:205-206)
+ * Keys: {code: MessagingErrorCode} — additionalProperties: false
+ */
+export const CODE_DATA_KEYS = new Set(['code']);
+// ═══════════════════════════════════════════════════════════════════════════
+// NOTE: Constants NOT in this module (derived from contract imports)
+// ═══════════════════════════════════════════════════════════════════════════
+//
+// The following are built from contract-imported arrays, not mirrors:
+//   KNOWN_ERROR_CODES = new Set(ALL_ERROR_CODES)         — from contract
+//   APPLICATION_CODES = new Set(APPLICATION_ERROR_CODES)  — from contract
+//   HANDSHAKE_REASONS = new Set(HANDSHAKE_REJECT_REASONS) — from contract
+//   DELIVERY_REASONS  = new Set(DELIVERY_REJECT_REASONS)  — from contract
+//   SNAPSHOT_REASONS  = new Set(SNAPSHOT_UNAVAILABLE_REASONS) — from contract
+//   NULL_ID_ERROR_CODES = new Set([PARSE_ERROR_CODE])     — from contract
+//
+// These stay in wire-dispatch.ts as performance wrappers, not mirrors.
+//# sourceMappingURL=contract-mirror.js.map

package/dist/contract-mirror.js.map

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

package/dist/events-publisher.d.ts

@@ -0,0 +1,34 @@
+/** Host-bound events.publish helper for declared C-2 signals. */
+import { type EventsPublishInput, type EventsPublishResult, type SignalDeclaration, type SignalSchemaCatalog } from '@clowder-ai/plugin-contract';
+import type { LocalHandshakeState } from './handshake-client.js';
+export type EventsPublishErrorCode = 'SESSION_NOT_ACTIVATED' | 'GRANT_MISSING' | 'SESSION_NOT_LIVE' | 'SIGNAL_UNDECLARED' | 'INVALID_DECLARATIONS' | 'INVALID_INPUT' | 'INVALID_RESULT';
+export declare class EventsPublishError extends Error {
+    readonly code: EventsPublishErrorCode;
+    constructor(code: EventsPublishErrorCode, message: string);
+}
+export interface EventsPublishHostTransport {
+    /**
+     * Calls the Host Broker. The SDK deliberately supplies no codec, route,
+     * credential, producer identity, or provenance field of its own.
+     */
+    call(method: 'events.publish', input: EventsPublishInput): Promise<unknown>;
+}
+export interface StdioSessionLiveness {
+    readonly kind: 'stdio-session';
+    /** Host/runtime-owned connection-or-lease verdict; no plugin clock math. */
+    isLive(): boolean;
+}
+export interface EventsPublisherOptions {
+    readonly transport: EventsPublishHostTransport;
+    /** Contract-validated manifest signals.provides snapshot. */
+    readonly declaredSignals: readonly SignalDeclaration[];
+    /** Host/package-loader-resolved schemas keyed by the declaration schemaRef. */
+    readonly signalSchemas: SignalSchemaCatalog;
+    readonly getHandshakeState: () => LocalHandshakeState;
+    readonly liveness: StdioSessionLiveness;
+}
+export interface EventsPublisher {
+    publish(input: unknown): Promise<EventsPublishResult>;
+}
+export declare function createEventsPublisher(options: EventsPublisherOptions): EventsPublisher;
+//# sourceMappingURL=events-publisher.d.ts.map

package/dist/events-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-publisher.d.ts","sourceRoot":"","sources":["../src/events-publisher.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,sBAAsB,GAC9B,uBAAuB,GACvB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,GACtB,eAAe,GACf,gBAAgB,CAAC;AAErB,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAK1D;AAED,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,4EAA4E;IAC5E,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvD,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACvD;AA+BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA2CtF"}

package/dist/events-publisher.js

@@ -0,0 +1,62 @@
+/** Host-bound events.publish helper for declared C-2 signals. */
+import { validateDeclaredEventsPublishInput, validateEventsPublishResult, } from '@clowder-ai/plugin-contract';
+export class EventsPublishError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'EventsPublishError';
+        this.code = code;
+    }
+}
+function requireLiveSession(options) {
+    const state = options.getHandshakeState();
+    if (state.phase !== 'activated') {
+        throw new EventsPublishError('SESSION_NOT_ACTIVATED', 'events.publish requires an activated Host-bound session');
+    }
+    if (!state.binding.effectiveGrants.includes('events.publish')) {
+        throw new EventsPublishError('GRANT_MISSING', 'the active Host grant snapshot does not include events.publish');
+    }
+    let live = false;
+    try {
+        live = options.liveness.isLive();
+    }
+    catch {
+        live = false;
+    }
+    if (!live) {
+        throw new EventsPublishError('SESSION_NOT_LIVE', 'the Host-owned stdio session liveness verdict is not live');
+    }
+}
+export function createEventsPublisher(options) {
+    return {
+        async publish(candidate) {
+            requireLiveSession(options);
+            const inputValidation = validateDeclaredEventsPublishInput(options.declaredSignals, options.signalSchemas, candidate);
+            if (!inputValidation.valid) {
+                const keywords = new Set(inputValidation.errors.map(({ keyword }) => keyword));
+                const code = keywords.has('declaredSignalType')
+                    ? 'SIGNAL_UNDECLARED'
+                    : keywords.has('signalDeclaration') ||
+                        keywords.has('signalSchemaUnresolved') ||
+                        keywords.has('signalSchemaInvalid')
+                        ? 'INVALID_DECLARATIONS'
+                        : 'INVALID_INPUT';
+                throw new EventsPublishError(code, `events.publish input rejected: ${inputValidation.errors
+                    .map(({ instancePath, message }) => `${instancePath || '/'} ${message}`)
+                    .join('; ')}`);
+            }
+            // Snapshot after validation so caller mutation cannot change the value
+            // while the transport is serializing it.
+            const input = structuredClone(inputValidation.value);
+            const result = await options.transport.call('events.publish', input);
+            const resultValidation = validateEventsPublishResult(result);
+            if (!resultValidation.valid) {
+                throw new EventsPublishError('INVALID_RESULT', `events.publish Host result rejected: ${resultValidation.errors
+                    .map(({ instancePath, message }) => `${instancePath || '/'} ${message}`)
+                    .join('; ')}`);
+            }
+            return structuredClone(resultValidation.value);
+        },
+    };
+}
+//# sourceMappingURL=events-publisher.js.map

package/dist/events-publisher.js.map

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

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,19 @@
+/**
+ * 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 rows and beta.9 events.publish row are executable;
+ * remaining production RPC methods stay reserved. The dispatch
+ * classifier gates all methods: CLOSED rows validate input shapes, RESERVED
+ * rows fail-closed with T-G (input type is `never` in v0 — no legal params
+ * exist).
+ */
+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, } 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';
+//# sourceMappingURL=index.d.ts.map