things-api 0.5.0

package/dist/write/capabilities.js

@@ -0,0 +1,16 @@
+/**
+ * The operation × vector support table — lab-validated matrices flattened
+ * for discovery. Shared by `things capabilities`, the MCP capabilities tool,
+ * and library consumers.
+ */
+import { OPERATION_KINDS } from "./operations.js";
+import { defaultVectors } from "./vectors/registry.js";
+export function capabilitiesTable(op) {
+    const vectors = defaultVectors();
+    const ops = op !== undefined ? [op] : [...OPERATION_KINDS];
+    return ops.map((kind) => ({
+        op: kind,
+        vectors: vectors.map((v) => ({ vector: v.id, ...(v.matrix[kind] ?? { support: "no" }) })),
+    }));
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/write/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/write/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAsB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQvD,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxB,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;KAC1F,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/write/commands.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CommandSpec catalog: for each operation — the hazards it must clear, the
+ * pre-read it needs, the DeltaSpec that proves it happened, and the compiled
+ * invocation per vector. Compilation emits exactly the command shapes the
+ * lab validated (u-suite / a-suite evidence ids in the vector matrices).
+ */
+import type { DatabaseSync } from "node:sqlite";
+import { type IsoDate } from "../model/dates.ts";
+import type { HazardId } from "./guards.ts";
+import type { OperationKind, OperationParamsMap } from "./operations.ts";
+import { type PreState } from "./pre-state.ts";
+import type { CompiledInvocation, VectorId } from "./vectors/types.ts";
+import type { DeltaSpec } from "./verify/delta.ts";
+export interface CompileCtx {
+    token: string | null;
+}
+export interface DeltaCtx {
+    /** Epoch seconds at execute time (create-probe window). */
+    nowEpoch: number;
+    /** Local calendar date (guest/host clock) for `when: today|evening`. */
+    todayIso: IsoDate;
+}
+export interface CommandSpec<K extends OperationKind = OperationKind> {
+    op: K;
+    hazards: HazardId[];
+    preRead(db: DatabaseSync, params: OperationParamsMap[K], now: Date): PreState;
+    expectedDelta(pre: PreState, params: OperationParamsMap[K], ctx: DeltaCtx): DeltaSpec;
+    compile(params: OperationParamsMap[K], vector: VectorId, pre: PreState, ctx: CompileCtx): CompiledInvocation;
+}
+export declare const COMMANDS: {
+    [K in OperationKind]: CommandSpec<K>;
+};