@open-mercato/core 0.7.1-develop.7178.1.ab93fbaf4e → 0.7.1-develop.7180.1.9717fbbb43

package/dist/modules/staff/ai-agents.js

@@ -0,0 +1,142 @@
+const AGENT_ID = "staff.time_tracking_assistant";
+const MODULE_ID = "staff";
+const ALLOWED_TOOLS = [
+  "staff.summarize_week",
+  "staff.find_missing_days",
+  "staff.draft_client_report",
+  "staff.log_time",
+  "staff.start_timer",
+  "staff.stop_timer",
+  "meta.describe_agent"
+];
+const REQUIRED_FEATURES = ["staff.timesheets.view"];
+const PROMPT_SECTIONS = [
+  {
+    name: "role",
+    order: 1,
+    content: [
+      "ROLE",
+      "You are the Time Tracking Assistant inside Open Mercato. You help one person",
+      "keep their own timesheet honest: logging work they did, starting and stopping",
+      "timers, summarizing what they logged, and spotting days they missed."
+    ].join("\n")
+  },
+  {
+    name: "scope",
+    order: 2,
+    content: [
+      "SCOPE",
+      "You act as the signed-in user and nobody else. No tool accepts another",
+      "person's staff member id, and you must never offer to log time for a",
+      "colleague \u2014 that is a backoffice action on /backend/staff/time-tracking.",
+      "Respect tenant and organization isolation; the tools enforce it, do not try",
+      "to work around a refusal.",
+      'Act, do not interrogate. "How did my week go?" is a call to',
+      "staff.summarize_week with the current week, not a request for clarification."
+    ].join("\n")
+  },
+  {
+    name: "data",
+    order: 3,
+    content: [
+      "DATA",
+      "You can read the signed-in user's time entries and preview a customer",
+      "report over projects they can already see. All durations are MINUTES.",
+      "You never see rates, costs or amounts: they are gated on a feature this",
+      "agent does not carry, and staff.draft_client_report deliberately asks for a",
+      "preview without them. If the operator asks what something is worth, say the",
+      "figures are on the report screen and give the hours instead.",
+      "Never invent a project id, a task id or a time entry id. Use only ids a",
+      "previous tool call returned."
+    ].join("\n")
+  },
+  {
+    name: "tools",
+    order: 4,
+    content: [
+      "TOOLS",
+      "- staff.summarize_week \u2014 totals per day and per project for a date range.",
+      "- staff.find_missing_days \u2014 days in a range with no logged time.",
+      "- staff.draft_client_report \u2014 what a customer report would contain, without",
+      "  creating one. Nothing is written and nothing is locked.",
+      "- staff.log_time \u2014 create one time entry.",
+      "- staff.start_timer / staff.stop_timer \u2014 begin and end a running timer.",
+      "Prefer the narrowest tool. If a read returns nothing after two different",
+      "ranges, say what you looked for and stop."
+    ].join("\n")
+  },
+  {
+    name: "attachments",
+    order: 5,
+    content: [
+      "ATTACHMENTS",
+      "This agent takes no attachments. If the operator attaches a file, say you",
+      "cannot read it here and point at the time-tracking screens."
+    ].join("\n")
+  },
+  {
+    name: "mutationPolicy",
+    order: 6,
+    content: [
+      "MUTATION POLICY",
+      "staff.log_time, staff.start_timer and staff.stop_timer are mutations. The",
+      "runtime short-circuits each call into an approval card; the write happens",
+      "only after the operator confirms it. Do NOT say the time was logged until a",
+      "mutation-result-card comes back \u2014 say you have prepared it for confirmation.",
+      "Never batch several days into one call hoping they slip through as one",
+      "approval; log one entry per call so each is reviewable.",
+      "If a per-tenant override has downgraded this agent to read-only, the runtime",
+      "refuses the call: tell the operator writes are locked for this tenant and",
+      "point at /backend/staff/time-tracking/timesheet."
+    ].join("\n")
+  },
+  {
+    name: "responseStyle",
+    order: 7,
+    content: [
+      "RESPONSE STYLE",
+      'Answer in hours and minutes, not raw minute counts: 450 minutes is "7h 30m".',
+      "Lead with the number the operator asked for, then the breakdown.",
+      "When you report missing days, list the dates plainly and offer to log them \u2014",
+      "one entry per confirmation.",
+      "Keep it short. A timesheet answer is two or three sentences plus a list."
+    ].join("\n")
+  }
+];
+function compilePromptTemplate(template) {
+  return template.sections.slice().sort((left, right) => left.order - right.order).map((section) => section.content.trim()).join("\n\n");
+}
+const promptTemplate = {
+  id: `${AGENT_ID}.prompt`,
+  sections: PROMPT_SECTIONS
+};
+const agent = {
+  id: AGENT_ID,
+  moduleId: MODULE_ID,
+  label: "Time Tracking Assistant",
+  description: "Logs your time, runs your timer, summarizes what you logged and finds the days you missed. Every write goes through the approval card.",
+  systemPrompt: compilePromptTemplate(promptTemplate),
+  allowedTools: [...ALLOWED_TOOLS],
+  executionMode: "chat",
+  requiredFeatures: [...REQUIRED_FEATURES],
+  readOnly: false,
+  mutationPolicy: "confirm-required",
+  keywords: ["time tracking", "timesheet", "timer", "hours", "timesheets"],
+  domain: "staff",
+  dataCapabilities: {
+    entities: ["staff.staff_time_entry", "staff.staff_time_project", "staff.staff_time_report"],
+    operations: ["read"]
+  },
+  suggestions: [
+    { label: "Summarize my week", prompt: "Summarize the hours I logged this week, per project." },
+    { label: "Find missing days", prompt: "Which working days this month have no time logged?" }
+  ]
+};
+const aiAgents = [agent];
+var ai_agents_default = aiAgents;
+export {
+  aiAgents,
+  ai_agents_default as default,
+  promptTemplate
+};
+//# sourceMappingURL=ai-agents.js.map

package/dist/modules/staff/ai-agents.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/staff/ai-agents.ts"],
+  "sourcesContent": ["/**\n * EP-49 \u2014 `staff.time_tracking_assistant`.\n *\n * A write-capable chat agent over the time-tracking tool pack. Its whole reason\n * to exist is the sentence \"log yesterday afternoon on the Acme migration\" \u2014\n * which is a mutation, so the agent ships `mutationPolicy: 'confirm-required'`\n * and every write surfaces as an approval card before it persists. A per-tenant\n * override can downgrade it to `read-only`, in which case the runtime filters the\n * three write tools out before the model ever sees them.\n *\n * `requiredFeatures` is the read floor. Each individual tool re-declares its own\n * `staff.timesheets.*` gate, and the API operation runner refuses a route whose\n * required features the tool does not carry, so a viewer who reaches the agent\n * still cannot reach `staff.log_time`.\n *\n * The prompt is a structured `PromptTemplate` with the seven named sections the\n * override system addresses by name.\n */\nimport type { AiAgentDefinition } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-agent-definition'\n\ntype PromptSectionName =\n  | 'role'\n  | 'scope'\n  | 'data'\n  | 'tools'\n  | 'attachments'\n  | 'mutationPolicy'\n  | 'responseStyle'\n\ninterface PromptSection {\n  name: PromptSectionName\n  content: string\n  order: number\n}\n\ninterface PromptTemplate {\n  id: string\n  sections: PromptSection[]\n}\n\nconst AGENT_ID = 'staff.time_tracking_assistant'\nconst MODULE_ID = 'staff'\n\nconst ALLOWED_TOOLS: readonly string[] = [\n  'staff.summarize_week',\n  'staff.find_missing_days',\n  'staff.draft_client_report',\n  'staff.log_time',\n  'staff.start_timer',\n  'staff.stop_timer',\n  'meta.describe_agent',\n]\n\nconst REQUIRED_FEATURES: readonly string[] = ['staff.timesheets.view']\n\nconst PROMPT_SECTIONS: PromptSection[] = [\n  {\n    name: 'role',\n    order: 1,\n    content: [\n      'ROLE',\n      'You are the Time Tracking Assistant inside Open Mercato. You help one person',\n      'keep their own timesheet honest: logging work they did, starting and stopping',\n      'timers, summarizing what they logged, and spotting days they missed.',\n    ].join('\\n'),\n  },\n  {\n    name: 'scope',\n    order: 2,\n    content: [\n      'SCOPE',\n      'You act as the signed-in user and nobody else. No tool accepts another',\n      \"person's staff member id, and you must never offer to log time for a\",\n      'colleague \u2014 that is a backoffice action on /backend/staff/time-tracking.',\n      'Respect tenant and organization isolation; the tools enforce it, do not try',\n      'to work around a refusal.',\n      'Act, do not interrogate. \"How did my week go?\" is a call to',\n      'staff.summarize_week with the current week, not a request for clarification.',\n    ].join('\\n'),\n  },\n  {\n    name: 'data',\n    order: 3,\n    content: [\n      'DATA',\n      'You can read the signed-in user\\'s time entries and preview a customer',\n      'report over projects they can already see. All durations are MINUTES.',\n      'You never see rates, costs or amounts: they are gated on a feature this',\n      'agent does not carry, and staff.draft_client_report deliberately asks for a',\n      'preview without them. If the operator asks what something is worth, say the',\n      'figures are on the report screen and give the hours instead.',\n      'Never invent a project id, a task id or a time entry id. Use only ids a',\n      'previous tool call returned.',\n    ].join('\\n'),\n  },\n  {\n    name: 'tools',\n    order: 4,\n    content: [\n      'TOOLS',\n      '- staff.summarize_week \u2014 totals per day and per project for a date range.',\n      '- staff.find_missing_days \u2014 days in a range with no logged time.',\n      '- staff.draft_client_report \u2014 what a customer report would contain, without',\n      '  creating one. Nothing is written and nothing is locked.',\n      '- staff.log_time \u2014 create one time entry.',\n      '- staff.start_timer / staff.stop_timer \u2014 begin and end a running timer.',\n      'Prefer the narrowest tool. If a read returns nothing after two different',\n      'ranges, say what you looked for and stop.',\n    ].join('\\n'),\n  },\n  {\n    name: 'attachments',\n    order: 5,\n    content: [\n      'ATTACHMENTS',\n      'This agent takes no attachments. If the operator attaches a file, say you',\n      'cannot read it here and point at the time-tracking screens.',\n    ].join('\\n'),\n  },\n  {\n    name: 'mutationPolicy',\n    order: 6,\n    content: [\n      'MUTATION POLICY',\n      'staff.log_time, staff.start_timer and staff.stop_timer are mutations. The',\n      'runtime short-circuits each call into an approval card; the write happens',\n      'only after the operator confirms it. Do NOT say the time was logged until a',\n      'mutation-result-card comes back \u2014 say you have prepared it for confirmation.',\n      'Never batch several days into one call hoping they slip through as one',\n      'approval; log one entry per call so each is reviewable.',\n      'If a per-tenant override has downgraded this agent to read-only, the runtime',\n      'refuses the call: tell the operator writes are locked for this tenant and',\n      'point at /backend/staff/time-tracking/timesheet.',\n    ].join('\\n'),\n  },\n  {\n    name: 'responseStyle',\n    order: 7,\n    content: [\n      'RESPONSE STYLE',\n      'Answer in hours and minutes, not raw minute counts: 450 minutes is \"7h 30m\".',\n      'Lead with the number the operator asked for, then the breakdown.',\n      'When you report missing days, list the dates plainly and offer to log them \u2014',\n      'one entry per confirmation.',\n      'Keep it short. A timesheet answer is two or three sentences plus a list.',\n    ].join('\\n'),\n  },\n]\n\nfunction compilePromptTemplate(template: PromptTemplate): string {\n  return template.sections\n    .slice()\n    .sort((left, right) => left.order - right.order)\n    .map((section) => section.content.trim())\n    .join('\\n\\n')\n}\n\nexport const promptTemplate: PromptTemplate = {\n  id: `${AGENT_ID}.prompt`,\n  sections: PROMPT_SECTIONS,\n}\n\nconst agent: AiAgentDefinition = {\n  id: AGENT_ID,\n  moduleId: MODULE_ID,\n  label: 'Time Tracking Assistant',\n  description:\n    'Logs your time, runs your timer, summarizes what you logged and finds the days you missed. Every write goes through the approval card.',\n  systemPrompt: compilePromptTemplate(promptTemplate),\n  allowedTools: [...ALLOWED_TOOLS],\n  executionMode: 'chat',\n  requiredFeatures: [...REQUIRED_FEATURES],\n  readOnly: false,\n  mutationPolicy: 'confirm-required',\n  keywords: ['time tracking', 'timesheet', 'timer', 'hours', 'timesheets'],\n  domain: 'staff',\n  dataCapabilities: {\n    entities: ['staff.staff_time_entry', 'staff.staff_time_project', 'staff.staff_time_report'],\n    operations: ['read'],\n  },\n  suggestions: [\n    { label: 'Summarize my week', prompt: 'Summarize the hours I logged this week, per project.' },\n    { label: 'Find missing days', prompt: 'Which working days this month have no time logged?' },\n  ],\n}\n\nexport const aiAgents: AiAgentDefinition[] = [agent]\n\nexport default aiAgents\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/ai-tools/time-tracking-pack.js

@@ -0,0 +1,348 @@
+import { z } from "zod";
+import { defineApiBackedAiTool } from "@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool";
+import {
+  assertTenantScope,
+  enumerateDates,
+  isWeekend,
+  resolveStaffToolScope,
+  toIsoDate,
+  toMinutes
+} from "./types.js";
+const VIEW_FEATURE = "staff.timesheets.view";
+const MANAGE_OWN_FEATURE = "staff.timesheets.manage_own";
+const REPORTS_VIEW_FEATURE = "staff.timesheets.reports.view";
+const isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Use a yyyy-mm-dd calendar date.");
+function readDate(row) {
+  return toIsoDate(row.date);
+}
+function readMinutes(row) {
+  const rounded = toMinutes(row.roundedMinutes);
+  if (rounded > 0) return rounded;
+  return toMinutes(row.durationMinutes ?? row.duration_minutes);
+}
+function readProjectId(row) {
+  const value = row.timeProjectId ?? row.time_project_id;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+const logTimeInput = z.object({
+  date: isoDate.describe("The calendar day the work happened, as yyyy-mm-dd."),
+  durationMinutes: z.number().int().min(1).max(1440).describe("How long the work took, in whole minutes (1\u20131440)."),
+  timeProjectId: z.string().uuid().optional().describe("Project the time belongs to. Omit for unassigned time."),
+  taskId: z.string().uuid().optional().describe("Task the time belongs to; the task carries its own project."),
+  notes: z.string().max(2e3).optional().describe("What was done. Shown to whoever reviews the timesheet."),
+  isBillable: z.boolean().optional().describe("Override the project default for whether the time is billable.")
+});
+const logTimeTool = defineApiBackedAiTool({
+  name: "staff.log_time",
+  displayName: "Log time",
+  description: "Create a time entry for the signed-in user. Mutation tool \u2014 the write is held for approval and shown as a preview card before it runs.",
+  inputSchema: logTimeInput,
+  requiredFeatures: [MANAGE_OWN_FEATURE],
+  isMutation: true,
+  loadBeforeRecord: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      recordId: `new:${scope.staffMemberId}:${input.date}`,
+      entityType: "staff.staff_time_entry",
+      recordVersion: null,
+      before: {},
+      after: {
+        date: input.date,
+        durationMinutes: input.durationMinutes,
+        timeProjectId: input.timeProjectId ?? null,
+        taskId: input.taskId ?? null,
+        notes: input.notes ?? null,
+        isBillable: input.isBillable ?? null
+      },
+      display: {
+        fieldLabels: {
+          date: "Date",
+          durationMinutes: "Minutes",
+          timeProjectId: "Project",
+          taskId: "Task",
+          notes: "Notes",
+          isBillable: "Billable"
+        }
+      }
+    };
+  },
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "POST",
+      path: "/staff/timesheets/time-entries",
+      body: {
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId,
+        staffMemberId: scope.staffMemberId,
+        date: input.date,
+        durationMinutes: input.durationMinutes,
+        ...input.timeProjectId ? { timeProjectId: input.timeProjectId } : {},
+        ...input.taskId ? { taskId: input.taskId } : {},
+        ...input.notes ? { notes: input.notes } : {},
+        ...input.isBillable === void 0 ? {} : { isBillable: input.isBillable }
+      }
+    };
+  },
+  mapResponse: (response, input) => ({
+    recordId: typeof response.data?.id === "string" ? response.data.id : null,
+    commandName: "staff.timesheets.time_entries.create",
+    before: {},
+    after: {
+      date: input.date,
+      durationMinutes: input.durationMinutes,
+      timeProjectId: input.timeProjectId ?? null,
+      taskId: input.taskId ?? null
+    }
+  })
+});
+const startTimerInput = z.object({
+  date: isoDate.optional().describe("Day to file the running timer under; defaults to today."),
+  timeProjectId: z.string().uuid().optional().describe("Project to start the timer against."),
+  taskId: z.string().uuid().optional().describe("Task to start the timer against; it carries its own project."),
+  notes: z.string().max(2e3).optional().describe("What the timer is for.")
+});
+const startTimerTool = defineApiBackedAiTool({
+  name: "staff.start_timer",
+  displayName: "Start timer",
+  description: "Start a running timer for the signed-in user. Mutation tool \u2014 held for approval before it runs.",
+  inputSchema: startTimerInput,
+  requiredFeatures: [MANAGE_OWN_FEATURE],
+  isMutation: true,
+  loadBeforeRecord: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    const date = input.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    return {
+      recordId: `timer:${scope.staffMemberId}:${date}`,
+      entityType: "staff.staff_time_entry",
+      recordVersion: null,
+      before: {},
+      after: {
+        date,
+        timeProjectId: input.timeProjectId ?? null,
+        taskId: input.taskId ?? null,
+        notes: input.notes ?? null
+      },
+      display: { fieldLabels: { date: "Date", timeProjectId: "Project", taskId: "Task", notes: "Notes" } }
+    };
+  },
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "POST",
+      path: "/staff/timesheets/time-entries/start-timer",
+      body: {
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId,
+        staffMemberId: scope.staffMemberId,
+        date: input.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+        ...input.timeProjectId ? { timeProjectId: input.timeProjectId } : {},
+        ...input.taskId ? { taskId: input.taskId } : {},
+        ...input.notes ? { notes: input.notes } : {}
+      }
+    };
+  },
+  mapResponse: (response, input) => ({
+    recordId: typeof response.data?.id === "string" ? response.data.id : null,
+    commandName: "staff.timesheets.time_entries.start_timer",
+    before: {},
+    after: { timeProjectId: input.timeProjectId ?? null, taskId: input.taskId ?? null }
+  })
+});
+const stopTimerInput = z.object({
+  timeEntryId: z.string().uuid().describe("The time entry whose running timer should be stopped.")
+});
+const stopTimerTool = defineApiBackedAiTool({
+  name: "staff.stop_timer",
+  displayName: "Stop timer",
+  description: "Stop the running timer on a time entry and freeze its duration. Mutation tool \u2014 held for approval before it runs.",
+  inputSchema: stopTimerInput,
+  requiredFeatures: [MANAGE_OWN_FEATURE],
+  isMutation: true,
+  loadBeforeRecord: async (input, ctx) => {
+    assertTenantScope(ctx);
+    return {
+      recordId: input.timeEntryId,
+      entityType: "staff.staff_time_entry",
+      recordVersion: null,
+      before: { timerRunning: true },
+      after: { timerRunning: false },
+      display: { fieldLabels: { timerRunning: "Timer running" } }
+    };
+  },
+  toOperation: async (input, ctx) => {
+    assertTenantScope(ctx);
+    return {
+      method: "POST",
+      path: `/staff/timesheets/time-entries/${input.timeEntryId}/timer-stop`,
+      body: {}
+    };
+  },
+  mapResponse: (response, input) => ({
+    recordId: input.timeEntryId,
+    commandName: "staff.timesheets.time_entries.stop_timer",
+    before: { timerRunning: true },
+    after: { timerRunning: false, durationMinutes: toMinutes(response.data?.durationMinutes) }
+  })
+});
+const summarizeWeekInput = z.object({
+  from: isoDate.describe("First day of the range, yyyy-mm-dd."),
+  to: isoDate.describe("Last day of the range, inclusive, yyyy-mm-dd.")
+});
+const summarizeWeekTool = defineApiBackedAiTool({
+  name: "staff.summarize_week",
+  displayName: "Summarize logged time",
+  description: "Summarize the signed-in user\u2019s logged time over a date range: totals per day and per project. Read-only. Returns minutes, never money.",
+  inputSchema: summarizeWeekInput,
+  requiredFeatures: [VIEW_FEATURE],
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "GET",
+      path: "/staff/timesheets/time-entries",
+      query: {
+        from: input.from,
+        to: input.to,
+        staffMemberId: scope.staffMemberId,
+        page: 1,
+        pageSize: 100
+      }
+    };
+  },
+  mapResponse: (response, input) => {
+    const items = Array.isArray(response.data?.items) ? response.data.items : [];
+    const byDate = /* @__PURE__ */ new Map();
+    const byProject = /* @__PURE__ */ new Map();
+    let totalMinutes = 0;
+    for (const row of items) {
+      const date = readDate(row);
+      const minutes = readMinutes(row);
+      totalMinutes += minutes;
+      if (date) byDate.set(date, (byDate.get(date) ?? 0) + minutes);
+      const projectKey = readProjectId(row) ?? "";
+      const bucket = byProject.get(projectKey) ?? { minutes: 0, entryCount: 0 };
+      bucket.minutes += minutes;
+      bucket.entryCount += 1;
+      byProject.set(projectKey, bucket);
+    }
+    return {
+      from: input.from,
+      to: input.to,
+      totalMinutes,
+      entryCount: items.length,
+      byDate: Array.from(byDate.entries()).map(([date, minutes]) => ({ date, minutes })).sort((left, right) => left.date.localeCompare(right.date)),
+      byProject: Array.from(byProject.entries()).map(([key, value]) => ({
+        timeProjectId: key.length > 0 ? key : null,
+        minutes: value.minutes,
+        entryCount: value.entryCount
+      }))
+    };
+  }
+});
+const findMissingDaysInput = z.object({
+  from: isoDate.describe("First day of the range, yyyy-mm-dd."),
+  to: isoDate.describe("Last day of the range, inclusive, yyyy-mm-dd."),
+  includeWeekends: z.boolean().optional().describe("Count Saturdays and Sundays as days that need time logged. Defaults to false.")
+});
+const findMissingDaysTool = defineApiBackedAiTool({
+  name: "staff.find_missing_days",
+  displayName: "Find days with no logged time",
+  description: "List the days in a range on which the signed-in user logged no time. Weekends are excluded unless asked for. Read-only.",
+  inputSchema: findMissingDaysInput,
+  requiredFeatures: [VIEW_FEATURE],
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "GET",
+      path: "/staff/timesheets/time-entries",
+      query: {
+        from: input.from,
+        to: input.to,
+        staffMemberId: scope.staffMemberId,
+        page: 1,
+        pageSize: 100
+      }
+    };
+  },
+  mapResponse: (response, input) => {
+    const items = Array.isArray(response.data?.items) ? response.data.items : [];
+    const logged = /* @__PURE__ */ new Set();
+    for (const row of items) {
+      const date = readDate(row);
+      if (date && readMinutes(row) > 0) logged.add(date);
+    }
+    const candidates = enumerateDates(input.from, input.to).filter(
+      (date) => (input.includeWeekends ?? false) || !isWeekend(date)
+    );
+    return {
+      from: input.from,
+      to: input.to,
+      missingDates: candidates.filter((date) => !logged.has(date)),
+      checkedDayCount: candidates.length
+    };
+  }
+});
+const draftClientReportInput = z.object({
+  timeProjectIds: z.array(z.string().uuid()).min(1).max(100).describe("Projects the report covers. They must all belong to the same customer."),
+  periodFrom: isoDate.describe("First day of the reported period, yyyy-mm-dd."),
+  periodTo: isoDate.describe("Last day of the reported period, inclusive, yyyy-mm-dd."),
+  customerId: z.string().uuid().optional().describe("Customer the report is for."),
+  grouping: z.string().optional().describe("Report grouping id, e.g. project_task, project_person or project_day."),
+  includeAlreadyReported: z.boolean().optional().describe("Include entries already frozen into an earlier report. Defaults to false.")
+});
+const draftClientReportTool = defineApiBackedAiTool({
+  name: "staff.draft_client_report",
+  displayName: "Draft a client report",
+  description: "Preview what a customer report would contain for a set of projects and a period, without creating one. Read-only \u2014 no report is written and nothing is locked. Amounts are omitted; ask the reports screen for money.",
+  inputSchema: draftClientReportInput,
+  requiredFeatures: [REPORTS_VIEW_FEATURE],
+  toOperation: async (input, ctx) => {
+    assertTenantScope(ctx);
+    return {
+      method: "POST",
+      path: "/staff/timesheets/reports/preview",
+      body: {
+        timeProjectIds: input.timeProjectIds,
+        periodFrom: input.periodFrom,
+        periodTo: input.periodTo,
+        periodKind: "custom",
+        ...input.customerId ? { customerId: input.customerId } : {},
+        ...input.grouping ? { grouping: input.grouping } : {},
+        includeAlreadyReported: input.includeAlreadyReported ?? false,
+        showRates: false
+      }
+    };
+  },
+  /**
+   * The preview response carries rates and amounts when the caller holds
+   * `staff.timesheets.rates.view`. The tool asks for `showRates: false` and then
+   * projects only the minute columns, so an agent transcript never becomes a
+   * second, ungated copy of the customer's rate card.
+   */
+  mapResponse: (response, input) => ({
+    periodFrom: input.periodFrom,
+    periodTo: input.periodTo,
+    grouping: typeof response.data?.grouping === "string" ? response.data.grouping : null,
+    projects: (response.data?.projects ?? []).map((project) => ({
+      id: typeof project.id === "string" ? project.id : null,
+      name: typeof project.name === "string" ? project.name : null,
+      billableMinutes: toMinutes(project.billableMinutes),
+      nonbillableMinutes: toMinutes(project.nonbillableMinutes),
+      entryCount: toMinutes(project.entryCount)
+    }))
+  })
+});
+const timeTrackingAiTools = [
+  logTimeTool,
+  startTimerTool,
+  stopTimerTool,
+  summarizeWeekTool,
+  findMissingDaysTool,
+  draftClientReportTool
+];
+var time_tracking_pack_default = timeTrackingAiTools;
+export {
+  time_tracking_pack_default as default,
+  timeTrackingAiTools
+};
+//# sourceMappingURL=time-tracking-pack.js.map

package/dist/modules/staff/ai-tools/time-tracking-pack.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/staff/ai-tools/time-tracking-pack.ts"],
+  "sourcesContent": ["/**\n * EP-49 \u2014 the time-tracking AI tool pack.\n *\n * Six tools, three of them writes. The write path is the platform's approval\n * contract, and the shape of that contract is the one thing worth stating\n * plainly here, because the spec described it inside out:\n *\n * A module tool does NOT call `prepareMutation`. `prepareMutation` is framework\n * code \u2014 its only call site is `agent-tools.ts` in `@open-mercato/ai-assistant`,\n * which intercepts the model's call, short-circuits the handler, persists an\n * `AiPendingAction` and returns a preview card. A tool opts into that by\n * declaring `isMutation: true` and a `loadBeforeRecord` resolver that renders the\n * diff; the agent opts in with `mutationPolicy: 'confirm-required'`. The handler\n * runs later, once, from the confirm route, with the stored input. Calling\n * `prepareMutation` from here would be calling the interceptor from inside the\n * thing it intercepts.\n *\n * Every tool is API-backed. `createAiApiOperationRunner` resolves the route from\n * the generated manifest and refuses to run a mutation route whose\n * `requiredFeatures` the tool does not itself declare, so the `staff.timesheets.*`\n * gate on each tool below is checked twice: once by the tool registry before the\n * handler, once by the runner against the route. The route then applies the\n * project-access intersection, the mutation guards, the interceptors and the\n * commands \u2014 none of which is reimplemented here.\n */\n\nimport { z } from 'zod'\nimport { defineApiBackedAiTool } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool'\nimport type {\n  AiApiOperationRequest,\n  AiToolExecutionContext,\n} from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport type { AiToolDefinition } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/types'\nimport {\n  assertTenantScope,\n  enumerateDates,\n  isWeekend,\n  resolveStaffToolScope,\n  toIsoDate,\n  toMinutes,\n} from './types'\n\nconst VIEW_FEATURE = 'staff.timesheets.view'\nconst MANAGE_OWN_FEATURE = 'staff.timesheets.manage_own'\nconst REPORTS_VIEW_FEATURE = 'staff.timesheets.reports.view'\n\nconst isoDate = z\n  .string()\n  .regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Use a yyyy-mm-dd calendar date.')\n\ntype EntryRow = {\n  id?: unknown\n  date?: unknown\n  durationMinutes?: unknown\n  duration_minutes?: unknown\n  roundedMinutes?: unknown\n  timeProjectId?: unknown\n  time_project_id?: unknown\n  projectName?: unknown\n  taskId?: unknown\n  notes?: unknown\n  isBillable?: unknown\n  is_billable?: unknown\n}\n\ntype EntriesApiResponse = {\n  items?: EntryRow[]\n  total?: number\n}\n\nfunction readDate(row: EntryRow): string | null {\n  return toIsoDate(row.date)\n}\n\nfunction readMinutes(row: EntryRow): number {\n  const rounded = toMinutes(row.roundedMinutes)\n  if (rounded > 0) return rounded\n  return toMinutes(row.durationMinutes ?? row.duration_minutes)\n}\n\nfunction readProjectId(row: EntryRow): string | null {\n  const value = row.timeProjectId ?? row.time_project_id\n  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null\n}\n\n/* ------------------------------------------------------------------ writes */\n\nconst logTimeInput = z.object({\n  date: isoDate.describe('The calendar day the work happened, as yyyy-mm-dd.'),\n  durationMinutes: z\n    .number()\n    .int()\n    .min(1)\n    .max(1440)\n    .describe('How long the work took, in whole minutes (1\u20131440).'),\n  timeProjectId: z.string().uuid().optional().describe('Project the time belongs to. Omit for unassigned time.'),\n  taskId: z.string().uuid().optional().describe('Task the time belongs to; the task carries its own project.'),\n  notes: z.string().max(2000).optional().describe('What was done. Shown to whoever reviews the timesheet.'),\n  isBillable: z.boolean().optional().describe('Override the project default for whether the time is billable.'),\n})\n\ntype LogTimeInput = z.infer<typeof logTimeInput>\n\nconst logTimeTool = defineApiBackedAiTool<LogTimeInput, { id?: string }, { recordId: string | null; commandName: string; before: Record<string, unknown>; after: Record<string, unknown> }>({\n  name: 'staff.log_time',\n  displayName: 'Log time',\n  description:\n    'Create a time entry for the signed-in user. Mutation tool \u2014 the write is held for approval and shown as a preview card before it runs.',\n  inputSchema: logTimeInput,\n  requiredFeatures: [MANAGE_OWN_FEATURE],\n  isMutation: true,\n  loadBeforeRecord: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx as unknown as AiToolExecutionContext)\n    return {\n      recordId: `new:${scope.staffMemberId}:${input.date}`,\n      entityType: 'staff.staff_time_entry',\n      recordVersion: null,\n      before: {},\n      after: {\n        date: input.date,\n        durationMinutes: input.durationMinutes,\n        timeProjectId: input.timeProjectId ?? null,\n        taskId: input.taskId ?? null,\n        notes: input.notes ?? null,\n        isBillable: input.isBillable ?? null,\n      },\n      display: {\n        fieldLabels: {\n          date: 'Date',\n          durationMinutes: 'Minutes',\n          timeProjectId: 'Project',\n          taskId: 'Task',\n          notes: 'Notes',\n          isBillable: 'Billable',\n        },\n      },\n    }\n  },\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'POST',\n      path: '/staff/timesheets/time-entries',\n      body: {\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n        staffMemberId: scope.staffMemberId,\n        date: input.date,\n        durationMinutes: input.durationMinutes,\n        ...(input.timeProjectId ? { timeProjectId: input.timeProjectId } : {}),\n        ...(input.taskId ? { taskId: input.taskId } : {}),\n        ...(input.notes ? { notes: input.notes } : {}),\n        ...(input.isBillable === undefined ? {} : { isBillable: input.isBillable }),\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => ({\n    recordId: typeof response.data?.id === 'string' ? response.data.id : null,\n    commandName: 'staff.timesheets.time_entries.create',\n    before: {},\n    after: {\n      date: input.date,\n      durationMinutes: input.durationMinutes,\n      timeProjectId: input.timeProjectId ?? null,\n      taskId: input.taskId ?? null,\n    },\n  }),\n}) as unknown as AiToolDefinition\n\nconst startTimerInput = z.object({\n  date: isoDate.optional().describe('Day to file the running timer under; defaults to today.'),\n  timeProjectId: z.string().uuid().optional().describe('Project to start the timer against.'),\n  taskId: z.string().uuid().optional().describe('Task to start the timer against; it carries its own project.'),\n  notes: z.string().max(2000).optional().describe('What the timer is for.'),\n})\n\ntype StartTimerInput = z.infer<typeof startTimerInput>\n\nconst startTimerTool = defineApiBackedAiTool<StartTimerInput, { id?: string | null }, { recordId: string | null; commandName: string; before: Record<string, unknown>; after: Record<string, unknown> }>({\n  name: 'staff.start_timer',\n  displayName: 'Start timer',\n  description:\n    'Start a running timer for the signed-in user. Mutation tool \u2014 held for approval before it runs.',\n  inputSchema: startTimerInput,\n  requiredFeatures: [MANAGE_OWN_FEATURE],\n  isMutation: true,\n  loadBeforeRecord: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx as unknown as AiToolExecutionContext)\n    const date = input.date ?? new Date().toISOString().slice(0, 10)\n    return {\n      recordId: `timer:${scope.staffMemberId}:${date}`,\n      entityType: 'staff.staff_time_entry',\n      recordVersion: null,\n      before: {},\n      after: {\n        date,\n        timeProjectId: input.timeProjectId ?? null,\n        taskId: input.taskId ?? null,\n        notes: input.notes ?? null,\n      },\n      display: { fieldLabels: { date: 'Date', timeProjectId: 'Project', taskId: 'Task', notes: 'Notes' } },\n    }\n  },\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'POST',\n      path: '/staff/timesheets/time-entries/start-timer',\n      body: {\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n        staffMemberId: scope.staffMemberId,\n        date: input.date ?? new Date().toISOString().slice(0, 10),\n        ...(input.timeProjectId ? { timeProjectId: input.timeProjectId } : {}),\n        ...(input.taskId ? { taskId: input.taskId } : {}),\n        ...(input.notes ? { notes: input.notes } : {}),\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => ({\n    recordId: typeof response.data?.id === 'string' ? response.data.id : null,\n    commandName: 'staff.timesheets.time_entries.start_timer',\n    before: {},\n    after: { timeProjectId: input.timeProjectId ?? null, taskId: input.taskId ?? null },\n  }),\n}) as unknown as AiToolDefinition\n\nconst stopTimerInput = z.object({\n  timeEntryId: z.string().uuid().describe('The time entry whose running timer should be stopped.'),\n})\n\ntype StopTimerInput = z.infer<typeof stopTimerInput>\n\nconst stopTimerTool = defineApiBackedAiTool<StopTimerInput, { durationMinutes?: number }, { recordId: string; commandName: string; before: Record<string, unknown>; after: Record<string, unknown> }>({\n  name: 'staff.stop_timer',\n  displayName: 'Stop timer',\n  description:\n    'Stop the running timer on a time entry and freeze its duration. Mutation tool \u2014 held for approval before it runs.',\n  inputSchema: stopTimerInput,\n  requiredFeatures: [MANAGE_OWN_FEATURE],\n  isMutation: true,\n  loadBeforeRecord: async (input, ctx) => {\n    assertTenantScope(ctx as unknown as AiToolExecutionContext)\n    return {\n      recordId: input.timeEntryId,\n      entityType: 'staff.staff_time_entry',\n      recordVersion: null,\n      before: { timerRunning: true },\n      after: { timerRunning: false },\n      display: { fieldLabels: { timerRunning: 'Timer running' } },\n    }\n  },\n  toOperation: async (input, ctx) => {\n    assertTenantScope(ctx)\n    return {\n      method: 'POST',\n      path: `/staff/timesheets/time-entries/${input.timeEntryId}/timer-stop`,\n      body: {},\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => ({\n    recordId: input.timeEntryId,\n    commandName: 'staff.timesheets.time_entries.stop_timer',\n    before: { timerRunning: true },\n    after: { timerRunning: false, durationMinutes: toMinutes(response.data?.durationMinutes) },\n  }),\n}) as unknown as AiToolDefinition\n\n/* ------------------------------------------------------------------- reads */\n\nconst summarizeWeekInput = z.object({\n  from: isoDate.describe('First day of the range, yyyy-mm-dd.'),\n  to: isoDate.describe('Last day of the range, inclusive, yyyy-mm-dd.'),\n})\n\ntype SummarizeWeekInput = z.infer<typeof summarizeWeekInput>\n\nconst summarizeWeekTool = defineApiBackedAiTool<\n  SummarizeWeekInput,\n  EntriesApiResponse,\n  {\n    from: string\n    to: string\n    totalMinutes: number\n    entryCount: number\n    byDate: Array<{ date: string; minutes: number }>\n    byProject: Array<{ timeProjectId: string | null; minutes: number; entryCount: number }>\n  }\n>({\n  name: 'staff.summarize_week',\n  displayName: 'Summarize logged time',\n  description:\n    'Summarize the signed-in user\u2019s logged time over a date range: totals per day and per project. Read-only. Returns minutes, never money.',\n  inputSchema: summarizeWeekInput,\n  requiredFeatures: [VIEW_FEATURE],\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'GET',\n      path: '/staff/timesheets/time-entries',\n      query: {\n        from: input.from,\n        to: input.to,\n        staffMemberId: scope.staffMemberId,\n        page: 1,\n        pageSize: 100,\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => {\n    const items = Array.isArray(response.data?.items) ? response.data.items : []\n    const byDate = new Map<string, number>()\n    const byProject = new Map<string, { minutes: number; entryCount: number }>()\n    let totalMinutes = 0\n    for (const row of items) {\n      const date = readDate(row)\n      const minutes = readMinutes(row)\n      totalMinutes += minutes\n      if (date) byDate.set(date, (byDate.get(date) ?? 0) + minutes)\n      const projectKey = readProjectId(row) ?? ''\n      const bucket = byProject.get(projectKey) ?? { minutes: 0, entryCount: 0 }\n      bucket.minutes += minutes\n      bucket.entryCount += 1\n      byProject.set(projectKey, bucket)\n    }\n    return {\n      from: input.from,\n      to: input.to,\n      totalMinutes,\n      entryCount: items.length,\n      byDate: Array.from(byDate.entries())\n        .map(([date, minutes]) => ({ date, minutes }))\n        .sort((left, right) => left.date.localeCompare(right.date)),\n      byProject: Array.from(byProject.entries()).map(([key, value]) => ({\n        timeProjectId: key.length > 0 ? key : null,\n        minutes: value.minutes,\n        entryCount: value.entryCount,\n      })),\n    }\n  },\n}) as unknown as AiToolDefinition\n\nconst findMissingDaysInput = z.object({\n  from: isoDate.describe('First day of the range, yyyy-mm-dd.'),\n  to: isoDate.describe('Last day of the range, inclusive, yyyy-mm-dd.'),\n  includeWeekends: z\n    .boolean()\n    .optional()\n    .describe('Count Saturdays and Sundays as days that need time logged. Defaults to false.'),\n})\n\ntype FindMissingDaysInput = z.infer<typeof findMissingDaysInput>\n\nconst findMissingDaysTool = defineApiBackedAiTool<\n  FindMissingDaysInput,\n  EntriesApiResponse,\n  { from: string; to: string; missingDates: string[]; checkedDayCount: number }\n>({\n  name: 'staff.find_missing_days',\n  displayName: 'Find days with no logged time',\n  description:\n    'List the days in a range on which the signed-in user logged no time. Weekends are excluded unless asked for. Read-only.',\n  inputSchema: findMissingDaysInput,\n  requiredFeatures: [VIEW_FEATURE],\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'GET',\n      path: '/staff/timesheets/time-entries',\n      query: {\n        from: input.from,\n        to: input.to,\n        staffMemberId: scope.staffMemberId,\n        page: 1,\n        pageSize: 100,\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => {\n    const items = Array.isArray(response.data?.items) ? response.data.items : []\n    const logged = new Set<string>()\n    for (const row of items) {\n      const date = readDate(row)\n      if (date && readMinutes(row) > 0) logged.add(date)\n    }\n    const candidates = enumerateDates(input.from, input.to).filter(\n      (date) => (input.includeWeekends ?? false) || !isWeekend(date),\n    )\n    return {\n      from: input.from,\n      to: input.to,\n      missingDates: candidates.filter((date) => !logged.has(date)),\n      checkedDayCount: candidates.length,\n    }\n  },\n}) as unknown as AiToolDefinition\n\nconst draftClientReportInput = z.object({\n  timeProjectIds: z\n    .array(z.string().uuid())\n    .min(1)\n    .max(100)\n    .describe('Projects the report covers. They must all belong to the same customer.'),\n  periodFrom: isoDate.describe('First day of the reported period, yyyy-mm-dd.'),\n  periodTo: isoDate.describe('Last day of the reported period, inclusive, yyyy-mm-dd.'),\n  customerId: z.string().uuid().optional().describe('Customer the report is for.'),\n  grouping: z\n    .string()\n    .optional()\n    .describe('Report grouping id, e.g. project_task, project_person or project_day.'),\n  includeAlreadyReported: z\n    .boolean()\n    .optional()\n    .describe('Include entries already frozen into an earlier report. Defaults to false.'),\n})\n\ntype DraftClientReportInput = z.infer<typeof draftClientReportInput>\n\ntype PreviewApiResponse = {\n  currencyCode?: unknown\n  grouping?: unknown\n  projects?: Array<{\n    id?: unknown\n    name?: unknown\n    entryCount?: unknown\n    billableMinutes?: unknown\n    nonbillableMinutes?: unknown\n  }>\n  totals?: unknown\n}\n\nconst draftClientReportTool = defineApiBackedAiTool<\n  DraftClientReportInput,\n  PreviewApiResponse,\n  {\n    periodFrom: string\n    periodTo: string\n    grouping: string | null\n    projects: Array<{ id: string | null; name: string | null; billableMinutes: number; nonbillableMinutes: number; entryCount: number }>\n  }\n>({\n  name: 'staff.draft_client_report',\n  displayName: 'Draft a client report',\n  description:\n    'Preview what a customer report would contain for a set of projects and a period, without creating one. Read-only \u2014 no report is written and nothing is locked. Amounts are omitted; ask the reports screen for money.',\n  inputSchema: draftClientReportInput,\n  requiredFeatures: [REPORTS_VIEW_FEATURE],\n  toOperation: async (input, ctx) => {\n    assertTenantScope(ctx)\n    return {\n      method: 'POST',\n      path: '/staff/timesheets/reports/preview',\n      body: {\n        timeProjectIds: input.timeProjectIds,\n        periodFrom: input.periodFrom,\n        periodTo: input.periodTo,\n        periodKind: 'custom',\n        ...(input.customerId ? { customerId: input.customerId } : {}),\n        ...(input.grouping ? { grouping: input.grouping } : {}),\n        includeAlreadyReported: input.includeAlreadyReported ?? false,\n        showRates: false,\n      },\n    } satisfies AiApiOperationRequest\n  },\n  /**\n   * The preview response carries rates and amounts when the caller holds\n   * `staff.timesheets.rates.view`. The tool asks for `showRates: false` and then\n   * projects only the minute columns, so an agent transcript never becomes a\n   * second, ungated copy of the customer's rate card.\n   */\n  mapResponse: (response, input) => ({\n    periodFrom: input.periodFrom,\n    periodTo: input.periodTo,\n    grouping: typeof response.data?.grouping === 'string' ? response.data.grouping : null,\n    projects: (response.data?.projects ?? []).map((project) => ({\n      id: typeof project.id === 'string' ? project.id : null,\n      name: typeof project.name === 'string' ? project.name : null,\n      billableMinutes: toMinutes(project.billableMinutes),\n      nonbillableMinutes: toMinutes(project.nonbillableMinutes),\n      entryCount: toMinutes(project.entryCount),\n    })),\n  }),\n}) as unknown as AiToolDefinition\n\nexport const timeTrackingAiTools: AiToolDefinition[] = [\n  logTimeTool,\n  startTimerTool,\n  stopTimerTool,\n  summarizeWeekTool,\n  findMissingDaysTool,\n  draftClientReportTool,\n]\n\nexport default timeTrackingAiTools\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/ai-tools/types.js

@@ -0,0 +1,54 @@
+import { getStaffMemberByUserId } from "../lib/staffMemberResolver.js";
+function assertTenantScope(ctx) {
+  if (!ctx.tenantId) throw new Error("[internal] Tenant context is required for staff.* tools");
+  if (!ctx.organizationId) {
+    throw new Error("[internal] Organization context is required for staff.* tools");
+  }
+  return { tenantId: ctx.tenantId, organizationId: ctx.organizationId };
+}
+async function resolveStaffToolScope(ctx) {
+  const { tenantId, organizationId } = assertTenantScope(ctx);
+  if (!ctx.userId) throw new Error("[internal] User context is required for staff.* tools");
+  const container = ctx.container;
+  const em = container.resolve("em").fork();
+  const member = await getStaffMemberByUserId(em, ctx.userId, tenantId, organizationId);
+  if (!member) {
+    throw new Error("The signed-in user has no staff profile, so time cannot be logged for them.");
+  }
+  return { tenantId, organizationId, staffMemberId: member.id };
+}
+function toIsoDate(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return value.toISOString().slice(0, 10);
+  }
+  if (typeof value === "string" && value.trim().length > 0) return value.trim().slice(0, 10);
+  return null;
+}
+function toMinutes(value) {
+  const parsed = typeof value === "number" ? value : Number(value ?? 0);
+  return Number.isFinite(parsed) ? Math.trunc(parsed) : 0;
+}
+function enumerateDates(from, to) {
+  const start = Date.parse(`${from}T00:00:00Z`);
+  const end = Date.parse(`${to}T00:00:00Z`);
+  if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) return [];
+  const dates = [];
+  for (let cursor = start; cursor <= end && dates.length < 366; cursor += 864e5) {
+    dates.push(new Date(cursor).toISOString().slice(0, 10));
+  }
+  return dates;
+}
+function isWeekend(date) {
+  const day = (/* @__PURE__ */ new Date(`${date}T00:00:00Z`)).getUTCDay();
+  return day === 0 || day === 6;
+}
+export {
+  assertTenantScope,
+  enumerateDates,
+  isWeekend,
+  resolveStaffToolScope,
+  toIsoDate,
+  toMinutes
+};
+//# sourceMappingURL=types.js.map

package/dist/modules/staff/ai-tools/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/staff/ai-tools/types.ts"],
+  "sourcesContent": ["import type { AwilixContainer } from 'awilix'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AiToolExecutionContext } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport { getStaffMemberByUserId } from '../lib/staffMemberResolver'\n\n/**\n * EP-49. Shared context helpers for the time-tracking AI tool pack.\n *\n * Every tool in the pack is API-backed: it re-uses a documented\n * `/api/staff/timesheets/*` route through `createAiApiOperationRunner`, which\n * resolves the route from the generated manifest, refuses a mutation route whose\n * `requiredFeatures` are not covered by the tool's own, and invokes the handler\n * in process with the caller's identity. So the tools inherit \u2014 rather than\n * restate \u2014 the project-access intersection, the money gate, the mutation guards,\n * the interceptors and the commands' audit and undo. Nothing here writes a time\n * entry itself.\n */\n\nexport type StaffToolScope = {\n  tenantId: string\n  organizationId: string\n  staffMemberId: string\n}\n\nexport function assertTenantScope(ctx: AiToolExecutionContext): {\n  tenantId: string\n  organizationId: string\n} {\n  if (!ctx.tenantId) throw new Error('[internal] Tenant context is required for staff.* tools')\n  if (!ctx.organizationId) {\n    throw new Error('[internal] Organization context is required for staff.* tools')\n  }\n  return { tenantId: ctx.tenantId, organizationId: ctx.organizationId }\n}\n\n/**\n * The pack is written for \"log MY time\": every tool acts as the caller's own\n * staff member and none of them accepts a `staffMemberId` from the model. A user\n * with no staff profile is refused rather than defaulted to somebody else.\n */\nexport async function resolveStaffToolScope(ctx: AiToolExecutionContext): Promise<StaffToolScope> {\n  const { tenantId, organizationId } = assertTenantScope(ctx)\n  if (!ctx.userId) throw new Error('[internal] User context is required for staff.* tools')\n  const container = ctx.container as AwilixContainer\n  const em = (container.resolve('em') as EntityManager).fork()\n  const member = await getStaffMemberByUserId(em, ctx.userId, tenantId, organizationId)\n  if (!member) {\n    throw new Error('The signed-in user has no staff profile, so time cannot be logged for them.')\n  }\n  return { tenantId, organizationId, staffMemberId: member.id }\n}\n\nexport function toIsoDate(value: unknown): string | null {\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) return null\n    return value.toISOString().slice(0, 10)\n  }\n  if (typeof value === 'string' && value.trim().length > 0) return value.trim().slice(0, 10)\n  return null\n}\n\nexport function toMinutes(value: unknown): number {\n  const parsed = typeof value === 'number' ? value : Number(value ?? 0)\n  return Number.isFinite(parsed) ? Math.trunc(parsed) : 0\n}\n\n/** Inclusive `yyyy-mm-dd` walk; caps at a year so a bad range cannot build an unbounded array. */\nexport function enumerateDates(from: string, to: string): string[] {\n  const start = Date.parse(`${from}T00:00:00Z`)\n  const end = Date.parse(`${to}T00:00:00Z`)\n  if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) return []\n  const dates: string[] = []\n  for (let cursor = start; cursor <= end && dates.length < 366; cursor += 86_400_000) {\n    dates.push(new Date(cursor).toISOString().slice(0, 10))\n  }\n  return dates\n}\n\nexport function isWeekend(date: string): boolean {\n  const day = new Date(`${date}T00:00:00Z`).getUTCDay()\n  return day === 0 || day === 6\n}\n"],
+  "mappings": "AAGA,SAAS,8BAA8B;AAqBhC,SAAS,kBAAkB,KAGhC;AACA,MAAI,CAAC,IAAI,SAAU,OAAM,IAAI,MAAM,yDAAyD;AAC5F,MAAI,CAAC,IAAI,gBAAgB;AACvB,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,SAAO,EAAE,UAAU,IAAI,UAAU,gBAAgB,IAAI,eAAe;AACtE;AAOA,eAAsB,sBAAsB,KAAsD;AAChG,QAAM,EAAE,UAAU,eAAe,IAAI,kBAAkB,GAAG;AAC1D,MAAI,CAAC,IAAI,OAAQ,OAAM,IAAI,MAAM,uDAAuD;AACxF,QAAM,YAAY,IAAI;AACtB,QAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAC3D,QAAM,SAAS,MAAM,uBAAuB,IAAI,IAAI,QAAQ,UAAU,cAAc;AACpF,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,6EAA6E;AAAA,EAC/F;AACA,SAAO,EAAE,UAAU,gBAAgB,eAAe,OAAO,GAAG;AAC9D;AAEO,SAAS,UAAU,OAA+B;AACvD,MAAI,iBAAiB,MAAM;AACzB,QAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,EAAG,QAAO;AAC1C,WAAO,MAAM,YAAY,EAAE,MAAM,GAAG,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,EAAG,QAAO,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACzF,SAAO;AACT;AAEO,SAAS,UAAU,OAAwB;AAChD,QAAM,SAAS,OAAO,UAAU,WAAW,QAAQ,OAAO,SAAS,CAAC;AACpE,SAAO,OAAO,SAAS,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI;AACxD;AAGO,SAAS,eAAe,MAAc,IAAsB;AACjE,QAAM,QAAQ,KAAK,MAAM,GAAG,IAAI,YAAY;AAC5C,QAAM,MAAM,KAAK,MAAM,GAAG,EAAE,YAAY;AACxC,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,SAAS,GAAG,KAAK,MAAM,MAAO,QAAO,CAAC;AAC7E,QAAM,QAAkB,CAAC;AACzB,WAAS,SAAS,OAAO,UAAU,OAAO,MAAM,SAAS,KAAK,UAAU,OAAY;AAClF,UAAM,KAAK,IAAI,KAAK,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA,EACxD;AACA,SAAO;AACT;AAEO,SAAS,UAAU,MAAuB;AAC/C,QAAM,OAAM,oBAAI,KAAK,GAAG,IAAI,YAAY,GAAE,UAAU;AACpD,SAAO,QAAQ,KAAK,QAAQ;AAC9B;",
+  "names": []
+}