@cline/shared 0.0.77 → 0.0.79-nightly.1787712192

package/dist/agent.d.ts

@@ -342,6 +342,12 @@ export interface AgentRuntimeConfig {
      * This is intentionally separate from the host-owned session id.
      */
     distinctId?: string;
+    /** Calling client surface, for example `cline-vscode` or `cline-sdk`. */
+    clientName?: string;
+    /** Calling client version, such as the VS Code extension version. */
+    clientVersion?: string;
+    /** Version of the Cline Core SDK executing the runtime. */
+    clineCoreVersion?: string;
     /**
      * Core/hub runtime session identifier.
      *

package/dist/agents/types.d.ts

@@ -673,6 +673,8 @@ export declare const AgentResultSchema: z.ZodObject<{
  * Configuration for creating an Agent
  */
 export interface AgentConfig {
+    /** Stable end-user identity used for provider and observability metadata. */
+    distinctId?: string;
     /**
      * Core/hub runtime session identifier.
      *
@@ -854,6 +856,7 @@ export interface AgentConfig {
     abortSignal?: AbortSignal;
 }
 export declare const AgentConfigSchema: z.ZodObject<{
+    distinctId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodString>;
     providerId: z.ZodString;
     modelId: z.ZodString;

package/dist/db/sqlite-db.d.ts

@@ -1,6 +1,7 @@
 export type SqliteStatement = {
     run: (...params: unknown[]) => {
         changes?: number;
+        lastInsertRowid?: number | bigint;
     };
     get: (...params: unknown[]) => Record<string, unknown> | null;
     all: (...params: unknown[]) => Record<string, unknown>[];

package/dist/hub.d.ts

@@ -7,7 +7,7 @@ export type HubProtocolVersion = "v1";
 export declare const CURRENT_HUB_PROTOCOL_VERSION: HubProtocolVersion;
 export declare const MIN_CLIENT_HUB_PROTOCOL_VERSION: HubProtocolVersion;
 export declare const MAX_CLIENT_HUB_PROTOCOL_VERSION: HubProtocolVersion;
-export type HubCapabilityName = "client.register" | "client.list" | "session.create" | "session.list" | "session.get" | "session.run" | "session.abort" | "schedule.create" | "schedule.list" | "task.create" | "task.list" | "task.get" | "task.update" | "task.approve" | "task.cancel" | "task.run" | "task.automation.get" | "task.automation.set" | "settings.get" | "settings.set" | "connector.start" | "connector.stop" | "connector.supervised";
+export type HubCapabilityName = "client.register" | "client.list" | "session.create" | "session.list" | "session.get" | "session.run" | "session.abort" | "schedule.create" | "schedule.list" | "task.create" | "task.list" | "task.get" | "task.update" | "task.approve" | "task.cancel" | "task.run" | "task.automation.get" | "task.automation.set" | "settings.get" | "settings.set" | "connector.start" | "connector.stop" | "connector.supervised" | "run.enqueue" | "run.list" | "hub.drain" | "hub.status" | "stream.replay";
 export declare const HUB_CAPABILITIES: readonly HubCapabilityName[];
 export interface HubProtocolMetadata {
     protocolVersion: string;
@@ -333,7 +333,7 @@ export interface HubCommandOutputMap {
 export type HubTypedCommandName = keyof HubCommandInputMap & HubCommandName;
 export type HubCommandInput<TCommand extends HubTypedCommandName> = HubCommandInputMap[TCommand];
 export type HubCommandOutput<TCommand extends HubTypedCommandName> = HubCommandOutputMap[TCommand];
-export type HubCommandName = "client.register" | "client.update" | "client.unregister" | "client.list" | "cline.account.get_current" | "prompt_commands.list" | "prompt_commands.execute" | "mention_files.search" | "catalog.list" | "session.list" | "session.create" | "session.attach" | "session.detach" | "session.get" | "session.messages" | "session.restore" | "session.delete" | "session.update" | "session.update_connection" | "session.compaction.get" | "session.compaction.update" | "session.pending_prompts" | "session.update_pending_prompt" | "session.remove_pending_prompt" | "session.fork" | "session.hook" | "run.start" | "session.send_input" | "run.abort" | "run.proceed_while_running" | "approval.request" | "approval.respond" | "capability.request" | "capability.progress" | "capability.respond" | "peer.register" | "peer.list_sessions" | "peer.attach_session" | "peer.detach_session" | "peer.proxy_command" | "schedule.create" | "schedule.list" | "schedule.get" | "schedule.update" | "schedule.delete" | "schedule.enable" | "schedule.disable" | "schedule.trigger" | "schedule.list_executions" | "schedule.stats" | "schedule.active" | "schedule.upcoming" | "task.create" | "task.list" | "task.get" | "task.update" | "task.approve" | "task.cancel" | "task.run" | "task.automation.get" | "task.automation.set" | "settings.list" | "settings.get" | "settings.patch" | "settings.toggle" | "connector.channels" | "connector.configure" | "connector.delete_config" | "connector.start" | "connector.stop" | "connector.supervised" | "cron.event.ingest" | "cron.event.list" | "cron.event.get" | "ui.notify" | "ui.show_window";
+export type HubCommandName = "client.register" | "client.update" | "client.unregister" | "client.list" | "cline.account.get_current" | "prompt_commands.list" | "prompt_commands.execute" | "mention_files.search" | "catalog.list" | "session.list" | "session.create" | "session.attach" | "session.detach" | "session.get" | "session.messages" | "session.restore" | "session.delete" | "session.update" | "session.update_connection" | "session.compaction.get" | "session.compaction.update" | "session.pending_prompts" | "session.update_pending_prompt" | "session.remove_pending_prompt" | "session.fork" | "session.hook" | "run.start" | "session.send_input" | "run.enqueue" | "run.list" | "run.abort" | "run.proceed_while_running" | "hub.drain" | "hub.status" | "approval.request" | "approval.respond" | "capability.request" | "capability.progress" | "capability.respond" | "peer.register" | "peer.list_sessions" | "peer.attach_session" | "peer.detach_session" | "peer.proxy_command" | "schedule.create" | "schedule.list" | "schedule.get" | "schedule.update" | "schedule.delete" | "schedule.enable" | "schedule.disable" | "schedule.trigger" | "schedule.list_executions" | "schedule.stats" | "schedule.active" | "schedule.upcoming" | "task.create" | "task.list" | "task.get" | "task.update" | "task.approve" | "task.cancel" | "task.run" | "task.automation.get" | "task.automation.set" | "settings.list" | "settings.get" | "settings.patch" | "settings.toggle" | "connector.channels" | "connector.configure" | "connector.delete_config" | "connector.start" | "connector.stop" | "connector.supervised" | "cron.event.ingest" | "cron.event.list" | "cron.event.get" | "ui.notify" | "ui.show_window";
 export declare const HUB_DEFAULT_COMMAND_TIMEOUT_MS = 30000;
 export declare const HUB_COMMAND_SLOW_LOG_MS = 5000;
 export declare function getDefaultHubCommandTimeoutMs(command: HubCommandName): number | null;
@@ -358,11 +358,18 @@ export interface HubReplyEnvelope {
         details?: Record<string, unknown>;
     };
 }
-export type HubEventName = "hub.client.registered" | "hub.client.disconnected" | "session.created" | "session.updated" | "session.attached" | "session.detached" | "session.forked" | "session.pending_prompts" | "session.pending_prompt_submitted" | "run.started" | "run.heartbeat" | "run.aborted" | "run.completed" | "run.failed" | "iteration.started" | "iteration.finished" | "assistant.delta" | "assistant.media" | "assistant.finished" | "session.notice" | "reasoning.delta" | "reasoning.finished" | "agent.done" | "usage.updated" | "tool.started" | "tool.updated" | "tool.finished" | "approval.requested" | "approval.resolved" | "capability.requested" | "capability.resolved" | "team.progress" | "artifact.created" | "diff.created" | "spoke.started" | "spoke.failed" | "spoke.stopped" | "peer.registered" | "peer.session_attached" | "peer.session_detached" | "schedule.created" | "schedule.updated" | "schedule.deleted" | "schedule.triggered" | "schedule.execution_completed" | "schedule.execution_failed" | "task.created" | "task.updated" | "task.deleted" | "task.run.started" | "task.run.completed" | "task.run.failed" | "task.automation.updated" | "settings.changed" | "ui.notify" | "ui.show_window" | "hub.client.updated";
+export type HubEventName = "hub.client.registered" | "hub.client.disconnected" | "session.created" | "session.updated" | "session.attached" | "session.detached" | "session.forked" | "session.pending_prompts" | "session.pending_prompt_submitted" | "run.started" | "run.heartbeat" | "run.aborted" | "run.completed" | "run.failed" | "run.enqueued" | "run.interrupted" | "hub.drain_changed" | "iteration.started" | "iteration.finished" | "assistant.delta" | "assistant.media" | "assistant.finished" | "session.notice" | "reasoning.delta" | "reasoning.finished" | "agent.done" | "usage.updated" | "tool.started" | "tool.updated" | "tool.finished" | "approval.requested" | "approval.resolved" | "capability.requested" | "capability.resolved" | "team.progress" | "artifact.created" | "diff.created" | "spoke.started" | "spoke.failed" | "spoke.stopped" | "peer.registered" | "peer.session_attached" | "peer.session_detached" | "schedule.created" | "schedule.updated" | "schedule.deleted" | "schedule.triggered" | "schedule.execution_completed" | "schedule.execution_failed" | "task.created" | "task.updated" | "task.deleted" | "task.run.started" | "task.run.completed" | "task.run.failed" | "task.automation.updated" | "settings.changed" | "ui.notify" | "ui.show_window" | "hub.client.updated";
 export interface HubEventEnvelope {
     version: HubProtocolVersion;
     event: HubEventName;
     eventId?: string;
+    /**
+     * Monotonic global sequence assigned by the Hub's durable event log.
+     * A client can resume delivery exactly where it left off by passing the
+     * last observed sequence as `sinceSequence` on `stream.subscribe`.
+     * Absent on hubs (or events) without a durable log.
+     */
+    sequence?: number;
     sessionId?: string;
     clientId?: string;
     sourceHubId?: string;
@@ -545,6 +552,12 @@ export type HubTransportFrame = {
     kind: "stream.subscribe";
     clientId: string;
     sessionId?: string;
+    /**
+     * Replay cursor: when set, the Hub first replays durable events with
+     * `sequence > sinceSequence` (scoped to `sessionId` when given), then
+     * live-tails. Omit for live-only delivery (legacy behavior).
+     */
+    sinceSequence?: number;
 } | {
     kind: "stream.unsubscribe";
     clientId: string;