Merge pull request #53 from posit-dev/feature/more-metadata

Add more metadata

Author: jmcphers

Cargo.lock

@@ -17,6 +17,7 @@ docs/ServerConfiguration.md
 docs/ServerConfigurationLogLevel.md
 docs/ServerStatus.md
 docs/SessionList.md
+docs/SessionMode.md
 docs/StartupError.md
 docs/Status.md
 docs/VarAction.md

crates/kallichore_api/.openapi-generator/FILES

@@ -14,7 +14,7 @@ To see how to make this your own, look here:
 [README]((https://openapi-generator.tech))
 
 - API version: 1.0.0
-- Build date: 2025-09-26T15:23:57.096174-07:00[America/Los_Angeles]
+- Build date: 2025-10-24T10:11:06.911877-07:00[America/Los_Angeles]
 - Generator version: 7.13.0
 
 For more information, please visit [https://posit.co](https://posit.co)
@@ -167,6 +167,7 @@ Method | HTTP request | Description
  - [ServerConfigurationLogLevel](docs/ServerConfigurationLogLevel.md)
  - [ServerStatus](docs/ServerStatus.md)
  - [SessionList](docs/SessionList.md)
+ - [SessionMode](docs/SessionMode.md)
  - [StartupError](docs/StartupError.md)
  - [Status](docs/Status.md)
  - [VarAction](docs/VarAction.md)

crates/kallichore_api/README.md

@@ -469,6 +469,13 @@ components:
       items:
         $ref: '#/components/schemas/varAction'
       type: array
+    sessionMode:
+      description: The mode in which the session is running
+      enum:
+      - console
+      - notebook
+      - background
+      type: string
     varActionType:
       description: The type of action to perform on the environment variable
       enum:
@@ -611,9 +618,14 @@ components:
           items:
             type: string
           type: array
+        session_mode:
+          $ref: '#/components/schemas/sessionMode'
         working_directory:
           description: The working directory in which to start the session.
           type: string
+        notebook_uri:
+          description: "For notebook sessions, the URI of the notebook file"
+          type: string
         env:
           description: A list of environment variable actions to perform
           items:
@@ -644,6 +656,7 @@ components:
       - interrupt_mode
       - language
       - session_id
+      - session_mode
       - username
       - working_directory
       type: object
@@ -699,6 +712,7 @@ components:
         - argv
         - argv
         socket_path: socket_path
+        notebook_uri: notebook_uri
         execution_queue:
           pending:
           - "{}"
@@ -707,6 +721,7 @@ components:
           active: "{}"
         interrupt_mode: signal
         connected: true
+        session_mode: console
         initial_env:
           key: initial_env
         username: username
@@ -748,9 +763,14 @@ components:
           description: An ISO 8601 timestamp of when the session was started
           format: date-time
           type: string
+        session_mode:
+          $ref: '#/components/schemas/sessionMode'
         working_directory:
           description: The session's current working directory
           type: string
+        notebook_uri:
+          description: "For notebook sessions, the URI of the notebook file"
+          type: string
         input_prompt:
           description: The text to use to prompt for input
           type: string
@@ -790,18 +810,21 @@ components:
       - kernel_info
       - language
       - session_id
+      - session_mode
       - started
       - status
       - username
       - working_directory
       type: object
     serverStatus:
       example:
-        process_id: 5
+        process_id: 2
         sessions: 0
         busy_seconds: 5
+        uptime_seconds: 5
         busy: true
         active: 6
+        started: 2000-01-23T04:56:07.000+00:00
         version: version
         idle_seconds: 1
       properties:
@@ -819,19 +842,28 @@ components:
           description: "The number of seconds any session has been busy, or 0 if all\
             \ sessions are idle"
           type: integer
+        uptime_seconds:
+          description: The number of seconds the server has been running
+          type: integer
         version:
           description: The version of the server
           type: string
         process_id:
           description: The server's operating system process identifier
           type: integer
+        started:
+          description: An ISO 8601 timestamp of when the server was started
+          format: date-time
+          type: string
       required:
       - active
       - busy
       - busy_seconds
       - idle_seconds
       - process_id
       - sessions
+      - started
+      - uptime_seconds
       - version
       type: object
     sessionList:
@@ -852,6 +884,7 @@ components:
           - argv
           - argv
           socket_path: socket_path
+          notebook_uri: notebook_uri
           execution_queue:
             pending:
             - "{}"
@@ -860,6 +893,7 @@ components:
             active: "{}"
           interrupt_mode: signal
           connected: true
+          session_mode: console
           initial_env:
             key: initial_env
           username: username
@@ -879,6 +913,7 @@ components:
           - argv
           - argv
           socket_path: socket_path
+          notebook_uri: notebook_uri
           execution_queue:
             pending:
             - "{}"
@@ -887,6 +922,7 @@ components:
             active: "{}"
           interrupt_mode: signal
           connected: true
+          session_mode: console
           initial_env:
             key: initial_env
           username: username

crates/kallichore_api/api/openapi.yaml

@@ -13,7 +13,9 @@ Name | Type | Description | Notes
 **initial_env** | **std::collections::HashMap<String, String>** | The environment variables set when the session was started | [optional] [default to None]
 **connected** | **bool** | Whether the session is connected to a client | 
 **started** | [**chrono::DateTime::<chrono::Utc>**](DateTime.md) | An ISO 8601 timestamp of when the session was started | 
+**session_mode** | [***models::SessionMode**](sessionMode.md) |  | 
 **working_directory** | **String** | The session's current working directory | 
+**notebook_uri** | **String** | For notebook sessions, the URI of the notebook file | [optional] [default to None]
 **input_prompt** | **String** | The text to use to prompt for input | 
 **continuation_prompt** | **String** | The text to use to prompt for input continuations | 
 **execution_queue** | [***models::ExecutionQueue**](execution_queue.md) |  | 

crates/kallichore_api/docs/ActiveSession.md

@@ -10,7 +10,9 @@ Name | Type | Description | Notes
 **input_prompt** | **String** | The text to use to prompt for input | 
 **continuation_prompt** | **String** | The text to use to prompt for input continuations | 
 **argv** | **Vec<String>** | The program and command-line parameters for the session | 
+**session_mode** | [***models::SessionMode**](sessionMode.md) |  | 
 **working_directory** | **String** | The working directory in which to start the session. | 
+**notebook_uri** | **String** | For notebook sessions, the URI of the notebook file | [optional] [default to None]
 **env** | [**Vec<models::VarAction>**](varAction.md) | A list of environment variable actions to perform | 
 **connection_timeout** | **i32** | The number of seconds to wait for a connection to the session's ZeroMQ sockets before timing out | [optional] [default to Some(30)]
 **interrupt_mode** | [***models::InterruptMode**](interrupt_mode.md) |  | 

crates/kallichore_api/docs/NewSession.md

@@ -8,8 +8,10 @@ Name | Type | Description | Notes
 **busy** | **bool** |  | 
 **idle_seconds** | **i32** | The number of seconds all sessions have been idle, or 0 if any session is busy | 
 **busy_seconds** | **i32** | The number of seconds any session has been busy, or 0 if all sessions are idle | 
+**uptime_seconds** | **i32** | The number of seconds the server has been running | 
 **version** | **String** | The version of the server | 
 **process_id** | **i32** | The server's operating system process identifier | 
+**started** | [**chrono::DateTime::<chrono::Utc>**](DateTime.md) | An ISO 8601 timestamp of when the server was started | 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

crates/kallichore_api/docs/ServerStatus.md

@@ -0,0 +1,9 @@
+# SessionMode
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+