Date Conflict Detector

Overview

Detects overlaps among caller-supplied time intervals and reports each conflicting pair with the overlapping window and its length in seconds. Endpoints may carry any offset or none — everything is compared on the instant timeline, so a Brussels meeting and a New York one are compared correctly. 'boundaryPolicy' decides whether intervals that merely touch conflict: 'half_open' (default) says they do not, 'closed' says they do. 'groupBy' names a field so that only intervals sharing that value are compared, which is how per-resource conflicts are checked. Detection is a sweep line, and conflicts are emitted in a stable order, so shuffling the input cannot change the output. This reports clashes; it does not schedule, resolve, or suggest alternatives.

Overlap detection has subtle rules — we make boundary policy, grouping, and stable output ordering explicit so you get every clash and its window.

When to use it

Scope

Non-goals

• Does not schedule, resolve conflicts, or suggest alternative slots
• Does not compute free slots or availability
• Does not expand recurrence rules — callers pass concrete intervals
• Does not rank or prioritise conflicts
• Does not read the system clock

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"time.detect_date_conflicts","input":{"intervals":[{"id":"a","start":"2026-03-02T09:00:00Z","end":"2026-03-02T10:00:00Z"},{"id":"b","start":"2026-03-02T09:30:00Z","end":"2026-03-02T11:00:00Z"}]}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("time.detect_date_conflicts", {"intervals":[{"end":"2026-03-02T10:00:00Z","start":"2026-03-02T09:00:00Z","id":"a"},{"end":"2026-03-02T11:00:00Z","start":"2026-03-02T09:30:00Z","id":"b"}]});

Errors

Other limits

Limitations

• Does not schedule, resolve conflicts, or suggest alternative slots
• Does not compute free slots or availability
• Does not expand recurrence rules — callers pass concrete intervals
• Does not rank or prioritise conflicts
• Does not read the system clock
• Finding a free slot for a new meeting
• Expanding a recurring series first (use time.generate_recurrence)
• Resolving a conflict once found

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "time.detect_date_conflicts",
  "input": {
    "intervals": [
      {
        "end": "2026-03-02T10:00:00Z",
        "start": "2026-03-02T09:00:00Z",
        "id": "a"
      },
      {
        "end": "2026-03-02T11:00:00Z",
        "start": "2026-03-02T09:30:00Z",
        "id": "b"
      }
    ]
  }
}

Examples

{
  "intervals": [
    {
      "end": "2026-03-02T10:00:00Z",
      "start": "2026-03-02T09:00:00Z",
      "id": "a"
    },
    {
      "end": "2026-03-02T11:00:00Z",
      "start": "2026-03-02T09:30:00Z",
      "id": "b"
    }
  ]
}

{
  "_meta": {
    "comparisons": 1
  },
  "truncated": false,
  "conflicts": [
    {
      "left": "a",
      "overlapSeconds": 1800,
      "overlapStart": "2026-03-02T09:30:00Z",
      "overlapEnd": "2026-03-02T10:00:00Z",
      "right": "b"
    }
  ],
  "hasConflicts": true,
  "boundaryPolicy": "half_open",
  "conflictCount": 1,
  "intervalCount": 2
}

{
  "intervals": [
    {
      "end": "2026-03-02T10:00:00Z",
      "start": "2026-03-02T09:00:00Z",
      "id": "a"
    },
    {
      "end": "2026-03-02T11:00:00Z",
      "start": "2026-03-02T10:00:00Z",
      "id": "b"
    }
  ],
  "boundaryPolicy": "closed"
}

{
  "_meta": {
    "comparisons": 1
  },
  "truncated": false,
  "conflicts": [
    {
      "left": "a",
      "overlapSeconds": 0,
      "overlapStart": "2026-03-02T10:00:00Z",
      "overlapEnd": "2026-03-02T10:00:00Z",
      "right": "b"
    }
  ],
  "hasConflicts": true,
  "boundaryPolicy": "closed",
  "conflictCount": 1,
  "intervalCount": 2
}

Recommended use cases

• Check a proposed booking set for double-booked rooms with groupBy
• Validate that shift assignments for one person do not overlap
• Find where two imported calendars collide before merging them

Avoid for

• Finding a free slot for a new meeting
• Expanding a recurring series first (use time.generate_recurrence)
• Resolving a conflict once found

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags