@hasna/instructions 0.7.0 → 0.7.2

package/dist/chunks/{index-4pfq42t5.js → index-pq18fdbj.js}

@@ -14,8 +14,9 @@ import {
   ProfileNotFoundError,
   isTemplate,
   renderTemplate,
-  renderTemplatePreview
-} from "./index-3djthcm6.js";
+  renderTemplatePreview,
+  validateExpectedConfigVersion
+} from "./index-27az1qb1.js";
 import {
   __export,
   __require
@@ -114,6 +115,9 @@ function buildCodexAgentsMd(source, context = {}) {
 function buildOpenCodeAgentsMd(source, context = {}) {
   return flattenWithRules(source, context);
 }
+function buildSumiAgentsMd(source, context = {}) {
+  return flattenWithRules(source, context);
+}
 function buildCursorMdc(source) {
   const stem = source.target_path ? basename(source.target_path, extname(source.target_path)) : source.slug;
   const description = source.name || stem;
@@ -142,6 +146,8 @@ function applyTransform(source, output, context = {}) {
       return buildCodexAgentsMd(source, context);
     case "opencode-flat":
       return buildOpenCodeAgentsMd(source, context);
+    case "sumi-flat":
+      return buildSumiAgentsMd(source, context);
     case "cursor-mdc":
       return buildCursorMdc(source);
     case "skill-neutral":
@@ -244,28 +250,6 @@ function truncateText(value, max = 80) {
     return text.slice(0, max);
   return `${text.slice(0, max - 3)}...`;
 }
-function summarizeConfig(config, opts = {}) {
-  const summary = {
-    id: config.id,
-    slug: config.slug,
-    name: config.name,
-    category: config.category,
-    agent: config.agent,
-    kind: config.kind,
-    format: config.format,
-    target_path: config.target_path,
-    output_count: config.outputs.length,
-    version: config.version,
-    is_template: config.is_template
-  };
-  if (opts.verbose) {
-    summary.updated_at = config.updated_at;
-    summary.description = config.description;
-    summary.tags = config.tags;
-    summary.outputs = config.outputs;
-  }
-  return summary;
-}
 function summarizeProfile(profile, opts = {}) {
   const selectorCount = (profile.selectors.os?.length ?? 0) + (profile.selectors.arch?.length ?? 0) + (profile.selectors.hostnames?.length ?? 0);
   const summary = {
@@ -431,6 +415,7 @@ var DEFAULT_ASSET_SURFACES = Object.freeze({
   codex: "cli",
   cursor: "ide",
   opencode: "cli",
+  sumi: "cli",
   codewith: "cli",
   qwen: "cli",
   aicopilot: "cli",
@@ -556,6 +541,7 @@ var DEFAULT_PROVIDER_CAPABILITIES = Object.freeze({
   codex: capability("codex", ">=0.1.0", "flattened", "AGENTS.md", { asset_surface: "cli" }),
   cursor: capability("cursor", ">=1.0.0", "cursor-rule", ".cursor/rules/*.mdc", { activation_modes: ["always", "glob"], conditional_artifacts: true, asset_surface: "ide" }),
   opencode: capability("opencode", ">=1.0.0", "managed-fragment", "opencode.json instructions", { provider_variant: "v1-instructions", session_surface: "opencode-config-instructions" }),
+  sumi: capability("sumi", ">=0.2.22 <0.3.0", "flattened", "AGENTS.md"),
   codewith: capability("codewith", ">=0.1.0", "flattened", "CODEWITH.md"),
   qwen: capability("qwen", ">=0.1.0", "flattened", "QWEN.md"),
   aicopilot: capability("aicopilot", ">=0.1.0", "flattened", "AICOPILOT.md"),
@@ -2059,6 +2045,19 @@ function parseBoundedOrLegacyPage(value, legacyItems, options, label) {
   const page = boundedReadPage(legacyItems.slice(normalized.cursor, normalized.cursor + normalized.limit), legacyItems.length, normalized);
   return { ...page, source_bounded: false };
 }
+function projectBoundedPage(page, project) {
+  return {
+    items: page.items.map(project),
+    total: page.total,
+    limit: page.limit,
+    cursor: page.cursor,
+    next_cursor: page.next_cursor,
+    has_more: page.has_more,
+    complete: page.complete,
+    truncated: page.truncated,
+    source_bounded: page.source_bounded
+  };
+}
 
 class CollectionChangedWhilePagingError extends Error {
   constructor(label, detail) {
@@ -2124,7 +2123,7 @@ function isNotFoundHttpError2(err) {
 var localStoreModulePromise = null;
 function localStoreModule() {
   if (!localStoreModulePromise)
-    localStoreModulePromise = import("./local-5wvv5xv3.js");
+    localStoreModulePromise = import("./local-1c1qxzvx.js");
   return localStoreModulePromise;
 }
 
@@ -2138,6 +2137,15 @@ class LocalConfigStore {
   async listConfigs(filter) {
     return (await localStoreModule()).listConfigs(filter, this.db);
   }
+  async listConfigsPage(filter = {}, options = {}) {
+    return (await localStoreModule()).listConfigsPage(filter, options, this.db);
+  }
+  async listConfigIdentitiesPage(filter = {}, options = {}) {
+    return (await localStoreModule()).listConfigIdentitiesPage(filter, options, this.db);
+  }
+  async listConfigSummariesPage(filter = {}, options = {}) {
+    return (await localStoreModule()).listConfigSummariesPage(filter, options, this.db);
+  }
   async getConfig(idOrSlug) {
     return (await localStoreModule()).getConfig(idOrSlug, this.db);
   }
@@ -2241,6 +2249,43 @@ class LocalConfigStore {
     (await localStoreModule()).resetLocalDatabase();
   }
 }
+function toConfigIdentity(value) {
+  const record = value && typeof value === "object" ? value : {};
+  return {
+    id: String(record.id ?? ""),
+    name: String(record.name ?? ""),
+    slug: String(record.slug ?? ""),
+    kind: String(record.kind ?? ""),
+    category: String(record.category ?? ""),
+    agent: String(record.agent ?? ""),
+    format: String(record.format ?? ""),
+    is_template: Boolean(record.is_template),
+    version: Number(record.version ?? 0),
+    created_at: String(record.created_at ?? ""),
+    updated_at: String(record.updated_at ?? ""),
+    synced_at: record.synced_at == null ? null : String(record.synced_at)
+  };
+}
+function toConfigSummary(value) {
+  const record = value && typeof value === "object" ? value : {};
+  const outputs = Array.isArray(record.outputs) ? record.outputs : [];
+  return {
+    id: String(record.id ?? ""),
+    slug: String(record.slug ?? ""),
+    name: String(record.name ?? ""),
+    category: String(record.category ?? ""),
+    agent: String(record.agent ?? ""),
+    kind: String(record.kind ?? ""),
+    format: String(record.format ?? ""),
+    target_path: record.target_path == null ? null : String(record.target_path),
+    output_count: Number(record.output_count ?? outputs.length),
+    version: Number(record.version ?? 0),
+    is_template: Boolean(record.is_template),
+    ...record.updated_at !== undefined ? { updated_at: String(record.updated_at) } : {},
+    ...record.description !== undefined ? { description: record.description == null ? null : String(record.description) } : {},
+    ...Array.isArray(record.tags) ? { tags: record.tags.map(String) } : {}
+  };
+}
 
 class CloudConfigStore {
   mode = "api";
@@ -2262,7 +2307,7 @@ class CloudConfigStore {
       throw err;
     }
   }
-  async listConfigsPageRemote(filter, options) {
+  async listConfigsPage(filter = {}, options = {}) {
     const normalized = normalizeBoundedReadOptions(options);
     const params = new URLSearchParams;
     if (filter.category)
@@ -2273,13 +2318,67 @@ class CloudConfigStore {
       params.set("kind", filter.kind);
     if (filter.search)
       params.set("search", filter.search);
+    for (const tag of filter.tags ?? [])
+      params.append("tag", tag);
     params.set("limit", String(normalized.limit));
     params.set("cursor", String(normalized.cursor));
     const { data } = await this.request("GET", `/configs?${params.toString()}`);
     return parseBoundedOrLegacyPage(data, data?.configs, normalized, "config list");
   }
+  async listConfigIdentitiesPage(filter = {}, options = {}) {
+    const normalized = normalizeBoundedReadOptions(options);
+    const params = new URLSearchParams;
+    if (filter.category)
+      params.set("category", filter.category);
+    if (filter.agent)
+      params.set("agent", filter.agent);
+    if (filter.kind)
+      params.set("kind", filter.kind);
+    if (filter.search)
+      params.set("search", filter.search);
+    for (const tag of filter.tags ?? [])
+      params.append("tag", tag);
+    params.set("view", "identity");
+    params.set("limit", String(normalized.limit));
+    params.set("cursor", String(normalized.cursor));
+    const { data } = await this.request("GET", `/configs?${params.toString()}`);
+    const page = parseBoundedOrLegacyPage(data, data?.configs, normalized, "config identity list");
+    if (page.items.some((item) => {
+      const record = item && typeof item === "object" ? item : {};
+      return ["content", "target_path", "outputs", "description", "tags"].some((field) => Object.prototype.hasOwnProperty.call(record, field));
+    })) {
+      throw new Error("Instructions /v1 config identity projection is unavailable; deploy the identity endpoint before using compact lists");
+    }
+    return projectBoundedPage(page, toConfigIdentity);
+  }
+  async listConfigSummariesPage(filter = {}, options = {}) {
+    const normalized = normalizeBoundedReadOptions(options);
+    const params = new URLSearchParams;
+    if (filter.category)
+      params.set("category", filter.category);
+    if (filter.agent)
+      params.set("agent", filter.agent);
+    if (filter.kind)
+      params.set("kind", filter.kind);
+    if (filter.search)
+      params.set("search", filter.search);
+    for (const tag of filter.tags ?? [])
+      params.append("tag", tag);
+    params.set("view", "summary");
+    params.set("limit", String(normalized.limit));
+    params.set("cursor", String(normalized.cursor));
+    const { data } = await this.request("GET", `/configs?${params.toString()}`);
+    const page = parseBoundedOrLegacyPage(data, data?.configs, normalized, "config summary list");
+    if (page.items.some((item) => {
+      const record = item && typeof item === "object" ? item : {};
+      return Object.prototype.hasOwnProperty.call(record, "content") || Object.prototype.hasOwnProperty.call(record, "outputs");
+    })) {
+      throw new Error("Instructions /v1 config summary projection is unavailable; deploy the summary endpoint before using summary lists");
+    }
+    return projectBoundedPage(page, toConfigSummary);
+  }
   async listConfigs(filter = {}) {
-    const configs = await aggregateBoundedCollection("config list", (cursor) => this.listConfigsPageRemote(filter, { limit: 100, cursor }), (config) => config.id, { requireAscendingIdentity: true });
+    const configs = await aggregateBoundedCollection("config list", (cursor) => this.listConfigsPage(filter, { limit: 100, cursor }), (config) => config.id, { requireAscendingIdentity: true });
     let filtered = configs;
     if (filter.tags && filter.tags.length > 0) {
       filtered = filtered.filter((config) => filter.tags.every((tag) => config.tags.includes(tag)));
@@ -2305,7 +2404,9 @@ class CloudConfigStore {
     return data.config;
   }
   async updateConfig(idOrSlug, input) {
-    const { data } = await this.request("PATCH", `/configs/${encodeURIComponent(idOrSlug)}`, input);
+    validateExpectedConfigVersion(input.expected_version);
+    const conditional = input.expected_version !== undefined;
+    const { data } = await this.request(conditional ? "POST" : "PATCH", `/configs/${encodeURIComponent(idOrSlug)}${conditional ? "/conditional-update" : ""}`, input);
     return data.config;
   }
   async deleteConfig(idOrSlug) {
@@ -2345,7 +2446,7 @@ class CloudConfigStore {
     return data?.pruned ?? 0;
   }
   async listProfiles() {
-    return aggregateBoundedCollection("profile list", (cursor) => this.listProfilesPage({ limit: 100, cursor }), (profile) => profile.id, { requireAscendingIdentity: true });
+    return aggregateBoundedCollection("profile list", (cursor) => this.listProfilesPage({ limit: 100, cursor }), (profile) => profile.id);
   }
   async listProfilesPage(options = {}) {
     const normalized = normalizeBoundedReadOptions(options);
@@ -2382,7 +2483,7 @@ class CloudConfigStore {
       throw new ProfileNotFoundError(idOrSlug);
     return parseBoundedOrLegacyPage(data.configs, data.profile.configs, normalized, "profile membership");
   }
-  async getProfileConfigBindings(idOrSlug) {
+  async getProfileConfigBindings(idOrSlug, options = {}) {
     let routeMissing = false;
     const bindings = await aggregateBoundedCollection("profile config bindings", async (cursor) => {
       const normalized = normalizeBoundedReadOptions({ limit: 100, cursor });
@@ -2395,6 +2496,8 @@ class CloudConfigStore {
     }, (binding) => `${binding.profile_id}\x00${binding.config_id}`);
     if (!routeMissing)
       return bindings;
+    if (options.requireExplicit)
+      throw new Error("HOSTED_BINDINGS_REQUIRED: profile config binding route is unavailable; refusing legacy activation fallback.");
     const profile = await this.getProfile(idOrSlug);
     const configs = await this.getProfileConfigs(idOrSlug);
     return configs.map((config, sort_order) => ({
@@ -2459,7 +2562,7 @@ class CloudConfigStore {
   async removeConfigFromProfile(profileIdOrSlug, configId) {
     await this.request("DELETE", `/profiles/${encodeURIComponent(profileIdOrSlug)}/configs/${encodeURIComponent(configId)}`, undefined, { allow404: true });
   }
-  async getProfileAssetBindings(profileIdOrSlug) {
+  async getProfileAssetBindings(profileIdOrSlug, options = {}) {
     let routeMissing = false;
     const assets = await aggregateBoundedCollection("profile asset bindings", async (cursor) => {
       const normalized = normalizeBoundedReadOptions({ limit: 100, cursor });
@@ -2472,6 +2575,8 @@ class CloudConfigStore {
     }, (asset) => `${asset.profile_id}\x00${asset.binding.assetKey}`);
     if (!routeMissing)
       return assets;
+    if (options.requireExplicit)
+      throw new Error("HOSTED_ASSETS_REQUIRED: profile asset binding route is unavailable; refusing an empty asset fallback.");
     await this.getProfile(profileIdOrSlug);
     return [];
   }
@@ -7108,6 +7213,15 @@ var SESSION_TOOL_ADAPTERS = {
     description: "OpenCode AGENTS.md plus opencode.json instructions pointing at managed fragments.",
     providerSurface: "legacy-dual"
   },
+  sumi: {
+    tool: "sumi",
+    mode: "flattened-markdown",
+    indexFile: "AGENTS.md",
+    managedDir: SESSION_RENDER_INSTRUCTIONS_MANAGED_DIR,
+    envVar: "SUMI_CONFIG_DIR",
+    nativeImports: false,
+    description: "Sumi native AGENTS.md in the explicit resolved config directory or project root."
+  },
   aicopilot: {
     tool: "aicopilot",
     mode: "flattened-markdown",
@@ -7297,4 +7411,4 @@ function renderMachineAwareContentPreview(content, variables) {
   return isTemplate(content) ? renderTemplatePreview(content, variables) : { content, unresolved: [] };
 }
 
-export { pagedPayload, summarizeConfig, summarizeProfile, summarizeApplyResult, normalizeBoundedReadOptions, boundedReadPage, SESSION_RENDER_SCHEMA, SESSION_RENDER_MANIFEST_RELATIVE_PATH, isRetiredOrUnsupportedConfigAgent, retiredOrUnsupportedAgentReason, applyTransform, normalizeProfileAssetBinding, isCursorGlobalAuthorityPath, stampCursorGlobalAuthorityMarker, getReportedDbPath, getRawStoreRoot, ANTIGRAVITY_RULE_FILE_CHAR_LIMIT, SESSION_RENDERER_OWNER_ID, SESSION_RENDER_OWNED_CONFIG_TARGETS, SESSION_RENDER_EXCLUSIVE_MANAGED_PATHS, legacyProfileConfigBinding, normalizeProfileConfigBinding, hasInstructionsEnvAuthorityIntent, normalizeOsFamily, detectMachineContext, machineContextToVariables, resolveProfileVariables, templateizeMachineContent, renderMachineAwareContentPreview, resolveConfigStore };
+export { pagedPayload, summarizeProfile, summarizeApplyResult, normalizeBoundedReadOptions, boundedReadPage, SESSION_RENDER_SCHEMA, SESSION_RENDER_MANIFEST_RELATIVE_PATH, isRetiredOrUnsupportedConfigAgent, retiredOrUnsupportedAgentReason, applyTransform, normalizeProfileAssetBinding, isCursorGlobalAuthorityPath, stampCursorGlobalAuthorityMarker, getReportedDbPath, getRawStoreRoot, ANTIGRAVITY_RULE_FILE_CHAR_LIMIT, SESSION_RENDERER_OWNER_ID, SESSION_RENDER_OWNED_CONFIG_TARGETS, SESSION_RENDER_EXCLUSIVE_MANAGED_PATHS, legacyProfileConfigBinding, normalizeProfileConfigBinding, hasInstructionsEnvAuthorityIntent, normalizeOsFamily, detectMachineContext, machineContextToVariables, resolveProfileVariables, templateizeMachineContent, renderMachineAwareContentPreview, resolveConfigStore };

package/dist/chunks/{index-n3fjspr0.js → index-preyvj8n.js}

@@ -4,6 +4,7 @@ var CONFIG_AGENTS = [
   "claude",
   "codex",
   "opencode",
+  "sumi",
   "cursor",
   "codewith",
   "aicopilot",
@@ -30,6 +31,32 @@ var ASSET_UNINSTALL_POLICIES = ["remove-managed", "retain"];
 var ASSET_ROLLBACK_POLICIES = ["snapshot", "installer-receipt", "none"];
 var INSTRUCTIONS_DOMAIN_ARCHIVE_SCHEMA = "hasna.instructions.domain-archive/v2";
 
+class InvalidExpectedVersionError extends Error {
+  code = "INVALID_EXPECTED_VERSION";
+  constructor() {
+    super("expected_version must be a positive safe integer");
+    this.name = "InvalidExpectedVersionError";
+  }
+}
+function validateExpectedConfigVersion(value) {
+  if (value !== undefined && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1)) {
+    throw new InvalidExpectedVersionError;
+  }
+}
+
+class ConfigVersionConflictError extends Error {
+  config_id;
+  expected_version;
+  code = "CONFIG_VERSION_CONFLICT";
+  status = 409;
+  constructor(config_id, expected_version) {
+    super(`Config version conflict: ${config_id} no longer has expected version ${expected_version}`);
+    this.config_id = config_id;
+    this.expected_version = expected_version;
+    this.name = "ConfigVersionConflictError";
+  }
+}
+
 class ConfigNotFoundError extends Error {
   constructor(id) {
     super(`Config not found: ${id}`);
@@ -116,4 +143,4 @@ function isTemplate(content) {
   return VAR_PATTERN.test(content);
 }
 
-export { CONFIG_AGENTS, PROFILE_CONFIG_BINDING_SCHEMA, INSTRUCTION_ACTIVATION_MODES, INSTRUCTION_FALLBACKS, PROFILE_ASSET_BINDING_SCHEMA, ASSET_KINDS, ASSET_DESTINATION_STRATEGIES, ASSET_SCOPES, ASSET_UNINSTALL_POLICIES, ASSET_ROLLBACK_POLICIES, INSTRUCTIONS_DOMAIN_ARCHIVE_SCHEMA, ConfigNotFoundError, ProfileNotFoundError, ConfigApplyError, parseTemplateVars, extractTemplateVars, renderTemplate, renderTemplatePreview, isTemplate };
+export { CONFIG_AGENTS, PROFILE_CONFIG_BINDING_SCHEMA, INSTRUCTION_ACTIVATION_MODES, INSTRUCTION_FALLBACKS, PROFILE_ASSET_BINDING_SCHEMA, ASSET_KINDS, ASSET_DESTINATION_STRATEGIES, ASSET_SCOPES, ASSET_UNINSTALL_POLICIES, ASSET_ROLLBACK_POLICIES, INSTRUCTIONS_DOMAIN_ARCHIVE_SCHEMA, validateExpectedConfigVersion, ConfigVersionConflictError, ConfigNotFoundError, ProfileNotFoundError, ConfigApplyError, parseTemplateVars, extractTemplateVars, renderTemplate, renderTemplatePreview, isTemplate };

package/dist/chunks/{index-z3ma4aqk.js → index-y8410ve0.js}

@@ -18,11 +18,11 @@ import {
   resolveProfileVariables,
   scanSecrets,
   stampCursorGlobalAuthorityMarker
-} from "./index-7m4j8a33.js";
+} from "./index-n6nh6f5r.js";
 import {
   ConfigApplyError,
   parseTemplateVars
-} from "./index-n3fjspr0.js";
+} from "./index-preyvj8n.js";
 
 // src/lib/apply.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, realpathSync, writeFileSync } from "fs";
@@ -529,4 +529,4 @@ function sessionRendererOwnsCanonicalTarget(normalized, opts) {
   return sessionRenderOwnsPath(normalized);
 }
 
-export { getConfigHome, expandPath, compactPathForConfigHome, normalizeTargetPath, applyConfig, applyConfigs, applyConfigsWithReport, previewConfigs };
+export { sessionRenderOwnsPath, getConfigHome, expandPath, compactPathForConfigHome, normalizeTargetPath, applyConfig, applyConfigs, applyConfigsWithReport, previewConfigs };

package/dist/chunks/{local-5wvv5xv3.js → local-1c1qxzvx.js}

@@ -14,12 +14,14 @@ import {
   normalizeOsFamily,
   normalizeProfileAssetBinding,
   normalizeProfileConfigBinding
-} from "./index-4pfq42t5.js";
+} from "./index-pq18fdbj.js";
 import"./index-35z65jsa.js";
 import {
   ConfigNotFoundError,
-  ProfileNotFoundError
-} from "./index-3djthcm6.js";
+  ConfigVersionConflictError,
+  ProfileNotFoundError,
+  validateExpectedConfigVersion
+} from "./index-27az1qb1.js";
 import"./index-nnwp92tk.js";
 
 // src/db/database.ts
@@ -339,7 +341,145 @@ function listConfigs(filter, db) {
   const rows = d.query(`SELECT * FROM configs ${where} ORDER BY category, name`).all(...params);
   return rows.map(rowToConfig);
 }
+function listConfigsPage(filter = {}, options = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (filter.category) {
+    conditions.push("category = ?");
+    params.push(filter.category);
+  }
+  if (filter.agent) {
+    conditions.push("agent = ?");
+    params.push(filter.agent);
+  }
+  if (filter.kind) {
+    conditions.push("kind = ?");
+    params.push(filter.kind);
+  }
+  if (filter.is_template !== undefined) {
+    conditions.push("is_template = ?");
+    params.push(filter.is_template ? 1 : 0);
+  }
+  if (filter.search) {
+    conditions.push("(name LIKE ? OR description LIKE ? OR content LIKE ?)");
+    const q = `%${filter.search}%`;
+    params.push(q, q, q);
+  }
+  if (filter.tags?.length) {
+    conditions.push(`(${filter.tags.map(() => "tags LIKE ?").join(" AND ")})`);
+    for (const tag of filter.tags)
+      params.push(`%"${tag}"%`);
+  }
+  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  const normalized = normalizeBoundedReadOptions(options);
+  const total = d.query(`SELECT COUNT(*) AS total FROM configs ${where}`).get(...params)?.total ?? 0;
+  const pageParams = [...params, normalized.limit, normalized.cursor];
+  const rows = d.query(`SELECT * FROM configs ${where} ORDER BY id LIMIT ? OFFSET ?`).all(...pageParams);
+  return boundedReadPage(rows.map(rowToConfig), total, normalized);
+}
+function listConfigIdentitiesPage(filter = {}, options = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (filter.category) {
+    conditions.push("category = ?");
+    params.push(filter.category);
+  }
+  if (filter.agent) {
+    conditions.push("agent = ?");
+    params.push(filter.agent);
+  }
+  if (filter.kind) {
+    conditions.push("kind = ?");
+    params.push(filter.kind);
+  }
+  if (filter.is_template !== undefined) {
+    conditions.push("is_template = ?");
+    params.push(filter.is_template ? 1 : 0);
+  }
+  if (filter.search) {
+    conditions.push("(name LIKE ? OR description LIKE ? OR content LIKE ?)");
+    const q = `%${filter.search}%`;
+    params.push(q, q, q);
+  }
+  if (filter.tags?.length) {
+    conditions.push(`(${filter.tags.map(() => "tags LIKE ?").join(" AND ")})`);
+    for (const tag of filter.tags)
+      params.push(`%"${tag}"%`);
+  }
+  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  const normalized = normalizeBoundedReadOptions(options);
+  const total = d.query(`SELECT COUNT(*) AS total FROM configs ${where}`).get(...params)?.total ?? 0;
+  const pageParams = [...params, normalized.limit, normalized.cursor];
+  const rows = d.query(`SELECT id, name, slug, kind, category, agent, format, is_template, version, created_at, updated_at, synced_at
+       FROM configs ${where} ORDER BY id LIMIT ? OFFSET ?`).all(...pageParams);
+  return boundedReadPage(rows.map((row) => ({
+    ...row,
+    kind: row.kind,
+    category: row.category,
+    agent: row.agent,
+    format: row.format,
+    is_template: Boolean(row.is_template)
+  })), total, normalized);
+}
+function listConfigSummariesPage(filter = {}, options = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (filter.category) {
+    conditions.push("category = ?");
+    params.push(filter.category);
+  }
+  if (filter.agent) {
+    conditions.push("agent = ?");
+    params.push(filter.agent);
+  }
+  if (filter.kind) {
+    conditions.push("kind = ?");
+    params.push(filter.kind);
+  }
+  if (filter.is_template !== undefined) {
+    conditions.push("is_template = ?");
+    params.push(filter.is_template ? 1 : 0);
+  }
+  if (filter.search) {
+    conditions.push("(name LIKE ? OR description LIKE ? OR content LIKE ?)");
+    const q = `%${filter.search}%`;
+    params.push(q, q, q);
+  }
+  if (filter.tags && filter.tags.length > 0) {
+    conditions.push(`(${filter.tags.map(() => "tags LIKE ?").join(" AND ")})`);
+    for (const tag of filter.tags)
+      params.push(`%"${tag}"%`);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const normalized = normalizeBoundedReadOptions(options);
+  const total = d.query(`SELECT COUNT(*) AS total FROM configs ${where}`).get(...params)?.total ?? 0;
+  const pageParams = [...params, normalized.limit, normalized.cursor];
+  const rows = d.query(`SELECT id, name, slug, kind, category, agent, target_path, format,
+            CASE WHEN json_valid(outputs) AND json_type(outputs) = 'array' THEN json_array_length(outputs) ELSE 0 END AS output_count, description, tags,
+            is_template, version, updated_at
+       FROM configs ${where} ORDER BY category, name, id LIMIT ? OFFSET ?`).all(...pageParams);
+  return boundedReadPage(rows.map((row) => ({
+    id: row.id,
+    slug: row.slug,
+    name: row.name,
+    category: row.category,
+    agent: row.agent,
+    kind: row.kind,
+    format: row.format,
+    target_path: row.target_path,
+    output_count: Number(row.output_count ?? 0),
+    version: row.version,
+    is_template: Boolean(row.is_template),
+    updated_at: row.updated_at,
+    description: row.description,
+    tags: JSON.parse(row.tags || "[]")
+  })), total, normalized);
+}
 function updateConfig(idOrSlug, input, db) {
+  validateExpectedConfigVersion(input.expected_version);
   const d = db || getDatabase();
   const existing = getConfig(idOrSlug, d);
   const ts = now();
@@ -395,7 +535,15 @@ function updateConfig(idOrSlug, input, db) {
   }
   return d.transaction(() => {
     params.push(existing.id);
-    d.run(`UPDATE configs SET ${updates.join(", ")} WHERE id = ?`, params);
+    const condition = input.expected_version === undefined ? "" : " AND version = ?";
+    if (input.expected_version !== undefined)
+      params.push(input.expected_version);
+    const result = d.run(`UPDATE configs SET ${updates.join(", ")} WHERE id = ?${condition}`, params);
+    if (result.changes !== 1) {
+      if (input.expected_version !== undefined)
+        throw new ConfigVersionConflictError(existing.id, input.expected_version);
+      throw new ConfigNotFoundError(existing.id);
+    }
     const updated = getConfigById(existing.id, d);
     createSnapshot(updated.id, updated.content, updated.version, d);
     return updated;
@@ -673,7 +821,10 @@ export {
   listSnapshots,
   listProfilesPage,
   listMachines,
+  listConfigsPage,
   listConfigs,
+  listConfigSummariesPage,
+  listConfigIdentitiesPage,
   insertFeedback,
   getSnapshotByVersion,
   getSnapshot,