@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export type { GoodVibesRealtime, GoodVibesSdk, GoodVibesRealtimeOptions, GoodVibesSdkOptions, RuntimeEventRecord, } from './client.js';
+export type { GoodVibesRealtime, GoodVibesSdk, GoodVibesRealtimeOptions, GoodVibesSdkOptions, } from './client.js';
 export { createGoodVibesSdk } from './client.js';
-export type { BrowserTokenStoreOptions, GoodVibesAuthClient, GoodVibesAuthLoginOptions, GoodVibesCurrentAuth, GoodVibesLoginInput, GoodVibesLoginOutput, GoodVibesTokenStore, } from './auth.js';
+export type { BrowserTokenStoreOptions, AutoRefreshCoordinatorOptions, AutoRefreshOptions, ControlPlaneAuthMode, ControlPlaneAuthSnapshot, GoodVibesAuthClient, GoodVibesAuthLoginOptions, GoodVibesCurrentAuth, GoodVibesExpiringTokenStore, GoodVibesLoginInput, GoodVibesLoginOutput, GoodVibesTokenStore, } from './auth.js';
 export { createBrowserTokenStore, createGoodVibesAuthClient, createMemoryTokenStore, } from './auth.js';
 export type { BrowserGoodVibesSdkOptions } from './browser.js';
 export { createBrowserGoodVibesSdk } from './browser.js';
@@ -12,9 +12,11 @@ export type { ReactNativeGoodVibesRealtime, ReactNativeGoodVibesSdk, ReactNative
 export { createReactNativeGoodVibesSdk } from './react-native.js';
 export type { ExpoGoodVibesSdkOptions } from './expo.js';
 export { createExpoGoodVibesSdk } from './expo.js';
+export { TokenStore, SessionManager, PermissionResolver, AutoRefreshCoordinator } from './client-auth/index.js';
 export * from './observer/index.js';
-export * from './contracts.js';
-export * from './daemon.js';
+export * from './events/index.js';
+export type { ContractHttpDefinition, DistributedPeerKind, DistributedWorkStatus, DistributedWorkType, GatewayEventTransport, GatewayMethodAccess, GatewayMethodSource, GatewayMethodTransport, JsonSchema, OperatorContractManifest, OperatorEventCoverageContract, OperatorEventContract, OperatorMethodContract, OperatorSchemaCoverageContract, PeerContractManifest, PeerEndpointContract, OperatorEventPayload, OperatorEventPayloadMap, JsonPrimitive, JsonValue, OperatorMethodInput, OperatorMethodInputMap, OperatorMethodOutput, OperatorMethodOutputMap, OperatorStreamMethodId, OperatorTypedEventId, OperatorTypedMethodId, PeerEndpointInput, PeerEndpointInputMap, PeerEndpointOutput, PeerEndpointOutputMap, PeerTypedEndpointId, RuntimeDomainEventPayload, RuntimeDomainEventPayloadMap, RuntimeDomainEventType, RuntimeEventTypedDomain, SharedSessionConversationRouteOutput, OperatorMethodId, PeerEndpointId, ControlAuthLoginResponse, ControlAuthCurrentResponse, AccountsSnapshotResponse, SerializedEventEnvelopeShape, TypedSerializedEventEnvelopeShape, ControlStatusResponse, LocalAuthStatusResponse, ProviderModelRef, ProviderModelEntry, ConfiguredVia, ProviderAuthRouteDescriptor, ProviderModelProvider, ListProviderModelsResponse, CurrentModelResponse, PatchCurrentModelBody, PatchCurrentModelError, PatchCurrentModelResponse, ModelChangedEvent, } from './contracts.js';
+export { DISTRIBUTED_WORK_TYPES, FOUNDATION_METADATA, OPERATOR_CONTRACT, OPERATOR_METHOD_IDS, PEER_CONTRACT, PEER_ENDPOINT_IDS, getOperatorContract, getPeerContract, getOperatorMethod, getPeerEndpoint, listOperatorMethods, listPeerEndpoints, isOperatorMethodId, isPeerEndpointId, ControlAuthLoginResponseSchema, ControlAuthCurrentResponseSchema, AccountsSnapshotResponseSchema, SerializedEventEnvelopeSchema, TypedSerializedEventEnvelopeSchema, RuntimeEventRecordSchema, ControlStatusResponseSchema, LocalAuthStatusResponseSchema, ProviderModelRefSchema, ProviderModelEntrySchema, ConfiguredViaSchema, ProviderAuthRouteDescriptorSchema, ProviderModelProviderSchema, ListProviderModelsResponseSchema, CurrentModelResponseSchema, PatchCurrentModelBodySchema, PatchCurrentModelErrorSchema, PatchCurrentModelResponseSchema, ModelChangedEventSchema, } from './contracts.js';
 export * from './errors.js';
 export * from './transport-core.js';
 export * from './transport-direct.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EACV,mCAAmC,EACnC,+BAA+B,EAC/B,wBAAwB,EACxB,+BAA+B,EAC/B,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,9 +5,22 @@ export { createWebGoodVibesSdk } from './web.js';
 export { createGoodVibesCloudflareWorker } from './workers.js';
 export { createReactNativeGoodVibesSdk } from './react-native.js';
 export { createExpoGoodVibesSdk } from './expo.js';
+// The barrel re-exports below flatten symbols from their respective packages
+// into the root SDK entrypoint. Each module is a single-concern passthrough
+// that re-exports a transport, event, or contract layer.
+//
+// Why the indirection through named modules rather than direct `export *`?
+// - Each intermediate module (observer, events, contracts, errors,
+//   transport-*) is also a versioned, independently buildable sub-package.
+//   The indirection lets us tree-shake at sub-package boundaries.
+// - It makes source attribution explicit in the final bundle map.
+//
+// Collision risk: keep exported names unique across these modules so the root
+// surface remains deterministic and compile-time collisions stay obvious.
+export { TokenStore, SessionManager, PermissionResolver, AutoRefreshCoordinator } from './client-auth/index.js';
 export * from './observer/index.js';
-export * from './contracts.js';
-export * from './daemon.js';
+export * from './events/index.js';
+export { DISTRIBUTED_WORK_TYPES, FOUNDATION_METADATA, OPERATOR_CONTRACT, OPERATOR_METHOD_IDS, PEER_CONTRACT, PEER_ENDPOINT_IDS, getOperatorContract, getPeerContract, getOperatorMethod, getPeerEndpoint, listOperatorMethods, listPeerEndpoints, isOperatorMethodId, isPeerEndpointId, ControlAuthLoginResponseSchema, ControlAuthCurrentResponseSchema, AccountsSnapshotResponseSchema, SerializedEventEnvelopeSchema, TypedSerializedEventEnvelopeSchema, RuntimeEventRecordSchema, ControlStatusResponseSchema, LocalAuthStatusResponseSchema, ProviderModelRefSchema, ProviderModelEntrySchema, ConfiguredViaSchema, ProviderAuthRouteDescriptorSchema, ProviderModelProviderSchema, ListProviderModelsResponseSchema, CurrentModelResponseSchema, PatchCurrentModelBodySchema, PatchCurrentModelErrorSchema, PatchCurrentModelResponseSchema, ModelChangedEventSchema, } from './contracts.js';
 export * from './errors.js';
 export * from './transport-core.js';
 export * from './transport-direct.js';

package/dist/observer/index.d.ts

@@ -6,8 +6,8 @@
  * optional; the SDK works identically whether an observer is present or not.
  *
  * Observer call sites are wrapped through `invokeObserver`: an observer that
- * throws will not propagate into SDK logic. This is intentional because observer
- * errors must never break the SDK flow.
+ * throws will not propagate into SDK logic. Failures are reported and returned
+ * so observer isolation does not hide broken callbacks.
  *
  * @example
  * const sdk = createGoodVibesSdk({
@@ -16,6 +16,8 @@
  *   observer: createConsoleObserver({ level: 'debug' }),
  * });
  */
+/** OpenTelemetry SpanStatusCode.ERROR. Use in custom observer implementations with `span.setStatus({ code: SPAN_STATUS_ERROR })`. */
+export declare const SPAN_STATUS_ERROR: 2;
 import type { GoodVibesSdkError } from '@pellux/goodvibes-errors';
 import type { AnyRuntimeEvent } from '../events/domain-map.js';
 import type { TransportObserver, TransportActivityInfo } from '@pellux/goodvibes-transport-core';
@@ -49,7 +51,7 @@ export interface AuthTransitionInfo {
  * instance to a supported client factory. All methods are optional.
  *
  * Every call site should go through `invokeObserver` so observer errors are
- * isolated from SDK control flow.
+ * isolated from SDK control flow while remaining observable.
  */
 export interface SDKObserver extends TransportObserver {
     /**
@@ -84,16 +86,37 @@ export interface SDKObserver extends TransportObserver {
     onAuthTransition?(transition: AuthTransitionInfo): void;
 }
 /**
- * Safely invoke an observer method. Observer errors are swallowed so they
- * never disrupt SDK control flow. This is the canonical call pattern for
- * all observer call sites throughout the SDK.
+ * Result returned from a protected observer callback invocation.
+ */
+export type ObserverInvocationResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+};
+export interface InvokeObserverOptions {
+    /**
+     * Optional callback label included in failure logs.
+     */
+    readonly label?: string | undefined;
+    /**
+     * Set to false when a caller handles a failed result itself and does not want
+     * the default warning.
+     */
+    readonly report?: boolean | undefined;
+}
+/**
+ * Safely invoke an observer method. Observer errors are isolated so they
+ * never disrupt SDK control flow, but failures are returned and logged by
+ * default. This is the canonical call pattern for all observer call sites
+ * throughout the SDK.
  *
  * @param fn - Zero-argument thunk wrapping the observer call.
  */
-export declare function invokeObserver(fn: () => void): void;
+export declare function invokeObserver(fn: () => void, options?: InvokeObserverOptions): ObserverInvocationResult;
 export interface ConsoleObserverOptions {
     /** Minimum log level. Defaults to `'info'`. */
-    readonly level?: 'debug' | 'info';
+    readonly level?: 'debug' | 'info' | undefined;
 }
 /**
  * Create a development-friendly observer that logs SDK activity to the console.

package/dist/observer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExF;;;GAGG;AACH,YAAY,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAEvC;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEvC;;;;;;;OAOG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAE5D;;;OAGG;IACH,gBAAgB,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACzD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAOnD;AAMD,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,sBAA2B,GACnC,WAAW,CAgCb;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACtD;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IAC9C,GAAG,IAAI,IAAI,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,CAAC;IAC7E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC;CACjG;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CACrF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,GACf,WAAW,CAiDb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"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"}

package/dist/observer/index.js

@@ -6,8 +6,8 @@
  * optional; the SDK works identically whether an observer is present or not.
  *
  * Observer call sites are wrapped through `invokeObserver`: an observer that
- * throws will not propagate into SDK logic. This is intentional because observer
- * errors must never break the SDK flow.
+ * throws will not propagate into SDK logic. Failures are reported and returned
+ * so observer isolation does not hide broken callbacks.
  *
  * @example
  * const sdk = createGoodVibesSdk({
@@ -16,21 +16,35 @@
  *   observer: createConsoleObserver({ level: 'debug' }),
  * });
  */
-const SPAN_STATUS_ERROR = 2; // OpenTelemetry SpanStatusCode.ERROR
+/** OpenTelemetry SpanStatusCode.ERROR. Use in custom observer implementations with `span.setStatus({ code: SPAN_STATUS_ERROR })`. */
+export const SPAN_STATUS_ERROR = 2;
+function reportObserverFailure(error, label) {
+    try {
+        const suffix = label ? `: ${label}` : '';
+        globalThis.console?.warn?.(`[sdk:observer] observer callback failed${suffix}`, error);
+    }
+    catch {
+        // Logging must not become another way for observer isolation to break SDK flow.
+    }
+}
 /**
- * Safely invoke an observer method. Observer errors are swallowed so they
- * never disrupt SDK control flow. This is the canonical call pattern for
- * all observer call sites throughout the SDK.
+ * Safely invoke an observer method. Observer errors are isolated so they
+ * never disrupt SDK control flow, but failures are returned and logged by
+ * default. This is the canonical call pattern for all observer call sites
+ * throughout the SDK.
  *
  * @param fn - Zero-argument thunk wrapping the observer call.
  */
-export function invokeObserver(fn) {
+export function invokeObserver(fn, options = {}) {
     try {
         fn();
+        return { ok: true };
     }
-    catch {
-        // Observer errors must not propagate into SDK logic.
-        // Observers are passive listeners; they have no authority to break flows.
+    catch (error) {
+        if (options.report !== false) {
+            reportObserverFailure(error, options.label);
+        }
+        return { ok: false, error };
     }
 }
 /**
@@ -47,12 +61,11 @@ export function invokeObserver(fn) {
 export function createConsoleObserver(options = {}) {
     const level = options.level ?? 'info';
     return {
+        /* eslint-disable no-console */
         onAuthTransition(transition) {
-            // eslint-disable-next-line no-console
             console.log(`[sdk:observer] auth transition ${transition.from} → ${transition.to} (${transition.reason})`);
         },
         onError(err) {
-            // eslint-disable-next-line no-console
             console.error(`[sdk:observer] error kind=${err.kind} category=${err.category}`, err.message);
         },
         onTransportActivity(activity) {
@@ -60,15 +73,14 @@ export function createConsoleObserver(options = {}) {
                 return;
             const status = activity.status !== undefined ? ` status=${activity.status}` : '';
             const dur = activity.durationMs !== undefined ? ` ${activity.durationMs}ms` : '';
-            // eslint-disable-next-line no-console
             console.debug(`[sdk:observer] transport ${activity.direction} ${activity.kind ?? 'http'} ${activity.url}${status}${dur}`);
         },
         onEvent(event) {
             if (level !== 'debug')
                 return;
-            // eslint-disable-next-line no-console
             console.debug(`[sdk:observer] event ${event.type}`);
         },
+        /* eslint-enable no-console */
     };
 }
 /**

package/dist/platform/acp/connection.js

@@ -177,7 +177,7 @@ export class AcpConnection {
                 await this.conn.cancel({ sessionId: this.sessionId });
             }
             catch (err) {
-                // Best-effort — kill the child if cancel fails
+                // If protocol cancel fails, still kill the child process.
                 logger.error('AcpConnection.cancel: failed to send cancel to subagent', { id: this.id, err: summarizeError(err) });
             }
         }

package/dist/platform/acp/manager.d.ts

@@ -14,7 +14,7 @@ export declare function getDefaultAcpAgentCommand(): string[];
  *
  * @example
  * ```ts
- * const mgr = new AcpManager(bus);
+ * const mgr = new AcpManager({ requestPermission });
  * const id = await mgr.spawn({ description: 'Fix the bug', context: '...', tools: ['read'] });
  * const results = await mgr.waitAll();
  * ```
@@ -26,9 +26,11 @@ export declare class AcpManager {
     private readonly requestPermission?;
     private readonly runtimeBus;
     private readonly hookDispatcher;
-    constructor(permissionOrLegacyBus?: PermissionRequestHandler | {
-        emit?: unknown;
-    }, runtimeBus?: RuntimeEventBus | null, hookDispatcher?: Pick<HookDispatcher, 'fire'> | null);
+    constructor(options?: {
+        readonly requestPermission?: PermissionRequestHandler | undefined;
+        readonly runtimeBus?: RuntimeEventBus | null | undefined;
+        readonly hookDispatcher?: Pick<HookDispatcher, 'fire'> | null | undefined;
+    });
     /**
      * Spawn a new subagent and start running the task.
      * Returns the subagent ID immediately; the task runs in the background.

package/dist/platform/acp/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAcxD,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;gBAGnE,qBAAqB,CAAC,EAAE,wBAAwB,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EACrE,UAAU,GAAE,eAAe,GAAG,IAAW,EACzC,cAAc,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,IAAW;IAQ5D;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkChD,uDAAuD;IACvD,SAAS,IAAI,YAAY,EAAE;IAI3B,4DAA4D;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,mCAAmC;IAC7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAQ3C"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAcxD,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAuC;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;gBAEzD,OAAO,GAAE;QACnB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;QAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;QACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;KACtE;IAON;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkChD,uDAAuD;IACvD,SAAS,IAAI,YAAY,EAAE;IAI3B,4DAA4D;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,mCAAmC;IAC7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAQ3C"}

package/dist/platform/acp/manager.js

@@ -27,7 +27,7 @@ export function getDefaultAcpAgentCommand() {
  *
  * @example
  * ```ts
- * const mgr = new AcpManager(bus);
+ * const mgr = new AcpManager({ requestPermission });
  * const id = await mgr.spawn({ description: 'Fix the bug', context: '...', tools: ['read'] });
  * const results = await mgr.waitAll();
  * ```
@@ -39,11 +39,11 @@ export class AcpManager {
     requestPermission;
     runtimeBus;
     hookDispatcher;
-    constructor(permissionOrLegacyBus, runtimeBus = null, hookDispatcher = null) {
+    constructor(options = {}) {
         this.agentCmd = resolveAgentCommand();
-        this.requestPermission = typeof permissionOrLegacyBus === 'function' ? permissionOrLegacyBus : undefined;
-        this.runtimeBus = runtimeBus;
-        this.hookDispatcher = hookDispatcher;
+        this.requestPermission = options.requestPermission;
+        this.runtimeBus = options.runtimeBus ?? null;
+        this.hookDispatcher = options.hookDispatcher ?? null;
     }
     /**
      * Spawn a new subagent and start running the task.

package/dist/platform/acp/protocol.d.ts

@@ -16,7 +16,7 @@ export interface SubagentInfo {
     status: SubagentStatus;
     startedAt: number;
     /** Latest progress text from session updates. */
-    progress?: string;
+    progress?: string | undefined;
 }
 /** Final result after a subagent completes. */
 export interface SubagentResult {
@@ -37,8 +37,8 @@ export interface SubagentTask {
     /** App-owned working directory for the spawned ACP session. */
     workingDirectory: string;
     /** Optional model override (e.g. "claude-sonnet-4-5"). */
-    model?: string;
+    model?: string | undefined;
     /** Optional provider override (e.g. "anthropic"). */
-    provider?: string;
+    provider?: string | undefined;
 }
 //# sourceMappingURL=protocol.d.ts.map

package/dist/platform/acp/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,MAAM,EACN,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMxD,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE5E,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,MAAM,EACN,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMxD,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE5E,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B"}

package/dist/platform/adapters/bluebubbles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/bluebubbles/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgBzD,wBAAsB,+BAA+B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6GrH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/bluebubbles/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgBzD,wBAAsB,+BAA+B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2HrH"}

package/dist/platform/adapters/bluebubbles/index.js

@@ -43,7 +43,14 @@ export async function handleBlueBubblesSurfaceWebhook(req, context) {
     const messageId = readString(message.guid) ?? readString(message.messageId) ?? readString(payload.guid);
     const isFromMe = Boolean(message.isFromMe ?? message.fromMe ?? payload.isFromMe ?? payload.fromMe);
     if (isFromMe) {
-        return Response.json({ ok: true, ignored: true, reason: 'from-me' });
+        return Response.json({
+            ok: true,
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            ignored: true,
+            reason: 'from-me',
+        });
     }
     const conversationId = chatGuid ?? senderId;
     if (!conversationId)
@@ -78,7 +85,14 @@ export async function handleBlueBubblesSurfaceWebhook(req, context) {
         },
     });
     if (!text) {
-        return Response.json({ ok: true, acknowledged: true, bindingId: binding.id });
+        return Response.json({
+            ok: true,
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'no-actionable-text',
+            bindingId: binding.id,
+        });
     }
     const controlCommand = context.parseSurfaceControlCommand(text);
     if (controlCommand) {

package/dist/platform/adapters/discord/index.d.ts

@@ -3,7 +3,7 @@ import type { SurfaceAdapterContext } from '../types.js';
 export declare function handleDiscordSurfaceWebhook(req: Request, context: SurfaceAdapterContext): Promise<Response>;
 export declare function handleDiscordInteractionPayload(bodyRecord: Record<string, unknown>, context: SurfaceAdapterContext, discord?: DiscordIntegration, req?: Request): Promise<Response>;
 export declare function handleDiscordGatewayDispatchPayload(dispatch: {
-    readonly t?: string;
-    readonly d?: Record<string, unknown> | null;
+    readonly t?: string | undefined;
+    readonly d?: Record<string, unknown> | null | undefined;
 }, context: SurfaceAdapterContext, discord?: DiscordIntegration): Promise<Response>;
 //# sourceMappingURL=index.d.ts.map

package/dist/platform/adapters/discord/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/discord/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAA0D,MAAM,6BAA6B,CAAC;AACzH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiCjH;AAED,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,qBAA2B,EAClC,GAAG,GAAE,OAAmF,GACvF,OAAO,CAAC,QAAQ,CAAC,CA8JnB;AAED,wBAAsB,mCAAmC,CACvD,QAAQ,EAAE;IAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,EAC9E,OAAO,EAAE,qBAAqB,EAC9B,OAAO,qBAA2B,GACjC,OAAO,CAAC,QAAQ,CAAC,CAyFnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/discord/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAA0D,MAAM,6BAA6B,CAAC;AACzH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiCjH;AAED,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,qBAA2B,EAClC,GAAG,GAAE,OAAmF,GACvF,OAAO,CAAC,QAAQ,CAAC,CA8JnB;AAED,wBAAsB,mCAAmC,CACvD,QAAQ,EAAE;IAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EACtG,OAAO,EAAE,qBAAqB,EAC9B,OAAO,qBAA2B,GACjC,OAAO,CAAC,QAAQ,CAAC,CAyFnB"}

package/dist/platform/adapters/github/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/github/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACP,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;CACzC,GACA,OAAO,CAAC,QAAQ,CAAC,CAgDnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/github/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACP,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;CACzC,GACA,OAAO,CAAC,QAAQ,CAAC,CAsDnB"}

package/dist/platform/adapters/github/index.js

@@ -37,7 +37,13 @@ export async function handleGitHubAutomationWebhook(req, context) {
             type: event.type,
             action: event.action,
         });
-        return Response.json({ acknowledged: true, queued: false, reason: 'Event not actionable' });
+        return Response.json({
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'event-not-actionable',
+            message: 'Event not actionable',
+        });
     }
     const spawnResult = context.trySpawnAgent({ mode: 'spawn', task: prompt }, 'handleGitHubAutomationWebhook');
     if (spawnResult instanceof Response)

package/dist/platform/adapters/google-chat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/google-chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAWzD,wBAAsB,8BAA8B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2GpH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/google-chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAYzD,wBAAsB,8BAA8B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkIpH"}

package/dist/platform/adapters/google-chat/index.js

@@ -1,4 +1,5 @@
-import { parseJsonRecord, readTextBodyWithinLimit } from '../helpers.js';
+import { constantTimeEquals, parseJsonRecord, readTextBodyWithinLimit } from '../helpers.js';
+import { logger } from '../../utils/logger.js';
 function readRecord(value) {
     return value && typeof value === 'object' ? value : null;
 }
@@ -20,12 +21,23 @@ export async function handleGoogleChatSurfaceWebhook(req, context) {
     if (!payload)
         return Response.json({ error: 'Invalid JSON body' }, { status: 400 });
     const providedToken = readString(payload.token) ?? req.headers.get('x-goog-chat-token') ?? '';
-    if (verificationToken && providedToken !== verificationToken) {
+    if (verificationToken && !constantTimeEquals(verificationToken, providedToken)) {
         return Response.json({ error: 'Unauthorized' }, { status: 401 });
     }
     const eventType = readString(payload.type) ?? 'MESSAGE';
     if (eventType !== 'MESSAGE' && eventType !== 'ADDED_TO_SPACE') {
-        return Response.json({ text: 'ignored' });
+        logger.info('handleGoogleChatSurfaceWebhook: event ignored', {
+            reason: 'unsupported-event-type',
+            eventType,
+        });
+        return Response.json({
+            text: 'Ignored.',
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'unsupported-event-type',
+            eventType,
+        });
     }
     const message = readRecord(payload.message);
     const space = readRecord(payload.space);
@@ -69,7 +81,19 @@ export async function handleGoogleChatSurfaceWebhook(req, context) {
         },
     });
     if (!text) {
-        return Response.json({ text: 'Acknowledged.' });
+        logger.info('handleGoogleChatSurfaceWebhook: message acknowledged without queueing', {
+            reason: 'no-actionable-text',
+            bindingId: binding.id,
+            eventType,
+        });
+        return Response.json({
+            text: 'Acknowledged.',
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'no-actionable-text',
+            bindingId: binding.id,
+        });
     }
     const controlCommand = context.parseSurfaceControlCommand(text);
     if (controlCommand) {

package/dist/platform/adapters/homeassistant/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/homeassistant/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQzD,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAmInB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/homeassistant/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQzD,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAqInB"}

package/dist/platform/adapters/homeassistant/index.js

@@ -85,6 +85,8 @@ export async function handleHomeAssistantSurfaceWebhook(req, context) {
         return Response.json({
             acknowledged: true,
             queued: false,
+            outcome: 'ignored',
+            reason: 'no-actionable-text',
             bindingId: binding.id,
         });
     }

package/dist/platform/adapters/imessage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/imessage/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAUzD,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgFlH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/imessage/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAUzD,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsFlH"}

package/dist/platform/adapters/imessage/index.js

@@ -1,4 +1,4 @@
-import { parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '../helpers.js';
+import { constantTimeEquals, parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '../helpers.js';
 function readRecord(value) {
     return value && typeof value === 'object' ? value : null;
 }
@@ -12,7 +12,7 @@ export async function handleIMessageSurfaceWebhook(req, context) {
         || '';
     if (configuredToken) {
         const providedToken = readBearerOrHeaderToken(req, 'x-goodvibes-imessage-token');
-        if (providedToken !== configuredToken) {
+        if (!constantTimeEquals(configuredToken, providedToken)) {
             return Response.json({ error: 'Unauthorized' }, { status: 401 });
         }
     }
@@ -54,7 +54,13 @@ export async function handleIMessageSurfaceWebhook(req, context) {
         metadata: { ...payload },
     });
     if (!message) {
-        return Response.json({ acknowledged: true, queued: false, bindingId: binding.id });
+        return Response.json({
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'no-actionable-text',
+            bindingId: binding.id,
+        });
     }
     const submission = await context.sessionBroker.submitMessage({
         routeId: binding.id,

package/dist/platform/adapters/matrix/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/matrix/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgBzD,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkGhH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/matrix/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgBzD,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyGhH"}

package/dist/platform/adapters/matrix/index.js

@@ -1,4 +1,4 @@
-import { parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '../helpers.js';
+import { constantTimeEquals, parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '../helpers.js';
 function readRecord(value) {
     return value && typeof value === 'object' ? value : null;
 }
@@ -16,7 +16,7 @@ export async function handleMatrixSurfaceWebhook(req, context) {
         || process.env.MATRIX_ACCESS_TOKEN
         || '';
     const providedToken = readBearerOrHeaderToken(req, 'x-goodvibes-matrix-token');
-    if (configuredToken && providedToken !== configuredToken) {
+    if (configuredToken && !constantTimeEquals(configuredToken, providedToken)) {
         return Response.json({ error: 'Unauthorized' }, { status: 401 });
     }
     const rawBody = await readTextBodyWithinLimit(req);
@@ -65,7 +65,14 @@ export async function handleMatrixSurfaceWebhook(req, context) {
         },
     });
     if (!text) {
-        return Response.json({ ok: true, acknowledged: true, bindingId: binding.id });
+        return Response.json({
+            ok: true,
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'no-actionable-text',
+            bindingId: binding.id,
+        });
     }
     const controlCommand = context.parseSurfaceControlCommand(text);
     if (controlCommand) {

package/dist/platform/adapters/mattermost/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/mattermost/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAwCzD,wBAAsB,8BAA8B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqHpH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/mattermost/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAwCzD,wBAAsB,8BAA8B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4HpH"}

package/dist/platform/adapters/mattermost/index.js

@@ -1,4 +1,4 @@
-import { parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '../helpers.js';
+import { constantTimeEquals, parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '../helpers.js';
 function readRecord(value) {
     return value && typeof value === 'object' ? value : null;
 }
@@ -47,7 +47,7 @@ export async function handleMattermostSurfaceWebhook(req, context) {
     const providedToken = readBearerOrHeaderToken(req, 'x-goodvibes-mattermost-token')
         ?? readString(body.token)
         ?? '';
-    if (configuredToken && providedToken !== configuredToken) {
+    if (configuredToken && !constantTimeEquals(configuredToken, providedToken)) {
         return Response.json({ error: 'Unauthorized' }, { status: 401 });
     }
     const post = typeof body.post === 'string'
@@ -100,7 +100,14 @@ export async function handleMattermostSurfaceWebhook(req, context) {
         },
     });
     if (!task) {
-        return Response.json({ ok: true, acknowledged: true, bindingId: binding.id });
+        return Response.json({
+            ok: true,
+            acknowledged: true,
+            queued: false,
+            outcome: 'ignored',
+            reason: 'no-actionable-text',
+            bindingId: binding.id,
+        });
     }
     const controlCommand = context.parseSurfaceControlCommand(task);
     if (controlCommand) {

package/dist/platform/adapters/msteams/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/msteams/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkCzD,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+IjH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/adapters/msteams/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAmCzD,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsKjH"}