@moltzap/client 2026.812.0 → 2026.902.0

package/dist/service.d.ts

@@ -1,228 +0,0 @@
-import { type AgentId } from "@moltzap/protocol/identity";
-import type { HelloOk } from "@moltzap/protocol/network";
-import type { AnyAgentCallableRpcDefinition, AnyNotificationDefinition, agentCallableGroup } from "@moltzap/protocol/socket/catalog";
-import type { ClientDefinitionPayload, ClientDefinitionSuccess } from "@moltzap/protocol/socket";
-import { type ConversationId } from "@moltzap/protocol/conversation";
-import { type Message } from "@moltzap/protocol/message";
-import { NotConnectedError, type RpcTimeoutError, type NotificationDelivery, type PayloadForTag, type SuccessForTag } from "@moltzap/protocol/rpc";
-import type { RpcGroup, Rpc } from "@effect/rpc";
-import { Effect } from "effect";
-import { type RpcCallOptions } from "./agent-client.js";
-import { type MoltzapServiceConfig, type ServiceConfigError } from "./config.js";
-import { type ConversationMeta, type CrossConversationEntry, type CrossConvMessage } from "./presentation/index.js";
-/** Presentation value types exposed alongside MoltZapService. */
-export type { ConversationMeta, CrossConversationEntry, CrossConvMessage, } from "./presentation/index.js";
-/** The agent group's member `Rpc`s — the tag-keyed surface the service drives. */
-type AgentCallableRpcs = RpcGroup.Rpcs<typeof agentCallableGroup>;
-/** The branded wire tags the service may originate. */
-type AgentCallableTag = AgentCallableRpcs["_tag"];
-/**
- * Errors that can surface from the Effect-based service API: any tagged error
- * an agent-callable method declares (recovered from the group's per-method
- * error unions) plus the transport errors. A method that fans several calls
- * surfaces this broad union; a single-method call narrows to that method's
- * errors at the `call` site.
- */
-export type ServiceRpcError = Rpc.Error<AgentCallableRpcs> | RpcTimeoutError | NotConnectedError;
-/** Configures context. */
-export interface ContextOptions {
-    type: "cross-conversation";
-    maxConversations?: number;
-    maxMessagesPerConv?: number;
-}
-/**
- * Escape `&lt;`, `>`, `&amp;` so sender content can't escape a `&lt;system-reminder>` block.
- * @param s Value supplied to the operation.
- * @returns The sanitize for system reminder result.
- */
-export declare function sanitizeForSystemReminder(s: string): string;
-type ServiceOptions = MoltzapServiceConfig;
-type NotificationHandler<T> = (data: T) => void;
-type ClientNotificationDelivery = NotificationDelivery<AnyNotificationDefinition>;
-interface ServiceHandlerPayloads {
-    readonly message: {
-        readonly message: Message;
-    };
-    /**
-     * The "raw notification" surface receives the descriptor-tagged delivery
-     * emitted after the native reverse RPC handler has Schema-decoded params.
-     * Subscribers that want a specific payload narrow the delivery themselves
-     * with `isNotificationDeliveryFor`.
-     */
-    readonly rawNotification: ClientNotificationDelivery;
-    readonly disconnect: undefined;
-}
-type ServiceHandlerName = keyof ServiceHandlerPayloads;
-/**
- * Stateful MoltZap client that manages connection, conversation tracking,
- * agent name resolution, and cross-conversation context generation.
- *
- * API contract: **every fallible method returns `Effect`.** No `*Async`
- * Promise siblings — async/await consumers run the Effect at the edge
- * with `Effect.runPromise`. Keep this class Effect-only so downstream
- * callers compose failures and cancellation explicitly.
- */
-export declare class MoltZapService {
-    private client;
-    private connectedValue;
-    private shutdownCompletion;
-    /**
-     * Service-owned scope. Opened in `connect()`, owns the
-     * `subscribeAll → Stream.runForEach` fan-out fiber. Closed in `close()` so
-     * the fiber terminates with the service.
-     *
-     * Held off the public `connect()` signature so callers do not need to
-     * thread a `Scope` requirement.
-     */
-    private serviceScope;
-    private readonly presentationState;
-    /**
-     * The branded outer and inner keys keep conversation and message ids from
-     * crossing accidentally while each conversation owns its eviction window.
-     */
-    private readonly seenMessageIds;
-    private readonly handlers;
-    private readonly ownAgentIdValue;
-    private readonly opts;
-    protected constructor(opts: ServiceOptions);
-    static fromConfig(config: MoltzapServiceConfig): MoltZapService;
-    static make(profileName: string): Effect.Effect<MoltZapService, ServiceConfigError>;
-    get connected(): boolean;
-    get ownAgentId(): AgentId | undefined;
-    /**
-     * Effect-native: compose via `yield*` or bridge at the edge via `Effect.runPromise`.
-     * @returns The client result.
-     */
-    connect(): Effect.Effect<HelloOk, ServiceRpcError>;
-    /**
-     * Returns a lazy teardown effect that resolves after the service's owned
-     * transports and notification scope close.
-     *
-     * @returns Completion of the service-owned cleanup.
-     * @internal
-     */
-    shutdown(): Effect.Effect<void>;
-    private beginShutdown;
-    /**
-     * Starts service teardown for callers that use the legacy synchronous
-     * lifecycle boundary.
-     */
-    close(): void;
-    getConversation(convId: string): ConversationMeta | undefined;
-    getConversations(): ConversationMeta[];
-    getHistory(convId: string, limit?: number): Message[];
-    getAgentName(agentId: string): string | undefined;
-    /**
-     * Cache-first agent-name lookup. Never fails: falls back to `agentId`
-     * when the RPC errors or the server has no record. The error path logs
-     * so ops can see repeated lookup failures; the empty-response path is
-     * silent (a cold agent is an expected transient state).
-     * @param agentId Identifier of the agent targeted by the operation.
-     * @returns The decoded d agent id.
-     */
-    resolveAgentName(agentId: string): Effect.Effect<string>;
-    /**
-     * Send a text message into a conversation.
-     *
-     * ```mermaid
-     * sequenceDiagram
-     *   participant caller
-     *   participant svc as MoltZapService
-     *   participant ws as MoltZapAgentClient
-     *   participant server
-     *
-     *   caller->>svc: send(convId, text, opts?)
-     *   svc->>ws: sendRpc(MessagesSend, params)
-     *   Note over ws: stateRef None → fail NotConnectedError; otherwise allocate request id, encode frame
-     *   ws->>server: {jsonrpc, method agent/message/send, id, params}
-     *   Note over ws: Deferred raced against 30s timeout
-     *   server-->>ws: {result, id} or {error, id}
-     *   Note over ws: reader fiber decodes, resolves the Deferred
-     *   ws-->>svc: result or RpcServerError or RpcTimeoutError
-     *   svc-->>caller: Effect.void
-     * ```
-     *
-     * @param conversationId Value supplied to the operation.
-     * @param text Text to process.
-     * @returns The send result.
-     */
-    send(conversationId: ConversationId, text: string): Effect.Effect<void, ServiceRpcError>;
-    private cacheAgentNames;
-    private agentListParams;
-    private cacheVisibleAgentNamesForIds;
-    private findVisibleAgentByName;
-    /**
-     * Generate a system reminder with updates from other conversations.
-     * Each conversation has its own view of what's "new" — markers are tracked
-     * per viewing conversation and advanced after notification.
-     * @param currentConvId Value supplied to the operation.
-     * @param opts Value supplied to the operation.
-     * @returns The context options result.
-     */
-    getContext(currentConvId: string, opts?: ContextOptions): string | null;
-    /**
-     * Return recent activity in other conversations without advancing any state.
-     * Call `commit()` on the result to mark the returned messages as seen so
-     * subsequent peeks return only what's new. A caller that reads without
-     * committing can re-peek idempotently.
-     * @param currentConvId Value supplied to the operation.
-     * @param opts Value supplied to the operation.
-     * @param opts.maxConversations Value supplied to the operation.
-     * @param opts.maxMessagesPerConv Value supplied to the operation.
-     * @returns The max convs result.
-     */
-    peekContextEntries(currentConvId: string, opts?: {
-        maxConversations?: number;
-        maxMessagesPerConv?: number;
-    }): {
-        entries: CrossConversationEntry[];
-        commit: () => void;
-    };
-    /**
-     * Return all new messages from all other conversations as full transcripts,
-     * sorted chronologically. Uses the same lastNotified markers as
-     * peekContextEntries. Call commit() to advance markers.
-     * @param currentConvId Value supplied to the operation.
-     * @returns The all messages result.
-     */
-    peekFullMessages(currentConvId: string): {
-        messages: CrossConvMessage[];
-        commit: () => void;
-    };
-    on<K extends ServiceHandlerName>(notification: K, handler: NotificationHandler<ServiceHandlerPayloads[K]>): void;
-    /**
-     * Outbound RPC, typed per method — delegates to the agent client's typed
-     * `call`. `call("agent/identity/agents/list", payload)` recovers the result and that
-     * method's tagged-error union; an app-only method does not typecheck.
-     * @param tag Value supplied to the operation.
-     * @param payload Value supplied to the operation.
-     * @param opts Value supplied to the operation.
-     * @returns The client result.
-     */
-    call<Tag extends AgentCallableTag>(tag: Tag, payload: PayloadForTag<AgentCallableRpcs, Tag>, opts?: RpcCallOptions): Effect.Effect<SuccessForTag<AgentCallableRpcs, Tag>, ServiceRpcError>;
-    callDefinition<D extends AnyAgentCallableRpcDefinition>(definition: D, payload: ClientDefinitionPayload<D>, opts?: RpcCallOptions): Effect.Effect<ClientDefinitionSuccess<D>, ServiceRpcError>;
-    protected handleNotification(notification: ClientNotificationDelivery): void;
-    private recordNotificationTrace;
-    private dispatchTypedNotification;
-    private dispatchMessageNotification;
-    private dispatchConversationNotification;
-    /**
-     * Record `messageId` in the per-conversation dedup window. Returns
-     * `true` when the id is new (caller proceeds), `false` when the id is
-     * a duplicate within the window (caller drops). On a new id, evicts
-     * the oldest entry if the window is full.
-     *
-     * Bound to the live `agent/message/received` notification path: a single
-     * server-side broadcast that surfaces the same id twice (network
-     * replay, dual subscription) is suppressed to one
-     * `on("message", ...)` event. `agent/message/list` returns raw history
-     * unfiltered; consumers that combine both feeds dedup themselves.
-     * @param convId Value supplied to the operation.
-     * @param msgId Value supplied to the operation.
-     * @returns The dedup window result.
-     */
-    private recordMessageIdIfNew;
-    private handleMessageReceivedNotification;
-    private handleConversationCreatedNotification;
-}
-//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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