@effect-agent/platform-cloudflare 0.0.1-beta.6 → 0.1.0-beta.11

package/dist/index.d.mts

@@ -2,8 +2,9 @@ import { Context, Effect, Layer, Option, Schema } from "effect";
 import { AbortCommand, AbortIntent, AdmissionConflict, AgentBindingResolver, AppendConflict, ApprovalConflict, ApprovalDecisionCommand, ApprovalDecisionIntent, CanonicalRecordEnvelope, CanonicalSequence, ConversationNotMaterialized, ConversationStore, ConversationStoreError, DefinitionDigests, DigestError, DurableAgentRuntime, DurableBindingFailure, DurableRuntimeConfig, DurableRuntimeFailpointError, DurableRuntimeFailpointHandler, DurableSubmitAgent, DurableSubmitOptions, DurableWorkerFailure, FenceRejected, IntegrityReport, JoinedToHost, LedgerError, ObligationReport, ObligationThresholds, OperationDenied, OwnershipLost, ProducerId, Receipt, RecoveryExplanation, RecoveryReport, ResolvedBinding, RetryCommand, RetryRefused, RunJournalError, Settlement, SettlementConflict, SubmissionLedger, ToolReconciler, UnknownResolutionCommand, UnknownResolutionConflict, UnknownResolutionIntent, WakeScheduler } from "@effect-agent/session";
 import { ConversationPortTransport, DoStorageFailpointHandler, DoStorageInitializationError } from "@effect-agent/storage-cloudflare";
 import { AgentInputError, ConversationId } from "@effect-agent/core";
-import { DurableObject, WorkerEntrypoint } from "cloudflare:workers";
+import { DurableObjectState as DurableObjectState$1, WorkerEnvironment } from "effect-cf";
 import { CodeExecutor, SandboxImplementation } from "@effect-agent/sandbox";
+import { DurableObject as DurableObject$1, WorkerEntrypoint } from "cloudflare:workers";
 //#region src/bindings.d.ts
 declare const CloudflareBindingError_base: Schema.Class<CloudflareBindingError, Schema.TaggedStruct<"CloudflareBindingError", {
   readonly binding: Schema.String;
@@ -149,8 +150,6 @@ declare const CloudflareDurableRuntimeConfigValue_base: Schema.Class<CloudflareD
   readonly abortPollInterval: Schema.Int;
   /** Canonical observation poll cadence of the Durable Object store. */
   readonly observationPollInterval: Schema.Int;
-  /** Cooperative background-export budget; native Object delivery never awaits the flush. */
-  readonly telemetryFlushTimeout: Schema.Int;
   /** Per-value byte bound; must stay under the platform's 2 MB SQLite value limit. */
   readonly maxStoredValueBytes: Schema.Int;
   /** Opt-in full payload/digest-chain audit while opening the store. */
@@ -177,7 +176,6 @@ declare const CLOUDFLARE_RUNTIME_DEFAULTS: {
   readonly leaseRenewalInterval: 10000;
   readonly abortPollInterval: 500;
   readonly observationPollInterval: 25;
-  readonly telemetryFlushTimeout: 2000;
   readonly maxStoredValueBytes: 1900000;
   readonly verifyOnOpen: false;
   readonly maxQueueDepthPerLane: 256;
@@ -324,36 +322,6 @@ declare const cloudflareWakeSchedulerLayer: Layer.Layer<WakeScheduler, never, Du
  */
 declare const conversationPortTransportLayer: Layer.Layer<ConversationPortTransport, never, ConversationObjectNamespace>;
 //#endregion
-//#region src/telemetry.d.ts
-declare const CloudflareTelemetryExportError_base: Schema.Class<CloudflareTelemetryExportError, Schema.TaggedStruct<"CloudflareTelemetryExportError", {
-  /** The original exporter failure, retained for host-side diagnostics. */
-  readonly cause: Schema.Defect;
-}>, import("effect/Cause").YieldableError>;
-/** A host exporter failed during one coalesced background export attempt. */
-declare class CloudflareTelemetryExportError extends CloudflareTelemetryExportError_base {}
-declare const CloudflareRuntimeTelemetry_base: Context.ServiceClass<CloudflareRuntimeTelemetry, "@effect-agent/platform-cloudflare/CloudflareRuntimeTelemetry", {
-  readonly flush: Effect.Effect<void, CloudflareTelemetryExportError>;
-}>;
-/**
- * Host-owned exporter lifecycle for one Cloudflare Conversation Object incarnation.
- *
- * The platform package creates measurements but deliberately does not select an exporter or
- * vendor. Native entrypoint instrumentation consumes this service at the Worker composition edge;
- * applications pass its provider as the second `makeConversationObjectClass` argument together
- * with their Effect Logger, Tracer, and Metric layers. That provider may read `DurableObjectContext` or
- * `ConversationObjectNamespace`, and its typed acquisition error remains visible in construction.
- * `flush` must attempt to export every configured signal. After the native span closes, the
- * Conversation Object reserves it into a shared post-settlement batch before `ctx.waitUntil` under
- * a cooperative timeout. Only each pending/trailing/queued batch's first owner registers its
- * shared Promise. Cycles remain capped at one first exporter attempt plus at most one trailing
- * attempt, with one queued cycle while trailing runs; exporter completion never holds endpoint
- * delivery open and exporter failure never replaces endpoint behavior.
- */
-declare class CloudflareRuntimeTelemetry extends CloudflareRuntimeTelemetry_base {
-  /** Content-free default selected by `makeConversationObjectClass` when no host Layer is passed. */
-  static readonly layerNoop: Layer.Layer<CloudflareRuntimeTelemetry, never, never>;
-}
-//#endregion
 //#region src/layers.d.ts
 /**
  * Raw (unvalidated) construction options for `CloudflareDurableRuntime.layer`, mirroring
@@ -381,11 +349,6 @@ interface CloudflareDurableRuntimeOptions {
   readonly abortPollInterval?: number | undefined;
   /** Milliseconds; default 25. */
   readonly observationPollInterval?: number | undefined;
-  /**
-   * Milliseconds; default 2000. Cooperative budget for the background exporter flush registered
-   * after each native RPC, wake, or alarm span. Delivery never awaits the flush.
-   */
-  readonly telemetryFlushTimeout?: number | undefined;
   /** Bytes; default just under the 2 MB platform value limit. */
   readonly maxStoredValueBytes?: number | undefined;
   /** Default false. */
@@ -458,9 +421,9 @@ declare class ConversationObjectPorts extends ConversationObjectPorts_base {}
  * Storage compatibility is verified during construction: an incompatible database fails the
  * Layer typed (`DoStorageCompatibilityError`) before anything is mutated (DEPLOY-008).
  *
- * Requires the two binding services (`DurableObjectContext`, `ConversationObjectNamespace`).
- * Host observability belongs to the Worker composition edge because native entrypoint lifecycle
- * instrumentation, rather than this durable runtime assembly, consumes it (DEPLOY-010).
+ * Requires only the two binding services (`DurableObjectContext`,
+ * `ConversationObjectNamespace`) — platform values enter exclusively through Layers
+ * (DEPLOY-010).
  */
 declare class CloudflareDurableRuntime {
   static layer(options: CloudflareDurableRuntimeOptions): Layer.Layer<CloudflareDurableRuntimeServices, CloudflareDurableRuntimeInitializationError, DurableObjectContext | ConversationObjectNamespace>;
@@ -655,6 +618,9 @@ declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorded | Hos
         readonly turn: number;
         readonly messages: Schema.Json;
         readonly messagesDigest: string;
+        readonly inputTokens?: number | undefined;
+        readonly outputTokens?: number | undefined;
+        readonly costMicrousd?: number | undefined;
       } | {
         readonly _tag: "ToolCallPrepared";
         readonly runId: string;
@@ -717,8 +683,10 @@ declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorded | Hos
       } | {
         readonly _tag: "CompactionCreated";
         readonly runId: string;
-        readonly sourceDigest: string;
-        readonly summary: string;
+        readonly turn: number;
+        readonly kind: "clear-tool-results" | "summarize";
+        readonly coversThrough: number;
+        readonly summary?: string | undefined;
       } | {
         readonly _tag: "RunFailed";
         readonly runId: string;
@@ -740,6 +708,7 @@ declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorded | Hos
         readonly outcome: "aborted" | "completed" | "failed";
         readonly runId?: string | undefined;
         readonly result?: Schema.Json | undefined;
+        readonly finishReason?: "budget-exhausted" | undefined;
       } | {
         readonly _tag: "SubagentRequested";
         readonly runId: string;
@@ -910,7 +879,7 @@ declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorded | Hos
     readonly attemptedEpoch: number;
   } | {
     readonly _tag: "DurableRuntimeFailpointError";
-    readonly location: "abort:after-intent" | "approval:after-request-append" | "approval:after-suspend" | "claim:after-claim" | "input:after-canonical-append" | "join:after-canonical-append" | "join:after-claim" | "resolve:after-intent" | "step:after-step-append" | "subagent:after-admit" | "subagent:after-child-abort-intent" | "subagent:after-child-ready" | "subagent:after-join-append" | "subagent:after-release" | "subagent:after-release-pending" | "subagent:after-request-append" | "subagent:after-reserve" | "subagent:after-sibling-settle" | "subagent:after-start-append" | "subagent:after-suspend" | "submit:after-admit" | "submit:after-materialize" | "terminalize:after-canonical-append" | "terminalize:after-reserve" | "tools:after-prepared-append" | "turn:after-canonical-append" | "turn:after-response-append" | "turn:after-results-append";
+    readonly location: "abort:after-intent" | "approval:after-request-append" | "approval:after-suspend" | "claim:after-claim" | "compaction:after-canonical-append" | "input:after-canonical-append" | "join:after-canonical-append" | "join:after-claim" | "resolve:after-intent" | "step:after-step-append" | "subagent:after-admit" | "subagent:after-child-abort-intent" | "subagent:after-child-ready" | "subagent:after-join-append" | "subagent:after-release" | "subagent:after-release-pending" | "subagent:after-request-append" | "subagent:after-reserve" | "subagent:after-sibling-settle" | "subagent:after-start-append" | "subagent:after-suspend" | "submit:after-admit" | "submit:after-materialize" | "terminalize:after-canonical-append" | "terminalize:after-reserve" | "tools:after-prepared-append" | "turn:after-canonical-append" | "turn:after-response-append" | "turn:after-results-append";
   } | {
     readonly _tag: "AdmissionLimitExceeded";
     readonly limit: "database-bytes" | "input-bytes" | "queue-depth";
@@ -963,7 +932,8 @@ declare class CloudflareConversationClient extends CloudflareConversationClient_
 //#endregion
 //#region src/conversation-object.d.ts
 /**
- * `makeConversationObjectClass(options, telemetry?)` — the Conversation Durable Object (plan §1.4,
+ * `makeConversationObjectClass(options, observability?)` — the Conversation Durable Object
+ * (plan §1.4,
  * D-P6-1): a factory returning a class that applications export from their Worker entry.
  * One SQLite-backed Object per Conversation is the serialized owner (durability §6); the
  * Object never runs `runResolvedWorker`'s infinite loop — each ingress event or alarm runs
@@ -1490,7 +1460,7 @@ declare const encodeAdminResponse: (input: AdminFailed | ExplainedRecovery | Obl
     readonly attemptedEpoch: number;
   } | {
     readonly _tag: "DurableRuntimeFailpointError";
-    readonly location: "abort:after-intent" | "approval:after-request-append" | "approval:after-suspend" | "claim:after-claim" | "input:after-canonical-append" | "join:after-canonical-append" | "join:after-claim" | "resolve:after-intent" | "step:after-step-append" | "subagent:after-admit" | "subagent:after-child-abort-intent" | "subagent:after-child-ready" | "subagent:after-join-append" | "subagent:after-release" | "subagent:after-release-pending" | "subagent:after-request-append" | "subagent:after-reserve" | "subagent:after-sibling-settle" | "subagent:after-start-append" | "subagent:after-suspend" | "submit:after-admit" | "submit:after-materialize" | "terminalize:after-canonical-append" | "terminalize:after-reserve" | "tools:after-prepared-append" | "turn:after-canonical-append" | "turn:after-response-append" | "turn:after-results-append";
+    readonly location: "abort:after-intent" | "approval:after-request-append" | "approval:after-suspend" | "claim:after-claim" | "compaction:after-canonical-append" | "input:after-canonical-append" | "join:after-canonical-append" | "join:after-claim" | "resolve:after-intent" | "step:after-step-append" | "subagent:after-admit" | "subagent:after-child-abort-intent" | "subagent:after-child-ready" | "subagent:after-join-append" | "subagent:after-release" | "subagent:after-release-pending" | "subagent:after-request-append" | "subagent:after-reserve" | "subagent:after-sibling-settle" | "subagent:after-start-append" | "subagent:after-suspend" | "submit:after-admit" | "submit:after-materialize" | "terminalize:after-canonical-append" | "terminalize:after-reserve" | "tools:after-prepared-append" | "turn:after-canonical-append" | "turn:after-response-append" | "turn:after-results-append";
   } | {
     readonly _tag: "DurableAlarmError";
     readonly operation: string;
@@ -1503,7 +1473,7 @@ declare const encodeAdminResponse: (input: AdminFailed | ExplainedRecovery | Obl
 }, Schema.SchemaError, never>;
 declare const decodeAdminResponse: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<AdminFailed | ExplainedRecovery | ObligationsScanned | RetryExecuted | VerifiedIntegrity, Schema.SchemaError, never>;
 /** The public endpoint surface of one Conversation Object instance. */
-interface ConversationObjectInstance extends DurableObject {
+interface ConversationObjectInstance extends DurableObject$1 {
   submitEncoded(encoded: unknown): Promise<unknown>;
   awaitSettlementEncoded(encoded: unknown): Promise<unknown>;
   observePage(encoded: unknown): Promise<unknown>;
@@ -1516,7 +1486,7 @@ interface ConversationObjectInstance extends DurableObject {
   obligationsEncoded(encoded: unknown): Promise<unknown>;
   portCall(encoded: unknown): Promise<unknown>;
   wake(): Promise<void>;
-  alarm(): Promise<void>;
+  alarm(alarmInfo?: AlarmInvocationInfo): Promise<void> | void;
 }
 /** The constructor shape workerd instantiates for each Conversation Object. */
 interface ConversationObjectClass {
@@ -1524,14 +1494,12 @@ interface ConversationObjectClass {
 }
 /**
  * Build the application's Conversation Object class (export it from the Worker entry).
- * `telemetry` is the host composition boundary: it may require the Object context/namespace and
- * retain a typed acquisition error, while any additional output services remain available to the
- * cached runtime. `TelemetryError` stays the first explicit generic for source compatibility;
- * additional outputs infer from the Layer. Omitting it installs the content-free no-op service.
- * The explicit return type is what makes declaration emit possible: the class body carries a
- * private runtime field, and TS4094 rejects inferring an exported anonymous class type around it.
+ * effect-cf owns the cached ManagedRuntime, native RPC methods, event scopes, and post-handler
+ * OTLP flush scheduling for RPC and alarm events. The optional outer Layer is built per native
+ * event, so a host can install Tracer/Logger/Metric services and `OtlpExporter.Flusher` without
+ * Effect Agent owning exporter lifecycle machinery.
  */
-declare const makeConversationObjectClass: <TelemetryError = never, AdditionalTelemetryOutputs = never>(options: ConversationObjectOptions, telemetry?: Layer.Layer<CloudflareRuntimeTelemetry | AdditionalTelemetryOutputs, TelemetryError, DurableObjectContext | ConversationObjectNamespace>) => ConversationObjectClass;
+declare const makeConversationObjectClass: <EventLayerError = never, EventServices = never>(options: ConversationObjectOptions, observability?: Layer.Layer<EventServices, EventLayerError, DurableObjectContext | ConversationObjectNamespace | DurableObjectState$1.DurableObjectState | WorkerEnvironment>) => ConversationObjectClass;
 //#endregion
 //#region src/code-mode-executor.d.ts
 /**
@@ -1576,5 +1544,5 @@ interface DynamicWorkerCodeExecutorOptions {
 /** Layer building the Dynamic Worker `CodeExecutor` from resolved bindings. */
 declare const dynamicWorkerCodeExecutorLayer: (options: DynamicWorkerCodeExecutorOptions) => Layer.Layer<CodeExecutor>;
 //#endregion
-export { AbortRecorded, AdminExplainRequest, AdminFailed, AdminFailure, AdminResponse, AdminVerifyRequest, AdmissionLimitExceeded, ApprovalRecorded, CLOUDFLARE_DATABASE_CAP_BYTES, CLOUDFLARE_RUNTIME_DEFAULTS, ClientAbortFailure, ClientApprovalFailure, ClientAwaitFailure, ClientObserveFailure, ClientSubmitFailure, ClientUnknownFailure, CloudflareAdmissionLimitsValue, CloudflareBindingError, CloudflareBindingSource, CloudflareBindingSourceContext, CloudflareConversationClient, CloudflareDurableRuntime, CloudflareDurableRuntimeConfig, CloudflareDurableRuntimeConfigValue, CloudflareDurableRuntimeInitializationError, CloudflareDurableRuntimeOptions, CloudflareDurableRuntimeServices, CloudflarePlatformConfigError, CloudflareRuntimeTelemetry, CloudflareTelemetryExportError, CodeModeHostEntrypoint, CodeModeHostStub, ConversationClientError, ConversationMaintenance, ConversationObjectClass, ConversationObjectIdentity, ConversationObjectInstance, ConversationObjectNamespace, ConversationObjectOptions, ConversationObjectPorts, ConversationObjectRpc, DEFAULT_MAX_DATABASE_BYTES, DurableAlarmError, DurableAlarmService, DurableObjectContext, DynamicWorkerCodeExecutorOptions, ExplainedRecovery, HostFailed, HostFailure, HostProtocolError, HostResponse, MaintenancePassFailure, MaintenancePassReport, ObligationsScanned, ObservePageRequest, ObservedPage, RetryExecuted, SettlementReached, SubmitRequest, SubmitSucceeded, UnknownResolutionRecorded, VerifiedIntegrity, boundHostDiagnostic, cloudflareWakeSchedulerLayer, conversationNamespaceFromEnv, conversationNamespaceLayer, conversationPortTransportLayer, decodeAbortCommand, decodeAdminExplainRequest, decodeAdminResponse, decodeAdminVerifyRequest, decodeApprovalDecisionCommand, decodeHostResponse, decodeObligationThresholds, decodeObservePageRequest, decodeReceipt, decodeRetryCommand, decodeSubmitRequest, decodeUnknownResolutionCommand, dynamicWorkerCodeExecutorLayer, dynamicWorkerImplementation, encodeAbortCommand, encodeAdminResponse, encodeApprovalDecisionCommand, encodeHostResponse, encodeObservePageRequest, encodeReceipt, encodeSubmitRequest, encodeUnknownResolutionCommand, makeConversationObjectClass };
+export { AbortRecorded, AdminExplainRequest, AdminFailed, AdminFailure, AdminResponse, AdminVerifyRequest, AdmissionLimitExceeded, ApprovalRecorded, CLOUDFLARE_DATABASE_CAP_BYTES, CLOUDFLARE_RUNTIME_DEFAULTS, ClientAbortFailure, ClientApprovalFailure, ClientAwaitFailure, ClientObserveFailure, ClientSubmitFailure, ClientUnknownFailure, CloudflareAdmissionLimitsValue, CloudflareBindingError, CloudflareBindingSource, CloudflareBindingSourceContext, CloudflareConversationClient, CloudflareDurableRuntime, CloudflareDurableRuntimeConfig, CloudflareDurableRuntimeConfigValue, CloudflareDurableRuntimeInitializationError, CloudflareDurableRuntimeOptions, CloudflareDurableRuntimeServices, CloudflarePlatformConfigError, CodeModeHostEntrypoint, CodeModeHostStub, ConversationClientError, ConversationMaintenance, ConversationObjectClass, ConversationObjectIdentity, ConversationObjectInstance, ConversationObjectNamespace, ConversationObjectOptions, ConversationObjectPorts, ConversationObjectRpc, DEFAULT_MAX_DATABASE_BYTES, DurableAlarmError, DurableAlarmService, DurableObjectContext, DynamicWorkerCodeExecutorOptions, ExplainedRecovery, HostFailed, HostFailure, HostProtocolError, HostResponse, MaintenancePassFailure, MaintenancePassReport, ObligationsScanned, ObservePageRequest, ObservedPage, RetryExecuted, SettlementReached, SubmitRequest, SubmitSucceeded, UnknownResolutionRecorded, VerifiedIntegrity, boundHostDiagnostic, cloudflareWakeSchedulerLayer, conversationNamespaceFromEnv, conversationNamespaceLayer, conversationPortTransportLayer, decodeAbortCommand, decodeAdminExplainRequest, decodeAdminResponse, decodeAdminVerifyRequest, decodeApprovalDecisionCommand, decodeHostResponse, decodeObligationThresholds, decodeObservePageRequest, decodeReceipt, decodeRetryCommand, decodeSubmitRequest, decodeUnknownResolutionCommand, dynamicWorkerCodeExecutorLayer, dynamicWorkerImplementation, encodeAbortCommand, encodeAdminResponse, encodeApprovalDecisionCommand, encodeHostResponse, encodeObservePageRequest, encodeReceipt, encodeSubmitRequest, encodeUnknownResolutionCommand, makeConversationObjectClass };
 //# sourceMappingURL=index.d.mts.map