@stigmer/react 3.2.3 → 3.3.0

package/src/index.ts

@@ -677,6 +677,88 @@ export type {
   AgentWizardData,
 } from "./agent/index.js";
 
+// Datastore — data hooks (kind family + describe projection), record
+// hooks (find/insert/update/delete + grid collection), guarded delete,
+// the canonical value semantics of declared fields, the typed filter
+// model, and the six styled components (detail view, records browser,
+// filter builder, record form, schema view, sync report, delete dialog)
+export {
+  useDatastore,
+  useDatastoreList,
+  useDatastoreCount,
+  useDatastoreSearch,
+  useDatastoreDescription,
+  DEFAULT_PARTITION,
+  useRecordList,
+  useInsertRecord,
+  useUpdateRecord,
+  useDeleteRecord,
+  useRecordCollection,
+  useDeleteDatastore,
+  buildUpdateFields,
+  coerceFieldValue,
+  formatFieldValue,
+  formatSystemTimestamp,
+  isListOperator,
+  isSortableField,
+  isValuelessOperator,
+  operatorsForField,
+  OPERATOR_LABELS,
+  RESERVED_FIELD_NAMES,
+  SYSTEM_FIELD_OPERATORS,
+  buildRecordFilter,
+  filterableFields,
+  formatConditionChip,
+  isConditionComplete,
+  FieldValueControl,
+  FIELD_INPUT_CLASSES,
+  CollectionSchemaView,
+  formatSubject,
+  DatastoreSyncReport,
+  RecordFilterBuilder,
+  RecordFormPanel,
+  CollectionRecordsBrowser,
+  DeleteDatastoreDialog,
+  DatastoreDetailView,
+  DatastoreIcon,
+} from "./datastore/index.js";
+export type {
+  UseDatastoreReturn,
+  UseDatastoreListOptions,
+  UseDatastoreListReturn,
+  UseDatastoreCountOptions,
+  UseDatastoreCountReturn,
+  UseDatastoreSearchOptions,
+  UseDatastoreSearchReturn,
+  UseDatastoreDescriptionReturn,
+  RecordScope,
+  UseRecordListParams,
+  UseRecordListReturn,
+  InsertRecordArgs,
+  UseInsertRecordReturn,
+  UpdateRecordArgs,
+  UseUpdateRecordReturn,
+  DeleteRecordArgs,
+  UseDeleteRecordReturn,
+  RecordColumnDef,
+  UseRecordCollectionOptions,
+  UseRecordCollectionReturn,
+  DeleteDatastoreArgs,
+  UseDeleteDatastoreReturn,
+  CoerceResult,
+  FilterableField,
+  RecordConditionDraft,
+  FieldValueControlProps,
+  CollectionSchemaViewProps,
+  DatastoreSyncReportProps,
+  RecordFilterBuilderProps,
+  RecordFormPanelProps,
+  CollectionRecordsBrowserProps,
+  DeleteDatastoreDialogProps,
+  DatastoreDetailTab,
+  DatastoreDetailViewProps,
+} from "./datastore/index.js";
+
 // Environment — data hooks, list hook, personal convenience hook, secret reveal, variable management, env var form, system env vars, and styled components
 export {
   useEnvironment,
@@ -770,6 +852,7 @@ export type {
   UseShareFlowReturn,
   ShareFlowResource,
   UseCheckPermissionReturn,
+  CheckPermissionOptions,
   PermissionCheckResource,
   RoleSelectorProps,
   PrincipalPickerProps,
@@ -832,9 +915,15 @@ export {
   useCreditLedger,
   useBillingUsageReport,
   useCustomerModelPricing,
+  usePricingGovernance,
+  useModelPricingBaselines,
+  useModelGovernanceView,
   useCreateCheckoutSession,
   useCreateBillingPortalSession,
   useSetAutoRechargeConfig,
+  useDecidePricingOverride,
+  useUpsertModelPricingBaseline,
+  useRetireModelPricingBaseline,
   BillingSection,
   CreditBalanceCard,
   PaymentMethodCard,
@@ -842,6 +931,9 @@ export {
   CreditPackGrid,
   CreditLedgerTable,
   LowBalanceBanner,
+  PricingGovernancePanel,
+  ModelCatalogPanel,
+  PricingGovernanceConsole,
   CREDIT_PACKS,
   formatPackPrice,
   formatCreditCount,
@@ -858,11 +950,23 @@ export type {
   UseCreditLedgerOptions,
   UseBillingUsageReportReturn,
   UseCustomerModelPricingReturn,
+  UsePricingGovernanceReturn,
+  UseModelPricingBaselinesOptions,
+  UseModelPricingBaselinesReturn,
+  GovernanceFlow,
+  ModelGovernanceRow,
+  UseModelGovernanceViewReturn,
   CreateCheckoutSessionInput,
   UseCreateCheckoutSessionReturn,
   UseCreateBillingPortalSessionReturn,
   SetAutoRechargeConfigInput,
   UseSetAutoRechargeConfigReturn,
+  DecidePricingOverrideInput,
+  UseDecidePricingOverrideReturn,
+  UpsertModelPricingBaselineInput,
+  UseUpsertModelPricingBaselineReturn,
+  RetireModelPricingBaselineInput,
+  UseRetireModelPricingBaselineReturn,
   BillingSectionProps,
   CreditBalanceCardProps,
   PaymentMethodCardProps,
@@ -870,11 +974,46 @@ export type {
   CreditPackGridProps,
   CreditLedgerTableProps,
   LowBalanceBannerProps,
+  PricingGovernancePanelProps,
+  ModelCatalogPanelProps,
+  PricingGovernanceConsoleProps,
+  PricingGovernanceTab,
   CreditPackInfo,
 } from "./billing/index.js";
 
+// Cursor accounts — platform-operator management of managed Cursor teams
+// (admin keys, member execution keys, org assignments, roster/spend)
+export {
+  useCursorAccounts,
+  useCursorAccountView,
+  useUpsertCursorAccount,
+  useDeleteCursorAccount,
+  useCursorMemberKeyActions,
+  useSyncCursorAccount,
+  CursorAccountsConsole,
+  CursorAccountEditor,
+  CursorAccountsAccessNotice,
+} from "./cursor-accounts/index.js";
+export type {
+  UseCursorAccountsReturn,
+  UseCursorAccountViewReturn,
+  UseUpsertCursorAccountReturn,
+  DeleteCursorAccountInput,
+  UseDeleteCursorAccountReturn,
+  AddCursorMemberKeyInput,
+  RemoveCursorMemberKeyInput,
+  UseCursorMemberKeyActionsReturn,
+  UseSyncCursorAccountReturn,
+  CursorAccountsConsoleProps,
+  CursorAccountEditorProps,
+} from "./cursor-accounts/index.js";
+
 // Settings — navigation structure + section components shared across app shells
-export { SETTINGS_NAV_GROUPS } from "./settings/index.js";
+export {
+  SETTINGS_NAV_GROUPS,
+  PLATFORM_SETTINGS_NAV_GROUP,
+  useSettingsNavGroups,
+} from "./settings/index.js";
 export type { SettingsNavItem, SettingsNavGroup } from "./settings/index.js";
 export { ApiKeysSection } from "./settings/index.js";
 export { MembersSection } from "./settings/index.js";
@@ -1138,15 +1277,8 @@ export {
   findStreamingPlan,
   PLAN_ARTIFACT_NAME,
   PLAN_ARTIFACT_SUFFIX,
-  parseResourceYaml,
-  serializeAgentYaml,
-  serializeMcpServerYaml,
-  serializeAgentInputYaml,
-  serializeMcpServerInputYaml,
   useApplyResource,
   useExportResource,
-  useImportResource,
-  ImportResourceDialog,
   VisibilitySelector,
   VisibilityBadge,
   blueprintVisibilityLevels,
@@ -1163,16 +1295,11 @@ export type {
   SessionPlan,
   StreamingPlan,
   UseDetectSkillPackageReturn,
-  ParsedResource,
   UseApplyResourceReturn,
   ApplyResourceResult,
   PushSkillParams,
   UseExportResourceOptions,
   UseExportResourceReturn,
-  ImportFormat,
-  ImportPreview,
-  UseImportResourceReturn,
-  ImportResourceDialogProps,
   VisibilitySelectorProps,
   VisibilityBadgeProps,
   VisibilityLevelOption,
@@ -1181,6 +1308,29 @@ export type {
   UseUpdateVisibilityReturn,
 } from "./library/index.js";
 
+// Manifest — kind-agnostic YAML edit/apply (editor, hooks, dialogs)
+export {
+  YamlEditor,
+  useEditResourceYaml,
+  useApplyManifest,
+  EditResourceYamlDialog,
+  ApplyManifestDialog,
+  RedactedSecretsNotice,
+} from "./manifest/index.js";
+export type {
+  YamlEditorProps,
+  EditYamlTarget,
+  EditYamlValidation,
+  UseEditResourceYamlOptions,
+  UseEditResourceYamlReturn,
+  ManifestEntryStatus,
+  ManifestPreviewEntry,
+  UseApplyManifestReturn,
+  EditResourceYamlDialogProps,
+  ApplyManifestDialogProps,
+  RedactedSecretsNoticeProps,
+} from "./manifest/index.js";
+
 // Action menu — compound component for resource item actions
 export { ActionMenu } from "./action-menu/index.js";
 export type {

package/src/library/index.ts

@@ -40,16 +40,6 @@ export type { StreamingPlan } from "./detect-streaming-plan.js";
 export { useDetectSkillPackage } from "./useDetectSkillPackage.js";
 export type { UseDetectSkillPackageReturn } from "./useDetectSkillPackage.js";
 
-export { parseResourceYaml } from "./parse-resource-yaml.js";
-export type { ParsedResource } from "./parse-resource-yaml.js";
-
-export {
-  serializeAgentYaml,
-  serializeMcpServerYaml,
-  serializeAgentInputYaml,
-  serializeMcpServerInputYaml,
-} from "./serialize-resource-yaml.js";
-
 export { serializeWorkflowYaml, parseWorkflowYaml } from "../workflow/serialize-workflow-yaml.js";
 
 export { useApplyResource } from "./useApplyResource.js";
@@ -65,16 +55,6 @@ export type {
   UseExportResourceReturn,
 } from "./useExportResource.js";
 
-export { useImportResource } from "./useImportResource.js";
-export type {
-  ImportFormat,
-  ImportPreview,
-  UseImportResourceReturn,
-} from "./useImportResource.js";
-
-export { ImportResourceDialog } from "./ImportResourceDialog.js";
-export type { ImportResourceDialogProps } from "./ImportResourceDialog.js";
-
 export { VisibilitySelector, VisibilityBadge } from "./VisibilitySelector.js";
 export type {
   VisibilitySelectorProps,

package/src/library/useApplyResource.ts

@@ -3,9 +3,9 @@
 import { useCallback, useState } from "react";
 import { create } from "@bufbuild/protobuf";
 import { PushSkillFromExecutionArtifactRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
+import { parseManifest } from "@stigmer/sdk";
 import { useStigmer } from "../hooks.js";
 import { toError } from "../internal/toError.js";
-import { parseResourceYaml } from "./parse-resource-yaml.js";
 
 /**
  * Result returned after successfully applying a resource to an organization.
@@ -14,8 +14,8 @@ import { parseResourceYaml } from "./parse-resource-yaml.js";
  * link to the resource in the Library (e.g., `/library/agents`).
  */
 export interface ApplyResourceResult {
-  /** The resource kind that was applied. */
-  readonly kind: "Agent" | "McpServer" | "Skill";
+  /** The resource kind that was applied (`"Agent"`, `"McpServer"`, `"Skill"`, …). */
+  readonly kind: string;
   /** The resource name (from response metadata). */
   readonly name: string;
   /** The organization the resource was applied to. */
@@ -44,14 +44,14 @@ export interface PushSkillParams {
 /** Return value of {@link useApplyResource}. */
 export interface UseApplyResourceReturn {
   /**
-   * Apply a Stigmer resource YAML (Agent or McpServer) to an organization.
+   * Apply a Stigmer resource YAML to an organization.
    *
-   * Parses the YAML content, converts it to the appropriate SDK input type,
-   * and calls `stigmer.agent.apply()` or `stigmer.mcpServer.apply()` based
-   * on the detected `kind`.
+   * Parses the YAML against the kind's generated proto schema via the SDK
+   * manifest engine and applies it through `stigmer.manifest.apply()` —
+   * any registry-supported kind, full fidelity.
    *
-   * The `org` parameter overrides `metadata.org` in the YAML — matching
-   * the "Apply to [my-org]" UX intent.
+   * The `org` parameter fills in `metadata.org` when the YAML omits it —
+   * matching the "Apply to [my-org]" UX intent.
    *
    * @throws Re-throws the original error after setting `error` state, so
    *   callers can optionally catch for flow control.
@@ -93,9 +93,9 @@ export interface UseApplyResourceReturn {
  *
  * Handles two parallel apply paths:
  *
- * 1. **YAML resources** (Agent, McpServer): `applyYamlResource(content, org)`
- *    parses the YAML, converts snake_case fields to SDK input types, and
- *    calls the appropriate `apply()` method.
+ * 1. **YAML resources**: `applyYamlResource(content, org)` parses the YAML
+ *    against the generated proto schema (SDK manifest engine) and applies
+ *    it through the kind's `apply` RPC.
  *
  * 2. **Skill packages** (directory artifacts): `pushSkillPackage(params)`
  *    delegates to the server-side `pushFromExecutionArtifact` RPC.
@@ -129,7 +129,7 @@ export interface UseApplyResourceReturn {
  * };
  * ```
  *
- * @see {@link parseResourceYaml} for the pure YAML-to-input conversion
+ * @see {@link parseManifest} for the YAML-to-proto conversion
  * @see {@link detectStigmerResource} for YAML resource detection
  * @see {@link useDetectSkillPackage} for skill package detection
  */
@@ -146,28 +146,21 @@ export function useApplyResource(): UseApplyResourceReturn {
       setError(null);
 
       try {
-        const parsed = parseResourceYaml(content, org);
-
-        switch (parsed.kind) {
-          case "Agent": {
-            const agent = await stigmer.agent.apply(parsed.input);
-            return {
-              kind: "Agent",
-              name: agent.metadata?.name ?? parsed.input.name,
-              org: agent.metadata?.org ?? org,
-              slug: agent.metadata?.slug ?? parsed.input.name,
-            };
-          }
-          case "McpServer": {
-            const mcpServer = await stigmer.mcpServer.apply(parsed.input);
-            return {
-              kind: "McpServer",
-              name: mcpServer.metadata?.name ?? parsed.input.name,
-              org: mcpServer.metadata?.org ?? org,
-              slug: mcpServer.metadata?.slug ?? parsed.input.name,
-            };
-          }
+        const documents = parseManifest(content, { org });
+        if (documents.length > 1) {
+          throw new Error(
+            "This artifact contains multiple resource documents. " +
+              "Use Apply YAML in the Library to apply multi-document manifests.",
+          );
         }
+
+        const applied = await stigmer.manifest.apply(documents[0]);
+        return {
+          kind: applied.yamlKind,
+          name: applied.name,
+          org: applied.org,
+          slug: applied.slug,
+        };
       } catch (err) {
         setError(toError(err));
         throw err;

package/src/library/useExportResource.ts

@@ -3,10 +3,11 @@
 import { useCallback, useMemo } from "react";
 import { parse as parseYaml } from "yaml";
 import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { Datastore } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/api_pb";
 import type { McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
 import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { serializeManifest } from "@stigmer/sdk";
 import { toast } from "../feedback/toast.js";
-import { serializeAgentYaml, serializeMcpServerYaml } from "./serialize-resource-yaml.js";
 import { serializeWorkflowYaml } from "../workflow/serialize-workflow-yaml.js";
 
 // ---------------------------------------------------------------------------
@@ -16,9 +17,9 @@ import { serializeWorkflowYaml } from "../workflow/serialize-workflow-yaml.js";
 /** Options for {@link useExportResource}. */
 export interface UseExportResourceOptions {
   /** The resource kind — determines which serializer is used. */
-  readonly kind: "Agent" | "McpServer" | "Workflow";
+  readonly kind: "Agent" | "McpServer" | "Workflow" | "Datastore";
   /** The proto resource to export, or `null` when not yet loaded. */
-  readonly resource: Agent | McpServer | Workflow | null;
+  readonly resource: Agent | McpServer | Workflow | Datastore | null;
 }
 
 /** Return value of {@link useExportResource}. */
@@ -42,16 +43,19 @@ export interface UseExportResourceReturn {
 // ---------------------------------------------------------------------------
 
 /**
- * Headless export hook for Stigmer resources (Agent, McpServer).
+ * Headless export hook for Stigmer resources (Agent, McpServer,
+ * Workflow, Datastore).
  *
  * Serializes the resource into YAML and JSON formats and provides
  * stable callbacks for copying to clipboard or triggering a file
  * download. All operations are client-side — no additional API calls.
  *
- * The serialized output uses the canonical Stigmer resource format
- * (`apiVersion`, `kind`, `metadata`, `spec`) with snake_case field
- * names, identical to what the CLI produces and what `parseResourceYaml`
- * accepts — ensuring full round-trip compatibility.
+ * Non-workflow kinds serialize through the SDK manifest engine
+ * ({@link serializeManifest}) — the canonical Stigmer resource format
+ * (`apiVersion`, `kind`, `metadata`, `spec`, snake_case fields) that
+ * round-trips through `parseManifest` and `stigmer apply -f`. Workflows
+ * use their own canonical serializer, shared with the workflow Editor
+ * tab, so one workflow has exactly one YAML shape across the product.
  *
  * @param options - Resource kind and the proto resource object.
  * @returns Stable callbacks and memoized serialized strings.
@@ -68,8 +72,8 @@ export interface UseExportResourceReturn {
  * <ActionMenu.Item onSelect={downloadYaml}>Download YAML</ActionMenu.Item>
  * ```
  *
- * @see {@link serializeAgentYaml} for the underlying Agent serializer
- * @see {@link serializeMcpServerYaml} for the underlying McpServer serializer
+ * @see {@link serializeManifest} for the underlying Agent/McpServer serializer
+ * @see {@link serializeWorkflowYaml} for the workflow-canonical serializer
  */
 export function useExportResource({
   kind,
@@ -77,15 +81,17 @@ export function useExportResource({
 }: UseExportResourceOptions): UseExportResourceReturn {
   const yaml = useMemo<string | null>(() => {
     if (!resource) return null;
-    if (kind === "Agent") return serializeAgentYaml(resource as Agent);
     if (kind === "Workflow") return serializeWorkflowYaml(resource as Workflow);
-    return serializeMcpServerYaml(resource as McpServer);
+    return serializeManifest(resource);
   }, [kind, resource]);
 
   const json = useMemo<string | null>(() => {
-    if (!resource) return null;
-    return serializeResourceJson(resource, kind);
-  }, [kind, resource]);
+    if (!yaml) return null;
+    // Parse the YAML output to re-stringify as JSON — this guarantees the
+    // JSON structure is identical to the YAML structure (snake_case
+    // fields, no status).
+    return JSON.stringify(parseYaml(yaml), null, 2);
+  }, [yaml]);
 
   const slug = useMemo<string>(() => {
     if (!resource) return "resource";
@@ -120,31 +126,6 @@ export function useExportResource({
   );
 }
 
-// ---------------------------------------------------------------------------
-// JSON serialization
-// ---------------------------------------------------------------------------
-
-/**
- * Produces a JSON representation of the resource using the same canonical
- * structure as the YAML export (apiVersion, kind, metadata, spec).
- *
- * Internally parses the YAML output to get a clean plain object, then
- * re-stringifies as JSON. This guarantees the JSON structure is identical
- * to the YAML structure (snake_case fields, no status).
- */
-function serializeResourceJson(
-  resource: Agent | McpServer | Workflow,
-  kind: "Agent" | "McpServer" | "Workflow",
-): string {
-  let yamlStr: string;
-  if (kind === "Agent") yamlStr = serializeAgentYaml(resource as Agent);
-  else if (kind === "Workflow") yamlStr = serializeWorkflowYaml(resource as Workflow);
-  else yamlStr = serializeMcpServerYaml(resource as McpServer);
-
-  const doc = parseYaml(yamlStr);
-  return JSON.stringify(doc, null, 2);
-}
-
 // ---------------------------------------------------------------------------
 // Clipboard
 // ---------------------------------------------------------------------------