@theway-ai/sdk 1.3.0 → 2.1.0

package/proto/graph_engine.proto

@@ -77,6 +77,7 @@ message GetNodeOutputRequest {
   string run_id = 1;
   string node_id = 2;
   uint64 offset = 3;
+  string session_id = 4;
 }
 
 message GetNodeOutputResponse {
@@ -99,11 +100,13 @@ enum GraphKind {
 
 message GraphCancelRequest {
   string run_id = 1;
+  string session_id = 2;
 }
 
 message GraphRetryRequest {
   string run_id = 1;
   optional string node_id = 2; // omitted = all failed/cancelled nodes
+  string session_id = 3;
 }
 
 message GraphRetryResponse {
@@ -113,18 +116,21 @@ message GraphRetryResponse {
 message GraphSkipRequest {
   string run_id = 1;
   string node_id = 2;
+  string session_id = 3;
 }
 
 // Turn-level control for a running DAG node's subagent.
 message GraphNodeInterruptRequest {
   string run_id = 1;
   string node_id = 2;
+  string session_id = 3;
 }
 
 message GraphNodeSteerRequest {
   string run_id = 1;
   string node_id = 2;
   string text = 3;
+  string session_id = 4;
 }
 
 message GraphSkipResponse {

package/proto/session.proto

@@ -1,6 +1,6 @@
 // Session domain: the full session state plane (snapshot, sidebar, feed,
 // model catalog, status), session resource messages
-// (list/create/switch/rename/delete), and the SessionService RPC surface.
+// (list/create/rename/delete), and the SessionService RPC surface.
 
 syntax = "proto3";
 package theway.grpc.v1;
@@ -45,6 +45,9 @@ message SessionState {
   // Session-cumulative token usage: total input, cached input, non-cached
   // input, output, and cache write totals for the current session.
   ContextUsage session_context_usage = 21;
+  // Active thinking level ("off" | "minimal" | "low" | "medium" | "high" |
+  // "xhigh"); empty for older daemons.
+  string thinking_level = 22;
 }
 
 message FeedBlockPatch {
@@ -192,35 +195,35 @@ message FeedBlock {
 
 message UserBlock {
   string text = 1;
-  optional string timestamp = 2;
+  optional string timestamp = 2; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
 }
 
 message AssistantBlock {
   string text = 1;
-  optional string timestamp = 2;
+  optional string timestamp = 2; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
 }
 
 message ThinkingBlock {
   string text = 1;
-  optional string timestamp = 2;
+  optional string timestamp = 2; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
 }
 
 message ToolBlock {
   string name = 1;
   string args = 2;
-  optional string timestamp = 3;
+  optional string timestamp = 3; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
 }
 
 message ToolResultBlock {
   repeated string lines = 1;
   bool is_error = 2;
-  optional string timestamp = 3;
+  optional string timestamp = 3; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
 }
 
 message PlainBlock {
   string text = 1;
   string level = 2; // "output" | "system" | "error" | "note" (serde snake_case variant names)
-  optional string timestamp = 3;
+  optional string timestamp = 3; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
 }
 
 message SessionSummary {
@@ -228,12 +231,23 @@ message SessionSummary {
   string name = 2;
   string cwd = 3;
   string model = 4;
-  string created_at = 5;
-  int64 last_activity_at = 6;
+  string created_at = 5; // RFC3339 / ISO-8601 with offset (UTC).
+  int64 last_activity_at = 6; // Deprecated epoch milliseconds; use last_activity_at_rfc3339.
   uint32 graph_count = 7;
   uint32 active_graph_count = 8;
   bool busy = 9;
   optional string preview = 10;
+  map<string, string> metadata = 11;
+  optional string last_activity_at_rfc3339 = 12; // RFC3339 / ISO-8601 with offset (UTC), null when absent.
+}
+
+message SessionStateRequest {
+  string session_id = 1;
+}
+
+message UpdateSessionMetadataRequest {
+  string session_id = 1;
+  map<string, string> metadata = 2;
 }
 
 message ListSessionsResponse {
@@ -243,16 +257,14 @@ message ListSessionsResponse {
 
 message CreateSessionRequest {
   optional string name = 1;
+  optional string session_id = 2;
+  map<string, string> metadata = 3;
 }
 
 message CreateSessionResponse {
   SessionSummary session = 1;
 }
 
-message SwitchSessionRequest {
-  string session_id = 1;
-}
-
 message RenameSessionRequest {
   string session_id = 1;
   string name = 2;
@@ -316,15 +328,16 @@ message ClearCredentialRequest {
 
 service SessionService {
   // Full structured state (binary protobuf).
-  rpc GetState(Empty) returns (SessionState);
-  // Session resources: list (with current marker) / create / switch / rename /
+  rpc GetState(SessionStateRequest) returns (SessionState);
+  // Session resources: list (with current marker) / create / rename /
   // delete. DeleteSession reports the offending run ids when refused because
   // the session still has running graphs.
   rpc ListSessions(Empty) returns (ListSessionsResponse);
   rpc CreateSession(CreateSessionRequest) returns (CreateSessionResponse);
-  rpc SwitchSession(SwitchSessionRequest) returns (CommandResult);
   rpc RenameSession(RenameSessionRequest) returns (CommandResult);
   rpc DeleteSession(DeleteSessionRequest) returns (DeleteSessionResponse);
+  // Update arbitrary session metadata KV (opaque to thewayd).
+  rpc UpdateSessionMetadata(UpdateSessionMetadataRequest) returns (CommandResult);
   // Daemon path context (issue #68): home/base/work_dir plus the current
   // skill search directories.
   rpc GetPathContext(Empty) returns (PathContext);

package/proto/settings.proto

@@ -54,6 +54,12 @@ message DaemonConfig {
   // trigger rules, cron jobs) over RPC instead of local storage directly.
   optional string storage_service_addr = 10;
 
+  // ── thinking level (persisted last-choice default) ──
+  // Full thinking level string ("off" | "minimal" | "low" | "medium" |
+  // "high" | "xhigh"). Finer-grained than the `thinking` toggle; the toggle
+  // stays for legacy compatibility.
+  optional string thinking_level = 12;
+
   // Field names to clear before applying values present in this message.
   // Unknown names make the daemon reject the patch without partial changes.
   repeated string clear_fields = 11;

package/proto/state.proto

@@ -114,6 +114,7 @@ service StorageService {
   rpc CreateSession(CreateSessionRequest) returns (CreateSessionResponse);
   rpc RenameSession(RenameSessionRequest) returns (CommandResult);
   rpc DeleteSession(DeleteSessionRequest) returns (DeleteSessionResponse);
+  rpc UpdateSessionMetadata(UpdateSessionMetadataRequest) returns (CommandResult);
 
   // DAG run persistence.
   rpc SaveDagRun(SaveDagRunRequest) returns (SaveDagRunResponse);