@sudobility/sider_types 0.0.3 → 0.0.6

package/dist/api.d.ts

@@ -1,5 +1,6 @@
-import type { EndpointGraphEdge, SafetyClass, SecretSlot, Site, ToolSpec, UXRecipe } from "./registry";
-import type { Observation, StepKind } from "./runtime";
+import type { IsoTimestamp, JSONSchema } from "./common";
+import type { EndpointGraphEdge, InvocationRecipe, SafetyClass, SecretSlot, Site, ToolSpec, ToolStatus, UXRecipe } from "./registry";
+import type { CaptureBatch, Contributor, Observation, StepKind } from "./runtime";
 /** A planner decision (mirror of the ShapeShyft plan-next-step output). */
 export interface PlannerStep {
     kind: StepKind;
@@ -52,3 +53,68 @@ export interface StatsResponse {
     trustedToolCount: number;
     contributorCount: number;
 }
+/** GET /api/v1/me — the signed-in contributor + aggregate counts. */
+export interface MeResponse {
+    contributor: Contributor;
+    batchCount: number;
+    observationCount: number;
+    /** Tools this user has corroborated (cast a recipe vote on). */
+    toolsContributed: number;
+    /** Of those, how many are currently `trusted`. */
+    trustedToolsContributed: number;
+}
+/** One row of GET /api/v1/me/capture-batches. */
+export interface MyCaptureBatchSummary extends CaptureBatch {
+    siteOrigin: string;
+    siteName: string;
+}
+/** GET /api/v1/me/capture-batches/:id — a batch plus its observations. */
+export interface MyCaptureBatchDetail {
+    batch: MyCaptureBatchSummary;
+    observations: Observation[];
+}
+/** One row of GET /api/v1/me/tools — a tool this user corroborated. */
+export interface MyToolEntry {
+    toolId: string;
+    siteId: string;
+    name: string;
+    status: ToolStatus;
+    safetyClass: SafetyClass;
+    version: number;
+    corroboratingUserCount: number;
+    /** Hash of MY independently-derived recipe. */
+    myRecipeHash: string;
+    /** Hash of the recipe currently stored on the tool. */
+    currentRecipeHash: string;
+    /** Whether my vote agrees with the stored recipe. */
+    agreesWithCurrent: boolean;
+    votedAt: IsoTimestamp;
+}
+/** GET /api/v1/tools/:id — full tool detail for the registry inspector. */
+export interface ToolDetailResponse {
+    /** The tools table row (recipe, schema, safety, status, counts). */
+    tool: {
+        id: string;
+        siteId: string;
+        name: string;
+        description: string;
+        capabilityLabel: string;
+        inputSchema: JSONSchema;
+        safetyClass: SafetyClass;
+        directCallAvailable: boolean;
+        recipe: InvocationRecipe;
+        status: ToolStatus;
+        version: number;
+        observationCount: number;
+        corroboratingUserCount: number;
+        confidence: number;
+        createdAt: IsoTimestamp;
+        updatedAt: IsoTimestamp;
+    };
+    /** Anonymized corroboration breakdown: recipe hash → distinct-user count. */
+    corroboration: {
+        distinctUsers: number;
+        hashCounts: Record<string, number>;
+        trustThreshold: number;
+    };
+}

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export * from "./api";
 export * from "./actions";
 export * from "./templating";
 export * from "./recipe-hash";
+export * from "./observe";

package/dist/index.js

@@ -12,3 +12,4 @@ export * from "./api";
 export * from "./actions";
 export * from "./templating";
 export * from "./recipe-hash";
+export * from "./observe";

package/dist/observe.d.ts

@@ -0,0 +1,46 @@
+export type SnapshotActionKind = "navigate" | "submit" | "input" | "select" | "click";
+/** A control's SHAPE. The graph hashes `tag|role|name|actionKind` into view identity. */
+export interface SnapshotControl {
+    tag: string;
+    role?: string;
+    /** Accessible name, e.g. "Add to Cart". Plans reference controls by this. */
+    name?: string;
+    actionKind?: SnapshotActionKind;
+}
+/**
+ * A region of the page. Nesting matters: a region whose content-bearing children
+ * are all leaves sharing one shape collapses to a single repeat token, which is
+ * what stops a product list from changing the view's identity every time its
+ * contents change.
+ */
+export interface SnapshotRegion {
+    key: string;
+    role?: string;
+    controls?: SnapshotControl[];
+    children?: SnapshotRegion[];
+}
+export interface SnapshotLink {
+    toUrlPath: string;
+    label?: string;
+}
+export interface PageSnapshot {
+    /** Path with query VALUES dropped and keys kept: /search?q={q} */
+    urlPath: string;
+    title?: string;
+    regions: SnapshotRegion[];
+    links: SnapshotLink[];
+    /** Structural text only — headings, control names, link labels, item titles. */
+    contentMd?: string;
+    /** How the agent arrived here, when known. */
+    trigger?: {
+        kind: string;
+        label?: string;
+    } | null;
+}
+/** POST /api/v1/observe body. */
+export interface ObserveBody {
+    /** Assistant thread id — correlates the snapshot with its run. */
+    threadId: string;
+    siteOrigin: string;
+    snapshot: PageSnapshot;
+}

package/dist/observe.js

@@ -0,0 +1,8 @@
+// The page-observation seam between sider_extension and sider_api.
+//
+// Deliberately absent: CSS selectors and page body prose. Selectors are
+// regenerated per render and are useless to another user of the site; body prose
+// is the current user's own data (order history, addresses) and the graph it
+// would land in is shared with every other user of that site. Neither is omitted
+// by a filter — neither exists in these types.
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/sider_types",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "description": "Shared domain types for Sider — AI assistance for generic web apps.",
   "license": "BUSL-1.1",
   "publishConfig": {

package/src/api.ts

@@ -2,15 +2,18 @@
 // (to type its handlers) and sider_client (to type its calls). Keeping these
 // here is the single source of truth that stops the two sides from drifting.
 
+import type { IsoTimestamp, JSONSchema } from "./common";
 import type {
   EndpointGraphEdge,
+  InvocationRecipe,
   SafetyClass,
   SecretSlot,
   Site,
   ToolSpec,
+  ToolStatus,
   UXRecipe,
 } from "./registry";
-import type { Observation, StepKind } from "./runtime";
+import type { CaptureBatch, Contributor, Observation, StepKind } from "./runtime";
 
 /** A planner decision (mirror of the ShapeShyft plan-next-step output). */
 export interface PlannerStep {
@@ -66,3 +69,77 @@ export interface StatsResponse {
   trustedToolCount: number;
   contributorCount: number;
 }
+
+// ---------------------------------------------------------------------------
+// Dashboard DTOs (per-user + registry inspection). Spec 2026-07-20 §3.
+// ---------------------------------------------------------------------------
+
+/** GET /api/v1/me — the signed-in contributor + aggregate counts. */
+export interface MeResponse {
+  contributor: Contributor;
+  batchCount: number;
+  observationCount: number;
+  /** Tools this user has corroborated (cast a recipe vote on). */
+  toolsContributed: number;
+  /** Of those, how many are currently `trusted`. */
+  trustedToolsContributed: number;
+}
+
+/** One row of GET /api/v1/me/capture-batches. */
+export interface MyCaptureBatchSummary extends CaptureBatch {
+  siteOrigin: string;
+  siteName: string;
+}
+
+/** GET /api/v1/me/capture-batches/:id — a batch plus its observations. */
+export interface MyCaptureBatchDetail {
+  batch: MyCaptureBatchSummary;
+  observations: Observation[];
+}
+
+/** One row of GET /api/v1/me/tools — a tool this user corroborated. */
+export interface MyToolEntry {
+  toolId: string;
+  siteId: string;
+  name: string;
+  status: ToolStatus;
+  safetyClass: SafetyClass;
+  version: number;
+  corroboratingUserCount: number;
+  /** Hash of MY independently-derived recipe. */
+  myRecipeHash: string;
+  /** Hash of the recipe currently stored on the tool. */
+  currentRecipeHash: string;
+  /** Whether my vote agrees with the stored recipe. */
+  agreesWithCurrent: boolean;
+  votedAt: IsoTimestamp;
+}
+
+/** GET /api/v1/tools/:id — full tool detail for the registry inspector. */
+export interface ToolDetailResponse {
+  /** The tools table row (recipe, schema, safety, status, counts). */
+  tool: {
+    id: string;
+    siteId: string;
+    name: string;
+    description: string;
+    capabilityLabel: string;
+    inputSchema: JSONSchema;
+    safetyClass: SafetyClass;
+    directCallAvailable: boolean;
+    recipe: InvocationRecipe;
+    status: ToolStatus;
+    version: number;
+    observationCount: number;
+    corroboratingUserCount: number;
+    confidence: number;
+    createdAt: IsoTimestamp;
+    updatedAt: IsoTimestamp;
+  };
+  /** Anonymized corroboration breakdown: recipe hash → distinct-user count. */
+  corroboration: {
+    distinctUsers: number;
+    hashCounts: Record<string, number>;
+    trustThreshold: number;
+  };
+}

package/src/index.ts

@@ -13,3 +13,4 @@ export * from "./api";
 export * from "./actions";
 export * from "./templating";
 export * from "./recipe-hash";
+export * from "./observe";

package/src/observe.ts

@@ -0,0 +1,56 @@
+// The page-observation seam between sider_extension and sider_api.
+//
+// Deliberately absent: CSS selectors and page body prose. Selectors are
+// regenerated per render and are useless to another user of the site; body prose
+// is the current user's own data (order history, addresses) and the graph it
+// would land in is shared with every other user of that site. Neither is omitted
+// by a filter — neither exists in these types.
+
+export type SnapshotActionKind = "navigate" | "submit" | "input" | "select" | "click";
+
+/** A control's SHAPE. The graph hashes `tag|role|name|actionKind` into view identity. */
+export interface SnapshotControl {
+  tag: string;
+  role?: string;
+  /** Accessible name, e.g. "Add to Cart". Plans reference controls by this. */
+  name?: string;
+  actionKind?: SnapshotActionKind;
+}
+
+/**
+ * A region of the page. Nesting matters: a region whose content-bearing children
+ * are all leaves sharing one shape collapses to a single repeat token, which is
+ * what stops a product list from changing the view's identity every time its
+ * contents change.
+ */
+export interface SnapshotRegion {
+  key: string;
+  role?: string;
+  controls?: SnapshotControl[];
+  children?: SnapshotRegion[];
+}
+
+export interface SnapshotLink {
+  toUrlPath: string;
+  label?: string;
+}
+
+export interface PageSnapshot {
+  /** Path with query VALUES dropped and keys kept: /search?q={q} */
+  urlPath: string;
+  title?: string;
+  regions: SnapshotRegion[];
+  links: SnapshotLink[];
+  /** Structural text only — headings, control names, link labels, item titles. */
+  contentMd?: string;
+  /** How the agent arrived here, when known. */
+  trigger?: { kind: string; label?: string } | null;
+}
+
+/** POST /api/v1/observe body. */
+export interface ObserveBody {
+  /** Assistant thread id — correlates the snapshot with its run. */
+  threadId: string;
+  siteOrigin: string;
+  snapshot: PageSnapshot;
+}