exponential-sdk 1.16.0 → 1.18.0

package/dist/index.d.ts

@@ -178,6 +178,67 @@ type MeetingUpdateDetailsProcedureInput = {
     workspaceId?: string | null;
     meetingDate?: Date | null;
 };
+type DecisionStatusInput = 'OPEN' | 'PROPOSED' | 'ACCEPTED' | 'SUPERSEDED' | 'DEPRECATED';
+type DecisionSourceInput = 'MEETING' | 'MANUAL' | 'AGENT';
+type DecisionEvidenceInput = {
+    turnIndex: number;
+    speaker?: string | null;
+    startTime?: number | null;
+    text: string;
+};
+type DecisionDeciderProcedureInput = {
+    userId?: string | null;
+    name: string;
+    email?: string | null;
+};
+type DecisionCreateProcedureInput = {
+    workspaceId: string;
+    statement: string;
+    body?: string | null;
+    status?: DecisionStatusInput;
+    source?: DecisionSourceInput;
+    decidedAt?: Date | null;
+    ownerId?: string | null;
+    transcriptionSessionId?: string | null;
+    occurrenceId?: string | null;
+    productId?: string | null;
+    projectId?: string | null;
+    goalId?: number | null;
+    keyResultId?: string | null;
+    deciders?: DecisionDeciderProcedureInput[];
+    evidence?: DecisionEvidenceInput[];
+};
+type DecisionUpdateProcedureInput = {
+    workspaceId: string;
+    decisionId: string;
+    statement?: string;
+    body?: string | null;
+    decidedAt?: Date | null;
+    ownerId?: string | null;
+    productId?: string | null;
+    projectId?: string | null;
+    goalId?: number | null;
+    keyResultId?: string | null;
+    adrDocumentId?: string | null;
+};
+type ActionUpsertBySourceInput$1 = {
+    sourceType: string;
+    sourceId: string;
+    name: string;
+    workspaceId: string;
+    description?: string;
+    projectId?: string | null;
+    ticketId?: string | null;
+};
+type TimeEntryCreateInput = {
+    actionId: string;
+    startedAt: Date;
+    endedAt: Date;
+    source?: 'manual' | 'claude-desktop' | 'agent-run';
+    status?: 'PROPOSED' | 'CONFIRMED';
+    sourceRef?: string;
+    note?: string;
+};
 interface TrpcClient {
     transcription: {
         getAllTranscriptions: {
@@ -255,6 +316,10 @@ interface TrpcClient {
         update: {
             mutate: (input: ActionUpdateInput$1) => Promise<unknown>;
         };
+        /** Idempotent create keyed on (workspaceId, sourceType, sourceId). */
+        upsertBySource: {
+            mutate: (input: ActionUpsertBySourceInput$1) => Promise<unknown>;
+        };
         bulkReschedule: {
             mutate: (input: {
                 actionIds: string[];
@@ -478,6 +543,118 @@ interface TrpcClient {
             }) => Promise<unknown>;
         };
     };
+    timeEntry: {
+        /** Explicit-bounds entry; never touches the running Timer (ADR-0061). */
+        create: {
+            mutate: (input: TimeEntryCreateInput) => Promise<unknown>;
+        };
+        upsertBySourceRef: {
+            mutate: (input: TimeEntryCreateInput & {
+                sourceRef: string;
+            }) => Promise<unknown>;
+        };
+        listByDateRange: {
+            query: (input: {
+                startDate: Date;
+                endDate: Date;
+                workspaceId?: string | null;
+            }) => Promise<unknown[]>;
+        };
+    };
+    decision: {
+        list: {
+            query: (input: {
+                workspaceId: string;
+                statuses?: DecisionStatusInput[];
+                sources?: DecisionSourceInput[];
+                /** A product id, or "workspace" for decisions with no product. */
+                productId?: string;
+                includeWorkspaceWide?: boolean;
+                projectId?: string;
+                search?: string;
+                /** One decision by its workspace sequence number — `D-0003` → 3. */
+                number?: number;
+                limit?: number;
+            }) => Promise<unknown[]>;
+        };
+        get: {
+            query: (input: {
+                workspaceId: string;
+                decisionId: string;
+            }) => Promise<unknown>;
+        };
+        /** Workspace comes from the meeting; drafts included for meeting editors. */
+        listForMeeting: {
+            query: (input: {
+                transcriptionSessionId: string;
+            }) => Promise<unknown>;
+        };
+        listForAdr: {
+            query: (input: {
+                workspaceId: string;
+                adrDocumentId: string;
+            }) => Promise<unknown[]>;
+        };
+        /** Extract draft decisions from a meeting's notes and transcript. */
+        extractDrafts: {
+            mutate: (input: {
+                transcriptionSessionId: string;
+            }) => Promise<unknown>;
+        };
+        create: {
+            mutate: (input: DecisionCreateProcedureInput) => Promise<unknown>;
+        };
+        update: {
+            mutate: (input: DecisionUpdateProcedureInput) => Promise<unknown>;
+        };
+        setStatus: {
+            mutate: (input: {
+                workspaceId: string;
+                decisionId: string;
+                status: DecisionStatusInput;
+                supersededById?: string | null;
+            }) => Promise<unknown>;
+        };
+        linkTicket: {
+            mutate: (input: {
+                workspaceId: string;
+                decisionId: string;
+                ticketId: string;
+            }) => Promise<unknown>;
+        };
+        linkFeature: {
+            mutate: (input: {
+                workspaceId: string;
+                decisionId: string;
+                featureId: string;
+            }) => Promise<unknown>;
+        };
+        /** `linkId` is the DecisionLink id, not the ticket or feature id. */
+        unlink: {
+            mutate: (input: {
+                workspaceId: string;
+                linkId: string;
+            }) => Promise<unknown>;
+        };
+        confirmDraft: {
+            mutate: (input: {
+                workspaceId: string;
+                decisionId: string;
+            }) => Promise<unknown>;
+        };
+        rejectDraft: {
+            mutate: (input: {
+                workspaceId: string;
+                decisionId: string;
+            }) => Promise<unknown>;
+        };
+        deleteDraft: {
+            mutate: (input: {
+                workspaceId: string;
+                decisionId: string;
+            }) => Promise<unknown>;
+        };
+    };
     crmApi: {
         contactList: {
             query: (input: {
@@ -1143,7 +1320,9 @@ interface Action {
         name: string;
     } | null;
     assignees?: Array<{
-        user: {
+        /** Bare form returned by `action.upsertBySource`. */
+        userId?: string;
+        user?: {
             id: string;
             name: string | null;
             email: string | null;
@@ -1231,6 +1410,30 @@ interface ActionUpdateInput {
     effortEstimate?: number | null;
     blockedByIds?: string[];
 }
+interface ActionUpsertBySourceInput {
+    /** Convention for the Daily worklog: `claude-session`. */
+    sourceType: string;
+    /** The conversation id — re-running with the same pair updates, never duplicates. */
+    sourceId: string;
+    name: string;
+    workspaceId: string;
+    description?: string;
+    /** Must live in `workspaceId`, or the call is NOT_FOUND. */
+    projectId?: string | null;
+    /** Must belong to a product in `workspaceId`, or the call is NOT_FOUND. */
+    ticketId?: string | null;
+}
+interface ActionUpsertBySourceResult {
+    action: Action & {
+        ticket?: {
+            id: string;
+            number: number;
+            shortId: string | null;
+            productId: string;
+        } | null;
+    };
+    outcome: 'created' | 'updated';
+}
 /** One action as returned inside a {@link TodaysActions} group. */
 interface TodaysActionRow {
     id: string;
@@ -1333,6 +1536,13 @@ declare class ActionsApi {
     getProjectActions(projectId: string, assigneeId?: string): Promise<Action[]>;
     create(input: ActionCreateInput): Promise<Action>;
     update(input: ActionUpdateInput): Promise<Action>;
+    /**
+     * One Action per external source: find by (workspaceId, sourceType,
+     * sourceId), refresh its name and links, else create it. `outcome` says
+     * which happened. Agents may call this; the created Action records the
+     * agent's shadow user as creator with `source: "agent"` (ADR-0049).
+     */
+    upsertBySource(input: ActionUpsertBySourceInput): Promise<ActionUpsertBySourceResult>;
 }
 
 interface CommentAuthor {
@@ -2433,6 +2643,381 @@ declare class ContactsApi {
     enrich(id: string): Promise<EnrichContactResult>;
 }
 
+/**
+ * Lifecycle of a decision.
+ *
+ * - `OPEN` — an open question: raised, not yet decided. This is how the
+ *   "Open questions" panel is populated; there is no separate model.
+ * - `PROPOSED` — put forward, not yet agreed (the server's default).
+ * - `ACCEPTED` — decided.
+ * - `SUPERSEDED` / `DEPRECATED` — end states reached through `setStatus`;
+ *   `create` rejects them as a birth state.
+ */
+type DecisionStatus = 'OPEN' | 'PROPOSED' | 'ACCEPTED' | 'SUPERSEDED' | 'DEPRECATED';
+/** Who logged it: a meeting, a person by hand, or an agent. */
+type DecisionSource = 'MEETING' | 'MANUAL' | 'AGENT';
+/**
+ * Draft decisions are invisible everywhere except the source meeting's draft
+ * views, and only to people who can edit that meeting.
+ */
+type DecisionReviewState = 'DRAFT' | 'CONFIRMED' | 'REJECTED';
+/** A quoted transcript turn backing a decision (max 50 per decision). */
+interface DecisionEvidenceTurn {
+    turnIndex: number;
+    speaker?: string | null;
+    startTime?: number | null;
+    text: string;
+}
+/**
+ * Someone who made the decision. External participants have no `User` row, so
+ * `userId` is null and the name/email pair carries them.
+ */
+interface DecisionDecider {
+    id: string;
+    userId: string | null;
+    name: string;
+    email: string | null;
+}
+interface DecisionUserRef {
+    id: string;
+    name: string | null;
+    email?: string | null;
+    image?: string | null;
+}
+interface DecisionProductRef {
+    id: string;
+    name: string;
+    slug: string;
+}
+interface DecisionProjectRef {
+    id: string;
+    name: string;
+    slug: string;
+}
+interface DecisionMeetingRef {
+    id: string;
+    title: string | null;
+    meetingDate?: Date | null;
+    workspaceId?: string | null;
+}
+interface DecisionOccurrenceRef {
+    id: string;
+    scheduledStart: Date;
+    ceremony: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+}
+/** A neighbour in the supersession chain. */
+interface DecisionChainRef {
+    id: string;
+    number: number;
+    statement: string;
+    status: DecisionStatus;
+}
+interface DecisionTicketRef {
+    id: string;
+    shortId: string | null;
+    number: number;
+    title: string;
+    status: string;
+    productId: string;
+}
+interface DecisionFeatureRef {
+    id: string;
+    name: string;
+    status: string;
+}
+/** An "implemented by" edge to a ticket or a feature. */
+interface DecisionLink {
+    id: string;
+    decisionId: string;
+    ticketId: string | null;
+    featureId: string | null;
+    createdById: string;
+    createdAt: Date;
+    ticket?: DecisionTicketRef | null;
+    feature?: DecisionFeatureRef | null;
+    createdBy?: DecisionUserRef;
+}
+interface DecisionAdrRef {
+    id: string;
+    number: number;
+    title: string;
+    repositoryId: string | null;
+}
+/**
+ * A list row — enough for the Decision Log and the meeting panels, without
+ * the body, evidence text, deciders or links.
+ */
+interface DecisionListRow {
+    id: string;
+    workspaceId: string;
+    /** Sequence number within the workspace; `label` is its rendered form. */
+    number: number;
+    /** `D-` plus the zero-padded number, e.g. `D-0042`. */
+    label: string;
+    statement: string;
+    status: DecisionStatus;
+    source: DecisionSource;
+    decidedAt: Date | null;
+    updatedAt: Date;
+    transcriptionSessionId: string | null;
+    occurrenceId: string | null;
+    productId: string | null;
+    projectId: string | null;
+    supersededById: string | null;
+    evidenceCount: number;
+    product: DecisionProductRef | null;
+    project: DecisionProjectRef | null;
+    occurrence: DecisionOccurrenceRef | null;
+    transcriptionSession: {
+        id: string;
+        title: string | null;
+    } | null;
+    /**
+     * `listForMeeting` rows carry `statement` and `status` too; the workspace
+     * log's rows carry only the id and label.
+     */
+    supersededBy: {
+        id: string;
+        label: string;
+        statement?: string;
+        status?: DecisionStatus;
+    } | null;
+    /** Present only on `listForMeeting` rows. */
+    reviewState?: DecisionReviewState;
+    _count?: {
+        links: number;
+        deciders: number;
+    };
+}
+/** One decision in full, as `get`, `create`, `update` and `setStatus` return it. */
+interface Decision {
+    id: string;
+    workspaceId: string;
+    number: number;
+    label: string;
+    statement: string;
+    /** Markdown, with ADR headings (context / alternatives / consequences). */
+    body: string | null;
+    status: DecisionStatus;
+    reviewState: DecisionReviewState;
+    source: DecisionSource;
+    decidedAt: Date | null;
+    ownerId: string | null;
+    createdById: string;
+    confirmedById: string | null;
+    confirmedAt: Date | null;
+    transcriptionSessionId: string | null;
+    occurrenceId: string | null;
+    productId: string | null;
+    projectId: string | null;
+    goalId: number | null;
+    keyResultId: string | null;
+    supersededById: string | null;
+    adrDocumentId: string | null;
+    pendingAdrPrUrl: string | null;
+    evidence: DecisionEvidenceTurn[];
+    createdAt: Date;
+    updatedAt: Date;
+    owner?: DecisionUserRef | null;
+    createdBy?: DecisionUserRef;
+    confirmedBy?: DecisionUserRef | null;
+    deciders?: DecisionDecider[];
+    transcriptionSession?: DecisionMeetingRef | null;
+    occurrence?: DecisionOccurrenceRef | null;
+    product?: DecisionProductRef | null;
+    project?: DecisionProjectRef | null;
+    goal?: {
+        id: number;
+        title: string;
+    } | null;
+    keyResult?: {
+        id: string;
+        title: string;
+    } | null;
+    supersededBy?: DecisionChainRef | null;
+    supersedes?: DecisionChainRef[];
+    adrDocument?: DecisionAdrRef | null;
+    links?: DecisionLink[];
+    /** Present on `get`: whether the caller may write to this decision. */
+    canEdit?: boolean;
+}
+/** What `listForMeeting` answers with — the rows plus the caller's rights. */
+interface MeetingDecisions {
+    decisions: DecisionListRow[];
+    /** False when the caller can't edit the meeting, or it has no workspace. */
+    canLogDecision: boolean;
+    workspaceId: string | null;
+}
+/** What `extractDrafts` reports back about one meeting. */
+interface DraftDecisionsResult {
+    success: boolean;
+    /** The meeting already has confirmed decisions; nothing was extracted. */
+    alreadyPublished: boolean;
+    /** The meeting already had drafts; they were returned, not regenerated. */
+    alreadyDrafted: boolean;
+    /** Drafts now awaiting review (existing or just created). */
+    draftCount: number;
+    draftsCreated: number;
+    /** Candidates dropped because no transcript turn supported them. */
+    discardedWithoutEvidence: number;
+    errors: string[];
+}
+
+/** A person who made the decision; `name` is the only required half. */
+interface DecisionDeciderInput {
+    userId?: string | null;
+    name: string;
+    email?: string | null;
+}
+interface DecisionListOptions {
+    workspaceId: string;
+    statuses?: DecisionStatus[];
+    sources?: DecisionSource[];
+    /** A product id, or the literal `"workspace"` for decisions with no product. */
+    productId?: string;
+    /** With a real `productId`: ALSO include decisions that have no product. */
+    includeWorkspaceWide?: boolean;
+    projectId?: string;
+    /** Free-text over statement and body (max 200 characters). */
+    search?: string;
+    /** One decision by its workspace sequence number — `D-0003` is number 3. */
+    number?: number;
+    /** Cap the rows returned (1-500). Unset returns everything visible. */
+    limit?: number;
+}
+interface DecisionCreateInput {
+    workspaceId: string;
+    /** The decision itself, or the open question. Max 500 characters. */
+    statement: string;
+    /** Markdown detail — context, alternatives, consequences. Max 20,000. */
+    body?: string | null;
+    /**
+     * Defaults to `PROPOSED` server-side. Pass `OPEN` to log an OPEN QUESTION —
+     * that is the only representation of one. `SUPERSEDED` and `DEPRECATED` are
+     * rejected here; they are `setStatus` transitions.
+     */
+    status?: DecisionStatus;
+    source?: DecisionSource;
+    decidedAt?: Date | null;
+    ownerId?: string | null;
+    /** Meeting provenance. Requires EDIT access to that meeting. */
+    transcriptionSessionId?: string | null;
+    occurrenceId?: string | null;
+    productId?: string | null;
+    projectId?: string | null;
+    goalId?: number | null;
+    keyResultId?: string | null;
+    /** Max 50. */
+    deciders?: DecisionDeciderInput[];
+    /**
+     * Quoted transcript turns backing the decision (max 50). The server checks
+     * every turn against the meeting's actual transcript: the index must
+     * resolve and the words must be that turn's, compared loosely for case,
+     * punctuation and whitespace. Turns that don't match are DROPPED, silently
+     * from the caller's side, and `speaker`/`startTime` are overwritten with
+     * the transcript's own values. Evidence therefore requires
+     * `transcriptionSessionId` — sending it without one is a BAD_REQUEST.
+     */
+    evidence?: DecisionEvidenceTurn[];
+}
+/** Content and scope only — status changes go through {@link DecisionsApi.setStatus}. */
+interface DecisionUpdateInput {
+    workspaceId: string;
+    decisionId: string;
+    statement?: string;
+    body?: string | null;
+    decidedAt?: Date | null;
+    ownerId?: string | null;
+    productId?: string | null;
+    projectId?: string | null;
+    goalId?: number | null;
+    keyResultId?: string | null;
+    adrDocumentId?: string | null;
+}
+interface DecisionSetStatusInput {
+    workspaceId: string;
+    decisionId: string;
+    status: DecisionStatus;
+    /** Required by convention when moving to `SUPERSEDED`. */
+    supersededById?: string | null;
+}
+/**
+ * Decisions — the writable half of the Decision Log (ADR-0060).
+ *
+ * The one thing worth knowing before using this: **an open question is a
+ * decision with status `OPEN`**. There is no separate model, and it is what
+ * the "Open questions" panel on a meeting page reads.
+ *
+ * Reads need workspace `view`; writes need workspace `edit`, and a decision
+ * carrying `transcriptionSessionId` additionally needs edit access to that
+ * meeting.
+ */
+declare class DecisionsApi {
+    private client;
+    constructor(client: TrpcClient);
+    /**
+     * Confirmed decisions in a workspace, newest decided first. Drafts are
+     * never included — see {@link listForMeeting} for those.
+     */
+    list(options: DecisionListOptions): Promise<DecisionListRow[]>;
+    get(workspaceId: string, decisionId: string): Promise<Decision>;
+    /**
+     * Decisions logged from one meeting — both panels' contents. Drafts are
+     * included for callers who can edit the meeting. No workspace id needed:
+     * the meeting resolves it.
+     */
+    listForMeeting(transcriptionSessionId: string): Promise<MeetingDecisions>;
+    /** Decisions formalised as one ADR ("Decided in"). */
+    listForAdr(workspaceId: string, adrDocumentId: string): Promise<DecisionListRow[]>;
+    /**
+     * Extract draft decisions from a meeting's notes and transcript. Drafts
+     * only — someone confirms or rejects each one. Idempotent per meeting:
+     * existing drafts come back untouched, and a meeting that already has
+     * confirmed decisions reports `alreadyPublished` without calling the model.
+     */
+    extractDrafts(transcriptionSessionId: string): Promise<DraftDecisionsResult>;
+    /**
+     * Log a decision. Pass `status: 'OPEN'` for an open question, and
+     * `transcriptionSessionId` to attach it to the meeting it came out of.
+     */
+    create(input: DecisionCreateInput): Promise<Decision>;
+    update(input: DecisionUpdateInput): Promise<Decision>;
+    /**
+     * Lifecycle transition — including answering an open question by moving it
+     * from `OPEN` to `ACCEPTED`.
+     */
+    setStatus(input: DecisionSetStatusInput): Promise<Decision>;
+    /** "Implemented by" a ticket. Idempotent: an existing link is returned. */
+    linkTicket(workspaceId: string, decisionId: string, ticketId: string): Promise<DecisionLink>;
+    /** "Implemented by" a feature. Idempotent: an existing link is returned. */
+    linkFeature(workspaceId: string, decisionId: string, featureId: string): Promise<DecisionLink>;
+    /** Remove one link, by the `DecisionLink` id (not the ticket/feature id). */
+    unlink(workspaceId: string, linkId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** Publish a draft into the log. */
+    confirmDraft(workspaceId: string, decisionId: string): Promise<Decision>;
+    /**
+     * Reject a draft. Confirmed decisions are never rejected — deprecate or
+     * supersede them through {@link setStatus}.
+     */
+    rejectDraft(workspaceId: string, decisionId: string): Promise<{
+        id: string;
+        reviewState: DecisionReviewState;
+    }>;
+    /**
+     * Hard-delete a draft or rejected row. The server refuses for a confirmed
+     * decision — the log keeps its history.
+     */
+    deleteDraft(workspaceId: string, decisionId: string): Promise<{
+        id: string;
+    }>;
+}
+
 type OrganizationSize = '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1000+';
 interface Organization {
     id: string;
@@ -3549,6 +4134,104 @@ declare class SearchApi {
     global(options: GlobalSearchOptions): Promise<GlobalSearchOutput>;
 }
 
+type TimeEntryStatus = 'PROPOSED' | 'CONFIRMED';
+/**
+ * Where an entry came from. `plugin` is the legacy stamp of the in-app Timer
+ * and calendar grids; new writes use the other three. `claude-desktop` is
+ * Proposed time from the Daily worklog, `agent-run` is Agent-run time (an
+ * agent working with no human turns, kept off the owner's attention totals).
+ */
+type TimeEntrySource = 'plugin' | 'manual' | 'claude-desktop' | 'agent-run';
+interface TimeEntry {
+    id: string;
+    /** Whose time it is. Under an agent key this is the agent's OWNER (ADR-0061). */
+    userId: string;
+    actionId: string;
+    workspaceId: string | null;
+    startedAt: Date;
+    endedAt: Date | null;
+    source: string;
+    status: TimeEntryStatus;
+    /** Idempotency key, e.g. `claude-session:<sessionId>#<segmentIndex>`. */
+    sourceRef: string | null;
+    note: string | null;
+    /** The external agent that wrote the row; null for human-made entries. */
+    createdByAgentId: string | null;
+    action: {
+        id: string;
+        name: string;
+        projectId: string | null;
+        workspaceId: string | null;
+    };
+}
+interface TimeLogInput {
+    actionId: string;
+    startedAt: Date;
+    endedAt: Date;
+    /** Defaults to `manual` server-side. */
+    source?: Exclude<TimeEntrySource, 'plugin'>;
+    /**
+     * Ignored under an agent key: agent-written entries are always PROPOSED.
+     * A human's entry defaults to CONFIRMED.
+     */
+    status?: TimeEntryStatus;
+    /**
+     * With a `sourceRef` the write is idempotent per owner: a re-run updates a
+     * PROPOSED entry in place and leaves a CONFIRMED one alone.
+     */
+    sourceRef?: string;
+    /** One line shown in the day view and list row (max 1000 chars). */
+    note?: string;
+}
+/**
+ * `created` — a new row; `updated` — an existing PROPOSED row was replaced;
+ * `left` — the row is CONFIRMED and was not touched.
+ */
+type TimeLogOutcome = 'created' | 'updated' | 'left';
+interface TimeLogResult {
+    entry: TimeEntry;
+    outcome: TimeLogOutcome;
+}
+interface TimeLogBatchResult {
+    index: number;
+    success: boolean;
+    sourceRef?: string;
+    entry?: TimeEntry;
+    outcome?: TimeLogOutcome;
+    error?: string;
+}
+/**
+ * Time entries — the Daily worklog's write path (ADR-0061).
+ *
+ * The thing to know: an entry always belongs to the person whose time it
+ * was. Called with an external-agent key, {@link log} writes an entry OWNED
+ * by the agent's owner, records the agent as author and forces it to
+ * `PROPOSED`; it shows on the owner's `/time` with a "proposed" chip and
+ * stays out of `Action.timeSpentMins` until the owner confirms the day.
+ * Manual time is never altered by these calls.
+ */
+declare class TimeApi {
+    private client;
+    constructor(client: TrpcClient);
+    /**
+     * Log one completed entry with explicit bounds. Never starts, stops or
+     * alters the running Timer. With `sourceRef` the call is an upsert keyed
+     * on (owner, sourceRef); without it every call creates a row.
+     */
+    log(input: TimeLogInput): Promise<TimeLogResult>;
+    /**
+     * Log many entries, one call each and in order, so a failure names the
+     * entry it belonged to instead of rejecting the whole batch. `defaults`
+     * fill any field an entry leaves out.
+     */
+    logBatch(entries: Partial<TimeLogInput>[], defaults?: Partial<TimeLogInput>): Promise<TimeLogBatchResult[]>;
+    /**
+     * The caller's entries that touch one calendar day (local time), oldest
+     * first, each with its `status`. Pass `YYYY-MM-DD` or a Date.
+     */
+    list(date: Date | string, workspaceId?: string): Promise<TimeEntry[]>;
+}
+
 interface ExponentialConfig {
     apiUrl: string;
     token: string;
@@ -3585,6 +4268,7 @@ declare class ExponentialClient {
     projects: ProjectsApi;
     workspaces: WorkspacesApi;
     contacts: ContactsApi;
+    decisions: DecisionsApi;
     organizations: OrganizationsApi;
     pipelines: PipelinesApi;
     tickets: TicketsApi;
@@ -3599,10 +4283,12 @@ declare class ExponentialClient {
     requirements: RequirementsApi;
     scopes: ScopesApi;
     search: SearchApi;
+    /** Time entries — the Daily worklog's write path (ADR-0061). */
+    time: TimeApi;
     constructor(config: {
         token: string;
         apiUrl: string;
     });
 }
 
-export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionsListOutput, type AddInteractionInput, type Area, type AreaCreateInput, type AreaListOptions, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, 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 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 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 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, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, 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, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig };
+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 Area, type AreaCreateInput, type AreaListOptions, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, 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 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 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, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, 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 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 Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig };