@theway-ai/sdk 0.1.9

package/dist/generated/session.d.ts

@@ -0,0 +1,854 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientReadableStream, type ClientUnaryCall, type handleServerStreamingCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { CommandResult, Empty } from "./commands.js";
+import { ExtensionSnapshot } from "./extensions.js";
+import { CollapsedSessionNode, DagRunSnapshot, SessionGraphNode, SubagentJobSnapshot } from "./graph_engine.js";
+export declare const protobufPackage = "theway.grpc.v1";
+/** Thinking levels supported by the runtime. */
+export declare enum ThinkingLevel {
+    THINKING_LEVEL_UNSPECIFIED = 0,
+    THINKING_LEVEL_OFF = 1,
+    THINKING_LEVEL_MINIMAL = 2,
+    THINKING_LEVEL_LOW = 3,
+    THINKING_LEVEL_MEDIUM = 4,
+    THINKING_LEVEL_HIGH = 5,
+    THINKING_LEVEL_XHIGH = 6,
+    UNRECOGNIZED = -1
+}
+export declare function thinkingLevelFromJSON(object: any): ThinkingLevel;
+export declare function thinkingLevelToJSON(object: ThinkingLevel): string;
+/** Incremental transcript patch: appends/replacements since a consumer cursor. */
+export interface FeedBlockPatch {
+    /**
+     * index == consumer length appends; index < length replaces; index > length
+     * is a gap and requires a full snapshot resync.
+     */
+    index: string;
+    block?: FeedBlock | undefined;
+}
+/** Token usage for the current/last turn, plus the model's context window size. */
+export interface ContextUsage {
+    cachedTokens: string;
+    newTokens: string;
+    totalInputTokens: string;
+    outputTokens: string;
+    cacheWriteTokens: string;
+    providerCacheHitRate?: number | undefined;
+    prefixCacheHitRate?: number | undefined;
+    prefixHitTokens?: string | undefined;
+    contextWindow: number;
+}
+export interface ProviderGroup {
+    provider: string;
+    hasCredential: boolean;
+    models: ModelEntry[];
+}
+export interface ModelEntry {
+    id: string;
+    name: string;
+}
+export interface TriggerPollStatus {
+    checkedAt: string;
+    traceId: string;
+    sourceLabel: string;
+    eventLabel: string;
+    summary: string;
+}
+export interface GoalSnapshot {
+    condition: string;
+    status: string;
+    iterations: number;
+    lastReason?: string | undefined;
+}
+export interface ControlPlanePromptSnapshot {
+    toolName: string;
+    label: string;
+    reason: string;
+    argsHash: string;
+    payload: string;
+}
+export interface SidebarSnapshot {
+    inboxNew: number;
+    skills?: SkillsSnapshot | undefined;
+    triggers?: TriggersSnapshot | undefined;
+    cron?: CronSnapshot | undefined;
+    mcp?: McpSnapshot | undefined;
+    tools?: ToolsSnapshot | undefined;
+    hooks: string[];
+    runtime: string[];
+    /**
+     * Slash-prefixed file-command names (claude-code format, issue #37):
+     * discovered from .agents/commands + .claude/commands.
+     */
+    commands: string[];
+    /**
+     * Daemon runtime revision, bumped by the `reload` agent tool; clients
+     * watch it to re-read local resources (e.g. ~/.theway/theme.toml).
+     */
+    runtimeRevision: string;
+}
+export interface SkillsSnapshot {
+    total: number;
+    enabled: number;
+    disabled: number;
+    builtin: number;
+    user: number;
+    project: number;
+    items: SkillSnapshot[];
+}
+export interface SkillSnapshot {
+    name: string;
+    source: string;
+    filePath: string;
+    enabled: boolean;
+}
+export interface TriggersSnapshot {
+    total: number;
+    enabled: number;
+    disabled: number;
+    rules: TriggerRuleSnapshot[];
+}
+export interface TriggerRuleSnapshot {
+    id: string;
+    fullId: string;
+    enabled: boolean;
+    mode: string;
+    condition: string;
+    action: string;
+}
+export interface CronSnapshot {
+    total: number;
+    enabled: number;
+    disabled: number;
+    jobs: CronJobSnapshot[];
+}
+export interface CronJobSnapshot {
+    id: string;
+    enabled: boolean;
+    schedule: string;
+    action: string;
+    skippedOverlapCount: string;
+    lastError?: string | undefined;
+}
+export interface McpSnapshot {
+    servers: number;
+    tools: number;
+    notificationHooks: number;
+    serverNames: string[];
+    toolNames: string[];
+}
+export interface ToolsSnapshot {
+    total: number;
+    names: string[];
+}
+/**
+ * One renderable feed entry. oneof mirrors the serde tagged enum WireFeedBlock;
+ * JSON channels keep serde shape until the protojson migration.
+ */
+export interface FeedBlock {
+    kind?: {
+        $case: "user";
+        user: UserBlock;
+    } | {
+        $case: "assistant";
+        assistant: AssistantBlock;
+    } | {
+        $case: "thinking";
+        thinking: ThinkingBlock;
+    } | {
+        $case: "toolResult";
+        toolResult: ToolResultBlock;
+    } | {
+        $case: "plain";
+        plain: PlainBlock;
+    } | {
+        $case: "toolCall";
+        toolCall: ToolCallBlock;
+    } | {
+        $case: "error";
+        error: ErrorBlock;
+    } | undefined;
+}
+export interface UserBlock {
+    text: string;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface AssistantBlock {
+    text: string;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface ThinkingBlock {
+    text: string;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface ToolCallBlock {
+    name: string;
+    args: string;
+    /** Optional tool-call metadata (JSON string). */
+    metadata?: string | undefined;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface ErrorBlock {
+    message: string;
+    code?: string | undefined;
+    recoverable: boolean;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface ToolResultBlock {
+    lines: string[];
+    isError: boolean;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface PlainBlock {
+    text: string;
+    /** "output" | "system" | "error" | "note" (serde snake_case variant names) */
+    level: string;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    timestamp?: string | undefined;
+}
+export interface SessionSummary {
+    /**
+     * Canonical session id. New clients should use this field; `session_id`
+     * remains as a deprecated alias for compatibility with older consumers.
+     */
+    id: string;
+    /** Compatibility alias; new clients should read `id`. */
+    sessionId: string;
+    name: string;
+    cwd: string;
+    model: string;
+    /** RFC3339 / ISO-8601 with offset (UTC). */
+    createdAt: string;
+    /** Deprecated epoch milliseconds; use last_activity_at_rfc3339. */
+    lastActivityAt: string;
+    graphCount: number;
+    activeGraphCount: number;
+    busy: boolean;
+    preview?: string | undefined;
+    metadata: {
+        [key: string]: string;
+    };
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    lastActivityAtRfc3339?: string | undefined;
+    /** Pi-style tree prefix (`├─ ` / `└─ ` / `│ `) for fork-lineage display. */
+    treePrefix: string;
+}
+export interface SessionSummary_MetadataEntry {
+    key: string;
+    value: string;
+}
+/** A resolved model reference in a session runtime. */
+export interface ModelRef {
+    provider: string;
+    model: string;
+    baseUrl?: string | undefined;
+}
+/** Static/dynamic session identity and display metadata. */
+export interface SessionInfo {
+    id: string;
+    name: string;
+    cwd: string;
+    /** RFC3339 / ISO-8601 with offset (UTC). */
+    createdAt: string;
+    /** Deprecated epoch milliseconds. */
+    lastActivityAt: string;
+    /** RFC3339 / ISO-8601 with offset (UTC), null when absent. */
+    lastActivityAtRfc3339?: string | undefined;
+    busy: boolean;
+    preview?: string | undefined;
+    metadata: {
+        [key: string]: string;
+    };
+    graphCount: number;
+    activeGraphCount: number;
+    queuedCount: number;
+    sidebar?: SidebarSnapshot | undefined;
+}
+export interface SessionInfo_MetadataEntry {
+    key: string;
+    value: string;
+}
+/** Live runtime configuration and model/context metadata. */
+export interface SessionRuntime {
+    model?: ModelRef | undefined;
+    thinkingLevel: ThinkingLevel;
+    supportedThinkingLevels: ThinkingLevel[];
+    contextUsage?: ContextUsage | undefined;
+    sessionContextUsage?: ContextUsage | undefined;
+    tuiMaxFeedLines?: number | undefined;
+    modelCatalog: ProviderGroup[];
+    latestTriggerPoll?: TriggerPollStatus | undefined;
+    goal?: GoalSnapshot | undefined;
+    controlPlanePrompt?: ControlPlanePromptSnapshot | undefined;
+    extensions?: ExtensionSnapshot | undefined;
+    /**
+     * Full rendered system context for the next request (base prompt + skills +
+     * tool inventory + working directory + memory + lineage). Mirrors the
+     * request/header epoch snapshot in deepseek-harness session logs.
+     */
+    systemContext: string;
+}
+/** Transcript plane of a session snapshot. */
+export interface SessionFeed {
+    blocks: FeedBlock[];
+    lines: string[];
+    blocksBase: string;
+    linesBase: string;
+    blockPatches: FeedBlockPatch[];
+}
+/** Graph-mode state mounted under a session snapshot. */
+export interface SessionGraphState {
+    dags: DagRunSnapshot[];
+    subagents: SubagentJobSnapshot[];
+    nodes: SessionGraphNode[];
+    activeNodeId?: string | undefined;
+}
+/** Session lineage for fork/collapse ancestry. */
+export interface SessionLineage {
+    parentSessionId?: string | undefined;
+    rootSessionId?: string | undefined;
+    ancestorSessionIds: string[];
+    childSessionIds: string[];
+    collapsedFromSessionId?: string | undefined;
+    collapsedIntoSessionId?: string | undefined;
+}
+/**
+ * Full structured session snapshot: the single-version authoritative current
+ * state shape served by GetSnapshot and StreamEvents snapshot frames.
+ */
+export interface SessionSnapshot {
+    sessionId: string;
+    info?: SessionInfo | undefined;
+    runtime?: SessionRuntime | undefined;
+    feed?: SessionFeed | undefined;
+    graphState?: SessionGraphState | undefined;
+    lineage?: SessionLineage | undefined;
+}
+/**
+ * Cursor-paginated read of the session's full message history. Entries are
+ * addressed by storage entry id; `before_entry_id` returns the page of
+ * message blocks strictly older than that entry.
+ */
+export interface ListSessionMessagesRequest {
+    sessionId: string;
+    /** Omitted = newest page of the active branch. */
+    beforeEntryId?: string | undefined;
+    /** Page size; server caps at 500. */
+    limit: number;
+}
+export interface SessionMessagePage {
+    sessionId: string;
+    /** Oldest → newest within the page. */
+    blocks: FeedBlock[];
+    /** Entry id of the oldest message in this page; empty when no older page. */
+    nextBeforeEntryId?: string | undefined;
+    hasMore: boolean;
+    /** Total message count on the active branch. */
+    total: string;
+}
+/** Collapse a session into a graph node, optionally under another session. */
+export interface CollapseSessionRequest {
+    sessionId: string;
+    intoSessionId?: string | undefined;
+    title?: string | undefined;
+    summary?: string | undefined;
+}
+export interface CollapseSessionResponse {
+    sessionId: string;
+    node?: SessionGraphNode | undefined;
+    collapsed?: CollapsedSessionNode | undefined;
+}
+export interface GetSessionGraphNodeRequest {
+    sessionId: string;
+    nodeId: string;
+}
+export interface GetSessionGraphNodeResponse {
+    node?: SessionGraphNode | undefined;
+}
+export interface ListSessionGraphNodeMessagesRequest {
+    sessionId: string;
+    nodeId: string;
+    offset: number;
+    limit: number;
+}
+export interface ListSessionGraphNodeMessagesResponse {
+    blocks: FeedBlock[];
+}
+export interface StreamSessionGraphNodeRequest {
+    sessionId: string;
+    nodeId: string;
+}
+/** Streaming frame for node changes and message appends. */
+export interface SessionGraphNodeStreamFrame {
+    payload?: {
+        $case: "node";
+        node: SessionGraphNode;
+    } | {
+        $case: "block";
+        block: FeedBlock;
+    } | undefined;
+}
+export interface SessionStateRequest {
+    sessionId: string;
+}
+export interface UpdateSessionMetadataRequest {
+    sessionId: string;
+    metadata: {
+        [key: string]: string;
+    };
+}
+export interface UpdateSessionMetadataRequest_MetadataEntry {
+    key: string;
+    value: string;
+}
+export interface ListSessionsResponse {
+    sessions: SessionSummary[];
+    currentSessionId: string;
+}
+export interface CreateSessionRequest {
+    name?: string | undefined;
+    sessionId?: string | undefined;
+    metadata: {
+        [key: string]: string;
+    };
+}
+export interface CreateSessionRequest_MetadataEntry {
+    key: string;
+    value: string;
+}
+export interface CreateSessionResponse {
+    session?: SessionSummary | undefined;
+}
+export interface RenameSessionRequest {
+    sessionId: string;
+    name: string;
+}
+export interface DeleteSessionRequest {
+    sessionId: string;
+}
+export interface DeleteSessionResponse {
+    /** Non-empty = deletion refused, these graphs are still running. */
+    runningRunIds: string[];
+}
+/**
+ * Daemon path context (issue #68): home / base / work_dir are fixed at daemon
+ * startup; skills_dirs reflects the current skill search directories and is
+ * the only mutable part (see SetSkillDirs).
+ */
+export interface PathContext {
+    home: string;
+    base: string;
+    workDir: string;
+    skillsDirs: string[];
+}
+export interface SetSkillDirsRequest {
+    dirs: string[];
+}
+/**
+ * Session activation (issue #26): explicit client key and optional runtime.
+ * Runtime is a singular message so its presence remains observable.
+ */
+export interface SessionRuntimeContext {
+    workDir: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    baseUrl?: string | undefined;
+    thinking?: boolean | undefined;
+}
+export interface ActivateSessionRequest {
+    sessionId?: string | undefined;
+    clientKey: string;
+    name?: string | undefined;
+    runtime?: SessionRuntimeContext | undefined;
+}
+export interface ActivateSessionResponse {
+    session?: SessionSummary | undefined;
+    created: boolean;
+}
+export interface SetCredentialRequest {
+    sessionId: string;
+    provider: string;
+    secret: Uint8Array;
+}
+export interface ClearCredentialRequest {
+    sessionId: string;
+    provider?: string | undefined;
+}
+export declare const FeedBlockPatch: MessageFns<FeedBlockPatch>;
+export declare const ContextUsage: MessageFns<ContextUsage>;
+export declare const ProviderGroup: MessageFns<ProviderGroup>;
+export declare const ModelEntry: MessageFns<ModelEntry>;
+export declare const TriggerPollStatus: MessageFns<TriggerPollStatus>;
+export declare const GoalSnapshot: MessageFns<GoalSnapshot>;
+export declare const ControlPlanePromptSnapshot: MessageFns<ControlPlanePromptSnapshot>;
+export declare const SidebarSnapshot: MessageFns<SidebarSnapshot>;
+export declare const SkillsSnapshot: MessageFns<SkillsSnapshot>;
+export declare const SkillSnapshot: MessageFns<SkillSnapshot>;
+export declare const TriggersSnapshot: MessageFns<TriggersSnapshot>;
+export declare const TriggerRuleSnapshot: MessageFns<TriggerRuleSnapshot>;
+export declare const CronSnapshot: MessageFns<CronSnapshot>;
+export declare const CronJobSnapshot: MessageFns<CronJobSnapshot>;
+export declare const McpSnapshot: MessageFns<McpSnapshot>;
+export declare const ToolsSnapshot: MessageFns<ToolsSnapshot>;
+export declare const FeedBlock: MessageFns<FeedBlock>;
+export declare const UserBlock: MessageFns<UserBlock>;
+export declare const AssistantBlock: MessageFns<AssistantBlock>;
+export declare const ThinkingBlock: MessageFns<ThinkingBlock>;
+export declare const ToolCallBlock: MessageFns<ToolCallBlock>;
+export declare const ErrorBlock: MessageFns<ErrorBlock>;
+export declare const ToolResultBlock: MessageFns<ToolResultBlock>;
+export declare const PlainBlock: MessageFns<PlainBlock>;
+export declare const SessionSummary: MessageFns<SessionSummary>;
+export declare const SessionSummary_MetadataEntry: MessageFns<SessionSummary_MetadataEntry>;
+export declare const ModelRef: MessageFns<ModelRef>;
+export declare const SessionInfo: MessageFns<SessionInfo>;
+export declare const SessionInfo_MetadataEntry: MessageFns<SessionInfo_MetadataEntry>;
+export declare const SessionRuntime: MessageFns<SessionRuntime>;
+export declare const SessionFeed: MessageFns<SessionFeed>;
+export declare const SessionGraphState: MessageFns<SessionGraphState>;
+export declare const SessionLineage: MessageFns<SessionLineage>;
+export declare const SessionSnapshot: MessageFns<SessionSnapshot>;
+export declare const ListSessionMessagesRequest: MessageFns<ListSessionMessagesRequest>;
+export declare const SessionMessagePage: MessageFns<SessionMessagePage>;
+export declare const CollapseSessionRequest: MessageFns<CollapseSessionRequest>;
+export declare const CollapseSessionResponse: MessageFns<CollapseSessionResponse>;
+export declare const GetSessionGraphNodeRequest: MessageFns<GetSessionGraphNodeRequest>;
+export declare const GetSessionGraphNodeResponse: MessageFns<GetSessionGraphNodeResponse>;
+export declare const ListSessionGraphNodeMessagesRequest: MessageFns<ListSessionGraphNodeMessagesRequest>;
+export declare const ListSessionGraphNodeMessagesResponse: MessageFns<ListSessionGraphNodeMessagesResponse>;
+export declare const StreamSessionGraphNodeRequest: MessageFns<StreamSessionGraphNodeRequest>;
+export declare const SessionGraphNodeStreamFrame: MessageFns<SessionGraphNodeStreamFrame>;
+export declare const SessionStateRequest: MessageFns<SessionStateRequest>;
+export declare const UpdateSessionMetadataRequest: MessageFns<UpdateSessionMetadataRequest>;
+export declare const UpdateSessionMetadataRequest_MetadataEntry: MessageFns<UpdateSessionMetadataRequest_MetadataEntry>;
+export declare const ListSessionsResponse: MessageFns<ListSessionsResponse>;
+export declare const CreateSessionRequest: MessageFns<CreateSessionRequest>;
+export declare const CreateSessionRequest_MetadataEntry: MessageFns<CreateSessionRequest_MetadataEntry>;
+export declare const CreateSessionResponse: MessageFns<CreateSessionResponse>;
+export declare const RenameSessionRequest: MessageFns<RenameSessionRequest>;
+export declare const DeleteSessionRequest: MessageFns<DeleteSessionRequest>;
+export declare const DeleteSessionResponse: MessageFns<DeleteSessionResponse>;
+export declare const PathContext: MessageFns<PathContext>;
+export declare const SetSkillDirsRequest: MessageFns<SetSkillDirsRequest>;
+export declare const SessionRuntimeContext: MessageFns<SessionRuntimeContext>;
+export declare const ActivateSessionRequest: MessageFns<ActivateSessionRequest>;
+export declare const ActivateSessionResponse: MessageFns<ActivateSessionResponse>;
+export declare const SetCredentialRequest: MessageFns<SetCredentialRequest>;
+export declare const ClearCredentialRequest: MessageFns<ClearCredentialRequest>;
+export type SessionServiceService = typeof SessionServiceService;
+export declare const SessionServiceService: {
+    /** Full nested session snapshot: the single authoritative current snapshot. */
+    readonly getSnapshot: {
+        readonly path: "/theway.grpc.v1.SessionService/GetSnapshot";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SessionStateRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SessionStateRequest;
+        readonly responseSerialize: (value: SessionSnapshot) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SessionSnapshot;
+    };
+    /** Cursor-paginated full message history on the session's active branch. */
+    readonly listSessionMessages: {
+        readonly path: "/theway.grpc.v1.SessionService/ListSessionMessages";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListSessionMessagesRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListSessionMessagesRequest;
+        readonly responseSerialize: (value: SessionMessagePage) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SessionMessagePage;
+    };
+    /** Collapse a session into a graph node (session-snapshot-collapse). */
+    readonly collapseSession: {
+        readonly path: "/theway.grpc.v1.SessionService/CollapseSession";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CollapseSessionRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CollapseSessionRequest;
+        readonly responseSerialize: (value: CollapseSessionResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CollapseSessionResponse;
+    };
+    readonly getSessionGraphNode: {
+        readonly path: "/theway.grpc.v1.SessionService/GetSessionGraphNode";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GetSessionGraphNodeRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GetSessionGraphNodeRequest;
+        readonly responseSerialize: (value: GetSessionGraphNodeResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetSessionGraphNodeResponse;
+    };
+    readonly listSessionGraphNodeMessages: {
+        readonly path: "/theway.grpc.v1.SessionService/ListSessionGraphNodeMessages";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListSessionGraphNodeMessagesRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListSessionGraphNodeMessagesRequest;
+        readonly responseSerialize: (value: ListSessionGraphNodeMessagesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListSessionGraphNodeMessagesResponse;
+    };
+    readonly streamSessionGraphNode: {
+        readonly path: "/theway.grpc.v1.SessionService/StreamSessionGraphNode";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: StreamSessionGraphNodeRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => StreamSessionGraphNodeRequest;
+        readonly responseSerialize: (value: SessionGraphNodeStreamFrame) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SessionGraphNodeStreamFrame;
+    };
+    /**
+     * Session resources: list (with current marker) / create / rename /
+     * delete. DeleteSession reports the offending run ids when refused because
+     * the session still has running graphs.
+     */
+    readonly listSessions: {
+        readonly path: "/theway.grpc.v1.SessionService/ListSessions";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: ListSessionsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListSessionsResponse;
+    };
+    readonly createSession: {
+        readonly path: "/theway.grpc.v1.SessionService/CreateSession";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateSessionRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateSessionRequest;
+        readonly responseSerialize: (value: CreateSessionResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateSessionResponse;
+    };
+    readonly renameSession: {
+        readonly path: "/theway.grpc.v1.SessionService/RenameSession";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: RenameSessionRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => RenameSessionRequest;
+        readonly responseSerialize: (value: CommandResult) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CommandResult;
+    };
+    readonly deleteSession: {
+        readonly path: "/theway.grpc.v1.SessionService/DeleteSession";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteSessionRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteSessionRequest;
+        readonly responseSerialize: (value: DeleteSessionResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => DeleteSessionResponse;
+    };
+    /** Update arbitrary session metadata KV (opaque to thewayd). */
+    readonly updateSessionMetadata: {
+        readonly path: "/theway.grpc.v1.SessionService/UpdateSessionMetadata";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateSessionMetadataRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateSessionMetadataRequest;
+        readonly responseSerialize: (value: CommandResult) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CommandResult;
+    };
+    /**
+     * Daemon path context (issue #68): home/base/work_dir plus the current
+     * skill search directories.
+     */
+    readonly getPathContext: {
+        readonly path: "/theway.grpc.v1.SessionService/GetPathContext";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: PathContext) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => PathContext;
+    };
+    /**
+     * Replace the extra skill directories dynamically; the command is queued
+     * into the event loop, which applies it authoritatively (hot-reload).
+     * `accepted` = the command was queued.
+     */
+    readonly setSkillDirs: {
+        readonly path: "/theway.grpc.v1.SessionService/SetSkillDirs";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetSkillDirsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetSkillDirsRequest;
+        readonly responseSerialize: (value: CommandResult) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CommandResult;
+    };
+    /**
+     * Session activation and credentials (issue #26): activate/resume a session
+     * and manage provider credentials without echoing secrets.
+     */
+    readonly activateSession: {
+        readonly path: "/theway.grpc.v1.SessionService/ActivateSession";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ActivateSessionRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ActivateSessionRequest;
+        readonly responseSerialize: (value: ActivateSessionResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ActivateSessionResponse;
+    };
+    readonly setCredential: {
+        readonly path: "/theway.grpc.v1.SessionService/SetCredential";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetCredentialRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetCredentialRequest;
+        readonly responseSerialize: (value: CommandResult) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CommandResult;
+    };
+    readonly clearCredential: {
+        readonly path: "/theway.grpc.v1.SessionService/ClearCredential";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ClearCredentialRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ClearCredentialRequest;
+        readonly responseSerialize: (value: CommandResult) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CommandResult;
+    };
+};
+export interface SessionServiceServer extends UntypedServiceImplementation {
+    /** Full nested session snapshot: the single authoritative current snapshot. */
+    getSnapshot: handleUnaryCall<SessionStateRequest, SessionSnapshot>;
+    /** Cursor-paginated full message history on the session's active branch. */
+    listSessionMessages: handleUnaryCall<ListSessionMessagesRequest, SessionMessagePage>;
+    /** Collapse a session into a graph node (session-snapshot-collapse). */
+    collapseSession: handleUnaryCall<CollapseSessionRequest, CollapseSessionResponse>;
+    getSessionGraphNode: handleUnaryCall<GetSessionGraphNodeRequest, GetSessionGraphNodeResponse>;
+    listSessionGraphNodeMessages: handleUnaryCall<ListSessionGraphNodeMessagesRequest, ListSessionGraphNodeMessagesResponse>;
+    streamSessionGraphNode: handleServerStreamingCall<StreamSessionGraphNodeRequest, SessionGraphNodeStreamFrame>;
+    /**
+     * Session resources: list (with current marker) / create / rename /
+     * delete. DeleteSession reports the offending run ids when refused because
+     * the session still has running graphs.
+     */
+    listSessions: handleUnaryCall<Empty, ListSessionsResponse>;
+    createSession: handleUnaryCall<CreateSessionRequest, CreateSessionResponse>;
+    renameSession: handleUnaryCall<RenameSessionRequest, CommandResult>;
+    deleteSession: handleUnaryCall<DeleteSessionRequest, DeleteSessionResponse>;
+    /** Update arbitrary session metadata KV (opaque to thewayd). */
+    updateSessionMetadata: handleUnaryCall<UpdateSessionMetadataRequest, CommandResult>;
+    /**
+     * Daemon path context (issue #68): home/base/work_dir plus the current
+     * skill search directories.
+     */
+    getPathContext: handleUnaryCall<Empty, PathContext>;
+    /**
+     * Replace the extra skill directories dynamically; the command is queued
+     * into the event loop, which applies it authoritatively (hot-reload).
+     * `accepted` = the command was queued.
+     */
+    setSkillDirs: handleUnaryCall<SetSkillDirsRequest, CommandResult>;
+    /**
+     * Session activation and credentials (issue #26): activate/resume a session
+     * and manage provider credentials without echoing secrets.
+     */
+    activateSession: handleUnaryCall<ActivateSessionRequest, ActivateSessionResponse>;
+    setCredential: handleUnaryCall<SetCredentialRequest, CommandResult>;
+    clearCredential: handleUnaryCall<ClearCredentialRequest, CommandResult>;
+}
+export interface SessionServiceClient extends Client {
+    /** Full nested session snapshot: the single authoritative current snapshot. */
+    getSnapshot(request: SessionStateRequest, callback: (error: ServiceError | null, response: SessionSnapshot) => void): ClientUnaryCall;
+    getSnapshot(request: SessionStateRequest, metadata: Metadata, callback: (error: ServiceError | null, response: SessionSnapshot) => void): ClientUnaryCall;
+    getSnapshot(request: SessionStateRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: SessionSnapshot) => void): ClientUnaryCall;
+    /** Cursor-paginated full message history on the session's active branch. */
+    listSessionMessages(request: ListSessionMessagesRequest, callback: (error: ServiceError | null, response: SessionMessagePage) => void): ClientUnaryCall;
+    listSessionMessages(request: ListSessionMessagesRequest, metadata: Metadata, callback: (error: ServiceError | null, response: SessionMessagePage) => void): ClientUnaryCall;
+    listSessionMessages(request: ListSessionMessagesRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: SessionMessagePage) => void): ClientUnaryCall;
+    /** Collapse a session into a graph node (session-snapshot-collapse). */
+    collapseSession(request: CollapseSessionRequest, callback: (error: ServiceError | null, response: CollapseSessionResponse) => void): ClientUnaryCall;
+    collapseSession(request: CollapseSessionRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CollapseSessionResponse) => void): ClientUnaryCall;
+    collapseSession(request: CollapseSessionRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CollapseSessionResponse) => void): ClientUnaryCall;
+    getSessionGraphNode(request: GetSessionGraphNodeRequest, callback: (error: ServiceError | null, response: GetSessionGraphNodeResponse) => void): ClientUnaryCall;
+    getSessionGraphNode(request: GetSessionGraphNodeRequest, metadata: Metadata, callback: (error: ServiceError | null, response: GetSessionGraphNodeResponse) => void): ClientUnaryCall;
+    getSessionGraphNode(request: GetSessionGraphNodeRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetSessionGraphNodeResponse) => void): ClientUnaryCall;
+    listSessionGraphNodeMessages(request: ListSessionGraphNodeMessagesRequest, callback: (error: ServiceError | null, response: ListSessionGraphNodeMessagesResponse) => void): ClientUnaryCall;
+    listSessionGraphNodeMessages(request: ListSessionGraphNodeMessagesRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListSessionGraphNodeMessagesResponse) => void): ClientUnaryCall;
+    listSessionGraphNodeMessages(request: ListSessionGraphNodeMessagesRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListSessionGraphNodeMessagesResponse) => void): ClientUnaryCall;
+    streamSessionGraphNode(request: StreamSessionGraphNodeRequest, options?: Partial<CallOptions>): ClientReadableStream<SessionGraphNodeStreamFrame>;
+    streamSessionGraphNode(request: StreamSessionGraphNodeRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<SessionGraphNodeStreamFrame>;
+    /**
+     * Session resources: list (with current marker) / create / rename /
+     * delete. DeleteSession reports the offending run ids when refused because
+     * the session still has running graphs.
+     */
+    listSessions(request: Empty, callback: (error: ServiceError | null, response: ListSessionsResponse) => void): ClientUnaryCall;
+    listSessions(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: ListSessionsResponse) => void): ClientUnaryCall;
+    listSessions(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListSessionsResponse) => void): ClientUnaryCall;
+    createSession(request: CreateSessionRequest, callback: (error: ServiceError | null, response: CreateSessionResponse) => void): ClientUnaryCall;
+    createSession(request: CreateSessionRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateSessionResponse) => void): ClientUnaryCall;
+    createSession(request: CreateSessionRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateSessionResponse) => void): ClientUnaryCall;
+    renameSession(request: RenameSessionRequest, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    renameSession(request: RenameSessionRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    renameSession(request: RenameSessionRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    deleteSession(request: DeleteSessionRequest, callback: (error: ServiceError | null, response: DeleteSessionResponse) => void): ClientUnaryCall;
+    deleteSession(request: DeleteSessionRequest, metadata: Metadata, callback: (error: ServiceError | null, response: DeleteSessionResponse) => void): ClientUnaryCall;
+    deleteSession(request: DeleteSessionRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: DeleteSessionResponse) => void): ClientUnaryCall;
+    /** Update arbitrary session metadata KV (opaque to thewayd). */
+    updateSessionMetadata(request: UpdateSessionMetadataRequest, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    updateSessionMetadata(request: UpdateSessionMetadataRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    updateSessionMetadata(request: UpdateSessionMetadataRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    /**
+     * Daemon path context (issue #68): home/base/work_dir plus the current
+     * skill search directories.
+     */
+    getPathContext(request: Empty, callback: (error: ServiceError | null, response: PathContext) => void): ClientUnaryCall;
+    getPathContext(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: PathContext) => void): ClientUnaryCall;
+    getPathContext(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: PathContext) => void): ClientUnaryCall;
+    /**
+     * Replace the extra skill directories dynamically; the command is queued
+     * into the event loop, which applies it authoritatively (hot-reload).
+     * `accepted` = the command was queued.
+     */
+    setSkillDirs(request: SetSkillDirsRequest, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    setSkillDirs(request: SetSkillDirsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    setSkillDirs(request: SetSkillDirsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    /**
+     * Session activation and credentials (issue #26): activate/resume a session
+     * and manage provider credentials without echoing secrets.
+     */
+    activateSession(request: ActivateSessionRequest, callback: (error: ServiceError | null, response: ActivateSessionResponse) => void): ClientUnaryCall;
+    activateSession(request: ActivateSessionRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ActivateSessionResponse) => void): ClientUnaryCall;
+    activateSession(request: ActivateSessionRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ActivateSessionResponse) => void): ClientUnaryCall;
+    setCredential(request: SetCredentialRequest, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    setCredential(request: SetCredentialRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    setCredential(request: SetCredentialRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    clearCredential(request: ClearCredentialRequest, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    clearCredential(request: ClearCredentialRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+    clearCredential(request: ClearCredentialRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CommandResult) => void): ClientUnaryCall;
+}
+export declare const SessionServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): SessionServiceClient;
+    service: typeof SessionServiceService;
+    serviceName: string;
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    $case: string;
+} ? {
+    [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
+} & {
+    $case: T["$case"];
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};
+//# sourceMappingURL=session.d.ts.map