@cursor/july 0.1.97 → 0.1.99

package/src/tools.ts

@@ -99,6 +99,15 @@ type ServerToolConfig<TSchema> = {
    * write, so a dry-run session answers it instead of running it.
    */
   effect?: ToolEffectDeclaration<ToolInput<TSchema>>;
+  /**
+   * Input properties carrying time bounds. In an `asOf` session each named
+   * argument must be an absolute ISO-8601 instant with a timezone, no later
+   * than the frozen instant; a call that omits one, or supplies a relative
+   * or later value, is refused so the model retries with absolute bounds.
+   * Names must exist in {@link inputSchema} or the frozen session refuses to
+   * start. Ignored without `asOf`.
+   */
+  timeArgs?: readonly string[];
   /** What a `"write"` tool returns in a dry-run session. */
   dryRunResult?:
     | ToolExecuteResult
@@ -126,10 +135,11 @@ type AgentToolConfig<TSchema> = {
   needsApproval?: never;
   /**
    * Agent tools run inside the harness, not through the host's tool path, so
-   * a dry run cannot answer them. Classify the work as a server tool if it
-   * needs to be dry-runnable.
+   * a dry run cannot answer them and an `asOf` session cannot bound them.
+   * Classify the work as a server tool if it needs either.
    */
   effect?: never;
+  timeArgs?: never;
   dryRunResult?: never;
 };
 

package/src/types.ts

@@ -880,6 +880,8 @@ export interface ToolContext {
    * `subagent.completed`). Omitted for scratch `callTool` with no session.
    */
   emit?: (payload: SessionEventPayload) => void;
+  /** The session's frozen `asOf`, or the wall clock. Use instead of `Date.now()`. */
+  now(): Date;
 }
 
 /**
@@ -992,6 +994,17 @@ export interface ToolConfig<TInput> {
    * write, so a dry run stubs it — see {@link ToolEffect}.
    */
   effect?: ToolEffectDeclaration<TInput>;
+  /**
+   * Input properties that carry time bounds. In a session created with
+   * {@link SendMessageOptions.asOf}, every named argument must be an
+   * absolute ISO-8601 instant with a timezone, no later than the session's
+   * frozen instant — a call that omits one, or supplies a relative or later
+   * value, is refused so the model retries with absolute bounds. Names must
+   * exist in {@link inputSchema}; a session with `asOf` refuses to start
+   * otherwise, because a misspelled name would silently check nothing.
+   * Ignored in sessions without `asOf`.
+   */
+  timeArgs?: readonly string[];
   /**
    * What a write tool returns in a dry-run session instead of executing.
    *
@@ -1025,6 +1038,7 @@ export interface ToolDefinition extends BrandedDefinition<"tool"> {
   readonly outputSchema?: z.ZodTypeAny | JsonSchemaObject;
   readonly needsApproval?: ToolNeedsApproval<never>;
   readonly effect?: ToolEffectDeclaration<never>;
+  readonly timeArgs?: readonly string[];
   readonly dryRunResult?:
     | ToolExecuteResult
     | ((input: never) => ToolExecuteResult);
@@ -1624,6 +1638,8 @@ export interface SessionInfo {
   purpose?: SessionPurpose;
   /** True when write-classified tool calls are answered by the host. */
   dryRun?: boolean;
+  /** Frozen instant this session reads at; absent means the wall clock. */
+  asOf?: string;
   auth: AuthContext | null;
   title?: string;
   /**
@@ -1658,6 +1674,8 @@ export interface SessionRecord {
   purpose?: SessionPurpose;
   /** Frozen at create from {@link SendMessageOptions.dryRun}. */
   dryRun?: boolean;
+  /** Frozen at create from {@link SendMessageOptions.asOf}. */
+  asOf?: string;
   /**
    * Denormalized sticky A/B arms (mirrors durable `ab.assigned` events) so
    * the agent loop / tools can read arms without re-folding the log. Source
@@ -1853,6 +1871,13 @@ export interface SendMessageOptions {
    * model chose stay on the session log as the record of the intended action.
    */
   dryRun?: boolean;
+  /**
+   * ISO-8601 instant with a timezone, frozen at create: the prompt states
+   * it, {@link ToolContext.now} returns it, and tools that declare
+   * {@link ToolConfig.timeArgs} refuse calls not bounded at or before it. A
+   * tool that declares nothing still reads the present.
+   */
+  asOf?: string;
   /**
    * Absolute directory used as the local harness `cwd` for this session.
    * On create, sets the session workspace. On resume (continuation hit),