exponential-sdk 1.22.0 → 1.25.0

package/dist/index.d.ts

@@ -284,6 +284,14 @@ interface TrpcClient {
                 limit?: number;
             }) => Promise<unknown>;
         };
+        knowledge: {
+            query: (input: {
+                query: string;
+                workspaceId: string;
+                limit?: number;
+                sourceTypes?: ('transcription' | 'resource' | 'document' | 'page')[];
+            }) => Promise<unknown>;
+        };
     };
     action: {
         getAll: {
@@ -905,6 +913,16 @@ interface TrpcClient {
         get: {
             query: (input: {
                 id: string;
+                format?: 'full' | 'markdown' | 'outline';
+                section?: string;
+            }) => Promise<unknown>;
+        };
+        search: {
+            query: (input: {
+                workspaceId: string;
+                query: string;
+                projectId?: string;
+                limit?: number;
             }) => Promise<unknown>;
         };
         create: {
@@ -914,6 +932,9 @@ interface TrpcClient {
                 title?: string;
                 body?: string;
                 includeInSearch?: boolean;
+                note?: string;
+                source?: string | null;
+                asOf?: Date | null;
             }) => Promise<unknown>;
         };
         update: {
@@ -923,6 +944,38 @@ interface TrpcClient {
                 projectId?: string | null;
                 includeInSearch?: boolean;
                 body?: string;
+                baseVersion?: number;
+                note?: string;
+                source?: string | null;
+                asOf?: Date | null;
+            }) => Promise<unknown>;
+        };
+        history: {
+            query: (input: {
+                id: string;
+                limit?: number;
+                cursor?: string;
+            }) => Promise<unknown>;
+        };
+        revision: {
+            query: (input: {
+                id: string;
+                revisionId: string;
+            }) => Promise<unknown>;
+        };
+        diff: {
+            query: (input: {
+                id: string;
+                revisionId: string;
+                against?: string;
+            }) => Promise<unknown>;
+        };
+        restore: {
+            mutate: (input: {
+                id: string;
+                revisionId: string;
+                note?: string;
+                baseVersion?: number;
             }) => Promise<unknown>;
         };
     };
@@ -954,6 +1007,20 @@ interface TrpcClient {
                 generateEmbeddings?: boolean;
             }) => Promise<unknown>;
         };
+        get: {
+            query: (input: {
+                id: string;
+            }) => Promise<unknown>;
+        };
+        update: {
+            mutate: (input: {
+                id: string;
+                title?: string;
+                description?: string;
+                tags?: string[];
+                readStatus?: string;
+            }) => Promise<unknown>;
+        };
         setReadStatus: {
             mutate: (input: {
                 id: string;
@@ -3090,8 +3157,19 @@ declare class DecisionsApi {
     unlink(workspaceId: string, linkId: string): Promise<{
         deleted: boolean;
     }>;
-    /** Publish a draft into the log. */
-    confirmDraft(workspaceId: string, decisionId: string): Promise<Decision>;
+    /**
+     * Publish a draft into the log. Needs a person's login: agent keys are
+     * refused. Idempotent on a decision that is already confirmed.
+     *
+     * `status` moves it in the same write — `{ status: 'ACCEPTED' }` is
+     * "confirm as accepted", and works on an already-confirmed decision too.
+     * `SUPERSEDED` is refused (it needs a successor; use {@link setStatus}).
+     * A person confirming or accepting a decision that no person stands behind
+     * becomes its decider. `decisionId` may also be a `D-0006` label.
+     */
+    confirmDraft(workspaceId: string, decisionId: string, options?: {
+        status?: DecisionStatus;
+    }): Promise<Decision>;
     /**
      * Reject a draft. Confirmed decisions are never rejected — deprecate or
      * supersede them through {@link setStatus}.
@@ -4038,9 +4116,19 @@ interface KnowledgePage {
     workspaceId: string;
     projectId: string | null;
     title: string;
+    /**
+     * Markdown body. With `format: "outline"` this is null; with `section` it is
+     * that section only (see `section`).
+     */
     body: string | null;
+    /** UTF-8 size of the whole Markdown body, whatever `format`/`section` returned. */
+    bodyBytes?: number;
     includeInSearch: boolean;
     docVersion: number;
+    /** Provenance (ADR-0074): where the page's facts come from — a URL, a document, a person. */
+    source?: string | null;
+    /** Provenance (ADR-0074): the date the page's facts were true. */
+    asOf?: Date | null;
     createdById: string;
     createdAt: Date;
     updatedAt: Date;
@@ -4056,13 +4144,148 @@ interface KnowledgePage {
     };
     /** Present on `get` responses: whether the caller may edit the page. */
     canEdit?: boolean;
+    /** Present on `get` responses: which `format` produced this payload. */
+    format?: PageGetFormat;
+    /** Present on `get` with `format: "outline"`: the page's headings. */
+    outline?: PageOutlineEntry[] | null;
+    /** Present on `get` with `section`: the heading the body was narrowed to. */
+    section?: PageOutlineEntry | null;
+}
+type PageGetFormat = 'full' | 'markdown' | 'outline';
+interface PageOutlineEntry {
+    /** Heading depth, 1–6. */
+    level: number;
+    text: string;
+    /** 0-based line in the Markdown body. */
+    line: number;
+}
+/** `baseline` is the unattributed starting row seeded for pages that predate history. */
+type PageRevisionKind = 'baseline' | 'create' | 'editor' | 'markdown' | 'restore';
+interface PageRevisionAuthor {
+    id: string;
+    name: string | null;
+    image: string | null;
+}
+/** One row of a page's history (ADR-0074): a snapshot after a write, without its body. */
+interface PageRevision {
+    id: string;
+    /** The page's `docVersion` after this write. */
+    docVersion: number;
+    title: string;
+    kind: PageRevisionKind;
+    /** Why the change was made, when the writer said. */
+    note: string | null;
+    /** UTF-8 size of the Markdown body at this revision. */
+    bodyBytes: number;
+    /** Provenance as it stood at this revision. */
+    source: string | null;
+    asOf: Date | null;
+    /**
+     * The author, or null. Null with `authorHidden: true` means names are
+     * withheld from you (you can view the page but are not a workspace member).
+     * Null with `authorHidden: false` means no person wrote it: a `baseline`
+     * row, or an automated write (an agenda seed, a generated Workspace update)
+     * whose `note` says what did.
+     */
+    author: PageRevisionAuthor | null;
+    authorHidden: boolean;
+    /** When the revision was first recorded. */
+    createdAt: Date;
+    /** When it last moved forward (editor saves fold into an open revision). */
+    updatedAt: Date;
+}
+interface PageHistory {
+    revisions: PageRevision[];
+    /** Pass back as `cursor` to fetch older revisions; null when there are none. */
+    nextCursor: string | null;
+}
+/** A revision with its Markdown body. */
+interface PageRevisionDetail extends PageRevision {
+    pageId: string;
+    body: string | null;
+}
+interface PageDiffSide {
+    /** Null for the empty state before the first revision, or for the live page. */
+    revisionId: string | null;
+    docVersion: number;
+    title: string;
+    source: string | null;
+    asOf: Date | null;
+    createdAt: Date | null;
+}
+interface PageDiff {
+    from: PageDiffSide;
+    to: PageDiffSide;
+    /** Unified diff of the Markdown bodies; empty when identical. */
+    unified: string;
+    stats: {
+        added: number;
+        removed: number;
+    };
+    titleChanged: boolean;
+    /** `source` or `asOf` differ between the two sides. */
+    provenanceChanged: boolean;
+}
+interface PageSearchResult {
+    id: string;
+    title: string;
+    /** The best-matching chunk (semantic) or the text around the match. */
+    snippet: string;
+    /** Cosine similarity for semantic hits; null for substring matches. */
+    similarity: number | null;
+    matchedBy: 'semantic' | 'text';
+    /** App-relative URL. */
+    url: string;
+}
+interface PageSearchOutput {
+    query: string;
+    workspaceId: string;
+    results: PageSearchResult[];
 }
 
 interface PageListOptions {
     workspaceId: string;
     projectId?: string;
+    /** Case-insensitive title match. To find pages by content or meaning use `search`. */
     search?: string;
 }
+interface PageGetOptions {
+    /**
+     * How much of the body to fetch. Defaults to `markdown` — the Markdown body
+     * without the editor's ProseMirror doc, which is several times larger and
+     * carries nothing an agent needs. `outline` returns headings only; `full`
+     * is the editor payload.
+     */
+    format?: PageGetFormat;
+    /**
+     * Narrow the body to one section: the heading's text (case-insensitive;
+     * `## ` prefix tolerated) through to the next heading of the same or a
+     * higher level. Unknown headings fail with the list of headings that exist.
+     */
+    section?: string;
+}
+interface PageSearchOptions {
+    workspaceId: string;
+    /** What the page should be about (2–200 chars). */
+    query: string;
+    projectId?: string;
+    /** Max pages returned (1–25, server default 10). */
+    limit?: number;
+}
+interface PageHistoryOptions {
+    /** Max revisions (1–200, server default 50). */
+    limit?: number;
+    /** `nextCursor` from a previous page of history. */
+    cursor?: string;
+}
+interface PageDiffOptions {
+    /**
+     * What to compare the revision with: `previous` (default — what this
+     * revision changed), `current` (the page as it is now), or another
+     * revision's id.
+     */
+    against?: 'previous' | 'current' | string;
+}
 interface PageCreateInput {
     workspaceId: string;
     projectId?: string | null;
@@ -4070,6 +4293,12 @@ interface PageCreateInput {
     /** Markdown body. Indexed for search when non-empty. */
     body?: string;
     includeInSearch?: boolean;
+    /** Why the page was created — recorded on its first revision. */
+    note?: string;
+    /** Provenance: where the facts come from (URL, document, person). */
+    source?: string | null;
+    /** Provenance: the date the facts were true. */
+    asOf?: Date | null;
 }
 interface PageUpdateInput {
     id: string;
@@ -4082,18 +4311,73 @@ interface PageUpdateInput {
      * the editor re-derives its rich document on next open.
      */
     body?: string;
+    /**
+     * The `docVersion` you read before editing. With it, a body write is a
+     * compare-and-set: if someone saved in between, the call fails with
+     * CONFLICT instead of overwriting their work. Always send it when you can.
+     */
+    baseVersion?: number;
+    /**
+     * Why this change — recorded on the revision and shown in the page's
+     * history. Always send one from an agent: a body write without a note
+     * reads "No reason given" to everyone who looks at the history.
+     */
+    note?: string;
+    /** Provenance: where the facts come from. Empty string / null clears it. */
+    source?: string | null;
+    /** Provenance: the date the facts were true. Null clears it. */
+    asOf?: Date | null;
+}
+interface PageRestoreOptions {
+    /** Why you are restoring; defaults to "Restored the version from <date>". */
+    note?: string;
+    /**
+     * The page's `docVersion` when you decided to restore (the newest
+     * revision's `docVersion` from `history`). With it, a page saved since then
+     * fails with CONFLICT instead of being replaced. Always send it.
+     */
+    baseVersion?: number;
 }
 /**
  * Knowledge pages (PRDs, research, technical specs). Workspace-scoped
  * documents; link one to a feature via `FeaturesApi.linkPage`.
+ *
+ * Reads are lean by default: `get` returns Markdown only. Use `outline` to see
+ * a long page's shape, then `get(id, { section })` for the part you need.
+ * Every write is recorded in the page's history (`history`, `diff`,
+ * `restore`); pass a `note` so the record says why.
  */
 declare class PagesApi {
     private client;
     constructor(client: TrpcClient);
     list(options: PageListOptions): Promise<KnowledgePage[]>;
-    get(id: string): Promise<KnowledgePage>;
+    /** One page. Markdown body only unless `format` says otherwise. */
+    get(id: string, options?: PageGetOptions): Promise<KnowledgePage>;
+    /** The page's headings (level, text, line) and `bodyBytes`, no body. */
+    outline(id: string): Promise<KnowledgePage>;
+    /**
+     * Pages about something: semantic hits from the Knowledge index first
+     * (nearest first, with the matching passage as `snippet`), then pages whose
+     * title or body contain the query. Only pages the caller can view.
+     */
+    search(options: PageSearchOptions): Promise<PageSearchOutput>;
     create(input: PageCreateInput): Promise<KnowledgePage>;
     update(input: PageUpdateInput): Promise<KnowledgePage>;
+    /** The page's revisions, newest first — who, when, why, size. Never the bodies. */
+    history(id: string, options?: PageHistoryOptions): Promise<PageHistory>;
+    /** One revision with its Markdown body. */
+    revision(pageId: string, revisionId: string): Promise<PageRevisionDetail>;
+    /** What a revision changed, as a unified diff of the Markdown. */
+    diff(pageId: string, revisionId: string, options?: PageDiffOptions): Promise<PageDiff>;
+    /**
+     * Put a revision's content back as the page's current content. A forward
+     * write: `docVersion` bumps and a "restore" revision is recorded.
+     */
+    restore(pageId: string, revisionId: string, options?: PageRestoreOptions): Promise<{
+        id: string;
+        docVersion: number;
+        revisionId: string;
+    }>;
 }
 
 type ResourceContentType = 'web_page' | 'document' | 'pdf' | 'bookmark' | 'note';
@@ -4155,6 +4439,13 @@ interface ResourceCreateInput {
     /** Defaults to true server-side; a no-op when there is no content to embed. */
     generateEmbeddings?: boolean;
 }
+/** Fields `update` may change. `tags` replaces the whole set. */
+interface ResourceUpdateInput {
+    title?: string;
+    description?: string;
+    tags?: string[];
+    readStatus?: ReadStatus;
+}
 interface ResourceReadState {
     id: string;
     readStatus: ReadStatus | string;
@@ -4173,11 +4464,20 @@ declare class ResourcesApi {
     constructor(client: TrpcClient);
     list(options?: ResourceListOptions): Promise<ResourceListResult>;
     create(input: ResourceCreateInput): Promise<Resource>;
-    /** Save a link to the Reading list: a `bookmark` in `to_read`, not embedded. */
+    get(id: string): Promise<Resource>;
+    update(id: string, input: ResourceUpdateInput): Promise<Resource>;
+    /**
+     * Save a link to the Reading list: a `bookmark` in `to_read`, not embedded.
+     *
+     * `tags` are added to the ones the link already has. The server dedupes by
+     * URL and would replace the set on re-save, so the link is saved untagged
+     * (which leaves existing tags alone) and the union written after.
+     */
     save(input: {
         url: string;
         title?: string;
         note?: string;
+        tags?: string[];
         workspaceId?: string;
         readStatus?: ReadStatus;
     }): Promise<Resource>;
@@ -4304,6 +4604,34 @@ interface GlobalSearchOutput {
     query: string;
     results: SearchResult[];
 }
+type KnowledgeSourceType = 'transcription' | 'resource' | 'document' | 'page';
+interface KnowledgeSearchOptions {
+    /** What the content should be about (3–200 chars). */
+    query: string;
+    /** Required: the Knowledge index is searched one workspace at a time. */
+    workspaceId: string;
+    /** Max sources returned (1-20, server default 5). */
+    limit?: number;
+    /** Restrict to these kinds of source; default is every kind the caller can see. */
+    sourceTypes?: KnowledgeSourceType[];
+}
+/** One Knowledge Base hit: the best-matching chunk of one indexed source. */
+interface KnowledgeSearchResult {
+    sourceType: KnowledgeSourceType;
+    sourceId: string;
+    title: string;
+    /** The matching chunk, whitespace-collapsed and cut to a one-line preview. */
+    snippet: string;
+    similarity: number;
+    /** In-app route, or the source's own URL when `external`. */
+    url: string;
+    external: boolean;
+}
+interface KnowledgeSearchOutput {
+    query: string;
+    workspaceId: string;
+    results: KnowledgeSearchResult[];
+}
 
 declare class SearchApi {
     private client;
@@ -4311,9 +4639,17 @@ declare class SearchApi {
     /**
      * Global text search across the entities the caller can access — the same
      * coverage as the app's Cmd+K palette (projects, actions, goals,
-     * workspaces, and other entity types as the API grows).
+     * workspaces, and other entity types as the API grows). Matches titles;
+     * for pages by meaning use `knowledge` or `PagesApi.search`.
      */
     global(options: GlobalSearchOptions): Promise<GlobalSearchOutput>;
+    /**
+     * Semantic search over one workspace's Knowledge index — the caller's own
+     * indexed meetings, resources, documents and pages, scored by meaning. Each
+     * source contributes its best-matching passage. Costs an embedding call;
+     * never throws for an index failure (returns no results instead).
+     */
+    knowledge(options: KnowledgeSearchOptions): Promise<KnowledgeSearchOutput>;
 }
 
 type TimeEntryStatus = 'PROPOSED' | 'CONFIRMED';
@@ -4726,4 +5062,4 @@ declare class ExponentialClient {
     });
 }
 
-export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionUpsertBySourceInput, type ActionUpsertBySourceResult, type ActionsListOutput, type AddInteractionInput, type AgentRunStatus, AgentRunsApi, type AppendEventsResult, type Area, type AreaCreateInput, type AreaListOptions, type ClaimedRun, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type ConversationMessage, DEFAULT_GAP_MINUTES, type DayReport, type DayReportActionRow, type DayReportEntry, type DayReportProductRow, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, type Decision, type DecisionAdrRef, type DecisionChainRef, type DecisionCreateInput, type DecisionDecider, type DecisionDeciderInput, type DecisionEvidenceTurn, type DecisionFeatureRef, type DecisionLink, type DecisionListOptions, type DecisionListRow, type DecisionMeetingRef, type DecisionOccurrenceRef, type DecisionProductRef, type DecisionProjectRef, type DecisionReviewState, type DecisionSetStatusInput, type DecisionSource, type DecisionStatus, type DecisionTicketRef, type DecisionUpdateInput, type DecisionUserRef, type DraftDecisionsResult, type EnrichContactResult, type Epic, type EpicCreateInput, type EpicListOptions, type EpicPriority, type EpicStatus, type EpicUpdateInput, ExponentialClient, type ExponentialConfig, type Feature, type FeatureComment, type FeatureCommentCreateInput, type FeatureCommentReplyInput, type FeatureCommentThreadInput, type FeatureCommentUpdateInput, type FeatureCreateInput, type FeatureKeyResultLink, type FeatureLinkPageInput, type FeatureListOptions, type FeatureScope, type FeatureScopeStatus, type FeatureStatus, type FeatureUpdateInput, type FinishInput, type FinishResult, type GlobalSearchOptions, type GlobalSearchOutput, type Goal, type GoalChildSummary, type GoalComment, type GoalCommentAddInput, type GoalCommentUpdateInput, type GoalCreateInput, type GoalHealth, type GoalKeyResultSummary, type GoalLifeDomain, type GoalListOptions, type GoalPeriod, type GoalProjectSummary, type GoalSetParentInput, type GoalSetStatusInput, type GoalStats, type GoalStatsOptions, type GoalStatus, type GoalTreeNode, type GoalTreeOptions, type GoalUpdateInput, type GoalUserSummary, type GoalWritableStatus, type HeartbeatResult, type InteractionDirection, type InteractionType, type KanbanStatus, type KeyResult, type KeyResultByObjectiveOptions, type KeyResultCheckIn, type KeyResultCheckInInput, type KeyResultCreateInput, type KeyResultFeatureLink, type KeyResultListOptions, type KeyResultProjectLink, type KeyResultStatus, type KeyResultUnit, type KeyResultUpdateInput, type KnowledgePage, type LabelCreateInput, type LabelListOptions, type ListForEntityInput, type Meeting, type MeetingActionSummary, type MeetingCreateInput, type MeetingDecisions, type MeetingListOptions, type MeetingParticipant, type MeetingParticipantInput, type MeetingProjectRef, type MeetingSourceIntegration, type MeetingTypeFilter, type MeetingUpdateInput, type MeetingWorkspaceRef, type ObjectiveWithKeyResults, type Organization, type OrganizationCreateInput, type OrganizationListOutput, type OrganizationSize, type OrganizationsListOptions, type OverdueCohort, type OverdueTriage, type OverdueTriageRow, type PageComment, type PageCommentCreateInput, type PageCommentUpdateInput, type PageCreateInput, type PageListOptions, type PageUpdateInput, type Pipeline, type PipelineStage, type Priority, type Product, type ProductCreateInput, type ProductUpdateInput, type Project, type ProjectDetail, type ProjectKeyResultLink, type ProjectOutput, type ProjectPriority, type ProjectStatus, type ProjectUpdateInput, type ProjectsListOptions, type ProjectsListOutput, ROUND_MINUTES, type ReadStatus, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, type Resource, type ResourceContentType, type ResourceCreateInput, type ResourceListOptions, type ResourceListResult, type ResourceReadState, type RunMessage, type RunnerEvent, type RunnerEventKind, type ScopeCreateInput, type ScopeListOptions, type ScopeUpdateInput, type SearchResult, type SearchResultType, type SearchResultWorkspace, type SetEntityTagsInput, type SetEntityTagsResult, type Tag, type TagEntityType, type TagListResult, type Ticket, type TicketAssignee, type TicketComment, type TicketCommentAddInput, type TicketCommentUpdateInput, type TicketCreateInput, type TicketDependencyEdge, type TicketDetail, type TicketListOptions, type TicketSearchOptions, type TicketStatus, type TicketType, type TicketUpdateInput, TimeApi, type TimeConfirmDayResult, type TimeEntry, type TimeEntrySource, type TimeEntryStatus, type TimeLogBatchResult, type TimeLogInput, type TimeLogOutcome, type TimeLogResult, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type WorklogSegment, type Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig, segmentConversation };
+export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionUpsertBySourceInput, type ActionUpsertBySourceResult, type ActionsListOutput, type AddInteractionInput, type AgentRunStatus, AgentRunsApi, type AppendEventsResult, type Area, type AreaCreateInput, type AreaListOptions, type ClaimedRun, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type ConversationMessage, DEFAULT_GAP_MINUTES, type DayReport, type DayReportActionRow, type DayReportEntry, type DayReportProductRow, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, type Decision, type DecisionAdrRef, type DecisionChainRef, type DecisionCreateInput, type DecisionDecider, type DecisionDeciderInput, type DecisionEvidenceTurn, type DecisionFeatureRef, type DecisionLink, type DecisionListOptions, type DecisionListRow, type DecisionMeetingRef, type DecisionOccurrenceRef, type DecisionProductRef, type DecisionProjectRef, type DecisionReviewState, type DecisionSetStatusInput, type DecisionSource, type DecisionStatus, type DecisionTicketRef, type DecisionUpdateInput, type DecisionUserRef, type DraftDecisionsResult, type EnrichContactResult, type Epic, type EpicCreateInput, type EpicListOptions, type EpicPriority, type EpicStatus, type EpicUpdateInput, ExponentialClient, type ExponentialConfig, type Feature, type FeatureComment, type FeatureCommentCreateInput, type FeatureCommentReplyInput, type FeatureCommentThreadInput, type FeatureCommentUpdateInput, type FeatureCreateInput, type FeatureKeyResultLink, type FeatureLinkPageInput, type FeatureListOptions, type FeatureScope, type FeatureScopeStatus, type FeatureStatus, type FeatureUpdateInput, type FinishInput, type FinishResult, type GlobalSearchOptions, type GlobalSearchOutput, type Goal, type GoalChildSummary, type GoalComment, type GoalCommentAddInput, type GoalCommentUpdateInput, type GoalCreateInput, type GoalHealth, type GoalKeyResultSummary, type GoalLifeDomain, type GoalListOptions, type GoalPeriod, type GoalProjectSummary, type GoalSetParentInput, type GoalSetStatusInput, type GoalStats, type GoalStatsOptions, type GoalStatus, type GoalTreeNode, type GoalTreeOptions, type GoalUpdateInput, type GoalUserSummary, type GoalWritableStatus, type HeartbeatResult, type InteractionDirection, type InteractionType, type KanbanStatus, type KeyResult, type KeyResultByObjectiveOptions, type KeyResultCheckIn, type KeyResultCheckInInput, type KeyResultCreateInput, type KeyResultFeatureLink, type KeyResultListOptions, type KeyResultProjectLink, type KeyResultStatus, type KeyResultUnit, type KeyResultUpdateInput, type KnowledgePage, type KnowledgeSearchOptions, type KnowledgeSearchOutput, type KnowledgeSearchResult, type KnowledgeSourceType, type LabelCreateInput, type LabelListOptions, type ListForEntityInput, type Meeting, type MeetingActionSummary, type MeetingCreateInput, type MeetingDecisions, type MeetingListOptions, type MeetingParticipant, type MeetingParticipantInput, type MeetingProjectRef, type MeetingSourceIntegration, type MeetingTypeFilter, type MeetingUpdateInput, type MeetingWorkspaceRef, type ObjectiveWithKeyResults, type Organization, type OrganizationCreateInput, type OrganizationListOutput, type OrganizationSize, type OrganizationsListOptions, type OverdueCohort, type OverdueTriage, type OverdueTriageRow, type PageComment, type PageCommentCreateInput, type PageCommentUpdateInput, type PageCreateInput, type PageDiff, type PageDiffOptions, type PageDiffSide, type PageGetFormat, type PageGetOptions, type PageHistory, type PageHistoryOptions, type PageListOptions, type PageOutlineEntry, type PageRestoreOptions, type PageRevision, type PageRevisionAuthor, type PageRevisionDetail, type PageRevisionKind, type PageSearchOptions, type PageSearchOutput, type PageSearchResult, type PageUpdateInput, type Pipeline, type PipelineStage, type Priority, type Product, type ProductCreateInput, type ProductUpdateInput, type Project, type ProjectDetail, type ProjectKeyResultLink, type ProjectOutput, type ProjectPriority, type ProjectStatus, type ProjectUpdateInput, type ProjectsListOptions, type ProjectsListOutput, ROUND_MINUTES, type ReadStatus, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, type Resource, type ResourceContentType, type ResourceCreateInput, type ResourceListOptions, type ResourceListResult, type ResourceReadState, type ResourceUpdateInput, type RunMessage, type RunnerEvent, type RunnerEventKind, type ScopeCreateInput, type ScopeListOptions, type ScopeUpdateInput, type SearchResult, type SearchResultType, type SearchResultWorkspace, type SetEntityTagsInput, type SetEntityTagsResult, type Tag, type TagEntityType, type TagListResult, type Ticket, type TicketAssignee, type TicketComment, type TicketCommentAddInput, type TicketCommentUpdateInput, type TicketCreateInput, type TicketDependencyEdge, type TicketDetail, type TicketListOptions, type TicketSearchOptions, type TicketStatus, type TicketType, type TicketUpdateInput, TimeApi, type TimeConfirmDayResult, type TimeEntry, type TimeEntrySource, type TimeEntryStatus, type TimeLogBatchResult, type TimeLogInput, type TimeLogOutcome, type TimeLogResult, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type WorklogSegment, type Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig, segmentConversation };

package/dist/index.js

@@ -643,11 +643,21 @@ var DecisionsApi = class {
       linkId
     });
   }
-  /** Publish a draft into the log. */
-  async confirmDraft(workspaceId, decisionId) {
+  /**
+   * Publish a draft into the log. Needs a person's login: agent keys are
+   * refused. Idempotent on a decision that is already confirmed.
+   *
+   * `status` moves it in the same write — `{ status: 'ACCEPTED' }` is
+   * "confirm as accepted", and works on an already-confirmed decision too.
+   * `SUPERSEDED` is refused (it needs a successor; use {@link setStatus}).
+   * A person confirming or accepting a decision that no person stands behind
+   * becomes its decider. `decisionId` may also be a `D-0006` label.
+   */
+  async confirmDraft(workspaceId, decisionId, options = {}) {
     return await this.client.decision.confirmDraft.mutate({
       workspaceId,
-      decisionId
+      decisionId,
+      ...options.status ? { status: options.status } : {}
     });
   }
   /**
@@ -1076,8 +1086,25 @@ var PagesApi = class {
   async list(options) {
     return await this.client.page.list.query(options);
   }
-  async get(id) {
-    return await this.client.page.get.query({ id });
+  /** One page. Markdown body only unless `format` says otherwise. */
+  async get(id, options = {}) {
+    return await this.client.page.get.query({
+      id,
+      format: options.format ?? "markdown",
+      ...options.section ? { section: options.section } : {}
+    });
+  }
+  /** The page's headings (level, text, line) and `bodyBytes`, no body. */
+  async outline(id) {
+    return await this.get(id, { format: "outline" });
+  }
+  /**
+   * Pages about something: semantic hits from the Knowledge index first
+   * (nearest first, with the matching passage as `snippet`), then pages whose
+   * title or body contain the query. Only pages the caller can view.
+   */
+  async search(options) {
+    return await this.client.page.search.query(options);
   }
   async create(input) {
     return await this.client.page.create.mutate(input);
@@ -1085,6 +1112,29 @@ var PagesApi = class {
   async update(input) {
     return await this.client.page.update.mutate(input);
   }
+  /** The page's revisions, newest first — who, when, why, size. Never the bodies. */
+  async history(id, options = {}) {
+    return await this.client.page.history.query({ id, ...options });
+  }
+  /** One revision with its Markdown body. */
+  async revision(pageId, revisionId) {
+    return await this.client.page.revision.query({ id: pageId, revisionId });
+  }
+  /** What a revision changed, as a unified diff of the Markdown. */
+  async diff(pageId, revisionId, options = {}) {
+    return await this.client.page.diff.query({
+      id: pageId,
+      revisionId,
+      against: options.against ?? "previous"
+    });
+  }
+  /**
+   * Put a revision's content back as the page's current content. A forward
+   * write: `docVersion` bumps and a "restore" revision is recorded.
+   */
+  async restore(pageId, revisionId, options = {}) {
+    return await this.client.page.restore.mutate({ id: pageId, revisionId, ...options });
+  }
 };
 
 // src/resources.ts
@@ -1099,9 +1149,23 @@ var ResourcesApi = class {
     const result = await this.client.resource.create.mutate(input);
     return result.resource;
   }
-  /** Save a link to the Reading list: a `bookmark` in `to_read`, not embedded. */
+  async get(id) {
+    const result = await this.client.resource.get.query({ id });
+    return result.resource;
+  }
+  async update(id, input) {
+    const result = await this.client.resource.update.mutate({ id, ...input });
+    return result.resource;
+  }
+  /**
+   * Save a link to the Reading list: a `bookmark` in `to_read`, not embedded.
+   *
+   * `tags` are added to the ones the link already has. The server dedupes by
+   * URL and would replace the set on re-save, so the link is saved untagged
+   * (which leaves existing tags alone) and the union written after.
+   */
   async save(input) {
-    return await this.create({
+    const resource = await this.create({
       title: input.title?.trim() || hostnameOf(input.url) || input.url,
       url: input.url,
       description: input.note,
@@ -1110,6 +1174,10 @@ var ResourcesApi = class {
       generateEmbeddings: false,
       workspaceId: input.workspaceId
     });
+    const existing = resource.tags ?? [];
+    const added = (input.tags ?? []).filter((t) => !existing.includes(t));
+    if (added.length === 0) return resource;
+    return await this.update(resource.id, { tags: [...existing, ...added] });
   }
   async setReadStatus(id, readStatus) {
     return await this.client.resource.setReadStatus.mutate({ id, readStatus });
@@ -1193,11 +1261,21 @@ var SearchApi = class {
   /**
    * Global text search across the entities the caller can access — the same
    * coverage as the app's Cmd+K palette (projects, actions, goals,
-   * workspaces, and other entity types as the API grows).
+   * workspaces, and other entity types as the API grows). Matches titles;
+   * for pages by meaning use `knowledge` or `PagesApi.search`.
    */
   async global(options) {
     return await this.client.search.global.query(options);
   }
+  /**
+   * Semantic search over one workspace's Knowledge index — the caller's own
+   * indexed meetings, resources, documents and pages, scored by meaning. Each
+   * source contributes its best-matching passage. Costs an embedding call;
+   * never throws for an index failure (returns no results instead).
+   */
+  async knowledge(options) {
+    return await this.client.search.knowledge.query(options);
+  }
 };
 
 // src/time.ts