@capybara-hq/kernel 0.1.0-rc.0 → 0.1.0-rc.10

package/dist/skills/skills.module.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Skills: the org library, agent-written skills and their approvals, the run start's skills
+ * catalog snapshot and the one {@link SkillInvoker}.
+ */
+export declare class SkillsModule {
+}

package/dist/skills/skills.module.js

@@ -0,0 +1,39 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Module } from "@nestjs/common";
+import { AgentLookupModule } from "../agents/agent-lookup.js";
+import { CatalogImportModule } from "../catalog/catalog-import.module.js";
+import { AttachmentsModule } from "../conversations/attachments.module.js";
+import { EventLogModule } from "../conversations/event-log.js";
+import { OrgLockModule } from "../orgs/org-lock.js";
+import { StorageModule } from "../storage/storage.module.js";
+import { SkillsCatalogService } from "./catalog.js";
+import { SkillChangesService } from "./changes.service.js";
+import { SkillInvoker } from "./invoke.js";
+import { SkillsService } from "./skills.service.js";
+/**
+ * Skills: the org library, agent-written skills and their approvals, the run start's skills
+ * catalog snapshot and the one {@link SkillInvoker}.
+ */
+let SkillsModule = class SkillsModule {
+};
+SkillsModule = __decorate([
+    Module({
+        imports: [
+            StorageModule,
+            OrgLockModule,
+            EventLogModule,
+            AttachmentsModule,
+            AgentLookupModule,
+            // the owner's new version of a skill it promoted goes to the platform row (ruling P3-4)
+            CatalogImportModule,
+        ],
+        providers: [SkillsService, SkillChangesService, SkillsCatalogService, SkillInvoker],
+        exports: [SkillsService, SkillChangesService, SkillsCatalogService, SkillInvoker],
+    })
+], SkillsModule);
+export { SkillsModule };

package/dist/skills/skills.schemas.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import type { RouteSchemas } from "../platform/route-schemas.js";
+/**
+ * The fields of `POST /skills` before the either-or refinement: zod 4 cannot `pick` / `omit` a
+ * refined object, so operations build from these and the route validates {@link SkillCreateBody}.
+ */
+export declare const SkillCreateFields: z.ZodObject<{
+    uploadId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    description: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    shareable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const SkillCreateBody: z.ZodObject<{
+    uploadId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    description: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    shareable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** `:id` where the route validates it (`@ZParam`). */
+export declare const SkillIdParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/** `:id` where the route takes it as is (`@Param`). */
+export declare const SkillPathParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const SkillShareableSchema: z.ZodObject<{
+    shareable: z.ZodBoolean;
+}, z.core.$strict>;
+/** `:id` of `GET /skill-changes/:id` (taken as is). */
+export declare const SkillChangePathParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/** `:agentId` of the agent's skills and invocable skills routes (taken as is). */
+export declare const AgentSkillsListParams: z.ZodObject<{
+    agentId: z.ZodString;
+}, z.core.$strip>;
+export declare const AgentSkillPathParams: z.ZodObject<{
+    agentId: z.ZodString;
+    skillId: z.ZodString;
+}, z.core.$strip>;
+/** `?conversationId=` of `GET /agents/:agentId/invocable-skills`. */
+export declare const InvocableSkillsQuerySchema: z.ZodObject<{
+    conversationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const SKILL_ROUTES: readonly RouteSchemas[];

package/dist/skills/skills.schemas.js

@@ -0,0 +1,61 @@
+import { isSkillName, SKILL_LIMITS } from "@capybara-hq/plugin-sdk";
+import { z } from "zod";
+import { SKILL_WRITE_MAX_BYTES } from "../tools/builtins/skill-write.js";
+/**
+ * The fields of `POST /skills` before the either-or refinement: zod 4 cannot `pick` / `omit` a
+ * refined object, so operations build from these and the route validates {@link SkillCreateBody}.
+ */
+export const SkillCreateFields = z
+    .object({
+    uploadId: z.string().min(1).max(100).optional(),
+    name: z
+        .string()
+        .refine(isSkillName, "name must be 1-64 lowercase letters, digits and single hyphens")
+        .optional(),
+    description: z.string().min(1).max(SKILL_LIMITS.descriptionMaxChars).optional(),
+    body: z.string().max(SKILL_WRITE_MAX_BYTES).optional(),
+    shareable: z.boolean().optional(),
+})
+    .strict();
+export const SkillCreateBody = SkillCreateFields.refine((v) => v.uploadId !== undefined
+    ? v.name === undefined && v.description === undefined && v.body === undefined
+    : v.name !== undefined && v.description !== undefined && v.body !== undefined, "send either { uploadId } or { name, description, body }");
+/** `:id` where the route validates it (`@ZParam`). */
+export const SkillIdParams = z.object({ id: z.string().min(1).max(100) });
+/** `:id` where the route takes it as is (`@Param`). */
+export const SkillPathParams = z.object({ id: z.string().min(1) });
+export const SkillShareableSchema = z.object({ shareable: z.boolean() }).strict();
+/** `:id` of `GET /skill-changes/:id` (taken as is). */
+export const SkillChangePathParams = z.object({ id: z.string().min(1).max(100) });
+/** `:agentId` of the agent's skills and invocable skills routes (taken as is). */
+export const AgentSkillsListParams = z.object({ agentId: z.string().min(1).max(100) });
+export const AgentSkillPathParams = AgentSkillsListParams.extend({
+    skillId: z.string().min(1).max(100),
+});
+/** `?conversationId=` of `GET /agents/:agentId/invocable-skills`. */
+export const InvocableSkillsQuerySchema = z
+    .object({ conversationId: z.string().min(1).max(100).optional() })
+    .strict();
+export const SKILL_ROUTES = [
+    { route: "GET /api/v1/orgs/:orgId/skill-changes/:id", params: SkillChangePathParams },
+    { route: "GET /api/v1/orgs/:orgId/agents/:agentId/skills", params: AgentSkillsListParams },
+    {
+        route: "DELETE /api/v1/orgs/:orgId/agents/:agentId/skills/:skillId",
+        params: AgentSkillPathParams,
+    },
+    {
+        route: "GET /api/v1/orgs/:orgId/agents/:agentId/invocable-skills",
+        params: AgentSkillsListParams,
+        query: InvocableSkillsQuerySchema,
+    },
+    { route: "GET /api/v1/orgs/:orgId/skills" },
+    { route: "GET /api/v1/orgs/:orgId/skills/:id", params: SkillPathParams },
+    { route: "POST /api/v1/orgs/:orgId/skills", body: SkillCreateBody },
+    {
+        route: "PUT /api/v1/orgs/:orgId/skills/:id/shareable",
+        params: SkillIdParams,
+        body: SkillShareableSchema,
+    },
+    { route: "GET /api/v1/orgs/:orgId/skills/:id/delete-preview", params: SkillIdParams },
+    { route: "DELETE /api/v1/orgs/:orgId/skills/:id", params: SkillPathParams },
+];

package/dist/skills/skills.service.d.ts

@@ -1,12 +1,14 @@
-import { type SkillInvocation } from "@capybara-hq/plugin-sdk";
-import { type Transaction } from "kysely";
 import type { AgentDefinition } from "../agents/definition.js";
-import { type AttachmentsService, type CreatedAttachment } from "../conversations/attachments.service.js";
-import type { KernelDatabase, KernelDb, SkillManifest, SourceFormat } from "../db/kernel-schema.js";
+import { type Owner } from "../catalog/ownership.js";
+import { PlatformComponents } from "../catalog/platform-components.js";
+import { AttachmentsService, type CreatedAttachment } from "../conversations/attachments.service.js";
+import type { KernelSchemaDb, SkillManifest, SourceFormat } from "../db/kernel-schema.js";
 import { ApiError } from "../errors.js";
-import type { StorageService } from "../storage/storage.service.js";
-import { type SkillPackageFile } from "./package.js";
-type Trx = Transaction<KernelDatabase>;
+import { KernelDb } from "../infra/database/kernel-db.js";
+import { TransactionHost } from "../infra/database/transaction-host.js";
+import { OrgLock } from "../orgs/org-lock.js";
+import { StorageService } from "../storage/storage.service.js";
+import { type SkillPackageInput } from "./package.js";
 /** Where an org skill came from (spec §9.2): the org's own, or a catalog plugin at a version. */
 export type SkillSource = {
     kind: "org";
@@ -21,12 +23,15 @@ export interface SkillConflict {
     source: SkillSource;
 }
 /**
- * The live org skills named in `skillNames` whose provenance is not catalog item `itemId` (spec
- * §9.2, Decision 8): the org's own skills (`catalog_item_id` null: uploaded or written by an
- * agent) and the skills of other catalog items. A skill of the same item (a reinstall or upgrade)
- * is not a conflict. In the order of `skillNames`.
+ * The skills named in `skillNames` an org would see twice if catalog item `itemId` brought its
+ * skills (spec §9.2, Decision 8; rule 10 of the plugin scope spec): the org's own usable skills
+ * (`catalog_item_id` null: uploaded or written by an agent; unlinked, or pinned copies of another
+ * plugin's platform skill), org skills of other catalog items, and other plugins' platform skills
+ * on in the org. A skill of the same item (an org copy of it, linked or not) is not a conflict;
+ * an unpinned copy of another plugin's platform skill counts through that platform skill. In the
+ * order of `skillNames`.
  */
-export declare function skillConflicts(db: KernelDb | Trx, orgId: string, itemId: string, skillNames: readonly string[]): Promise<SkillConflict[]>;
+export declare function skillConflicts(db: KernelSchemaDb, orgId: string, itemId: string, skillNames: readonly string[]): Promise<SkillConflict[]>;
 /** One line of the conflict message (spec §9.2). */
 export declare function skillConflictLine(c: SkillConflict): string;
 /** 409 `plugin.skill_conflict`: one message line and one detail per conflicting skill. */
@@ -39,7 +44,7 @@ export interface SkillSummary {
     name: string;
     description: string;
     currentVersion: number;
-    createdBy: string;
+    createdBy: string | null;
     createdAt: Date;
     updatedAt: Date;
     /** The catalog item name the skill came from; null for the org's own (uploaded or written). */
@@ -56,13 +61,34 @@ export interface SkillSummary {
     manual: boolean;
     /** Phase D: the current version runs as a sub-agent when a person invokes it. */
     fork: boolean;
+    /**
+     * Phase 2: `platform` for a platform skill (deployment-owned, on in the org; not deletable or
+     * versioned by the org), `org` for the org's own.
+     */
+    origin: "org" | "platform";
+    /**
+     * A platform skill's owner (ruling P3-1): the platform, or the org whose upload it came from
+     * (absent on the org's own skills).
+     */
+    owner?: Owner;
+    /**
+     * The org's own skill is marked 可共享 by its org (plugin scope phase 3, ruling P3-6); false for
+     * platform skills and agents' skills.
+     */
+    shareable: boolean;
+    /**
+     * Phase 2, in the library list only: a platform skill's unpinned org copies linked to it (ruling
+     * B2). They resolve to this skill under their own ids, so an agent that selects one of them
+     * selects this skill.
+     */
+    linkedIds?: string[];
 }
 /** 技能的一个版本（含文件清单）。 */
 export interface SkillVersionView {
     version: number;
     files: SkillManifest["files"];
     description: string;
-    createdBy: string;
+    createdBy: string | null;
     createdAt: Date;
 }
 /** 技能详情：各版本新的在前。 */
@@ -82,17 +108,13 @@ export interface UploadedSkill {
     version: number;
     created: boolean;
 }
-export interface SkillsDeps {
-    db: KernelDb;
-    storage: StorageService;
-    attachments: Pick<AttachmentsService, "create" | "readSkillPackage" | "consumeSkillPackage">;
-}
 /**
- * 在调用方事务里核对 agent 定义引用的组织技能：每个 id 都必须是该组织未删除的 `scope=org` 技能，
+ * 在调用方事务里核对 agent 定义引用的组织技能：每个 id 都必须是该组织未删除的 `scope=org` 技能
+ * (or, phase 2, a platform skill on in the org: skills/usable.ts)，
  * 否则 `validation_failed`（path `skills.orgSkills.<i>`）；不可重复。调用方须已锁组织行（技能删除同样锁组织行，二者串行）。
  * `kept`：当前版本里已有的引用（保存时合法），修改时不再核对——技能之后被删也不挡住其他改动（运行时由 T14 忽略已删除的技能）。
  */
-export declare function assertOrgSkills(t: Trx, orgId: string, ids: readonly string[], kept?: ReadonlySet<string>): Promise<void>;
+export declare function assertOrgSkills(db: KernelSchemaDb, orgId: string, ids: readonly string[], kept?: ReadonlySet<string>): Promise<void>;
 /** Why a pinned skill reference is refused (`agent.pinned_invalid` details). */
 export type PinnedSkillProblem = "not_selected" | "not_found" | "duplicate" | "too_many" | "too_large"
 /** Phase D: the skill's current version is manual-only (not in the model's catalog). */
@@ -113,14 +135,37 @@ export type PinnedSkillProblem = "not_selected" | "not_found" | "duplicate" | "t
  *   when the pinned list changed: a pinned skill's new version never blocks an unrelated edit (the
  *   run keeps what fits).
  */
-export declare function assertPinnedSkills(t: Trx, orgId: string, agentId: string | null, skills: AgentDefinition["skills"], kept?: readonly string[]): Promise<void>;
+export declare function assertPinnedSkills(db: KernelSchemaDb, orgId: string, agentId: string | null, skills: AgentDefinition["skills"], kept?: readonly string[]): Promise<void>;
 /**
  * 技能库（M5 T13）：组织技能的上传（新技能或新版本）、列表、详情与软删除。
  * 字节在对象存储 `kernel/<orgId>/skills/<uploadId>/<path>`，元数据在 PG；无进程内状态，可多副本共用。
  */
+export { type SkillPackageInput, skillManifest } from "./package.js";
 export declare class SkillsService {
-    private readonly d;
-    constructor(d: SkillsDeps);
+    private readonly db;
+    private readonly storage;
+    private readonly attachments;
+    readonly txHost: TransactionHost;
+    private readonly orgLock;
+    /** The owner's new versions of a skill it promoted go to the platform row (ruling P3-4). */
+    private readonly platform;
+    constructor(db: KernelDb, storage: StorageService, attachments: AttachmentsService, txHost: TransactionHost, orgLock: OrgLock, 
+    /** The owner's new versions of a skill it promoted go to the platform row (ruling P3-4). */
+    platform: PlatformComponents);
+    /**
+     * Writes a package's files where its version will live: for a new version of a skill the org
+     * promoted (ruling P3-3: a live org skill of the name linked without a pin to a platform skill
+     * the org owns), the platform row's next version prefix in `deployment/` (ruling P3-4); else
+     * `kernel/<orgId>/<prefix>`. Returns the platform version prepared, if any. Never inside a
+     * transaction; the transaction checks that the skill is still promoted (and still at that
+     * version).
+     */
+    private putVersionFiles;
+    /**
+     * The summary of the org's skill `copyId` it promoted to `platformId`, as it serves now: the
+     * platform row's current version (ruling P3-4) under the org row's id, still the org's own.
+     */
+    private promotedSummary;
     /** 登记一个技能包上传（预签名 POST，`application/zip`，≤ 50MB）；角色由路由的 `skills.manage` 把关。 */
     createUpload(orgId: string, accountId: string, input: {
         name: string;
@@ -135,25 +180,58 @@ export declare class SkillsService {
      * 第 3 步之前中断不会留下可见的版本；已写的文件由清理任务在上传过期后删除（未被任何版本引用时）。
      * 同一上传已经产生过版本（上次提交了、响应丢了而重试）→ 直接返回那个版本（同组织、同一发起人）。
      */
-    upload(orgId: string, actorAccountId: string, uploadId: string, actorTokenId?: string): Promise<UploadedSkill>;
+    upload(orgId: string, actorAccountId: string, uploadId: string, actorTokenId?: string, shareable?: boolean): Promise<UploadedSkill>;
     /**
-     * 用一组已校验的技能文件创建组织技能或给同名技能新增版本（上传与企业目录安装共用）：
+     * The transaction of {@link upload}: under the org row lock (re-checking `skills.manage`), the
+     * custom-skill policy is re-checked and the upload consumed (of concurrent requests for the same
+     * upload only one succeeds), then the version is written in the same transaction
+     * ({@link createVersionIn} joins it).
+     */
+    private createUploadedVersionIn;
+    /**
+     * The read-only checks of {@link createFromText}, for the `Platform` tool's precheck (before the
+     * card): custom skills allowed, a valid `SKILL.md`, and no live org skill of the name. Throws the
+     * same `ApiError` the create would; the create checks the name again under its lock.
+     */
+    checkCreateFromText(orgId: string, input: {
+        name: string;
+        description: string;
+        body: string;
+    }): Promise<void>;
+    /**
+     * Creates an org skill from text (spec §14, P3-24): `SKILL.md` is built from the name,
+     * description and body ({@link buildSkillWrite}, the description a YAML string) and checked like
+     * an uploaded package. The same policy and name rules as an upload, except that a live org skill
+     * of that name is `skill.name_exists` (409) instead of a new version.
+     */
+    createFromText(orgId: string, actorAccountId: string, input: {
+        name: string;
+        description: string;
+        body: string;
+        shareable?: boolean;
+        actorTokenId?: string;
+        /** Merged into the audit event's detail (the `Platform` tool's `via: "agent"`). */
+        auditDetail?: Record<string, unknown>;
+    }): Promise<UploadedSkill>;
+    /**
+     * 用一组已校验的技能文件创建组织技能或给同名技能新增版本（上传与平台目录安装共用）：
      * 1. 把文件写到 `kernel/<orgId>/<prefix>`（缺省 `skills/<新 id>/`）；
-     * 2. 一个事务里：锁组织行并复核 `skills.manage`，执行 `inTransaction`（上传：标记上传已用；目录：按条目策略复核），
+     * 2. 一个事务里：锁组织行并复核 `skills.manage`（目录安装：按条目策略复核），
      *    同名未删除的组织技能存在则 `current_version + 1`，否则新建；技能与版本都记下 `directory` 来源（没有则清空：
      *    自定义上传盖在目录技能上就不再算目录安装），写版本与审计
      *    （`skill.created` / `skill.version_created`，目录安装时 detail 带 directory）。
      */
-    createVersionFromFiles(orgId: string, actorAccountId: string, pkg: {
-        name: string;
-        description: string;
-        files: SkillPackageFile[];
-        /** Phase D: stored in the manifest when it is not the default. */
-        invocation?: SkillInvocation;
-    }, opts?: {
+    createVersionFromFiles(orgId: string, 
+    /** null: the kernel itself (the plugin scope sync installing a plugin), no role check. */
+    actorAccountId: string | null, pkg: SkillPackageInput, opts?: {
         prefix?: string;
         actorTokenId?: string;
-        inTransaction?: (t: Trx) => Promise<void>;
+        /** Merged into the audit event's detail. */
+        auditDetail?: Record<string, unknown>;
+        /** The owner shares a new skill with other orgs (default false). */
+        shareable?: boolean;
+        /** A live org skill of the name is `skill.name_exists` instead of getting a new version. */
+        failIfExists?: boolean;
         /** Catalog provenance; `approvedBy` is the item whose policy approves it (default `itemId`). */
         catalog?: {
             itemId: string;
@@ -165,22 +243,43 @@ export declare class SkillsService {
             suggestPinned?: boolean;
         };
     }): Promise<UploadedSkill>;
+    /** Writes a skill package's files to `kernel/<orgId>/<prefix>` (a few at a time). */
+    private putFiles;
+    /** The transaction of {@link createVersionFromFiles}. */
+    private createVersionIn;
     /**
-     * 在调用方事务里撤销应用安装给已有技能加的版本（调用方已锁组织行）：只有当前版本仍是 `version` 时才退回上一版本并删掉
-     * 该版本行（之后又有新版本则不动，返回 false），技能的描述与目录来源也退回上一版本的。审计 `skill.version_reverted`。
+     * In the caller's transaction (`mandatory`: the caller holds the org row lock), reverts the
+     * version a plugin install added to an existing skill: only while `version` is still current,
+     * back to the previous version, deleting this version's row (returns false when a newer version
+     * exists); the skill's description and catalog source revert too. Audit `skill.version_reverted`.
      */
-    revertVersionIn(t: Trx, orgId: string, skillId: string, version: number, actorAccountId: string, reason: string): Promise<boolean>;
+    revertVersionIn(orgId: string, skillId: string, version: number, actorAccountId: string | null, reason: string): Promise<boolean>;
     /**
-     * 在调用方事务里软删除组织技能（调用方已锁组织行；应用安装的回滚与卸载用）。审计 `skill.deleted`（带 reason）。
-     * 已删除 / 不存在时返回 false。
+     * In the caller's transaction (`mandatory`: the caller holds the org row lock), soft-deletes an
+     * org skill (plugin install rollback and uninstall). Audit `skill.deleted` with the reason.
+     * Returns false when it is already deleted or missing.
+     */
+    softDeleteIn(orgId: string, skillId: string, actorAccountId: string | null, reason: string): Promise<boolean>;
+    /**
+     * The org skill library, sorted by name: the org's live `scope=org` skills except copies linked
+     * to a platform skill without a pin, and the platform skills on in the org (phase 2,
+     * `usableSkills`; `origin` tells them apart), each with the ids of those copies (`linkedIds`).
      */
-    softDeleteIn(t: Trx, orgId: string, skillId: string, actorAccountId: string, reason: string): Promise<boolean>;
-    /** 组织技能库（`scope=org`、未删除），按名字排序。 */
     list(orgId: string): Promise<SkillSummary[]>;
     /** 对该 agent 自动生效的技能（`scope=agent`、未删除），按名字排序。 */
     listForAgent(orgId: string, agentId: string): Promise<SkillSummary[]>;
-    /** 组织技能详情：各版本与文件清单。不存在 / 已删除 / 不是组织技能 → `skill.not_found`。 */
+    /**
+     * 组织技能详情：各版本与文件清单。不存在 / 已删除 / 不是组织技能 → `skill.not_found`。
+     * An org copy linked to a platform skill without a pin (ruling B2) serves the platform skill's
+     * content under its own id, so its detail is the platform skill's (its id, versions and body;
+     * 404 while that skill is off in the org); a pinned copy keeps its own (Task 10).
+     */
     get(orgId: string, skillId: string): Promise<SkillDetail>;
+    /**
+     * A platform skill's detail (phase 2): only while it is on in the org, else `skill.not_found`.
+     * Its versions are the platform skill's.
+     */
+    private getPlatform;
     /** 读某版本 SKILL.md 的正文（见 {@link SkillDetail.body}）；任何读取问题都返回 null，不让详情失败。 */
     private readBody;
     /**
@@ -188,5 +287,13 @@ export declare class SkillsService {
      * 保存时会被拒绝（运行时由 T14 忽略已删除的技能）。不存在 / 已删除 → `skill.not_found`。
      */
     softDelete(orgId: string, skillId: string, actorAccountId: string, actorTokenId?: string): Promise<void>;
+    /** The transaction of {@link softDelete}. */
+    private softDeleteTx;
+    /**
+     * In the caller's transaction (`mandatory`: the caller holds the org row lock and checked
+     * `skills.manage`), soft-deletes an org-scope skill of the org: what {@link softDelete} writes
+     * (audit `skill.deleted`); missing or deleted -> `skill.not_found`. The owner delete of a
+     * promoted skill (`OwnedItems.deleteSkill`) calls it after its platform row was dealt with.
+     */
+    deleteOrgSkillIn(orgId: string, skillId: string, actorAccountId: string, actorTokenId: string | undefined, auditDetail?: Record<string, unknown>): Promise<void>;
 }
-export {};