@openshain/core 0.4.0 → 0.4.1

package/dist/config/schema.d.ts

@@ -11,6 +11,7 @@ export declare const ConfigFileSchema: z.ZodObject<{
             en: "en";
             ja: "ja";
         }>>;
+        timezone: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
     principal: z.ZodObject<{
         id: z.ZodString;
@@ -63,6 +64,7 @@ export interface Config {
     company: {
         name: string;
         language: Language;
+        timezone: string;
     };
     principal: {
         id: string;

package/dist/config/schema.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { hostTimezone, isTimezone } from "../time.js";
 const identifier = z
     .string()
     .regex(/^[a-z][a-z0-9_-]*$/, "use lowercase letters, digits, _ or -, starting with a letter");
@@ -35,6 +36,16 @@ export const ConfigFileSchema = z.strictObject({
     company: z.strictObject({
         name: z.string().min(1).max(200),
         language: z.enum(LANGUAGES).default("ja"),
+        // The company's own clock decides every business date, so a workspace answers the same
+        // whether it runs on a laptop in Tokyo or in a container set to UTC.
+        // No default in the schema: it would bake the machine that generated it into the published
+        // JSON Schema. The fallback is applied when the file is turned into a Config.
+        timezone: z
+            .string()
+            .min(1)
+            .max(100)
+            .refine(isTimezone, "not a timezone name, such as Asia/Tokyo")
+            .optional(),
     }),
     principal: z.strictObject({ id: identifier, name: z.string().min(1).max(200) }),
     profession: z.strictObject({ id: identifier, instructions: z.string().min(1).max(100_000) }),
@@ -70,7 +81,11 @@ export const ConfigFileSchema = z.strictObject({
 export function toConfig(file) {
     return {
         version: file.version,
-        company: { name: file.company.name, language: file.company.language },
+        company: {
+            name: file.company.name,
+            language: file.company.language,
+            timezone: file.company.timezone ?? hostTimezone(),
+        },
         principal: { id: file.principal.id, name: file.principal.name },
         profession: { id: file.profession.id, instructions: file.profession.instructions },
         ...(file.model && {

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { type EventId, newEventId, newWorkId, parseEventId, parseWorkId, type Wo
 export type { ModelDescription, ModelMessage, ModelProvider, ModelRequest, ModelResponse, UserPart, } from "./model/types.ts";
 export { type CallOptions, type CreateRuntimeOptions, createRuntime, createToolCaller, createToolRegistry, MAX_TOOL_TEXT_CHARS, type PendingApprovalResult, REVIEW_DIR_NAME, type Runtime, type RuntimeProviders, type ToolSummary, } from "./runtime.ts";
 export { jsonSchemas, type SchemaName } from "./schemas.ts";
+export { businessDate, companyTime, hostTimezone, isTimezone } from "./time.ts";
 export { ASK_USER, RUNTIME_PROVIDER_ID } from "./tool/ask-user.ts";
 export { loadToolModule } from "./tool/load-module.ts";
 export { RESERVED_PATHS, resolveWorkspacePath } from "./tool/paths.ts";

package/dist/index.js

@@ -6,6 +6,7 @@ export { ERROR_CODES, isOpenshainError, OpenshainError } from "./errors.js";
 export { newEventId, newWorkId, parseEventId, parseWorkId, } from "./ids.js";
 export { createRuntime, createToolCaller, createToolRegistry, MAX_TOOL_TEXT_CHARS, REVIEW_DIR_NAME, } from "./runtime.js";
 export { jsonSchemas } from "./schemas.js";
+export { businessDate, companyTime, hostTimezone, isTimezone } from "./time.js";
 export { ASK_USER, RUNTIME_PROVIDER_ID } from "./tool/ask-user.js";
 export { loadToolModule } from "./tool/load-module.js";
 export { RESERVED_PATHS, resolveWorkspacePath } from "./tool/paths.js";

package/dist/runtime.js

@@ -3,6 +3,7 @@ import { join } from "node:path";
 import { evaluate, loadAuthority, OPEN_AUTHORITY, } from "./authority/policy.js";
 import { loadConfig } from "./config/load.js";
 import { isOpenshainError, OpenshainError } from "./errors.js";
+import { businessDate } from "./time.js";
 import { loadToolModule } from "./tool/load-module.js";
 import { ToolRegistry } from "./tool/registry.js";
 import { uuidv7 } from "./uuid.js";
@@ -112,7 +113,7 @@ async function callTool(input) {
             principal: config.principal.id,
             profession: config.profession.id,
             workType: (await work.current()).type,
-            businessDate: businessDate(),
+            businessDate: businessDate(config.company.timezone),
         });
         if (judged.kind === "deny")
             return reject("denied", judged.reason);
@@ -264,11 +265,6 @@ function pathOf(input) {
     return segments.join("/");
 }
 /** Today's date on this machine's clock, YYYY-MM-DD. */
-function businessDate() {
-    const now = new Date();
-    const pad = (n) => String(n).padStart(2, "0");
-    return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
-}
 function isRejectionCode(code) {
     return TOOL_REJECTION_CODES.includes(code);
 }

package/dist/time.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The company's clock. Every date the runtime judges against — a decision's effective days, a
+ * delegation's validity — is a date in the company's timezone, not in the host's. A workspace
+ * carried between a laptop in Tokyo and a container in UTC has to answer the same question the
+ * same way, so the timezone is part of the configuration rather than the environment.
+ */
+/** True when the name is a timezone this runtime knows (`Asia/Tokyo`, `UTC`, ...). */
+export declare function isTimezone(name: string): boolean;
+/** The timezone of the machine, used when the configuration names none. */
+export declare function hostTimezone(): string;
+/** The business date (`YYYY-MM-DD`) in the company's timezone. */
+export declare function businessDate(timezone: string, at?: Date): string;
+/** The moment as the company reads it: `2026-09-09T14:03:11+09:00`. */
+export declare function companyTime(timezone: string, at?: Date): string;

package/dist/time.js

@@ -0,0 +1,50 @@
+/**
+ * The company's clock. Every date the runtime judges against — a decision's effective days, a
+ * delegation's validity — is a date in the company's timezone, not in the host's. A workspace
+ * carried between a laptop in Tokyo and a container in UTC has to answer the same question the
+ * same way, so the timezone is part of the configuration rather than the environment.
+ */
+/** True when the name is a timezone this runtime knows (`Asia/Tokyo`, `UTC`, ...). */
+export function isTimezone(name) {
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: name });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The timezone of the machine, used when the configuration names none. */
+export function hostTimezone() {
+    const name = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return name && isTimezone(name) ? name : "UTC";
+}
+/** The business date (`YYYY-MM-DD`) in the company's timezone. */
+export function businessDate(timezone, at = new Date()) {
+    // en-CA writes a date as YYYY-MM-DD.
+    return new Intl.DateTimeFormat("en-CA", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    }).format(at);
+}
+/** The moment as the company reads it: `2026-09-09T14:03:11+09:00`. */
+export function companyTime(timezone, at = new Date()) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+        timeZone: timezone,
+        hour12: false,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        timeZoneName: "longOffset",
+    }).formatToParts(at);
+    const of = (type) => parts.find((part) => part.type === type)?.value ?? "";
+    // "GMT+09:00" for a zone with an offset, "GMT" for UTC itself.
+    const zone = of("timeZoneName").replace("GMT", "");
+    const hour = of("hour") === "24" ? "00" : of("hour");
+    return `${of("year")}-${of("month")}-${of("day")}T${hour}:${of("minute")}:${of("second")}${zone === "" ? "+00:00" : zone}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openshain/core",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Contracts (provider interfaces), fundamental objects, and the work runtime",
   "keywords": [
     "openshain",

package/src/config/schema.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { hostTimezone, isTimezone } from "../time.ts";
 
 const identifier = z
   .string()
@@ -43,6 +44,16 @@ export const ConfigFileSchema = z.strictObject({
   company: z.strictObject({
     name: z.string().min(1).max(200),
     language: z.enum(LANGUAGES).default("ja"),
+    // The company's own clock decides every business date, so a workspace answers the same
+    // whether it runs on a laptop in Tokyo or in a container set to UTC.
+    // No default in the schema: it would bake the machine that generated it into the published
+    // JSON Schema. The fallback is applied when the file is turned into a Config.
+    timezone: z
+      .string()
+      .min(1)
+      .max(100)
+      .refine(isTimezone, "not a timezone name, such as Asia/Tokyo")
+      .optional(),
   }),
   principal: z.strictObject({ id: identifier, name: z.string().min(1).max(200) }),
   profession: z.strictObject({ id: identifier, instructions: z.string().min(1).max(100_000) }),
@@ -96,7 +107,7 @@ export interface ModelConfig {
 
 export interface Config {
   version: 1;
-  company: { name: string; language: Language };
+  company: { name: string; language: Language; timezone: string };
   principal: { id: string; name: string };
   profession: { id: string; instructions: string };
   /** The model the interactive CLI runs on. Absent when the workspace is used from other agents only. */
@@ -109,7 +120,11 @@ export interface Config {
 export function toConfig(file: ConfigFile): Config {
   return {
     version: file.version,
-    company: { name: file.company.name, language: file.company.language },
+    company: {
+      name: file.company.name,
+      language: file.company.language,
+      timezone: file.company.timezone ?? hostTimezone(),
+    },
     principal: { id: file.principal.id, name: file.principal.name },
     profession: { id: file.profession.id, instructions: file.profession.instructions },
     ...(file.model && {

package/src/index.ts

@@ -62,6 +62,7 @@ export {
   type ToolSummary,
 } from "./runtime.ts";
 export { jsonSchemas, type SchemaName } from "./schemas.ts";
+export { businessDate, companyTime, hostTimezone, isTimezone } from "./time.ts";
 export { ASK_USER, RUNTIME_PROVIDER_ID } from "./tool/ask-user.ts";
 export { loadToolModule } from "./tool/load-module.ts";
 export { RESERVED_PATHS, resolveWorkspacePath } from "./tool/paths.ts";

package/src/runtime.ts

@@ -11,6 +11,7 @@ import { loadConfig } from "./config/load.ts";
 import type { Config, ModelConfig } from "./config/schema.ts";
 import { isOpenshainError, OpenshainError } from "./errors.ts";
 import type { ModelProvider } from "./model/types.ts";
+import { businessDate } from "./time.ts";
 import { loadToolModule } from "./tool/load-module.ts";
 import type { HiddenTool } from "./tool/registry.ts";
 import { type RegisteredTool, ToolRegistry } from "./tool/registry.ts";
@@ -215,7 +216,7 @@ async function callTool(input: {
       principal: config.principal.id,
       profession: config.profession.id,
       workType: (await work.current()).type,
-      businessDate: businessDate(),
+      businessDate: businessDate(config.company.timezone),
     });
     if (judged.kind === "deny") return reject("denied", judged.reason);
     if (judged.kind === "approval_required" || judged.kind === "review_required") {
@@ -370,11 +371,6 @@ function pathOf(input: unknown): string | undefined {
 }
 
 /** Today's date on this machine's clock, YYYY-MM-DD. */
-function businessDate(): string {
-  const now = new Date();
-  const pad = (n: number) => String(n).padStart(2, "0");
-  return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
-}
 
 function isRejectionCode(code: string): code is ToolRejectionCode {
   return (TOOL_REJECTION_CODES as readonly string[]).includes(code);

package/src/time.ts

@@ -0,0 +1,54 @@
+/**
+ * The company's clock. Every date the runtime judges against — a decision's effective days, a
+ * delegation's validity — is a date in the company's timezone, not in the host's. A workspace
+ * carried between a laptop in Tokyo and a container in UTC has to answer the same question the
+ * same way, so the timezone is part of the configuration rather than the environment.
+ */
+
+/** True when the name is a timezone this runtime knows (`Asia/Tokyo`, `UTC`, ...). */
+export function isTimezone(name: string): boolean {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: name });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** The timezone of the machine, used when the configuration names none. */
+export function hostTimezone(): string {
+  const name = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  return name && isTimezone(name) ? name : "UTC";
+}
+
+/** The business date (`YYYY-MM-DD`) in the company's timezone. */
+export function businessDate(timezone: string, at: Date = new Date()): string {
+  // en-CA writes a date as YYYY-MM-DD.
+  return new Intl.DateTimeFormat("en-CA", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).format(at);
+}
+
+/** The moment as the company reads it: `2026-09-09T14:03:11+09:00`. */
+export function companyTime(timezone: string, at: Date = new Date()): string {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: timezone,
+    hour12: false,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    timeZoneName: "longOffset",
+  }).formatToParts(at);
+  const of = (type: Intl.DateTimeFormatPartTypes) =>
+    parts.find((part) => part.type === type)?.value ?? "";
+  // "GMT+09:00" for a zone with an offset, "GMT" for UTC itself.
+  const zone = of("timeZoneName").replace("GMT", "");
+  const hour = of("hour") === "24" ? "00" : of("hour");
+  return `${of("year")}-${of("month")}-${of("day")}T${hour}:${of("minute")}:${of("second")}${zone === "" ? "+00:00" : zone}`;
+}