@tai42/studio-sdk 1.4.0 → 1.5.0

package/dist/components/entity-card-grid.d.ts

@@ -3,7 +3,7 @@
  * half of {@link ViewToggle}). It lays its children out on the design system's
  * responsive `.tai-grid-cards` track (three columns, dropping to two then one down
  * the responsive bands); each child is expected to be an interactive `Card`. Living
- * in the SDK keeps the tools screen and PLAN_4's flows page on one identical grid.
+ * in the SDK keeps the tools screen and the flows page on one identical grid.
  */
 import type { ReactNode } from 'react';
 export interface EntityCardGridProps {

package/dist/components/folder-nav.d.ts

@@ -1,6 +1,6 @@
 /**
  * Folder navigation primitives for the tool-organization tree — shared by the tools
- * screen and PLAN_4's flows page so both explore, breadcrumb, and re-file against
+ * screen and the flows page so both explore, breadcrumb, and re-file against
  * one identical set of controls.
  *
  * The tree is passed FLAT (a {@link Folder} list keyed by `id`, each naming its

package/dist/components/folder-nav.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Folder navigation primitives for the tool-organization tree — shared by the tools
- * screen and PLAN_4's flows page so both explore, breadcrumb, and re-file against
+ * screen and the flows page so both explore, breadcrumb, and re-file against
  * one identical set of controls.
  *
  * The tree is passed FLAT (a {@link Folder} list keyed by `id`, each naming its

package/dist/components/overlay-details-fields.d.ts

@@ -1,7 +1,7 @@
 /**
  * `OverlayDetailsFields` — the display-name + user-tags editor shared by EVERY
  * tool_meta edit surface (the tools-screen edit dialog, the presets screen, and
- * PLAN_4's flows page). One canonical control means the merge-patch write semantics
+ * the flows page). One canonical control means the merge-patch write semantics
  * exist exactly once.
  *
  * Controlled: the caller owns `value` (prefilled from the tool's overlay row) and

package/dist/components/view-toggle.d.ts

@@ -6,7 +6,7 @@
  * so the segment shows just its glyph while keeping a real accessible name. A single
  * screen's choice persists across sessions in `localStorage`, keyed per SURFACE —
  * the tools screen and the flows page each remember their own view — via
- * {@link useViewMode}. The two live in the SDK so every entity screen (and PLAN_4's
+ * {@link useViewMode}. The two live in the SDK so every entity screen (and the
  * flows page) toggles identically; `EntityCardGrid` renders the card half.
  */
 import { type ReactNode } from 'react';

package/dist/components/view-toggle.js

@@ -7,7 +7,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * so the segment shows just its glyph while keeping a real accessible name. A single
  * screen's choice persists across sessions in `localStorage`, keyed per SURFACE —
  * the tools screen and the flows page each remember their own view — via
- * {@link useViewMode}. The two live in the SDK so every entity screen (and PLAN_4's
+ * {@link useViewMode}. The two live in the SDK so every entity screen (and the
  * flows page) toggles identically; `EntityCardGrid` renders the card half.
  */
 import { useCallback, useState } from 'react';

package/dist/hooks/useApi.d.ts

@@ -1401,7 +1401,10 @@ export declare const ApiProvider: import("react").Provider<{
         format: "csv" | "json";
     }, signal?: AbortSignal) => Promise<Blob>;
     readonly searchMarketplace: (query?: import("@tai42/api-client").MarketplaceSearchQuery, signal?: AbortSignal) => Promise<{
-        items: {
+        total: number;
+        page: number;
+        page_size: number;
+        listings: {
             name: string;
             description: string;
             tags: string[];
@@ -1409,12 +1412,10 @@ export declare const ApiProvider: import("react").Provider<{
             icon_url: string | null;
             categories: string[];
             updated_at: string;
-            item: {
+            groups: {
                 name: string;
-                description: string;
-                tags: string[];
-                kind: string;
-            };
+                count: number;
+            }[];
             ref: string;
             namespace: string;
             package: string;
@@ -1422,11 +1423,13 @@ export declare const ApiProvider: import("react").Provider<{
             pricing: string;
             latest_version: string | null;
             downloads: number;
+            kinds: {
+                kind: string;
+                count: number;
+                names: string[];
+            }[];
             premium?: boolean | null | undefined;
         }[];
-        total: number;
-        page: number;
-        page_size: number;
     }>;
     readonly getMarketplacePlugin: (namespace: string, name: string, signal?: AbortSignal) => Promise<{
         name: string;
@@ -1457,6 +1460,7 @@ export declare const ApiProvider: import("react").Provider<{
                 description: string;
                 tags: string[];
                 kind: string;
+                group: string | null;
             }[];
             version: string;
             contract_range: string | null;

package/dist/hooks/useApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useApi.d.ts","sourceRoot":"","sources":["../../src/hooks/useApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useApi.d.ts","sourceRoot":"","sources":["../../src/hooks/useApi.ts"],"names":[],"mappings":"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"}

package/dist/tool-visibility.d.ts

@@ -5,8 +5,8 @@
  * EFFECTIVE hidden is the overlay's tri-state OVERRIDE of the plugin's own
  * declaration: an overlay opinion (`true`/`false`) wins, else the plugin
  * declaration stands. So an overlay `false` UNHIDES a plugin-hidden tool, `true`
- * force-hides, and `null` (no overlay row is the same) DEFERS to the declaration
- * (PLAN §Tools-read-surface). The rule lives here ONCE so the list-exclusion and
+ * force-hides, and `null` (no overlay row is the same) DEFERS to the declaration.
+ * The rule lives here ONCE so the list-exclusion and
  * the picker-exclusion can never drift apart.
  */
 import type { ToolMetaRecord, ToolTagEntry } from '@tai42/api-client';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -89,7 +89,7 @@
     "@radix-ui/react-select": "^2.3.2",
     "@radix-ui/react-tabs": "^1.1.16",
     "@radix-ui/react-tooltip": "^1.2.11",
-    "@tai42/api-client": "1.4.0"
+    "@tai42/api-client": "1.5.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",

package/src/components/entity-card-grid.tsx

@@ -3,7 +3,7 @@
  * half of {@link ViewToggle}). It lays its children out on the design system's
  * responsive `.tai-grid-cards` track (three columns, dropping to two then one down
  * the responsive bands); each child is expected to be an interactive `Card`. Living
- * in the SDK keeps the tools screen and PLAN_4's flows page on one identical grid.
+ * in the SDK keeps the tools screen and the flows page on one identical grid.
  */
 import type { ReactNode } from 'react';
 

package/src/components/folder-nav.tsx

@@ -1,6 +1,6 @@
 /**
  * Folder navigation primitives for the tool-organization tree — shared by the tools
- * screen and PLAN_4's flows page so both explore, breadcrumb, and re-file against
+ * screen and the flows page so both explore, breadcrumb, and re-file against
  * one identical set of controls.
  *
  * The tree is passed FLAT (a {@link Folder} list keyed by `id`, each naming its

package/src/components/overlay-details-fields.tsx

@@ -1,7 +1,7 @@
 /**
  * `OverlayDetailsFields` — the display-name + user-tags editor shared by EVERY
  * tool_meta edit surface (the tools-screen edit dialog, the presets screen, and
- * PLAN_4's flows page). One canonical control means the merge-patch write semantics
+ * the flows page). One canonical control means the merge-patch write semantics
  * exist exactly once.
  *
  * Controlled: the caller owns `value` (prefilled from the tool's overlay row) and

package/src/components/view-toggle.tsx

@@ -6,7 +6,7 @@
  * so the segment shows just its glyph while keeping a real accessible name. A single
  * screen's choice persists across sessions in `localStorage`, keyed per SURFACE —
  * the tools screen and the flows page each remember their own view — via
- * {@link useViewMode}. The two live in the SDK so every entity screen (and PLAN_4's
+ * {@link useViewMode}. The two live in the SDK so every entity screen (and the
  * flows page) toggles identically; `EntityCardGrid` renders the card half.
  */
 import { useCallback, useState, type ReactNode } from 'react';

package/src/tool-visibility.ts

@@ -5,8 +5,8 @@
  * EFFECTIVE hidden is the overlay's tri-state OVERRIDE of the plugin's own
  * declaration: an overlay opinion (`true`/`false`) wins, else the plugin
  * declaration stands. So an overlay `false` UNHIDES a plugin-hidden tool, `true`
- * force-hides, and `null` (no overlay row is the same) DEFERS to the declaration
- * (PLAN §Tools-read-surface). The rule lives here ONCE so the list-exclusion and
+ * force-hides, and `null` (no overlay row is the same) DEFERS to the declaration.
+ * The rule lives here ONCE so the list-exclusion and
  * the picker-exclusion can never drift apart.
  */
 import type { ToolMetaRecord, ToolTagEntry } from '@tai42/api-client';