orbitmap 0.4.4 → 0.5.0

package/dist/adapters/types.d.ts

@@ -8,6 +8,13 @@
  */
 import type { WorkLogEntry } from '../work-log.js';
 export interface WorkspaceAdapter {
+    /**
+     * `GET /context` — since API 10.0.0 this is MATCHING MATERIAL, not a work queue:
+     * `agent` first, then `area` (area branch) or `workspace`, `missions[]`, `intents[]`
+     * (no status filter — closed intents included), `workitems[]`, `areas[]`,
+     * `documents[]` metadata and `meta.more`. The old `tasks`, `active_mission`,
+     * `open_intents` and `agent.introduction` are gone.
+     */
     getContext(areaId?: string): Promise<unknown>;
     /**
      * The area this adapter is scoped to (slug or uuid), or `undefined` when none could be
@@ -16,15 +23,35 @@ export interface WorkspaceAdapter {
      * would demand cloud credentials even in local mode).
      */
     getDefaultArea(): Promise<string | undefined>;
+    /**
+     * `GET /tasks`. Since API 9.0.0 the answer spans every area the key reaches and every
+     * assignee unless a filter narrows it; `areaId` (one ref or several) is the ONLY thing
+     * that narrows by area — the `X-Orbitmap-Area` header no longer does.
+     */
     getTasks(options?: {
         status?: string;
         priority?: string;
-        areaId?: string;
+        areaId?: string | string[];
         orbit?: string;
+        intentId?: string;
+        missionId?: string;
+        /** `me`, an agent slug or a uuid. */
+        agentId?: string;
+        unassigned?: boolean;
+        all?: boolean;
+        limit?: string | number;
+        /** Opaque keyset cursor from `meta.next_cursor`. */
+        cursor?: string;
     }): Promise<unknown>;
     getTask(taskId: string): Promise<unknown>;
     getTaskByNumber(taskNumber: string): Promise<unknown>;
-    startTask(taskId?: string): Promise<unknown>;
+    /**
+     * `confirmReassign` answers a 409 `REASSIGN_CONFIRMATION_REQUIRED` — it reassigns a task
+     * held by another agent and starts it. Only ever sent after the USER said yes.
+     */
+    startTask(taskId?: string, options?: {
+        confirmReassign?: boolean;
+    }): Promise<unknown>;
     /**
      * `force` is the `--force` escape hatch of spec §6.2: it bypasses the "a parent task
      * cannot go to `done` with unfinished subtasks" rule. Only the LocalAdapter acts on it
@@ -86,7 +113,10 @@ export interface WorkspaceAdapter {
     getDocuments(options?: {
         type?: string;
         search?: string;
-        areaId?: string;
+        areaId?: string | string[];
+        status?: string;
+        limit?: string | number;
+        cursor?: string;
     }): Promise<unknown>;
     getDocument(idOrSlug: string, mode?: 'inline' | 'file', options?: {
         full?: boolean;
@@ -187,7 +217,10 @@ export interface WorkspaceAdapter {
     listIssues(options?: {
         status?: string;
         severity?: string;
-        limit?: string;
+        areaId?: string | string[];
+        intentId?: string;
+        limit?: string | number;
+        cursor?: string;
     }): Promise<unknown>;
     /** `GET /issues/{id_or_number}` — uuid, bare code or `IS-xxxxxx`; the server resolves it. */
     getIssue(idOrNumber: string): Promise<unknown>;
@@ -209,7 +242,9 @@ export interface WorkspaceAdapter {
     listVibes(options?: {
         type?: string;
         since?: string;
-        limit?: string;
+        areaId?: string | string[];
+        limit?: string | number;
+        cursor?: string;
     }): Promise<unknown>;
     getVibe(id: string): Promise<unknown>;
     updateVibe(id: string, data: {
@@ -221,7 +256,9 @@ export interface WorkspaceAdapter {
     listIdeas(options?: {
         status?: string;
         priority?: string;
-        limit?: string;
+        areaId?: string | string[];
+        limit?: string | number;
+        cursor?: string;
     }): Promise<unknown>;
     /** `GET /ideas/{id_or_number}` — uuid, bare code or `ID-xxxxxx`; the server resolves it. */
     getIdea(idOrNumber: string): Promise<unknown>;
@@ -272,9 +309,29 @@ export interface WorkspaceAdapter {
     }): Promise<unknown>;
     listIntents(options?: {
         status?: string;
-        limit?: string;
+        missionId?: string;
+        limit?: string | number;
+        cursor?: string;
+    }): Promise<unknown>;
+    /**
+     * `GET /intents/{id_or_number}`. `logs: false` maps to `?logs=0` (API 10.0.0):
+     * the intent without its embedded `work_logs` tail — a measurably smaller payload
+     * for callers that only want the body fields.
+     *
+     * API 10.1.0 (IN-qqqna5):
+     * - `bundle: false` maps to `?bundle=0` — strips the context bundle
+     *   (`data.bundle.{available_docs, workspace_knowledge, orbit_docs, mission,
+     *   siblings, items}`) that show embeds by default.
+     * - `slim: true` maps to `?slim=1` — the freshness probe instead of the full body:
+     *   `{number, name, status, outcome_tldr, design_tldr, plan_tldr, areas, mission,
+     *   task_counts, updated_at, last_log_id}`. Slim wins over `logs`/`bundle`,
+     *   exactly as the provider resolves the query params.
+     */
+    getIntent(idOrNumber: string, options?: {
+        logs?: boolean;
+        bundle?: boolean;
+        slim?: boolean;
     }): Promise<unknown>;
-    getIntent(idOrNumber: string): Promise<unknown>;
     createIntent(data: {
         name: string;
         outcome?: string;
@@ -286,6 +343,10 @@ export interface WorkspaceAdapter {
     /**
      * `logs` is the status-transition batch: entries written verbatim, in order, inside the
      * same transaction as the update. The API rejects a status change that carries none (422).
+     *
+     * `area_ids` (API 10.0.0) DECLARES the intent's areas — each entry a slug or uuid,
+     * writing the `intent_area` pivot; it replaces the declared set. Declared areas beat
+     * task-derived ones in the `/context` matching material.
      */
     updateIntent(idOrNumber: string, data: {
         name?: string;
@@ -293,6 +354,7 @@ export interface WorkspaceAdapter {
         design?: string;
         plan?: string;
         status?: string;
+        area_ids?: string[];
         logs?: WorkLogEntry[];
     }): Promise<unknown>;
     linkIntentItem(idOrNumber: string, data: {
@@ -306,7 +368,8 @@ export interface WorkspaceAdapter {
     setIntentOrbit(idOrNumber: string, orbitId: string | null): Promise<unknown>;
     listMissions(options?: {
         status?: string;
-        limit?: string;
+        limit?: string | number;
+        cursor?: string;
     }): Promise<unknown>;
     getMission(idOrNumber: string): Promise<unknown>;
     createMission(data: {