Merge pull request #58 from amol-anand/inject-datetime

feat: add user's timezone to the agent context

Author: mhaack

src/prompt-builder.ts

@@ -257,10 +257,13 @@ The user is currently working on the following document in DA (Document Authorin
 - site (repo): ${pageContext.site}
 - path: ${ensureHtmlExtension(pageContext.path)}
 - view: ${pageContext.view}
+- user's local time zone: ${pageContext.timeZone ?? 'unknown'}
 - Live Preview URL: https://main--${pageContext.site}--${pageContext.org}.${environment === 'production' || !environment ? 'preview.da.live' : 'stage-preview.da.live'}${pathForUrl}
 - Previewed URL: https://main--${pageContext.site}--${pageContext.org}.aem.page${pathForUrl}
 - Published URL: https://main--${pageContext.site}--${pageContext.org}.aem.live${pathForUrl}
 
+Use the user's local time zone above when interpreting relative dates/times (e.g. "today", "next Monday") or converting timestamps for display — including when calling any date/time tool — unless the user specifies otherwise.
+
 **URL freshness rules:**
 - The **Live Preview URL** always reflects the current state of the document as it appears right now in DA — no operation needed.
 - The **Previewed URL** only reflects the latest content after a **preview** operation has been performed; otherwise it is outdated.

src/request-schemas.ts

@@ -5,6 +5,7 @@ export const PageContextSchema = z.object({
   site: z.string(),
   path: z.string().optional().default(''),
   view: z.string().optional(),
+  timeZone: z.string().optional(),
 });
 
 export type PageContext = z.infer<typeof PageContextSchema>;

test/prompt-builder.test.ts

@@ -53,6 +53,16 @@ describe('buildSystemPrompt with pageContext', () => {
     expect(prompt).toContain('/index.html');
   });
 
+  it('includes user time zone when present', () => {
+    const prompt = buildSystemPrompt({ ...pageContext, timeZone: 'America/New_York' });
+    expect(prompt).toContain('America/New_York');
+  });
+
+  it('shows unknown time zone when absent', () => {
+    const prompt = buildSystemPrompt(pageContext);
+    expect(prompt).toContain("user's local time zone: unknown");
+  });
+
   it('includes live preview URL', () => {
     const prompt = buildSystemPrompt(
       pageContext,

test/request-schemas.test.ts

@@ -23,6 +23,17 @@ describe('PageContextSchema', () => {
     expect(result.data?.view).toBe('edit');
   });
 
+  it('accepts optional timeZone field', () => {
+    const result = PageContextSchema.safeParse({
+      org: 'adobe',
+      site: 'docs',
+      path: '/index.html',
+      timeZone: 'America/New_York',
+    });
+    expect(result.success).toBe(true);
+    expect(result.data?.timeZone).toBe('America/New_York');
+  });
+
   it('rejects missing org', () => {
     const result = PageContextSchema.safeParse({ site: 'docs', path: '/index.html' });
     expect(result.success).toBe(false);