@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/runtime/events/contracts/automation-route.js

@@ -0,0 +1,315 @@
+import { AUTOMATION_RUN_OUTCOMES, AUTOMATION_SCHEDULE_KINDS, } from '../automation.js';
+import { ROUTE_SURFACE_KINDS, ROUTE_TARGET_KINDS, } from '../routes.js';
+import { CONTROL_PLANE_CLIENT_KINDS, CONTROL_PLANE_PRINCIPAL_KINDS, CONTROL_PLANE_TRANSPORT_KINDS } from '../control-plane.js';
+import { DELIVERY_KINDS } from '../deliveries.js';
+import { WATCHER_SOURCE_KINDS } from '../watchers.js';
+import { SURFACE_KINDS } from '../surfaces.js';
+import { validateEventFields } from './shared.js';
+export function validatePluginLoaded(v) {
+    return validateEventFields('PLUGIN_LOADED', v, [
+        { key: 'pluginName', kind: 'string' },
+        { key: 'version', kind: 'string' },
+        { key: 'toolCount', kind: 'number' },
+    ]);
+}
+export function validatePluginFailed(v) {
+    return validateEventFields('PLUGIN_FAILED', v, [
+        { key: 'pluginName', kind: 'string' },
+        { key: 'error', kind: 'string' },
+    ]);
+}
+export function validateAutomationJobCreated(v) {
+    return validateEventFields('AUTOMATION_JOB_CREATED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'name', kind: 'string' },
+        { key: 'scheduleKind', kind: 'enum', values: AUTOMATION_SCHEDULE_KINDS },
+        { key: 'enabled', kind: 'boolean' },
+    ]);
+}
+export function validateAutomationJobUpdated(v) {
+    return validateEventFields('AUTOMATION_JOB_UPDATED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'changedFields', kind: 'string[]' },
+    ]);
+}
+export function validateAutomationJobEnabled(v) {
+    return validateEventFields('AUTOMATION_JOB_ENABLED', v, [
+        { key: 'jobId', kind: 'string' },
+    ]);
+}
+export function validateAutomationJobDisabled(v) {
+    return validateEventFields('AUTOMATION_JOB_DISABLED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateAutomationRunQueued(v) {
+    return validateEventFields('AUTOMATION_RUN_QUEUED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'scheduledAt', kind: 'number' },
+        { key: 'forced', kind: 'boolean' },
+    ]);
+}
+export function validateAutomationRunStarted(v) {
+    return validateEventFields('AUTOMATION_RUN_STARTED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'startedAt', kind: 'number' },
+        { key: 'attempt', kind: 'number' },
+    ]);
+}
+export function validateAutomationRunCompleted(v) {
+    return validateEventFields('AUTOMATION_RUN_COMPLETED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'startedAt', kind: 'number' },
+        { key: 'completedAt', kind: 'number' },
+        { key: 'durationMs', kind: 'number' },
+        { key: 'outcome', kind: 'enum', values: AUTOMATION_RUN_OUTCOMES },
+    ]);
+}
+export function validateAutomationRunFailed(v) {
+    return validateEventFields('AUTOMATION_RUN_FAILED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'startedAt', kind: 'number' },
+        { key: 'failedAt', kind: 'number' },
+        { key: 'error', kind: 'string' },
+        { key: 'retryable', kind: 'boolean' },
+    ]);
+}
+export function validateAutomationRunCancelled(v) {
+    return validateEventFields('AUTOMATION_RUN_CANCELLED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'cancelledAt', kind: 'number' },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateAutomationScheduleError(v) {
+    return validateEventFields('AUTOMATION_SCHEDULE_ERROR', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'scheduleText', kind: 'string' },
+        { key: 'error', kind: 'string' },
+    ]);
+}
+export function validateAutomationJobAutoDisabled(v) {
+    return validateEventFields('AUTOMATION_JOB_AUTO_DISABLED', v, [
+        { key: 'jobId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+        { key: 'consecutiveFailures', kind: 'number' },
+    ]);
+}
+export function validateRouteBindingCreated(v) {
+    return validateEventFields('ROUTE_BINDING_CREATED', v, [
+        { key: 'bindingId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'externalId', kind: 'string' },
+        { key: 'targetKind', kind: 'enum', values: ROUTE_TARGET_KINDS },
+        { key: 'targetId', kind: 'string' },
+    ]);
+}
+export function validateRouteBindingUpdated(v) {
+    return validateEventFields('ROUTE_BINDING_UPDATED', v, [
+        { key: 'bindingId', kind: 'string' },
+        { key: 'changedFields', kind: 'string[]' },
+    ]);
+}
+export function validateRouteBindingResolved(v) {
+    return validateEventFields('ROUTE_BINDING_RESOLVED', v, [
+        { key: 'bindingId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'externalId', kind: 'string' },
+        { key: 'targetKind', kind: 'enum', values: ROUTE_TARGET_KINDS },
+        { key: 'targetId', kind: 'string' },
+    ]);
+}
+export function validateRouteReplyTargetCaptured(v) {
+    return validateEventFields('ROUTE_REPLY_TARGET_CAPTURED', v, [
+        { key: 'bindingId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'externalId', kind: 'string' },
+        { key: 'replyTargetId', kind: 'string' },
+        { key: 'threadId', kind: 'string' },
+    ]);
+}
+export function validateRouteBindingFailed(v) {
+    return validateEventFields('ROUTE_BINDING_FAILED', v, [
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'externalId', kind: 'string' },
+        { key: 'error', kind: 'string' },
+    ]);
+}
+export function validateControlPlaneClientConnected(v) {
+    return validateEventFields('CONTROL_PLANE_CLIENT_CONNECTED', v, [
+        { key: 'clientId', kind: 'string' },
+        { key: 'clientKind', kind: 'enum', values: CONTROL_PLANE_CLIENT_KINDS },
+        { key: 'transport', kind: 'enum', values: CONTROL_PLANE_TRANSPORT_KINDS },
+    ]);
+}
+export function validateControlPlaneClientDisconnected(v) {
+    return validateEventFields('CONTROL_PLANE_CLIENT_DISCONNECTED', v, [
+        { key: 'clientId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateControlPlaneSubscriptionCreated(v) {
+    return validateEventFields('CONTROL_PLANE_SUBSCRIPTION_CREATED', v, [
+        { key: 'clientId', kind: 'string' },
+        { key: 'subscriptionId', kind: 'string' },
+        { key: 'topics', kind: 'string[]' },
+    ]);
+}
+export function validateControlPlaneSubscriptionDropped(v) {
+    return validateEventFields('CONTROL_PLANE_SUBSCRIPTION_DROPPED', v, [
+        { key: 'clientId', kind: 'string' },
+        { key: 'subscriptionId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateControlPlaneAuthGranted(v) {
+    return validateEventFields('CONTROL_PLANE_AUTH_GRANTED', v, [
+        { key: 'clientId', kind: 'string' },
+        { key: 'principalId', kind: 'string' },
+        { key: 'principalKind', kind: 'enum', values: CONTROL_PLANE_PRINCIPAL_KINDS },
+        { key: 'scopes', kind: 'string[]' },
+    ]);
+}
+export function validateControlPlaneAuthRejected(v) {
+    return validateEventFields('CONTROL_PLANE_AUTH_REJECTED', v, [
+        { key: 'clientId', kind: 'string' },
+        { key: 'principalId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateDeliveryQueued(v) {
+    return validateEventFields('DELIVERY_QUEUED', v, [
+        { key: 'deliveryId', kind: 'string' },
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'targetId', kind: 'string' },
+        { key: 'deliveryKind', kind: 'enum', values: DELIVERY_KINDS },
+    ]);
+}
+export function validateDeliveryStarted(v) {
+    return validateEventFields('DELIVERY_STARTED', v, [
+        { key: 'deliveryId', kind: 'string' },
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'targetId', kind: 'string' },
+        { key: 'startedAt', kind: 'number' },
+    ]);
+}
+export function validateDeliverySucceeded(v) {
+    return validateEventFields('DELIVERY_SUCCEEDED', v, [
+        { key: 'deliveryId', kind: 'string' },
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'targetId', kind: 'string' },
+        { key: 'completedAt', kind: 'number' },
+        { key: 'durationMs', kind: 'number' },
+        { key: 'statusCode', kind: 'number' },
+    ]);
+}
+export function validateDeliveryFailed(v) {
+    return validateEventFields('DELIVERY_FAILED', v, [
+        { key: 'deliveryId', kind: 'string' },
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'targetId', kind: 'string' },
+        { key: 'failedAt', kind: 'number' },
+        { key: 'error', kind: 'string' },
+        { key: 'retryable', kind: 'boolean' },
+    ]);
+}
+export function validateDeliveryDeadLettered(v) {
+    return validateEventFields('DELIVERY_DEAD_LETTERED', v, [
+        { key: 'deliveryId', kind: 'string' },
+        { key: 'jobId', kind: 'string' },
+        { key: 'runId', kind: 'string' },
+        { key: 'surfaceKind', kind: 'enum', values: ROUTE_SURFACE_KINDS },
+        { key: 'targetId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+        { key: 'attempts', kind: 'number' },
+    ]);
+}
+export function validateWatcherStarted(v) {
+    return validateEventFields('WATCHER_STARTED', v, [
+        { key: 'watcherId', kind: 'string' },
+        { key: 'sourceKind', kind: 'enum', values: WATCHER_SOURCE_KINDS },
+        { key: 'name', kind: 'string' },
+    ]);
+}
+export function validateWatcherHeartbeat(v) {
+    return validateEventFields('WATCHER_HEARTBEAT', v, [
+        { key: 'watcherId', kind: 'string' },
+        { key: 'sourceKind', kind: 'enum', values: WATCHER_SOURCE_KINDS },
+        { key: 'seenAt', kind: 'number' },
+        { key: 'checkpoint', kind: 'string' },
+    ]);
+}
+export function validateWatcherCheckpointAdvanced(v) {
+    return validateEventFields('WATCHER_CHECKPOINT_ADVANCED', v, [
+        { key: 'watcherId', kind: 'string' },
+        { key: 'sourceKind', kind: 'enum', values: WATCHER_SOURCE_KINDS },
+        { key: 'checkpoint', kind: 'string' },
+    ]);
+}
+export function validateWatcherFailed(v) {
+    return validateEventFields('WATCHER_FAILED', v, [
+        { key: 'watcherId', kind: 'string' },
+        { key: 'sourceKind', kind: 'enum', values: WATCHER_SOURCE_KINDS },
+        { key: 'error', kind: 'string' },
+        { key: 'retryable', kind: 'boolean' },
+    ]);
+}
+export function validateWatcherStopped(v) {
+    return validateEventFields('WATCHER_STOPPED', v, [
+        { key: 'watcherId', kind: 'string' },
+        { key: 'sourceKind', kind: 'enum', values: WATCHER_SOURCE_KINDS },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateSurfaceEnabled(v) {
+    return validateEventFields('SURFACE_ENABLED', v, [
+        { key: 'surfaceKind', kind: 'enum', values: SURFACE_KINDS },
+        { key: 'surfaceId', kind: 'string' },
+        { key: 'accountId', kind: 'string' },
+    ]);
+}
+export function validateSurfaceDisabled(v) {
+    return validateEventFields('SURFACE_DISABLED', v, [
+        { key: 'surfaceKind', kind: 'enum', values: SURFACE_KINDS },
+        { key: 'surfaceId', kind: 'string' },
+        { key: 'reason', kind: 'string' },
+    ]);
+}
+export function validateSurfaceAccountConnected(v) {
+    return validateEventFields('SURFACE_ACCOUNT_CONNECTED', v, [
+        { key: 'surfaceKind', kind: 'enum', values: SURFACE_KINDS },
+        { key: 'surfaceId', kind: 'string' },
+        { key: 'accountId', kind: 'string' },
+        { key: 'displayName', kind: 'string' },
+    ]);
+}
+export function validateSurfaceAccountDegraded(v) {
+    return validateEventFields('SURFACE_ACCOUNT_DEGRADED', v, [
+        { key: 'surfaceKind', kind: 'enum', values: SURFACE_KINDS },
+        { key: 'surfaceId', kind: 'string' },
+        { key: 'accountId', kind: 'string' },
+        { key: 'error', kind: 'string' },
+    ]);
+}
+export function validateSurfaceCapabilityChanged(v) {
+    return validateEventFields('SURFACE_CAPABILITY_CHANGED', v, [
+        { key: 'surfaceKind', kind: 'enum', values: SURFACE_KINDS },
+        { key: 'surfaceId', kind: 'string' },
+        { key: 'capability', kind: 'string' },
+        { key: 'enabled', kind: 'boolean' },
+    ]);
+}

package/dist/_internal/platform/runtime/events/contracts/shared.d.ts

@@ -0,0 +1,28 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Shared primitives for runtime event contract validation.
+ */
+export interface ContractResult {
+    readonly valid: boolean;
+    readonly violations: readonly string[];
+}
+export declare function isString(v: unknown): v is string;
+export declare function isNumber(v: unknown): v is number;
+export declare function isBoolean(v: unknown): v is boolean;
+export declare function isObject(v: unknown): v is Record<string, unknown>;
+export type FieldKind = 'string' | 'number' | 'boolean' | 'string[]' | 'enum' | 'object';
+export interface FieldSpec {
+    readonly key: string;
+    readonly kind: FieldKind;
+    readonly values?: readonly string[];
+}
+export declare function validateEventFields(type: string, v: unknown, fields: readonly FieldSpec[]): ContractResult;
+export interface EventEnvelopeShape {
+    readonly traceId: string;
+    readonly sessionId: string;
+    readonly timestamp: number;
+    readonly source: string;
+    readonly event: Record<string, unknown>;
+}
+export declare function validateEnvelope(v: unknown): ContractResult;
+//# sourceMappingURL=shared.d.ts.map

package/dist/_internal/platform/runtime/events/contracts/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/events/contracts/shared.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAQD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAElD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,cAAc,CAiC1G;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAS3D"}

package/dist/_internal/platform/runtime/events/contracts/shared.js

@@ -0,0 +1,72 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+const OK = { valid: true, violations: [] };
+function fail(...messages) {
+    return { valid: false, violations: messages };
+}
+export function isString(v) {
+    return typeof v === 'string';
+}
+export function isNumber(v) {
+    return typeof v === 'number';
+}
+export function isBoolean(v) {
+    return typeof v === 'boolean';
+}
+export function isObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+export function validateEventFields(type, v, fields) {
+    if (!isObject(v))
+        return fail('event must be an object');
+    if (v['type'] !== type)
+        return fail(`type must be '${type}', got ${String(v['type'])}`);
+    const violations = [];
+    for (const field of fields) {
+        const value = v[field.key];
+        switch (field.kind) {
+            case 'string':
+                if (!isString(value))
+                    violations.push(`${field.key} must be a string`);
+                break;
+            case 'number':
+                if (!isNumber(value))
+                    violations.push(`${field.key} must be a number`);
+                break;
+            case 'boolean':
+                if (!isBoolean(value))
+                    violations.push(`${field.key} must be a boolean`);
+                break;
+            case 'string[]':
+                if (!Array.isArray(value) || value.some((item) => !isString(item))) {
+                    violations.push(`${field.key} must be an array of strings`);
+                }
+                break;
+            case 'enum':
+                if (!isString(value) || !(field.values ?? []).includes(value)) {
+                    violations.push(`${field.key} must be one of: ${(field.values ?? []).join(', ')}`);
+                }
+                break;
+            case 'object':
+                if (!isObject(value))
+                    violations.push(`${field.key} must be an object`);
+                break;
+        }
+    }
+    return violations.length ? { valid: false, violations } : OK;
+}
+export function validateEnvelope(v) {
+    if (!isObject(v))
+        return fail('envelope must be an object');
+    const violations = [];
+    if (!isString(v['traceId']))
+        violations.push('traceId must be a string');
+    if (!isString(v['sessionId']))
+        violations.push('sessionId must be a string');
+    if (!isNumber(v['timestamp']))
+        violations.push('timestamp must be a number');
+    if (!isString(v['source']))
+        violations.push('source must be a string');
+    if (!isObject(v['event']))
+        violations.push('event must be an object');
+    return violations.length ? { valid: false, violations } : OK;
+}

package/dist/_internal/platform/runtime/events/contracts/turn-tool.d.ts

@@ -0,0 +1,10 @@
+import type { ContractResult } from './shared.js';
+export declare function validateTurnStarted(v: unknown): ContractResult;
+export declare function validateTurnStreaming(v: unknown): ContractResult;
+export declare function validateTurnCompleted(v: unknown): ContractResult;
+export declare function validateTurnFailed(v: unknown): ContractResult;
+export declare function validateTurnCancelled(v: unknown): ContractResult;
+export declare function validateToolReceived(v: unknown): ContractResult;
+export declare function validateToolSucceeded(v: unknown): ContractResult;
+export declare function validateToolFailed(v: unknown): ContractResult;
+//# sourceMappingURL=turn-tool.d.ts.map

package/dist/_internal/platform/runtime/events/contracts/turn-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/events/contracts/turn-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAK9D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAMhE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAKhE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAK7D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAIhE;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAO/D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAMhE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAM7D"}

package/dist/_internal/platform/runtime/events/contracts/turn-tool.js

@@ -0,0 +1,53 @@
+import { validateEventFields } from './shared.js';
+export function validateTurnStarted(v) {
+    return validateEventFields('TURN_STARTED', v, [
+        { key: 'turnId', kind: 'string' },
+        { key: 'prompt', kind: 'string' },
+    ]);
+}
+export function validateTurnStreaming(v) {
+    return validateEventFields('TURN_STREAMING', v, [
+        { key: 'turnId', kind: 'string' },
+        { key: 'delta', kind: 'string' },
+        { key: 'deltaIndex', kind: 'number' },
+    ]);
+}
+export function validateTurnCompleted(v) {
+    return validateEventFields('TURN_COMPLETED', v, [
+        { key: 'turnId', kind: 'string' },
+        { key: 'durationMs', kind: 'number' },
+    ]);
+}
+export function validateTurnFailed(v) {
+    return validateEventFields('TURN_FAILED', v, [
+        { key: 'turnId', kind: 'string' },
+        { key: 'error', kind: 'string' },
+    ]);
+}
+export function validateTurnCancelled(v) {
+    return validateEventFields('TURN_CANCELLED', v, [
+        { key: 'turnId', kind: 'string' },
+    ]);
+}
+export function validateToolReceived(v) {
+    return validateEventFields('TOOL_RECEIVED', v, [
+        { key: 'callId', kind: 'string' },
+        { key: 'turnId', kind: 'string' },
+        { key: 'toolName', kind: 'string' },
+        { key: 'args', kind: 'object' },
+    ]);
+}
+export function validateToolSucceeded(v) {
+    return validateEventFields('TOOL_SUCCEEDED', v, [
+        { key: 'callId', kind: 'string' },
+        { key: 'turnId', kind: 'string' },
+        { key: 'durationMs', kind: 'number' },
+    ]);
+}
+export function validateToolFailed(v) {
+    return validateEventFields('TOOL_FAILED', v, [
+        { key: 'callId', kind: 'string' },
+        { key: 'turnId', kind: 'string' },
+        { key: 'error', kind: 'string' },
+    ]);
+}

package/dist/_internal/platform/runtime/events/contracts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Event schema contracts for runtime event validation.
+ */
+export { type ContractResult, type EventEnvelopeShape, type FieldKind, type FieldSpec, validateEnvelope, validateEventFields, isString, isNumber, isBoolean, isObject, } from './contracts/shared.js';
+export { validateTurnStarted, validateTurnStreaming, validateTurnCompleted, validateTurnFailed, validateTurnCancelled, validateToolReceived, validateToolSucceeded, validateToolFailed, } from './contracts/turn-tool.js';
+export { validateAgentSpawning, validateAgentCompleted, validateAgentFailed, validateMcpConnected, validateMcpDisconnected, validateMcpReconnecting, } from './contracts/agent-mcp.js';
+export { validatePluginLoaded, validatePluginFailed, validateAutomationJobCreated, validateAutomationJobUpdated, validateAutomationJobEnabled, validateAutomationJobDisabled, validateAutomationRunQueued, validateAutomationRunStarted, validateAutomationRunCompleted, validateAutomationRunFailed, validateAutomationRunCancelled, validateAutomationScheduleError, validateAutomationJobAutoDisabled, validateRouteBindingCreated, validateRouteBindingUpdated, validateRouteBindingResolved, validateRouteReplyTargetCaptured, validateRouteBindingFailed, validateControlPlaneClientConnected, validateControlPlaneClientDisconnected, validateControlPlaneSubscriptionCreated, validateControlPlaneSubscriptionDropped, validateControlPlaneAuthGranted, validateControlPlaneAuthRejected, validateDeliveryQueued, validateDeliveryStarted, validateDeliverySucceeded, validateDeliveryFailed, validateDeliveryDeadLettered, validateWatcherStarted, validateWatcherHeartbeat, validateWatcherCheckpointAdvanced, validateWatcherFailed, validateWatcherStopped, validateSurfaceEnabled, validateSurfaceDisabled, validateSurfaceAccountConnected, validateSurfaceAccountDegraded, validateSurfaceCapabilityChanged, } from './contracts/automation-route.js';
+export declare function validateEvent(event: unknown): import('./contracts/shared.js').ContractResult;
+export declare function isKnownEventType(type: unknown): type is string;
+export declare function registeredEventTypes(): readonly string[];
+//# sourceMappingURL=contracts.d.ts.map

package/dist/_internal/platform/runtime/events/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/contracts.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,gBAAgB,EAChB,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,gCAAgC,EAChC,0BAA0B,EAC1B,mCAAmC,EACnC,sCAAsC,EACtC,uCAAuC,EACvC,uCAAuC,EACvC,+BAA+B,EAC/B,gCAAgC,EAChC,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAsHzC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,uBAAuB,EAAE,cAAc,CAO5F;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAE9D;AAED,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}

package/dist/_internal/platform/runtime/events/contracts.js

@@ -0,0 +1,83 @@
+/**
+ * Event schema contracts for runtime event validation.
+ */
+export { validateEnvelope, validateEventFields, isString, isNumber, isBoolean, isObject, } from './contracts/shared.js';
+import { isObject, isString, } from './contracts/shared.js';
+export { validateTurnStarted, validateTurnStreaming, validateTurnCompleted, validateTurnFailed, validateTurnCancelled, validateToolReceived, validateToolSucceeded, validateToolFailed, } from './contracts/turn-tool.js';
+export { validateAgentSpawning, validateAgentCompleted, validateAgentFailed, validateMcpConnected, validateMcpDisconnected, validateMcpReconnecting, } from './contracts/agent-mcp.js';
+export { validatePluginLoaded, validatePluginFailed, validateAutomationJobCreated, validateAutomationJobUpdated, validateAutomationJobEnabled, validateAutomationJobDisabled, validateAutomationRunQueued, validateAutomationRunStarted, validateAutomationRunCompleted, validateAutomationRunFailed, validateAutomationRunCancelled, validateAutomationScheduleError, validateAutomationJobAutoDisabled, validateRouteBindingCreated, validateRouteBindingUpdated, validateRouteBindingResolved, validateRouteReplyTargetCaptured, validateRouteBindingFailed, validateControlPlaneClientConnected, validateControlPlaneClientDisconnected, validateControlPlaneSubscriptionCreated, validateControlPlaneSubscriptionDropped, validateControlPlaneAuthGranted, validateControlPlaneAuthRejected, validateDeliveryQueued, validateDeliveryStarted, validateDeliverySucceeded, validateDeliveryFailed, validateDeliveryDeadLettered, validateWatcherStarted, validateWatcherHeartbeat, validateWatcherCheckpointAdvanced, validateWatcherFailed, validateWatcherStopped, validateSurfaceEnabled, validateSurfaceDisabled, validateSurfaceAccountConnected, validateSurfaceAccountDegraded, validateSurfaceCapabilityChanged, } from './contracts/automation-route.js';
+import { validateTurnStarted, validateTurnStreaming, validateTurnCompleted, validateTurnFailed, validateTurnCancelled, validateToolReceived, validateToolSucceeded, validateToolFailed, } from './contracts/turn-tool.js';
+import { validateAgentSpawning, validateAgentCompleted, validateAgentFailed, validateMcpConnected, validateMcpDisconnected, validateMcpReconnecting, } from './contracts/agent-mcp.js';
+import { validatePluginLoaded, validatePluginFailed, validateAutomationJobCreated, validateAutomationJobUpdated, validateAutomationJobEnabled, validateAutomationJobDisabled, validateAutomationRunQueued, validateAutomationRunStarted, validateAutomationRunCompleted, validateAutomationRunFailed, validateAutomationRunCancelled, validateAutomationScheduleError, validateAutomationJobAutoDisabled, validateRouteBindingCreated, validateRouteBindingUpdated, validateRouteBindingResolved, validateRouteReplyTargetCaptured, validateRouteBindingFailed, validateControlPlaneClientConnected, validateControlPlaneClientDisconnected, validateControlPlaneSubscriptionCreated, validateControlPlaneSubscriptionDropped, validateControlPlaneAuthGranted, validateControlPlaneAuthRejected, validateDeliveryQueued, validateDeliveryStarted, validateDeliverySucceeded, validateDeliveryFailed, validateDeliveryDeadLettered, validateWatcherStarted, validateWatcherHeartbeat, validateWatcherCheckpointAdvanced, validateWatcherFailed, validateWatcherStopped, validateSurfaceEnabled, validateSurfaceDisabled, validateSurfaceAccountConnected, validateSurfaceAccountDegraded, validateSurfaceCapabilityChanged, } from './contracts/automation-route.js';
+const EVENT_VALIDATORS = {
+    TURN_STARTED: validateTurnStarted,
+    TURN_STREAMING: validateTurnStreaming,
+    TURN_COMPLETED: validateTurnCompleted,
+    TURN_FAILED: validateTurnFailed,
+    TURN_CANCELLED: validateTurnCancelled,
+    TOOL_RECEIVED: validateToolReceived,
+    TOOL_SUCCEEDED: validateToolSucceeded,
+    TOOL_FAILED: validateToolFailed,
+    AGENT_SPAWNING: validateAgentSpawning,
+    AGENT_COMPLETED: validateAgentCompleted,
+    AGENT_FAILED: validateAgentFailed,
+    MCP_CONNECTED: validateMcpConnected,
+    MCP_DISCONNECTED: validateMcpDisconnected,
+    MCP_RECONNECTING: validateMcpReconnecting,
+    PLUGIN_LOADED: validatePluginLoaded,
+    PLUGIN_FAILED: validatePluginFailed,
+    AUTOMATION_JOB_CREATED: validateAutomationJobCreated,
+    AUTOMATION_JOB_UPDATED: validateAutomationJobUpdated,
+    AUTOMATION_JOB_ENABLED: validateAutomationJobEnabled,
+    AUTOMATION_JOB_DISABLED: validateAutomationJobDisabled,
+    AUTOMATION_RUN_QUEUED: validateAutomationRunQueued,
+    AUTOMATION_RUN_STARTED: validateAutomationRunStarted,
+    AUTOMATION_RUN_COMPLETED: validateAutomationRunCompleted,
+    AUTOMATION_RUN_FAILED: validateAutomationRunFailed,
+    AUTOMATION_RUN_CANCELLED: validateAutomationRunCancelled,
+    AUTOMATION_SCHEDULE_ERROR: validateAutomationScheduleError,
+    AUTOMATION_JOB_AUTO_DISABLED: validateAutomationJobAutoDisabled,
+    ROUTE_BINDING_CREATED: validateRouteBindingCreated,
+    ROUTE_BINDING_UPDATED: validateRouteBindingUpdated,
+    ROUTE_BINDING_RESOLVED: validateRouteBindingResolved,
+    ROUTE_REPLY_TARGET_CAPTURED: validateRouteReplyTargetCaptured,
+    ROUTE_BINDING_FAILED: validateRouteBindingFailed,
+    CONTROL_PLANE_CLIENT_CONNECTED: validateControlPlaneClientConnected,
+    CONTROL_PLANE_CLIENT_DISCONNECTED: validateControlPlaneClientDisconnected,
+    CONTROL_PLANE_SUBSCRIPTION_CREATED: validateControlPlaneSubscriptionCreated,
+    CONTROL_PLANE_SUBSCRIPTION_DROPPED: validateControlPlaneSubscriptionDropped,
+    CONTROL_PLANE_AUTH_GRANTED: validateControlPlaneAuthGranted,
+    CONTROL_PLANE_AUTH_REJECTED: validateControlPlaneAuthRejected,
+    DELIVERY_QUEUED: validateDeliveryQueued,
+    DELIVERY_STARTED: validateDeliveryStarted,
+    DELIVERY_SUCCEEDED: validateDeliverySucceeded,
+    DELIVERY_FAILED: validateDeliveryFailed,
+    DELIVERY_DEAD_LETTERED: validateDeliveryDeadLettered,
+    WATCHER_STARTED: validateWatcherStarted,
+    WATCHER_HEARTBEAT: validateWatcherHeartbeat,
+    WATCHER_CHECKPOINT_ADVANCED: validateWatcherCheckpointAdvanced,
+    WATCHER_FAILED: validateWatcherFailed,
+    WATCHER_STOPPED: validateWatcherStopped,
+    SURFACE_ENABLED: validateSurfaceEnabled,
+    SURFACE_DISABLED: validateSurfaceDisabled,
+    SURFACE_ACCOUNT_CONNECTED: validateSurfaceAccountConnected,
+    SURFACE_ACCOUNT_DEGRADED: validateSurfaceAccountDegraded,
+    SURFACE_CAPABILITY_CHANGED: validateSurfaceCapabilityChanged,
+};
+export function validateEvent(event) {
+    if (!isObject(event))
+        return { valid: false, violations: ['event must be an object'] };
+    const type = event['type'];
+    if (!isString(type))
+        return { valid: false, violations: ['event.type must be a string'] };
+    const validator = EVENT_VALIDATORS[type];
+    if (!validator)
+        return { valid: false, violations: [`unknown event type: '${type}'`] };
+    return validator(event);
+}
+export function isKnownEventType(type) {
+    return isString(type) && type in EVENT_VALIDATORS;
+}
+export function registeredEventTypes() {
+    return Object.keys(EVENT_VALIDATORS);
+}

package/dist/_internal/platform/runtime/events/control-plane.d.ts

@@ -0,0 +1,43 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * ControlPlaneEvent — discriminated union covering gateway/control-plane client lifecycle events.
+ */
+export declare const CONTROL_PLANE_CLIENT_KINDS: readonly ["tui", "web", "slack", "discord", "ntfy", "daemon", "webhook", "service", "telegram", "google-chat", "signal", "whatsapp", "imessage", "msteams", "bluebubbles", "mattermost", "matrix"];
+export declare const CONTROL_PLANE_TRANSPORT_KINDS: readonly ["local", "http", "sse", "ws", "websocket", "webhook"];
+export declare const CONTROL_PLANE_PRINCIPAL_KINDS: readonly ["user", "bot", "service", "token"];
+export type ControlPlaneClientKind = (typeof CONTROL_PLANE_CLIENT_KINDS)[number];
+export type ControlPlaneTransportKind = (typeof CONTROL_PLANE_TRANSPORT_KINDS)[number];
+export type ControlPlanePrincipalKind = (typeof CONTROL_PLANE_PRINCIPAL_KINDS)[number];
+export type ControlPlaneEvent = {
+    type: 'CONTROL_PLANE_CLIENT_CONNECTED';
+    clientId: string;
+    clientKind: ControlPlaneClientKind;
+    transport: ControlPlaneTransportKind;
+} | {
+    type: 'CONTROL_PLANE_CLIENT_DISCONNECTED';
+    clientId: string;
+    reason: string;
+} | {
+    type: 'CONTROL_PLANE_SUBSCRIPTION_CREATED';
+    clientId: string;
+    subscriptionId: string;
+    topics: string[];
+} | {
+    type: 'CONTROL_PLANE_SUBSCRIPTION_DROPPED';
+    clientId: string;
+    subscriptionId: string;
+    reason: string;
+} | {
+    type: 'CONTROL_PLANE_AUTH_GRANTED';
+    clientId: string;
+    principalId: string;
+    principalKind: ControlPlanePrincipalKind;
+    scopes: string[];
+} | {
+    type: 'CONTROL_PLANE_AUTH_REJECTED';
+    clientId: string;
+    principalId: string;
+    reason: string;
+};
+export type ControlPlaneEventType = ControlPlaneEvent['type'];
+//# sourceMappingURL=control-plane.d.ts.map

package/dist/_internal/platform/runtime/events/control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/control-plane.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;GAEG;AAEH,eAAO,MAAM,0BAA0B,oMAkB7B,CAAC;AACX,eAAO,MAAM,6BAA6B,iEAAkE,CAAC;AAC7G,eAAO,MAAM,6BAA6B,8CAA+C,CAAC;AAE1F,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,gCAAgC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,sBAAsB,CAAC;IACnC,SAAS,EAAE,yBAAyB,CAAC;CACtC,GACD;IACE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,oCAAoC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,IAAI,EAAE,oCAAoC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,yBAAyB,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC"}