exponential-sdk 1.17.0 → 1.20.0

package/dist/index.d.ts

@@ -221,6 +221,24 @@ type DecisionUpdateProcedureInput = {
     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: {
@@ -298,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[];
@@ -521,6 +543,38 @@ 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[]>;
+        };
+        /** Human-only; `date` is the start of the day in the caller's timezone. */
+        confirmDay: {
+            mutate: (input: {
+                date: Date;
+                workspaceId?: string | null;
+            }) => Promise<unknown>;
+        };
+        /** `date` is the start of the day in the caller's timezone; an agent key reads its owner's day. */
+        dayReport: {
+            query: (input: {
+                date: Date;
+                workspaceId?: string | null;
+            }) => Promise<unknown>;
+        };
+    };
     decision: {
         list: {
             query: (input: {
@@ -1280,7 +1334,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;
@@ -1368,6 +1424,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;
@@ -1470,6 +1550,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 {
@@ -4061,6 +4148,207 @@ 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` / `updated` — proposed pieces were written; `left` — a CONFIRMED
+ * row already carries this ref and was not touched; `merged` — manual time
+ * on the same Action covers it, so the manual entries were annotated instead
+ * (V2, manual wins); `dropped` — manual time on other Actions covered every
+ * minute, nothing written.
+ */
+type TimeLogOutcome = 'created' | 'updated' | 'left' | 'merged' | 'dropped';
+interface TimeLogResult {
+    /** The first written piece, or the untouched CONFIRMED row; null for merged/dropped. */
+    entry: TimeEntry | null;
+    outcome: TimeLogOutcome;
+    /** Every piece written — several when manual time on another Action split the proposal. */
+    pieces?: TimeEntry[];
+    /** Manual entry ids whose note now carries the conversation reference. */
+    mergedInto?: string[];
+}
+interface DayReportEntry extends TimeEntry {
+    /** Whole minutes inside the day window (a running entry ends "now"). */
+    minutes: number;
+    /** `ticket.productId ?? project.productId ?? null`. */
+    productId: string | null;
+    productName: string | null;
+    isAgentRun: boolean;
+    flags: Array<'forgotten-timer'>;
+    action: TimeEntry['action'] & {
+        ticketId: string | null;
+        project: {
+            id: string;
+            name: string;
+            productId: string | null;
+        } | null;
+        ticket: {
+            id: string;
+            number: number;
+            shortId: string | null;
+            title: string;
+            productId: string;
+        } | null;
+    };
+}
+interface DayReportProductRow {
+    /** Null is Unassigned time. */
+    productId: string | null;
+    name: string;
+    /** Overlap-split minutes; the rows sum to `attentionMinutes`. */
+    minutes: number;
+}
+interface DayReportActionRow {
+    actionId: string;
+    name: string;
+    /** Overlap-split minutes; the rows sum to `attentionMinutes`. */
+    minutes: number;
+    /** Plain sum of the Action's non-agent-run entries. */
+    sessionMinutes: number;
+    agentRunMinutes: number;
+    productId: string | null;
+    productName: string | null;
+    projectId: string | null;
+    projectName: string | null;
+    ticket: {
+        id: string;
+        number: number;
+        shortId: string | null;
+        title: string;
+    } | null;
+    proposedCount: number;
+}
+/**
+ * One day of a person's time — the same numbers the `/time` Day tab shows.
+ * Attention minutes count each covered minute once; session minutes are the
+ * plain sum; Agent-run time is kept off both and reported on its own.
+ */
+interface DayReport {
+    dayStart: Date;
+    dayEnd: Date;
+    entries: DayReportEntry[];
+    attentionMinutes: number;
+    sessionMinutes: number;
+    agentRunMinutes: number;
+    byProduct: DayReportProductRow[];
+    byAction: DayReportActionRow[];
+    /** Non-agent-run entries whose Action has neither Ticket nor Project. */
+    unassignedCount: number;
+    proposedCount: number;
+    flags: Array<{
+        entryId: string;
+        flag: 'forgotten-timer';
+    }>;
+}
+interface TimeConfirmDayResult {
+    /** Proposed entries flipped to CONFIRMED. */
+    confirmed: number;
+}
+interface TimeLogBatchResult {
+    index: number;
+    success: boolean;
+    sourceRef?: string;
+    /** Null when the outcome is `merged` or `dropped`. */
+    entry?: TimeEntry | null;
+    outcome?: TimeLogOutcome;
+    pieces?: TimeEntry[];
+    mergedInto?: string[];
+    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[]>;
+    /**
+     * Confirm a day: every PROPOSED entry of yours that starts on that local
+     * calendar day becomes CONFIRMED and the Actions' spent time moves. Human
+     * only — the server refuses agent keys, so run this with personal
+     * credentials. A day with nothing proposed returns `{ confirmed: 0 }`.
+     */
+    confirmDay(date: Date | string, workspaceId?: string): Promise<TimeConfirmDayResult>;
+    /**
+     * The day report for one local calendar day: entries joined to Action,
+     * Ticket, Project and Product, attention / session / agent-run minutes,
+     * the overlap-split roll-ups and the counts — exactly what the `/time` Day
+     * tab and the Daily summary's Yesterday line read. Under an agent key the
+     * report is the OWNER's day.
+     */
+    dayReport(date: Date | string, workspaceId?: string): Promise<DayReport>;
+    /**
+     * 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;
@@ -4083,6 +4371,42 @@ declare function clearConfig(): void;
 declare function isAuthenticated(): boolean;
 declare function getConfigPath(): string;
 
+/**
+ * Worklog segments (CONTEXT.md "Worklog segment"): cut a conversation into
+ * the stretches of a person's attention it actually held. Pure — it lives in
+ * the SDK because the Daily worklog that needs it runs outside the app
+ * (decision 2026-09-12).
+ */
+interface ConversationMessage {
+    at: Date | string;
+    role: 'user' | 'assistant';
+}
+interface WorklogSegment {
+    start: Date;
+    end: Date;
+    /** Number of the person's messages inside. `0` marks an Agent-run stretch. */
+    humanTurns: number;
+}
+/** Silence between the person's messages that ends a segment. */
+declare const DEFAULT_GAP_MINUTES = 30;
+/** Segment bounds are rounded outward to this grain. */
+declare const ROUND_MINUTES = 5;
+/**
+ * Rules:
+ *  - a segment opens at a user message and, as long as the person keeps
+ *    replying within `gapMinutes` of their previous message, runs to the
+ *    last reply before the next gap (CONTEXT.md: "starts at the person's
+ *    first message and ends at the last reply");
+ *  - the exception is unattended work: once the assistant has been talking
+ *    alone for longer than `gapMinutes` since the person's last message, the
+ *    rest of that run — when it lasts longer than `gapMinutes` itself — is
+ *    a separate segment with `humanTurns: 0`, and the person's segment ends
+ *    at the last message inside the window. A shorter tail is just the reply
+ *    and stays in the person's segment;
+ *  - every segment is rounded outward to 5 minutes.
+ */
+declare function segmentConversation(messages: ConversationMessage[], gapMinutes?: number): WorklogSegment[];
+
 declare class ExponentialClient {
     private config;
     private client;
@@ -4112,10 +4436,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 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, 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 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 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, ROUND_MINUTES, 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 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

@@ -144,6 +144,15 @@ var ActionsApi = class {
   async update(input) {
     return await this.client.action.update.mutate(input);
   }
+  /**
+   * 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).
+   */
+  async upsertBySource(input) {
+    return await this.client.action.upsertBySource.mutate(input);
+  }
 };
 
 // src/actionComments.ts
@@ -1152,6 +1161,101 @@ var SearchApi = class {
   }
 };
 
+// src/time.ts
+function startOfLocalDay(date) {
+  const d = typeof date === "string" && /^\d{4}-\d{2}-\d{2}$/.test(date) ? /* @__PURE__ */ new Date(`${date}T00:00:00`) : new Date(date);
+  if (Number.isNaN(d.getTime())) {
+    throw new Error(`Invalid date: "${String(date)}". Use YYYY-MM-DD or an ISO timestamp.`);
+  }
+  return new Date(d.getFullYear(), d.getMonth(), d.getDate());
+}
+var TimeApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 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.
+   */
+  async log(input) {
+    if (input.sourceRef) {
+      return await this.client.timeEntry.upsertBySourceRef.mutate({
+        ...input,
+        sourceRef: input.sourceRef
+      });
+    }
+    const entry = await this.client.timeEntry.create.mutate(input);
+    return { entry, outcome: "created", pieces: [entry], mergedInto: [] };
+  }
+  /**
+   * 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.
+   */
+  async logBatch(entries, defaults = {}) {
+    const results = [];
+    for (const [index, item] of entries.entries()) {
+      const merged = { ...defaults, ...item };
+      const sourceRef = merged.sourceRef;
+      try {
+        if (!merged.actionId) throw new Error("actionId is required");
+        if (!merged.startedAt || !merged.endedAt) {
+          throw new Error("startedAt and endedAt are required");
+        }
+        const result = await this.log(merged);
+        results.push({ index, success: true, sourceRef, ...result });
+      } catch (error) {
+        results.push({
+          index,
+          success: false,
+          sourceRef,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    return results;
+  }
+  /**
+   * Confirm a day: every PROPOSED entry of yours that starts on that local
+   * calendar day becomes CONFIRMED and the Actions' spent time moves. Human
+   * only — the server refuses agent keys, so run this with personal
+   * credentials. A day with nothing proposed returns `{ confirmed: 0 }`.
+   */
+  async confirmDay(date, workspaceId) {
+    return await this.client.timeEntry.confirmDay.mutate({
+      date: startOfLocalDay(date),
+      workspaceId
+    });
+  }
+  /**
+   * The day report for one local calendar day: entries joined to Action,
+   * Ticket, Project and Product, attention / session / agent-run minutes,
+   * the overlap-split roll-ups and the counts — exactly what the `/time` Day
+   * tab and the Daily summary's Yesterday line read. Under an agent key the
+   * report is the OWNER's day.
+   */
+  async dayReport(date, workspaceId) {
+    return await this.client.timeEntry.dayReport.query({
+      date: startOfLocalDay(date),
+      workspaceId
+    });
+  }
+  /**
+   * The caller's entries that touch one calendar day (local time), oldest
+   * first, each with its `status`. Pass `YYYY-MM-DD` or a Date.
+   */
+  async list(date, workspaceId) {
+    const startDate = startOfLocalDay(date);
+    const endDate = new Date(startDate.getTime() + 24 * 60 * 60 * 1e3);
+    return await this.client.timeEntry.listByDateRange.query({
+      startDate,
+      endDate,
+      workspaceId
+    });
+  }
+};
+
 // src/config.ts
 import Conf from "conf";
 var schema = {
@@ -1229,6 +1333,60 @@ function getConfigPath() {
   return defaultStore.path;
 }
 
+// src/segment.ts
+var DEFAULT_GAP_MINUTES = 30;
+var ROUND_MINUTES = 5;
+function roundDown(ms) {
+  const grain = ROUND_MINUTES * 6e4;
+  return new Date(Math.floor(ms / grain) * grain);
+}
+function roundUp(ms) {
+  const grain = ROUND_MINUTES * 6e4;
+  return new Date(Math.ceil(ms / grain) * grain);
+}
+function segmentConversation(messages, gapMinutes = DEFAULT_GAP_MINUTES) {
+  const gapMs = gapMinutes * 6e4;
+  const sorted = messages.map((m) => ({ at: new Date(m.at).getTime(), role: m.role })).filter((m) => !Number.isNaN(m.at)).sort((a, b) => a.at - b.at);
+  const out = [];
+  let seg = null;
+  let run = null;
+  const closeSegment = () => {
+    if (seg) out.push({ start: roundDown(seg.start), end: roundUp(seg.end), humanTurns: seg.humanTurns });
+    seg = null;
+  };
+  const resolveRun = () => {
+    if (!run) return;
+    if (run.end - run.start > gapMs) {
+      closeSegment();
+      out.push({ start: roundDown(run.start), end: roundUp(run.end), humanTurns: 0 });
+    } else if (seg) {
+      seg.end = Math.max(seg.end, run.end);
+    }
+    run = null;
+  };
+  for (const m of sorted) {
+    if (m.role === "user") {
+      resolveRun();
+      if (seg && m.at - seg.lastUserAt > gapMs) closeSegment();
+      if (!seg) seg = { start: m.at, end: m.at, humanTurns: 0, lastUserAt: m.at };
+      seg.end = Math.max(seg.end, m.at);
+      seg.lastUserAt = m.at;
+      seg.humanTurns += 1;
+      continue;
+    }
+    if (run) {
+      run.end = m.at;
+    } else if (!seg || m.at - seg.lastUserAt > gapMs) {
+      run = { start: m.at, end: m.at };
+    } else {
+      seg.end = Math.max(seg.end, m.at);
+    }
+  }
+  resolveRun();
+  closeSegment();
+  return out;
+}
+
 // src/index.ts
 var ExponentialClient = class {
   constructor(config) {
@@ -1259,6 +1417,7 @@ var ExponentialClient = class {
     this.requirements = new RequirementsApi(this.client);
     this.scopes = new ScopesApi(this.client);
     this.search = new SearchApi(this.client);
+    this.time = new TimeApi(this.client);
   }
   client;
   actions;
@@ -1287,16 +1446,22 @@ var ExponentialClient = class {
   requirements;
   scopes;
   search;
+  /** Time entries — the Daily worklog's write path (ADR-0061). */
+  time;
 };
 export {
+  DEFAULT_GAP_MINUTES,
   ExponentialClient,
+  ROUND_MINUTES,
   TRPCClientError,
+  TimeApi,
   clearConfig,
   createConfigStore,
   getConfigPath,
   isAuthenticated,
   isTRPCError,
   loadConfig,
-  saveConfig
+  saveConfig,
+  segmentConversation
 };
 //# sourceMappingURL=index.js.map