@alisio/sdk 0.1.0-alpha.15 → 0.1.0-alpha.16

package/dist/index.d.ts

@@ -1154,9 +1154,21 @@ export type ServerFrame = {
     sessionId?: string;
     reason: "overflow" | "gap" | "server_restart";
 };
-export type ApiErrorCode = "unauthorized" | "forbidden_origin" | "forbidden_host" | "validation_failed" | "not_found" | "unknown_command" | "session_busy" | "session_locked" | "workspace_limit" | "payload_too_large" | "unsupported_media_type" | "path_outside_workspace" | "not_a_git_repo" | "approval_resolved" | "capability_ceiling" | "not_manageable" | "mcp_not_permitted" | "runs_active" | "provider_unavailable" | "protocol_mismatch" | "shutting_down"
+export type ApiErrorCode = "unauthorized" | "forbidden_origin" | "forbidden_host" | "validation_failed" | "not_found" | "unknown_command" | "session_busy" | "session_locked" | "workspace_limit"
+/** A known workspace whose folder was deleted, moved or is no longer accessible (404). */
+ | "workspace_missing" | "payload_too_large" | "unsupported_media_type" | "path_outside_workspace" | "not_a_git_repo" | "approval_resolved" | "capability_ceiling" | "not_manageable" | "mcp_not_permitted" | "runs_active" | "provider_unavailable" | "protocol_mismatch" | "shutting_down"
 /** Too many concurrent event streams (SSE) for this server. */
- | "stream_limit" | "internal";
+ | "stream_limit"
+/** The workspace is archived: unarchive it before starting new sessions (409). */
+ | "workspace_archived"
+/** A native folder dialog is already open on the server machine (409). */
+ | "picker_busy"
+/** No native folder dialog / folder browser on this server (remote bind, no desktop) (503). */
+ | "picker_unavailable"
+/** The server user may not read that directory (403). */
+ | "permission_denied"
+/** The request was cancelled before it finished, e.g. a `/btw` side question (409). */
+ | "cancelled" | "internal";
 /** `GET /api/health` (the only unauthenticated API route). */
 export interface HealthInfo {
     name: "alisio";
@@ -1172,8 +1184,45 @@ export interface HealthInfo {
         automation: boolean;
         /** The server listens on a non-loopback address (`--allow-remote`). */
         remote: boolean;
+        /**
+         * `POST /api/workspaces/pick` can open a native folder dialog on this machine (loopback only,
+         * with a desktop session and a dialog tool). Absent on older servers.
+         */
+        nativePicker?: boolean;
+        /** `GET /api/fs/dirs` lists directory names for the in-app folder browser (loopback only). */
+        folderBrowser?: boolean;
     };
 }
+/** `POST /api/workspaces/pick`: the folder chosen in the native dialog, or a cancellation. */
+export type FolderPickResult = {
+    path: string;
+} | {
+    cancelled: true;
+};
+/** One page of the in-app folder browser (`GET /api/fs/dirs`): subdirectory names only. */
+export interface DirectoryListing {
+    /** Absolute path listed (the server's own separators; `""` for the drive list on Windows). */
+    path: string;
+    /** Parent directory, absent at a filesystem root (and at the drive list). */
+    parent?: string;
+    /** Breadcrumbs from the root to `path`, built by the server (no separator assumptions). */
+    segments: Array<{
+        name: string;
+        path: string;
+    }>;
+    /** Subdirectories (names and absolute paths; never files, never contents). */
+    entries: Array<{
+        name: string;
+        path: string;
+        hidden: boolean;
+    }>;
+    /** The server user's home directory (where browsing starts). */
+    home: string;
+    /** Path separator of the server platform. */
+    separator: "/" | "\\";
+    /** More than the listing cap: the rest is not shown. */
+    truncated?: boolean;
+}
 /** A workspace known to the server (`GET /api/workspaces`). */
 export interface WorkspaceInfo {
     /** Opaque, stable id: a short sha256 of the canonical path. */
@@ -1184,10 +1233,17 @@ export interface WorkspaceInfo {
     pinned: boolean;
     /** An `Application` is open for it in the server right now. */
     open: boolean;
+    /**
+     * The folder is still an accessible directory. A workspace known from old sessions may have been
+     * deleted or moved: its sessions stay readable, but it cannot be opened (`workspace_missing`).
+     */
+    exists: boolean;
     /** Project resources load (trusted from the terminal or by a launch flag). */
     trusted: boolean;
     /** The directory has project resources that are not trusted (shown as "untrusted"). */
     untrustedResources: boolean;
+    /** Archived: hidden from the default list; its sessions stay readable, new ones are refused. */
+    archived: boolean;
     lastOpenedAt?: number;
 }
 /** Permission presets of the web composer (RF-08). */
@@ -1252,6 +1308,27 @@ export interface CommandOutcome {
     effects?: string[];
     duplicate?: boolean;
 }
+/**
+ * One `/btw` side question: a tool-less question about a session answered outside its
+ * conversation (never persisted as messages, events, runs or session usage). Answer of
+ * `POST /api/sessions/:sid/btw`; `GET /api/sessions/:sid/btw` lists them, oldest first.
+ */
+export interface SideQuestionEntry {
+    id: string;
+    question: string;
+    /** Markdown answer. */
+    answer: string;
+    /** Model that answered (the session's model at the time). */
+    model: string;
+    usage: {
+        input: number;
+        output: number;
+    };
+    /** Epoch milliseconds. */
+    createdAt: number;
+    /** The provider cut the answer at the output-token budget. */
+    truncated?: boolean;
+}
 /** `GET /api/sessions/:sid/models`: models of the session's provider (credential-free). */
 export interface SessionModels {
     provider: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/sdk",
-  "version": "0.1.0-alpha.15",
+  "version": "0.1.0-alpha.16",
   "description": "Typed plugin SDK for Alisio: the stable contract for tools, commands, context, compaction and session hooks, model completions and storage. Types only plus tiny helpers; zero runtime dependencies.",
   "author": "Gustavo Gutiérrez",
   "license": "MIT",