@hasna/instructions 0.7.0 → 0.7.2

package/dist/server/index.js

@@ -17,12 +17,18 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/types/index.ts
-var CONFIG_AGENTS, PROFILE_CONFIG_BINDING_SCHEMA = "hasna.instructions.profile-config-binding/v1", INSTRUCTION_ACTIVATION_MODES, INSTRUCTION_FALLBACKS, PROFILE_ASSET_BINDING_SCHEMA = "hasna.instructions.profile-asset-binding/v1", ASSET_KINDS, ASSET_DESTINATION_STRATEGIES, ASSET_SCOPES, ASSET_UNINSTALL_POLICIES, ASSET_ROLLBACK_POLICIES, ConfigNotFoundError, ProfileNotFoundError;
+function validateExpectedConfigVersion(value) {
+  if (value !== undefined && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1)) {
+    throw new InvalidExpectedVersionError;
+  }
+}
+var CONFIG_AGENTS, PROFILE_CONFIG_BINDING_SCHEMA = "hasna.instructions.profile-config-binding/v1", INSTRUCTION_ACTIVATION_MODES, INSTRUCTION_FALLBACKS, PROFILE_ASSET_BINDING_SCHEMA = "hasna.instructions.profile-asset-binding/v1", ASSET_KINDS, ASSET_DESTINATION_STRATEGIES, ASSET_SCOPES, ASSET_UNINSTALL_POLICIES, ASSET_ROLLBACK_POLICIES, InvalidExpectedVersionError, ConfigVersionConflictError, ConfigNotFoundError, ProfileNotFoundError;
 var init_types = __esm(() => {
   CONFIG_AGENTS = [
     "claude",
     "codex",
     "opencode",
+    "sumi",
     "cursor",
     "codewith",
     "aicopilot",
@@ -45,6 +51,25 @@ var init_types = __esm(() => {
   ASSET_SCOPES = ["global", "project", "session"];
   ASSET_UNINSTALL_POLICIES = ["remove-managed", "retain"];
   ASSET_ROLLBACK_POLICIES = ["snapshot", "installer-receipt", "none"];
+  InvalidExpectedVersionError = class InvalidExpectedVersionError extends Error {
+    code = "INVALID_EXPECTED_VERSION";
+    constructor() {
+      super("expected_version must be a positive safe integer");
+      this.name = "InvalidExpectedVersionError";
+    }
+  };
+  ConfigVersionConflictError = 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";
+    }
+  };
   ConfigNotFoundError = class ConfigNotFoundError extends Error {
     constructor(id) {
       super(`Config not found: ${id}`);
@@ -104,7 +129,6 @@ function boundedReadPage(items, total, options = {}) {
   };
 }
 var init_bounded_read = () => {};
-
 // ../../node_modules/.bun/@hasna+contracts@1.0.2+e8014c875821e0be/node_modules/@hasna/contracts/dist/client/transport.js
 import { createRequire } from "module";
 var MAX_CREDENTIAL_FILE_BYTES, INSPECT_CUSTOM, CREDENTIAL_SEAL, AMBIENT_ENVIRONMENT, SECRETS_PACKAGE_SPECIFIER, requireSecretsSdk, IDEMPOTENT_METHODS, AUTHORITY_OVERRIDE_HEADERS;
@@ -174,6 +198,7 @@ var init_config_store = __esm(() => {
 // src/lib/global-agent-rules-standard.ts
 var AGENT_OPERATING_RULES_SOURCE_SET_ID = "hasna-global-agent-rules-standard", AGENT_OPERATING_RULES_SOURCE_ID = "hasna-agent-operating-rules", AGENT_OPERATING_RULES_VERSION = "1.1.26", AGENT_OPERATING_RULES_SOURCE_SET_VERSION = "2026-08-11", AGENT_OPERATING_RULES_PAYLOAD_SHA256 = "486844a3d869e3dabc2f33fd66479d4e2fb0a0d1864a3d8a3dd05669eb3f1b77", AGENT_OPERATING_RULES_UPSTREAM_FILE_SHA256 = "b8e89cdb49e207e5b497ac51384d67022b94fe5645cc9273db60384eb2c2fb32", SCOPED_OPERATIONAL_CONTROL_POLICY_REFERENCE = "hasna-agent-operating-rules/scoped-operational-control/v1", AGENT_OPERATING_RULES_UPSTREAM, SCOPED_OPERATIONAL_CONTROL_POLICY, AGENT_OPERATING_RULES_PROVENANCE, GLOBAL_AGENT_RULES_STANDARD_CONTENT;
 var init_global_agent_rules_standard = __esm(() => {
+  init_types();
   init_config_store();
   AGENT_OPERATING_RULES_UPSTREAM = {
     repository: "hasnaxyz/iapp-identities",
@@ -264,6 +289,7 @@ var init_global_agent_rules_standard = __esm(() => {
 // src/lib/codewith-shared-todos-storage-standard.ts
 var CODEWITH_SHARED_TODOS_STORAGE_POLICY_REFERENCE = "codewith/shared-todos-storage/v1", CODEWITH_SHARED_TODOS_STORAGE_STANDARD_CONTENT;
 var init_codewith_shared_todos_storage_standard = __esm(() => {
+  init_types();
   init_config_store();
   CODEWITH_SHARED_TODOS_STORAGE_STANDARD_CONTENT = `# Codewith Shared Todos Storage Standard
 
@@ -4717,6 +4743,7 @@ var init_asset_plan = __esm(() => {
     codex: "cli",
     cursor: "ide",
     opencode: "cli",
+    sumi: "cli",
     codewith: "cli",
     qwen: "cli",
     aicopilot: "cli",
@@ -4842,6 +4869,15 @@ var init_session_render = __esm(() => {
       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",
@@ -5063,6 +5099,7 @@ var init_instruction_graph = __esm(() => {
   init_types();
   init_session_render();
   init_asset_plan();
+  init_transforms();
   COMMON_FALLBACKS = ["fail", "flatten", "promote-always", "omit"];
   DEFAULT_PROVIDER_CAPABILITIES = Object.freeze({
     claude: capability("claude", ">=1.0.0", "native-import", "CLAUDE.md @ imports plus path-gated rules", {
@@ -5074,6 +5111,7 @@ var init_instruction_graph = __esm(() => {
     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"),
@@ -8013,6 +8051,10 @@ function configFilterSql(filter) {
     const parameter = `$${params.length}`;
     conditions.push(`(name ILIKE ${parameter} OR description ILIKE ${parameter} OR content ILIKE ${parameter})`);
   }
+  if (filter.tags?.length) {
+    for (const tag of filter.tags)
+      add("tags @> $?::jsonb", JSON.stringify([tag]));
+  }
   return {
     where: conditions.length ? `WHERE ${conditions.join(" AND ")}` : "",
     params
@@ -8025,6 +8067,31 @@ async function listConfigsPage(client, filter = {}, options = {}) {
   const rows = await client.many(`SELECT * FROM configs ${where} ORDER BY id LIMIT $${params.length + 1} OFFSET $${params.length + 2}`, [...params, normalized.limit, normalized.cursor]);
   return boundedReadPage(rows.map(rowToConfig), Number(count?.total ?? 0), normalized);
 }
+async function listConfigSummariesPage(client, filter = {}, options = {}) {
+  const normalized = normalizeBoundedReadOptions(options);
+  const { where, params } = configFilterSql(filter);
+  const count = await client.get(`SELECT COUNT(*) AS total FROM configs ${where}`, params);
+  const rows = await client.many(`SELECT id, name, slug, kind, category, agent, target_path, format,
+            jsonb_array_length(outputs) AS output_count, description, tags,
+            is_template, version, updated_at
+       FROM configs ${where} ORDER BY id LIMIT $${params.length + 1} OFFSET $${params.length + 2}`, [...params, normalized.limit, normalized.cursor]);
+  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: toIso2(row.updated_at),
+    description: row.description,
+    tags: Array.isArray(row.tags) ? row.tags.map(String) : []
+  })), Number(count?.total ?? 0), normalized);
+}
 async function listConfigIdentitiesPage(client, filterOrOptions = {}, maybeOptions) {
   const filterKeys = ["category", "agent", "kind", "is_template", "search", "tags"];
   const isFilterOnly = maybeOptions === undefined && filterKeys.some((key) => (key in filterOrOptions));
@@ -8082,6 +8149,7 @@ async function createConfig(client, input) {
   return getConfig(client, id);
 }
 async function updateConfig(client, idOrSlug, input) {
+  validateExpectedConfigVersion(input.expected_version);
   const existing = await getConfig(client, idOrSlug);
   const sets = ["updated_at = now()", "version = version + 1"];
   const params = [];
@@ -8119,13 +8187,27 @@ async function updateConfig(client, idOrSlug, input) {
   const configIdParam = params.length;
   params.push(randomUUID());
   const snapshotIdParam = params.length;
-  await client.execute(`WITH updated_config AS (
-       UPDATE configs SET ${sets.join(", ")} WHERE id = $${configIdParam}
-       RETURNING id, content, version
+  let condition = "";
+  if (input.expected_version !== undefined) {
+    params.push(input.expected_version);
+    condition = ` AND version::bigint = $${params.length}::bigint`;
+  }
+  const updated = await client.get(`WITH updated_config AS (
+       UPDATE configs SET ${sets.join(", ")} WHERE id = $${configIdParam}${condition}
+       RETURNING *
+     ), inserted_snapshot AS (
+       INSERT INTO config_snapshots (id, config_id, content, version, created_at)
+       SELECT $${snapshotIdParam}, id, content, version, now() FROM updated_config
+       RETURNING config_id
      )
-     INSERT INTO config_snapshots (id, config_id, content, version, created_at)
-     SELECT $${snapshotIdParam}, id, content, version, now() FROM updated_config`, params);
-  return getConfig(client, existing.id);
+     SELECT updated_config.* FROM updated_config
+     JOIN inserted_snapshot ON inserted_snapshot.config_id = updated_config.id`, params);
+  if (!updated) {
+    if (input.expected_version !== undefined)
+      throw new ConfigVersionConflictError(existing.id, input.expected_version);
+    throw new ConfigNotFoundError(existing.id);
+  }
+  return rowToConfig(updated);
 }
 async function deleteConfig(client, idOrSlug) {
   const existing = await getConfig(client, idOrSlug);
@@ -8717,16 +8799,25 @@ async function handleV1Request(req, url, context = {}) {
             ...url.searchParams.get("category") ? { category: url.searchParams.get("category") } : {},
             ...url.searchParams.get("agent") ? { agent: url.searchParams.get("agent") } : {},
             ...url.searchParams.get("kind") ? { kind: url.searchParams.get("kind") } : {},
-            ...search ? { search } : {}
+            ...search ? { search } : {},
+            ...url.searchParams.getAll("tag").length ? { tags: url.searchParams.getAll("tag") } : {}
           };
           const options = {
             limit: url.searchParams.get("limit") ?? undefined,
             cursor: url.searchParams.get("cursor") ?? undefined
           };
-          if (url.searchParams.get("view") === "identity") {
+          const view = url.searchParams.get("view");
+          if (view !== null && view !== "identity" && view !== "summary") {
+            return errorResponse(400, "unsupported config view", { code: "INVALID_CONFIG_VIEW" });
+          }
+          if (view === "identity") {
             const page2 = await listConfigIdentitiesPage(client, filter, options);
             return json(pagePayload("configs", page2));
           }
+          if (view === "summary") {
+            const page2 = await listConfigSummariesPage(client, filter, options);
+            return json({ ...page2, count: page2.items.length });
+          }
           const page = await listConfigsPage(client, filter, options);
           return json(pagePayload("configs", page));
         }
@@ -8772,6 +8863,18 @@ async function handleV1Request(req, url, context = {}) {
         }
         return errorResponse(405, `method ${method} not allowed on /v1/configs/:id/snapshots`);
       }
+      if (action === "conditional-update") {
+        if (method !== "POST")
+          return errorResponse(405, `method ${method} not allowed on /v1/configs/:id/conditional-update`);
+        const body = await readJson(req);
+        if (!body)
+          return errorResponse(400, "invalid JSON body");
+        if (body.expected_version === undefined)
+          throw new InvalidExpectedVersionError;
+        validateExpectedConfigVersion(body.expected_version);
+        const config = await updateConfig(client, id, body);
+        return json({ config });
+      }
       if (action)
         return errorResponse(404, `unknown config action: ${action}`);
       if (method === "GET") {
@@ -8975,6 +9078,11 @@ async function handleV1Request(req, url, context = {}) {
   } catch (e) {
     if (e instanceof HttpInputError)
       return errorResponse(e.status, e.message, { code: e.code });
+    if (e instanceof InvalidExpectedVersionError)
+      return errorResponse(400, e.message, { code: e.code });
+    if (e instanceof ConfigVersionConflictError) {
+      return errorResponse(409, e.message, { code: e.code, config_id: e.config_id, expected_version: e.expected_version });
+    }
     if (e instanceof StoreValidationError)
       return errorResponse(400, e.message, { code: e.code });
     if (e instanceof IdempotencyConflictError)
@@ -9010,6 +9118,27 @@ var configSchema = {
     synced_at: { type: "string", nullable: true }
   }
 };
+var configSummarySchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["id", "name", "slug", "kind", "category", "agent", "target_path", "format", "output_count", "description", "tags", "is_template", "version", "updated_at"],
+  properties: {
+    id: { type: "string" },
+    name: { type: "string" },
+    slug: { type: "string" },
+    kind: { type: "string" },
+    category: { type: "string" },
+    agent: { type: "string" },
+    target_path: { type: "string", nullable: true },
+    format: { type: "string" },
+    output_count: { type: "number" },
+    description: { type: "string", nullable: true },
+    tags: { type: "array", items: { type: "string" } },
+    is_template: { type: "boolean" },
+    version: { type: "number" },
+    updated_at: { type: "string" }
+  }
+};
 var profileSchema = {
   type: "object",
   properties: {
@@ -9025,6 +9154,7 @@ var profileSchema = {
 };
 var configIdentitySchema = {
   type: "object",
+  additionalProperties: false,
   required: ["id", "name", "slug", "kind", "category", "agent", "format", "is_template", "version", "created_at", "updated_at", "synced_at"],
   properties: {
     id: { type: "string" },
@@ -9077,6 +9207,12 @@ var snapshotSchema = {
 };
 var limitParameter = { name: "limit", in: "query", schema: { type: "integer", minimum: 1, maximum: 100 } };
 var cursorParameter = { name: "cursor", in: "query", schema: { type: "integer", minimum: 0, maximum: 1e5 } };
+var configViewParameter = {
+  name: "view",
+  in: "query",
+  description: "Use summary for a content-free list projection, or identity for the smallest metadata-only projection.",
+  schema: { type: "string", enum: ["summary", "identity"] }
+};
 var identityViewParameter = {
   name: "view",
   in: "query",
@@ -9120,6 +9256,7 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
       },
       schemas: {
         Config: configSchema,
+        ConfigSummary: configSummarySchema,
         ConfigIdentity: configIdentitySchema,
         Profile: profileSchema,
         ProfileIdentity: profileIdentitySchema,
@@ -9144,6 +9281,26 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
         UpdateConfigInput: {
           type: "object",
           properties: {
+            expected_version: { type: "integer", minimum: 1, description: "Atomically require this current version; a mismatch returns 409 without changing the config or snapshots." },
+            name: { type: "string" },
+            kind: { type: "string" },
+            category: { type: "string" },
+            agent: { type: "string" },
+            target_path: { type: "string", nullable: true },
+            outputs: { type: "array", items: { type: "object" } },
+            format: { type: "string" },
+            content: { type: "string" },
+            description: { type: "string", nullable: true },
+            tags: { type: "array", items: { type: "string" } },
+            is_template: { type: "boolean" },
+            synced_at: { type: "string", nullable: true }
+          }
+        },
+        ConditionalUpdateConfigInput: {
+          type: "object",
+          required: ["expected_version"],
+          properties: {
+            expected_version: { type: "integer", minimum: 1, description: "Atomically require this current version; a mismatch returns 409 without changing the config or snapshots." },
             name: { type: "string" },
             kind: { type: "string" },
             category: { type: "string" },
@@ -9347,6 +9504,23 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
             source_bounded: { type: "boolean" }
           }
         },
+        BoundedConfigSummaryPage: {
+          type: "object",
+          required: ["items", "total", "limit", "cursor", "next_cursor", "has_more", "complete", "truncated", "source_bounded"],
+          properties: {
+            configs: { type: "array", items: { $ref: "#/components/schemas/ConfigSummary" } },
+            items: { type: "array", items: { $ref: "#/components/schemas/ConfigSummary" } },
+            count: { type: "number" },
+            total: { type: "number" },
+            limit: { type: "number" },
+            cursor: { type: "number" },
+            next_cursor: { type: "number", nullable: true },
+            has_more: { type: "boolean" },
+            complete: { type: "boolean" },
+            truncated: { type: "boolean", const: false },
+            source_bounded: { type: "boolean" }
+          }
+        },
         BoundedConfigIdentityPage: {
           type: "object",
           required: ["items", "total", "limit", "cursor", "next_cursor", "has_more", "complete", "truncated", "source_bounded"],
@@ -9485,15 +9659,17 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
             { name: "search", in: "query", schema: { type: "string", maxLength: 512 } },
             limitParameter,
             cursorParameter,
-            identityViewParameter
+            { name: "tag", in: "query", schema: { type: "array", items: { type: "string" } } },
+            configViewParameter
           ],
           responses: {
             "200": {
               content: {
                 "application/json": {
                   schema: {
-                    oneOf: [
+                    anyOf: [
                       { $ref: "#/components/schemas/BoundedConfigPage" },
+                      { $ref: "#/components/schemas/BoundedConfigSummaryPage" },
                       { $ref: "#/components/schemas/BoundedConfigIdentityPage" }
                     ]
                   }
@@ -9546,6 +9722,8 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
             content: { "application/json": { schema: { $ref: "#/components/schemas/UpdateConfigInput" } } }
           },
           responses: {
+            "400": { description: "Invalid expected_version; must be a positive safe integer." },
+            "409": { description: "CONFIG_VERSION_CONFLICT: expected_version no longer matches; config and snapshots are unchanged." },
             "200": {
               content: {
                 "application/json": {
@@ -9564,6 +9742,8 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
             content: { "application/json": { schema: { $ref: "#/components/schemas/UpdateConfigInput" } } }
           },
           responses: {
+            "400": { description: "Invalid expected_version; must be a positive safe integer." },
+            "409": { description: "CONFIG_VERSION_CONFLICT: expected_version no longer matches; config and snapshots are unchanged." },
             "200": {
               content: {
                 "application/json": {
@@ -9588,6 +9768,26 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
           }
         }
       },
+      "/v1/configs/{id}/conditional-update": {
+        post: {
+          operationId: "conditionalUpdateConfig",
+          summary: "Atomically update a config only if its current version matches",
+          description: "Requires expected_version. Older servers return 404 without changing the config. Clients must never retry through an unconditional update route.",
+          parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+          requestBody: {
+            required: true,
+            content: { "application/json": { schema: { $ref: "#/components/schemas/ConditionalUpdateConfigInput" } } }
+          },
+          responses: {
+            "200": {
+              content: { "application/json": { schema: { type: "object", properties: { config: { $ref: "#/components/schemas/Config" } } } } }
+            },
+            "400": { description: "expected_version is required and must be a positive safe integer." },
+            "404": { description: "Config not found, or conditional updates are unsupported by this server." },
+            "409": { description: "CONFIG_VERSION_CONFLICT: config and snapshots are unchanged." }
+          }
+        }
+      },
       "/v1/configs/{id}/snapshots": {
         get: {
           operationId: "listSnapshots",
@@ -10034,14 +10234,14 @@ app.all("/v1/*", async (c) => {
 });
 var HOST = process.env["HOST"] ?? process.env["INSTRUCTIONS_HOST"] ?? "localhost";
 var serverOptions = { port: PORT, hostname: HOST, fetch: app.fetch };
+var server;
 if (import.meta.main) {
   console.log(`instructions-serve listening on http://${HOST}:${PORT} (backend: ${serviceBackend()})`);
-  Bun.serve(serverOptions);
+  server = Bun.serve(serverOptions);
 }
-var server_default = app;
 export {
   serviceBackend,
   serverOptions,
-  server_default as default,
+  server,
   app
 };