stitchkit 0.70.0 → 0.70.2

package/dist/agent-runtime.js

@@ -27,7 +27,7 @@ import {
   registerDeferredToolRepair,
   repairedSearchCall,
   selectAgentHistory
-} from "./index-vy5bjy07.js";
+} from "./index-4qfqy0m6.js";
 import {
   AgentModelCapabilitySchema,
   AgentModelCatalogEntrySchema,
@@ -71,11 +71,11 @@ import {
   RequestRunInterruptSchema,
   createAgentRuntimeStore,
   createMemoryAgentRuntimeStore
-} from "./index-hsabxjz0.js";
+} from "./index-jw81xr75.js";
 import {
   isAssistantHistoryEvidence,
   isCompleteAgentHistoryTurn
-} from "./index-es0h4w26.js";
+} from "./index-y2s6h5bf.js";
 import {
   createBoundedSinkManager
 } from "./index-a59da114.js";
@@ -695,112 +695,112 @@ function defineAgentProtocol(config) {
   };
 }
 export {
-  ACTIVE_AGENT_RUN_STATES,
-  AcceptInputAndAssignRunSchema,
-  AcquireAgentRunSchema,
-  AgentAdmissionEventSchema,
-  AgentAdmissionReceiptSchema,
-  AgentAssistantPlaceholderSchema,
-  AgentCheckpointEventSchema,
-  AgentContextOverflowError,
-  AgentControlPartSchema,
-  AgentConversationMessagePageSchema,
-  AgentConversationPageSchema,
-  AgentConversationSummarySchema,
-  AgentCostValueSchema,
-  AgentFilePartSchema,
-  AgentHistoryMutationSchema,
-  AgentJsonObjectSchema,
-  AgentMessagePartSchema,
-  AgentMessageRoleSchema,
-  AgentMessageSchema,
-  AgentMessageStatusSchema,
-  AgentModelCapabilitySchema,
-  AgentModelCatalogEntrySchema,
-  AgentModelCatalogSchema,
-  AgentModelDescriptorSchema,
-  AgentModelMetricSchema,
-  AgentModelPopularitySchema,
-  AgentModelPriceSchema,
-  AgentModelRegistrySnapshotSchema,
-  AgentModelSearchInputSchema,
-  AgentModelSearchResultSchema,
-  AgentModelSelectionSchema,
-  AgentOpaquePartSchema,
-  AgentProvenanceSchema,
-  AgentProviderEnvelopeSchema,
-  AgentReasoningDeltaEventSchema,
-  AgentReasoningEndEventSchema,
-  AgentReasoningPartSchema,
-  AgentReasoningStartEventSchema,
-  AgentRecordIdSchema,
-  AgentRecordVersionSchema,
-  AgentRecoverableDescriptorSchema,
-  AgentRecoverablePageSchema,
-  AgentRunEventSchema,
-  AgentRunMetricsSchema,
-  AgentRunQueuePrioritySchema,
-  AgentRunSchema,
-  AgentRunStartedEventSchema,
-  AgentRunStateEventSchema,
-  AgentRunStateSchema,
-  AgentRunTerminalEventSchema,
-  AgentRunViewSchema,
-  AgentRuntimeConflictError,
-  AgentRuntimeEventCursorSchema,
-  AgentRuntimeEventSchema,
-  AgentRuntimeHeadSchema,
-  AgentSnapshotSchema,
-  AgentSourcePartSchema,
-  AgentStepFinishedEventSchema,
-  AgentStoreAppliedSchema,
-  AgentStoreConflictSchema,
-  AgentStoreDuplicateSchema,
-  AgentStoreMutationResultSchema,
-  AgentStoreNotFoundSchema,
-  AgentStoredRunSchema,
-  AgentTerminalEventSchema,
-  AgentTerminalReasonSchema,
-  AgentTextPartSchema,
-  AgentTimestampSchema,
-  AgentTokenCountSchema,
-  AgentToolApprovalRequestPartSchema,
-  AgentToolApprovalResponsePartSchema,
-  AgentToolCallPartSchema,
-  AgentToolResultPartSchema,
-  AgentToolStatusEventSchema,
-  AgentTransientDeltaEventSchema,
-  AgentUsageSchema,
-  AgentUsageValueSchema,
-  CheckpointRunAssistantSchema,
-  CommitRunTerminalSchema,
-  DeferredAgentToolMatchSchema,
-  DeferredAgentToolReceiptSchema,
-  DeferredAgentToolSearchInputSchema,
-  RecoverAgentRunSchema,
-  ReplaceCompactedRangeSchema,
-  RequestRunInterruptSchema,
-  advanceAgentRuntimeEventCursor,
-  agentDurableEventId,
-  composeAgentPrompt,
-  createAgentObservability,
-  createAgentRuntime,
-  createAgentRuntimeEventSink,
-  createAgentRuntimeStore,
-  createAgentSessionCoordinator,
-  createAgentToolFenceLifecycle,
-  createDeferredAgentToolSurface,
-  createMemoryAgentModelSelectionStore,
-  createMemoryAgentRuntimeStore,
-  defineAgentProtocol,
-  defineModelRegistry,
-  hasAgentTerminalOutput,
-  isAssistantHistoryEvidence,
-  projectAgentHistory,
-  projectAgentHistoryDetailed,
-  runStateForTerminalReason,
-  searchAgentModelCatalog,
-  selectAgentHistory,
+  validateAgentModelSnapshot,
   structuredCompaction,
-  validateAgentModelSnapshot
+  selectAgentHistory,
+  searchAgentModelCatalog,
+  runStateForTerminalReason,
+  projectAgentHistoryDetailed,
+  projectAgentHistory,
+  isAssistantHistoryEvidence,
+  hasAgentTerminalOutput,
+  defineModelRegistry,
+  defineAgentProtocol,
+  createMemoryAgentRuntimeStore,
+  createMemoryAgentModelSelectionStore,
+  createDeferredAgentToolSurface,
+  createAgentToolFenceLifecycle,
+  createAgentSessionCoordinator,
+  createAgentRuntimeStore,
+  createAgentRuntimeEventSink,
+  createAgentRuntime,
+  createAgentObservability,
+  composeAgentPrompt,
+  agentDurableEventId,
+  advanceAgentRuntimeEventCursor,
+  RequestRunInterruptSchema,
+  ReplaceCompactedRangeSchema,
+  RecoverAgentRunSchema,
+  DeferredAgentToolSearchInputSchema,
+  DeferredAgentToolReceiptSchema,
+  DeferredAgentToolMatchSchema,
+  CommitRunTerminalSchema,
+  CheckpointRunAssistantSchema,
+  AgentUsageValueSchema,
+  AgentUsageSchema,
+  AgentTransientDeltaEventSchema,
+  AgentToolStatusEventSchema,
+  AgentToolResultPartSchema,
+  AgentToolCallPartSchema,
+  AgentToolApprovalResponsePartSchema,
+  AgentToolApprovalRequestPartSchema,
+  AgentTokenCountSchema,
+  AgentTimestampSchema,
+  AgentTextPartSchema,
+  AgentTerminalReasonSchema,
+  AgentTerminalEventSchema,
+  AgentStoredRunSchema,
+  AgentStoreNotFoundSchema,
+  AgentStoreMutationResultSchema,
+  AgentStoreDuplicateSchema,
+  AgentStoreConflictSchema,
+  AgentStoreAppliedSchema,
+  AgentStepFinishedEventSchema,
+  AgentSourcePartSchema,
+  AgentSnapshotSchema,
+  AgentRuntimeHeadSchema,
+  AgentRuntimeEventSchema,
+  AgentRuntimeEventCursorSchema,
+  AgentRuntimeConflictError,
+  AgentRunViewSchema,
+  AgentRunTerminalEventSchema,
+  AgentRunStateSchema,
+  AgentRunStateEventSchema,
+  AgentRunStartedEventSchema,
+  AgentRunSchema,
+  AgentRunQueuePrioritySchema,
+  AgentRunMetricsSchema,
+  AgentRunEventSchema,
+  AgentRecoverablePageSchema,
+  AgentRecoverableDescriptorSchema,
+  AgentRecordVersionSchema,
+  AgentRecordIdSchema,
+  AgentReasoningStartEventSchema,
+  AgentReasoningPartSchema,
+  AgentReasoningEndEventSchema,
+  AgentReasoningDeltaEventSchema,
+  AgentProviderEnvelopeSchema,
+  AgentProvenanceSchema,
+  AgentOpaquePartSchema,
+  AgentModelSelectionSchema,
+  AgentModelSearchResultSchema,
+  AgentModelSearchInputSchema,
+  AgentModelRegistrySnapshotSchema,
+  AgentModelPriceSchema,
+  AgentModelPopularitySchema,
+  AgentModelMetricSchema,
+  AgentModelDescriptorSchema,
+  AgentModelCatalogSchema,
+  AgentModelCatalogEntrySchema,
+  AgentModelCapabilitySchema,
+  AgentMessageStatusSchema,
+  AgentMessageSchema,
+  AgentMessageRoleSchema,
+  AgentMessagePartSchema,
+  AgentJsonObjectSchema,
+  AgentHistoryMutationSchema,
+  AgentFilePartSchema,
+  AgentCostValueSchema,
+  AgentConversationSummarySchema,
+  AgentConversationPageSchema,
+  AgentConversationMessagePageSchema,
+  AgentControlPartSchema,
+  AgentContextOverflowError,
+  AgentCheckpointEventSchema,
+  AgentAssistantPlaceholderSchema,
+  AgentAdmissionReceiptSchema,
+  AgentAdmissionEventSchema,
+  AcquireAgentRunSchema,
+  AcceptInputAndAssignRunSchema,
+  ACTIVE_AGENT_RUN_STATES
 };

package/dist/application/server-resource.d.ts

@@ -14,6 +14,7 @@ export interface ManagedServerResourceConfig<TRuntime> {
     readonly dependsOn?: readonly ManagedResourceDependency[];
     readonly required?: boolean;
     readonly retryAfterSeconds?: number;
+    readonly realtimeCloseTimeoutMs?: number;
 }
 /**
  * A managed resource that owns a managed server.

package/dist/application/server-resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-resource.d.ts","sourceRoot":"","sources":["../../src/application/server-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAmC,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,2BAA2B,CAAC,QAAQ;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EACX,mBAAmB,CAAC,QAAQ,CAAC,GAC7B,CAAC,CACC,OAAO,EAAE,sBAAsB,KAC5B,mBAAmB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,QAAQ,CAAE,SAAQ,eAAe;IACtE,KAAK,CACH,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,QAAQ,EAC5C,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,GAC5C,qBAAqB,CAAC,QAAQ,CAAC,CAwIjC"}
+{"version":3,"file":"server-resource.d.ts","sourceRoot":"","sources":["../../src/application/server-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAmC,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,2BAA2B,CAAC,QAAQ;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EACX,mBAAmB,CAAC,QAAQ,CAAC,GAC7B,CAAC,CACC,OAAO,EAAE,sBAAsB,KAC5B,mBAAmB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,QAAQ,CAAE,SAAQ,eAAe;IACtE,KAAK,CACH,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,QAAQ,EAC5C,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,GAC5C,qBAAqB,CAAC,QAAQ,CAAC,CA2IjC"}

package/dist/application-grammy.js

@@ -160,7 +160,7 @@ function createGrammyWebhookResource(config) {
   };
 }
 export {
-  GrammyWebhookUnavailableError,
+  grammyPollingResource,
   createGrammyWebhookResource,
-  grammyPollingResource
+  GrammyWebhookUnavailableError
 };

package/dist/application.js

@@ -29,7 +29,7 @@ import {
   ApplicationShutdownBudgetSchema,
   ApplicationShutdownOptionsSchema,
   createApplication
-} from "./index-6wzr93cg.js";
+} from "./index-w0445741.js";
 import {
   defineManagedResource,
   managedResourceDependencyId
@@ -47,7 +47,7 @@ import {
   ManagedResourceStateSchema,
   projectApplicationStatus
 } from "./index-8eywc9zv.js";
-import"./index-dk6e56g0.js";
+import"./index-7wpgrqa8.js";
 import"./index-0w9abg87.js";
 import {
   isRecord
@@ -1030,6 +1030,9 @@ function managedServerResource(config) {
       ...gracePeriodMs !== undefined && { gracePeriodMs },
       ...forceTimeoutMs !== undefined && { forceTimeoutMs },
       retryAfterSeconds: grace(config.retryAfterSeconds ?? 5),
+      ...config.realtimeCloseTimeoutMs !== undefined && {
+        realtimeCloseTimeoutMs: grace(config.realtimeCloseTimeoutMs)
+      },
       signal: context.signal
     };
     shutdownPromise = isHandle(server) ? server.shutdown(options) : server.then((handle) => handle.shutdown(options));
@@ -1062,68 +1065,68 @@ function managedServerResource(config) {
   });
 }
 export {
-  ActivityIdSchema,
-  ActivityLiveStateSchema,
-  ActivitySnapshotSchema,
-  ActivityStageIdSchema,
-  ActivityStageSnapshotSchema,
-  ActivityTokenBrand,
-  ApplicationAdmissionError,
-  ApplicationAdmissionSnapshotSchema,
-  ApplicationHealthHandlerOptionsSchema,
-  ApplicationHealthSchema,
-  ApplicationIdSchema,
-  ApplicationLifecycleEventSchema,
-  ApplicationLifecycleSchema,
-  ApplicationOperationalHandlersOptionsSchema,
-  ApplicationResourceShutdownSchema,
-  ApplicationShutdownBudgetSchema,
-  ApplicationShutdownOptionsSchema,
-  ApplicationShutdownResultSchema,
-  ApplicationSnapshotSchema,
-  ApplicationSnapshotSinkStatusSchema,
-  ApplicationStatusProjectionSchema,
-  BoundedAdmissionPolicySchema,
-  BoundedAdmissionRefusalError,
-  BoundedAdmissionRefusalReasonSchema,
-  BoundedAdmissionSnapshotSchema,
-  BoundedAdmissionStateSchema,
-  BoundedChannelPolicySchema,
-  BoundedChannelReaderError,
-  BoundedChannelSnapshotSchema,
-  BoundedChannelStateSchema,
-  BoundedOperationWaitError,
-  BoundedRateBudgetSchema,
-  CreditWindowSnapshotSchema,
-  DiagnosticJournalCloseResultSchema,
-  DiagnosticJournalFailurePhaseSchema,
-  DiagnosticJournalFrameSchema,
-  DiagnosticJournalLimitsSchema,
-  DiagnosticJournalRefusalReasonSchema,
-  DiagnosticJournalStateSchema,
-  DiagnosticJournalStatusSchema,
-  DiagnosticJournalSubmitResultSchema,
-  DiagnosticJournalWaitResultSchema,
-  ManagedResourceSnapshotSchema,
-  ManagedResourceStateSchema,
-  ManagedScheduleDescriptorSchema,
-  ManagedScheduleErrorPolicySchema,
-  ManagedScheduleOverlapSchema,
-  ManagedScheduleStatusSchema,
-  applicationLifecycleEvent,
-  createActivityProjection,
-  createApplication,
-  createApplicationEventSink,
-  createApplicationHealthHandler,
-  createApplicationOperationalHandlers,
-  createApplicationSnapshotSink,
-  createBoundedAdmission,
-  createBoundedChannel,
-  createCreditWindow,
-  createDiagnosticJournal,
-  createManagedSchedule,
-  defineManagedResource,
-  managedResourceDependencyId,
+  projectApplicationStatus,
   managedServerResource,
-  projectApplicationStatus
+  managedResourceDependencyId,
+  defineManagedResource,
+  createManagedSchedule,
+  createDiagnosticJournal,
+  createCreditWindow,
+  createBoundedChannel,
+  createBoundedAdmission,
+  createApplicationSnapshotSink,
+  createApplicationOperationalHandlers,
+  createApplicationHealthHandler,
+  createApplicationEventSink,
+  createApplication,
+  createActivityProjection,
+  applicationLifecycleEvent,
+  ManagedScheduleStatusSchema,
+  ManagedScheduleOverlapSchema,
+  ManagedScheduleErrorPolicySchema,
+  ManagedScheduleDescriptorSchema,
+  ManagedResourceStateSchema,
+  ManagedResourceSnapshotSchema,
+  DiagnosticJournalWaitResultSchema,
+  DiagnosticJournalSubmitResultSchema,
+  DiagnosticJournalStatusSchema,
+  DiagnosticJournalStateSchema,
+  DiagnosticJournalRefusalReasonSchema,
+  DiagnosticJournalLimitsSchema,
+  DiagnosticJournalFrameSchema,
+  DiagnosticJournalFailurePhaseSchema,
+  DiagnosticJournalCloseResultSchema,
+  CreditWindowSnapshotSchema,
+  BoundedRateBudgetSchema,
+  BoundedOperationWaitError,
+  BoundedChannelStateSchema,
+  BoundedChannelSnapshotSchema,
+  BoundedChannelReaderError,
+  BoundedChannelPolicySchema,
+  BoundedAdmissionStateSchema,
+  BoundedAdmissionSnapshotSchema,
+  BoundedAdmissionRefusalReasonSchema,
+  BoundedAdmissionRefusalError,
+  BoundedAdmissionPolicySchema,
+  ApplicationStatusProjectionSchema,
+  ApplicationSnapshotSinkStatusSchema,
+  ApplicationSnapshotSchema,
+  ApplicationShutdownResultSchema,
+  ApplicationShutdownOptionsSchema,
+  ApplicationShutdownBudgetSchema,
+  ApplicationResourceShutdownSchema,
+  ApplicationOperationalHandlersOptionsSchema,
+  ApplicationLifecycleSchema,
+  ApplicationLifecycleEventSchema,
+  ApplicationIdSchema,
+  ApplicationHealthSchema,
+  ApplicationHealthHandlerOptionsSchema,
+  ApplicationAdmissionSnapshotSchema,
+  ApplicationAdmissionError,
+  ActivityTokenBrand,
+  ActivityStageSnapshotSchema,
+  ActivityStageIdSchema,
+  ActivitySnapshotSchema,
+  ActivityLiveStateSchema,
+  ActivityIdSchema
 };

package/dist/browser/live-state.d.ts

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+export declare const LiveStatePhaseSchema: z.ZodEnum<{
+    closed: "closed";
+    idle: "idle";
+    live: "live";
+    opening: "opening";
+    "resync-required": "resync-required";
+    unavailable: "unavailable";
+}>;
+export type LiveStatePhase = z.infer<typeof LiveStatePhaseSchema>;
+export declare const LiveStateStopReasonSchema: z.ZodEnum<{
+    "buffer-overflow": "buffer-overflow";
+    "controller-capacity": "controller-capacity";
+    "controller-error": "controller-error";
+    gap: "gap";
+    "source-error": "source-error";
+    "source-unavailable": "source-unavailable";
+}>;
+export type LiveStateStopReason = z.infer<typeof LiveStateStopReasonSchema>;
+export declare const LiveStateControllerStatusSchema: z.ZodReadonly<z.ZodObject<{
+    phase: z.ZodEnum<{
+        closed: "closed";
+        idle: "idle";
+        live: "live";
+        opening: "opening";
+        "resync-required": "resync-required";
+        unavailable: "unavailable";
+    }>;
+    generation: z.ZodNumber;
+    hasValue: z.ZodBoolean;
+    bufferedEvents: z.ZodNumber;
+    bufferedBytes: z.ZodNumber;
+    receivedEvents: z.ZodNumber;
+    appliedEvents: z.ZodNumber;
+    duplicateEvents: z.ZodNumber;
+    gapEvents: z.ZodNumber;
+    refusedEvents: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodEnum<{
+        "buffer-overflow": "buffer-overflow";
+        "controller-capacity": "controller-capacity";
+        "controller-error": "controller-error";
+        gap: "gap";
+        "source-error": "source-error";
+        "source-unavailable": "source-unavailable";
+    }>>;
+}, z.core.$strict>>;
+export type LiveStateControllerStatus = z.infer<typeof LiveStateControllerStatusSchema>;
+export interface LiveStateControllerSnapshot<TState> extends LiveStateControllerStatus {
+    readonly value?: TState;
+}
+export type LiveStateEventDecision<TState> = {
+    readonly outcome: 'applied';
+    readonly state: TState;
+} | {
+    readonly outcome: 'duplicate';
+} | {
+    readonly outcome: 'gap';
+};
+export interface LiveStateSourceOpenInput<TEvent> {
+    readonly signal: AbortSignal;
+    /** May run before `open()` resolves; the controller buffers those events finitely. */
+    readonly onEvent: (event: TEvent) => void;
+    /** Reports loss of this source generation. Reconnect policy remains source-owned. */
+    readonly onUnavailable: () => void;
+}
+export interface LiveStateSourceOpenResult<TState> {
+    /** State at the source's declared consistency point. */
+    readonly snapshot: TState;
+    /**
+     * Releases only resources owned by this opened source generation. Must be
+     * idempotent because abort-aware sources may already have begun cleanup.
+     */
+    close(): void | Promise<void>;
+}
+export interface LiveStateSource<TState, TEvent> {
+    /**
+     * Open one continuous generation.
+     *
+     * By resolution, every event after `snapshot`'s consistency point has already
+     * been or will be passed to `onEvent`. A source that performs an unrelated
+     * snapshot read followed by subscription does not satisfy this contract.
+     */
+    open(input: LiveStateSourceOpenInput<TEvent>): Promise<LiveStateSourceOpenResult<TState>>;
+}
+export interface LiveStateControllerError {
+    readonly error: unknown;
+    readonly generation: number;
+    readonly phase: LiveStatePhase;
+}
+export interface LiveStateSubscriberError<TState> {
+    readonly error: unknown;
+    readonly snapshot: LiveStateControllerSnapshot<TState>;
+}
+export interface LiveStateControllerConfig<TState, TEvent> {
+    readonly source: LiveStateSource<TState, TEvent>;
+    /** Provider-owned cursor/revision policy and state reduction. Must be synchronous. */
+    readonly applyEvent: (state: TState, event: TEvent) => LiveStateEventDecision<TState>;
+    readonly maxBufferedEvents: number;
+    readonly maxBufferedBytes: number;
+    /** Exact retained-byte accounting for an event waiting behind the snapshot boundary. */
+    readonly sizeOfEvent: (event: TEvent) => number;
+    readonly signal?: AbortSignal;
+    onControllerError?(failure: LiveStateControllerError): void;
+    onSubscriberError?(failure: LiveStateSubscriberError<TState>): void;
+}
+export interface LiveStateController<TState> {
+    /** Opens only from `idle`; use `resync()` after loss or an explicit refresh. */
+    start(): Promise<LiveStateControllerSnapshot<TState>>;
+    /**
+     * Fences the current generation and opens a fresh source boundary while
+     * bounded pending-operation capacity permits. Otherwise it returns
+     * `unavailable/controller-capacity`; retry after `resync-required` is published.
+     */
+    resync(): Promise<LiveStateControllerSnapshot<TState>>;
+    getSnapshot(): LiveStateControllerSnapshot<TState>;
+    /** Synchronous external-store subscription; async listeners are removed as invalid. */
+    subscribe(listener: (snapshot: LiveStateControllerSnapshot<TState>) => void): () => void;
+    /** Fences current work and closes any source handle that has already opened. */
+    close(): Promise<LiveStateControllerSnapshot<TState>>;
+}
+/**
+ * Keep one application state current across a provider-declared snapshot/event
+ * boundary without owning transport reconnect, schemas, replay storage or cursors.
+ */
+export declare function createLiveStateController<TState, TEvent>(config: LiveStateControllerConfig<TState, TEvent>): LiveStateController<TState>;
+//# sourceMappingURL=live-state.d.ts.map

package/dist/browser/live-state.d.ts.map

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

package/dist/cli.js

@@ -20,10 +20,10 @@ import"./index-0w9abg87.js";
 import"./index-qyrqwr4c.js";
 import"./index-6k1937bx.js";
 export {
-  DEFAULT_EXIT_CODES,
-  createCli,
-  defineCliCommand,
-  emitResult,
+  pollUntilDone,
   parseCliArgs,
-  pollUntilDone
+  emitResult,
+  defineCliCommand,
+  createCli,
+  DEFAULT_EXIT_CODES
 };

package/dist/contract/index.js

@@ -23,25 +23,25 @@ import {
 } from "../index-f6n5n7nz.js";
 import"../index-ksp6e2ye.js";
 export {
-  ALL_TRANSPORTS,
-  AppError,
-  ContractStreamFrameSchema,
-  DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
-  ManagedFilePathSchema,
-  ManagedFileRefSchema,
-  STITCH_ERROR_STATUS,
-  appError,
-  badRequest,
-  conflict,
-  createContractFactory,
-  decodeCursor,
-  defineContract,
-  defineErrors,
-  encodeCursor,
-  forbidden,
-  isStitchErrorCode,
-  notFound,
-  paginatedSchema,
+  unauthorized,
   rateLimited,
-  unauthorized
+  paginatedSchema,
+  notFound,
+  isStitchErrorCode,
+  forbidden,
+  encodeCursor,
+  defineErrors,
+  defineContract,
+  decodeCursor,
+  createContractFactory,
+  conflict,
+  badRequest,
+  appError,
+  STITCH_ERROR_STATUS,
+  ManagedFileRefSchema,
+  ManagedFilePathSchema,
+  DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
+  ContractStreamFrameSchema,
+  AppError,
+  ALL_TRANSPORTS
 };

package/dist/declaration.d.ts

@@ -1,6 +1,10 @@
 /**
  * The project declaration — the one machine-readable statement a repository
  * chooses to make about itself.
+ * Identity names its buildable source/artifact, not product membership, a
+ * checkout or a harness workspace. Explicit product↔repository membership is
+ * many-to-many and belongs to an external registry with its own access policy;
+ * dependencies do not create membership or require private companion metadata.
  *
  * The schema lives in the published framework, not in the repository that fills
  * it in, because it has readers that must never disagree: the project itself,

package/dist/declaration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../src/declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAoBpD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK/D;AAUD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAO3B,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,uCAQlC,CAAC;AAEJ,yEAAyE;AACzE,eAAO,MAAM,qBAAqB;;;;;kBAOvB,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,aAW9B,CAAC;AAEJ,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,aAEiD,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB;;;;kBAavB,CAAC;AAEZ,kDAAkD;AAClD,eAAO,MAAM,oBAAoB;;;EAAwC,CAAC;AAoG1E,eAAO,MAAM,oBAAoB;;;kBAKtB,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;kBAMpC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;kBA0BnB,CAAC;AAEZ;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB;;;;kBAezB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,gFAAgF;AAChF,eAAO,MAAM,kBAAkB;;;;;;;;;;;kBAciD,CAAC;AAEjF,0CAA0C;AAC1C,eAAO,MAAM,6BAA6B;;;EAA+B,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;kBAK1B,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;;kBAMzB,CAAC;AAEZ,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB;;;;;;kBAEtB,CAAC;AAEZ,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB;;;;;;EAA0D,CAAC;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;kBAclC,CAAC;AAEJ,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0DjC,CAAC;AAyCL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAKpE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAU3E;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAC7B,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAEzB"}
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../src/declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAoBpD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK/D;AAUD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAO3B,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,uCAQlC,CAAC;AAEJ,yEAAyE;AACzE,eAAO,MAAM,qBAAqB;;;;;kBAOvB,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,aAW9B,CAAC;AAEJ,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,aAEiD,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB;;;;kBAavB,CAAC;AAEZ,kDAAkD;AAClD,eAAO,MAAM,oBAAoB;;;EAAwC,CAAC;AAoG1E,eAAO,MAAM,oBAAoB;;;kBAKtB,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;kBAMpC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;kBA0BnB,CAAC;AAEZ;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB;;;;kBAezB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,gFAAgF;AAChF,eAAO,MAAM,kBAAkB;;;;;;;;;;;kBAciD,CAAC;AAEjF,0CAA0C;AAC1C,eAAO,MAAM,6BAA6B;;;EAA+B,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;kBAK1B,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;;kBAMzB,CAAC;AAEZ,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB;;;;;;kBAEtB,CAAC;AAEZ,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB;;;;;;EAA0D,CAAC;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;kBAclC,CAAC;AAEJ,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0DjC,CAAC;AAyCL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAKpE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAU3E;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAC7B,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAEzB"}