@lucern/contracts 1.0.0 → 1.0.1

package/dist/tool-contracts.ontology.js

@@ -0,0 +1,344 @@
+// src/tool-contracts.ontology.ts
+var MANAGE_WRITE_POLICY = {
+  name: "manage_write_policy",
+  description: "Manage write policies for MCP mutation tools. Like `git config` for write permissions \u2014 sets per-topic or global policies that control which roles can mutate the graph.",
+  parameters: {
+    action: {
+      type: "string",
+      description: "Action to perform: 'get' (read policies) or 'set' (upsert a policy)",
+      enum: ["get", "set"]
+    },
+    topicId: {
+      type: "string",
+      description: "Topic scope for the policy. Omit for global policies."
+    },
+    role: {
+      type: "string",
+      description: "Role to set policy for (required for 'set'). E.g. 'agent:internal' or a Permit role key such as 'workspace_admin'."
+    },
+    permission: {
+      type: "string",
+      description: "Permission level (required for 'set').",
+      enum: ["allow", "deny", "read_only"]
+    },
+    maxWritesPerSession: {
+      type: "number",
+      description: "Optional per-session write limit for this role+scope."
+    },
+    rationale: {
+      type: "string",
+      description: "Why this policy is being set (audit trail)."
+    }
+  },
+  required: ["action"],
+  response: {
+    description: "Policy operation result",
+    fields: {
+      action: "string \u2014 get | set",
+      topicId: "string|null \u2014 topic scope or null for global",
+      policies: "array \u2014 (for get) list of matching policies",
+      role: "string \u2014 (for set) role that was updated",
+      permission: "string \u2014 (for set) new permission level",
+      maxWritesPerSession: "number|null \u2014 (for set) session write cap"
+    }
+  },
+  ownerModule: "access-control",
+  ontologyPrimitive: "policy",
+  tier: "workhorse"
+};
+var LIST_ONTOLOGIES = {
+  name: "list_ontologies",
+  description: "List ontology definitions with optional filters. Like `git remote -v` for ontologies \u2014 shows all registered ontology definitions with their tier, status, and tenant scope.",
+  parameters: {
+    tenantId: {
+      type: "string",
+      description: "Filter by tenant ID. Omit for platform-level ontologies."
+    },
+    tier: {
+      type: "string",
+      description: "Filter by tier",
+      enum: ["platform", "pack", "tenant"]
+    },
+    status: {
+      type: "string",
+      description: "Filter by status",
+      enum: ["draft", "active", "deprecated", "archived"]
+    }
+  },
+  required: [],
+  response: {
+    description: "Array of ontology definitions",
+    fields: {
+      ontologies: "array \u2014 ontology definitions with id, ontologyKey, name, tier, status"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var GET_ONTOLOGY = {
+  name: "get_ontology",
+  description: "Get a single ontology definition by ID or ontologyKey. Like `git show` for an ontology \u2014 returns the definition metadata plus the latest published version with entity types and edge types.",
+  parameters: {
+    id: {
+      type: "string",
+      description: "Ontology definition ID (Convex document ID)"
+    },
+    ontologyKey: {
+      type: "string",
+      description: "Ontology key (e.g., 'investment-ontology'). Alternative to id."
+    },
+    tenantId: {
+      type: "string",
+      description: "Tenant scope for key lookup. Omit for platform-level."
+    }
+  },
+  required: ["id"],
+  response: {
+    description: "Ontology definition with latest published version",
+    fields: {
+      id: "string \u2014 definition ID",
+      ontologyKey: "string \u2014 unique key",
+      name: "string \u2014 display name",
+      publishedVersion: "object|null \u2014 latest published version with entityTypes and edgeTypes"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var APPLY_ONTOLOGY = {
+  name: "apply_ontology",
+  description: "Bind an ontology definition directly to a topic. Like `git checkout` for a domain vocabulary \u2014 applies an ontology to a topic so the topic and its descendants inherit the configured entity and edge schema.",
+  parameters: {
+    ontologyId: {
+      type: "string",
+      description: "Canonical ontology identifier to bind"
+    },
+    topicId: {
+      type: "string",
+      description: "Canonical topic identifier to receive the binding"
+    }
+  },
+  required: ["ontologyId", "topicId"],
+  response: {
+    description: "Ontology binding summary",
+    fields: {
+      applied: "boolean \u2014 true when the binding was written",
+      source: "string \u2014 always 'direct' for an explicit bind",
+      ontologyId: "string \u2014 canonical ontology ID",
+      ontologyKey: "string \u2014 ontology key",
+      topicId: "string \u2014 canonical topic ID"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var MATCH_ENTITY_TYPE = {
+  name: "match_entity_type",
+  description: "Classify free text against the effective ontology vocabulary. Like `git grep` for ontology types \u2014 ranks the most likely entity types for the supplied text using the topic-bound or explicitly selected ontology.",
+  parameters: {
+    text: {
+      type: "string",
+      description: "Free text to classify against ontology entity types"
+    },
+    topicId: {
+      type: "string",
+      description: "Canonical topic ID used to resolve the effective ontology when ontologyId is omitted"
+    },
+    ontologyId: {
+      type: "string",
+      description: "Optional ontology definition ID to match against instead of the topic-bound ontology"
+    },
+    minScore: {
+      type: "number",
+      description: "Optional lower similarity bound for returned matches"
+    },
+    limit: {
+      type: "number",
+      description: "Optional maximum number of ranked matches to return"
+    }
+  },
+  required: ["text", "ontologyId"],
+  response: {
+    description: "Ranked ontology entity type matches",
+    fields: {
+      matches: "array \u2014 ranked entity type matches with score, entityType, label, and optional description",
+      ontologyId: "string|null \u2014 ontology used for matching",
+      topicId: "string|null \u2014 topic scope used for ontology resolution"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var CREATE_ONTOLOGY = {
+  name: "create_ontology",
+  description: "Create a new ontology definition. Like `git init` for a domain vocabulary \u2014 creates a named, versioned container for entity types and edge types. Starts in 'draft' status.",
+  parameters: {
+    ontologyKey: {
+      type: "string",
+      description: "Unique key (lowercase, hyphens, e.g., 'investment-ontology')"
+    },
+    name: { type: "string", description: "Human-readable name" },
+    description: { type: "string", description: "What this ontology covers" },
+    tenantId: {
+      type: "string",
+      description: "Tenant scope. Omit for platform-level."
+    },
+    tier: {
+      type: "string",
+      description: "Ontology tier",
+      enum: ["platform", "pack", "tenant"]
+    },
+    parentOntologyId: {
+      type: "string",
+      description: "Parent ontology ID for layered composition"
+    }
+  },
+  required: ["ontologyKey", "name", "tier"],
+  response: {
+    description: "Created ontology definition",
+    fields: {
+      id: "string \u2014 new definition ID",
+      ontologyKey: "string \u2014 normalized key"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var UPDATE_ONTOLOGY = {
+  name: "update_ontology",
+  description: "Update an ontology definition's metadata (name, description, status). Like `git config` for an ontology \u2014 updates mutable fields on the definition. Only allowed while the ontology is in draft or active status.",
+  parameters: {
+    id: { type: "string", description: "Ontology definition ID" },
+    name: { type: "string", description: "New display name" },
+    description: { type: "string", description: "New description" },
+    status: {
+      type: "string",
+      description: "New status",
+      enum: ["draft", "active", "deprecated"]
+    }
+  },
+  required: ["id"],
+  response: {
+    description: "Update confirmation",
+    fields: { success: "boolean" }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "workhorse"
+};
+var ARCHIVE_ONTOLOGY = {
+  name: "archive_ontology",
+  description: "Archive an ontology definition. Like `git rm` for an ontology \u2014 soft-deletes the definition. Archived ontologies are preserved in history but no longer active.",
+  parameters: {
+    id: { type: "string", description: "Ontology definition ID to archive" }
+  },
+  required: ["id"],
+  response: {
+    description: "Archive confirmation",
+    fields: { success: "boolean" }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "workhorse"
+};
+var CREATE_ONTOLOGY_VERSION = {
+  name: "create_ontology_version",
+  description: "Create a new version snapshot for an ontology definition. Like `git commit` for ontology content \u2014 captures entity types and edge types in a versioned snapshot. Starts in 'draft' status. Publish to freeze.",
+  parameters: {
+    ontologyId: {
+      type: "string",
+      description: "Parent ontology definition ID"
+    },
+    version: {
+      type: "string",
+      description: "Semantic version string (X.Y.Z format)"
+    },
+    entityTypes: {
+      type: "array",
+      description: "Array of entity type definitions: [{ value, label, description?, schema?, subtypes? }]"
+    },
+    edgeTypes: {
+      type: "array",
+      description: "Array of edge type definitions: [{ value, label, description?, sourceTypes?, targetTypes?, constraintSeverity? }]"
+    },
+    releaseNotes: {
+      type: "string",
+      description: "Optional release notes for this version"
+    }
+  },
+  required: ["ontologyId", "version", "entityTypes", "edgeTypes"],
+  response: {
+    description: "Created version",
+    fields: {
+      id: "string \u2014 new version ID",
+      version: "string \u2014 version string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var PUBLISH_ONTOLOGY_VERSION = {
+  name: "publish_ontology_version",
+  description: "Publish a draft ontology version \u2014 freezes it permanently. Like `git tag` for an ontology release \u2014 the version becomes immutable after publish. If the parent definition is still in 'draft', promotes it to 'active'.",
+  parameters: {
+    id: { type: "string", description: "Ontology version ID to publish" }
+  },
+  required: ["id"],
+  response: {
+    description: "Publish confirmation",
+    fields: {
+      success: "boolean",
+      publishedAt: "number \u2014 timestamp"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "showcase"
+};
+var DEPRECATE_ONTOLOGY_VERSION = {
+  name: "deprecate_ontology_version",
+  description: "Deprecate a published ontology version. Like `git tag -d` for an ontology release \u2014 marks the version as deprecated. Only published versions can be deprecated.",
+  parameters: {
+    id: { type: "string", description: "Ontology version ID to deprecate" }
+  },
+  required: ["id"],
+  response: {
+    description: "Deprecation confirmation",
+    fields: { success: "boolean" }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "workhorse"
+};
+var RESOLVE_EFFECTIVE_ONTOLOGY = {
+  name: "resolve_effective_ontology",
+  description: "Resolve the effective ontology by composing the parent chain. Like `git merge --squash` for ontology layers \u2014 walks parentOntologyId chain (max depth 3) and merges entity/edge types additively from root (platform) to leaf (tenant).",
+  parameters: {
+    ontologyId: {
+      type: "string",
+      description: "Ontology definition ID to resolve from"
+    }
+  },
+  required: ["ontologyId"],
+  response: {
+    description: "Merged ontology with composed entity and edge types",
+    fields: {
+      entityTypes: "array \u2014 merged entity types from all layers",
+      edgeTypes: "array \u2014 merged edge types from all layers",
+      layers: "array \u2014 ontology keys in composition order"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "ontology",
+  tier: "workhorse"
+};
+
+export { APPLY_ONTOLOGY, ARCHIVE_ONTOLOGY, CREATE_ONTOLOGY, CREATE_ONTOLOGY_VERSION, DEPRECATE_ONTOLOGY_VERSION, GET_ONTOLOGY, LIST_ONTOLOGIES, MANAGE_WRITE_POLICY, MATCH_ENTITY_TYPE, PUBLISH_ONTOLOGY_VERSION, RESOLVE_EFFECTIVE_ONTOLOGY, UPDATE_ONTOLOGY };
+//# sourceMappingURL=tool-contracts.ontology.js.map
+//# sourceMappingURL=tool-contracts.ontology.js.map

package/dist/tool-contracts.ontology.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-contracts.ontology.ts"],"names":[],"mappings":"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","file":"tool-contracts.ontology.js","sourcesContent":["import type { McpToolContract } from \"./tool-contracts.types\";\n\nexport const MANAGE_WRITE_POLICY: McpToolContract = {\n  name: \"manage_write_policy\",\n  description:\n    \"Manage write policies for MCP mutation tools. \" +\n    \"Like `git config` for write permissions — sets per-topic or global \" +\n    \"policies that control which roles can mutate the graph.\",\n  parameters: {\n    action: {\n      type: \"string\",\n      description:\n        \"Action to perform: 'get' (read policies) or 'set' (upsert a policy)\",\n      enum: [\"get\", \"set\"],\n    },\n    topicId: {\n      type: \"string\",\n      description: \"Topic scope for the policy. Omit for global policies.\",\n    },\n    role: {\n      type: \"string\",\n      description:\n        \"Role to set policy for (required for 'set'). E.g. 'agent:internal' or a Permit role key such as 'workspace_admin'.\",\n    },\n    permission: {\n      type: \"string\",\n      description: \"Permission level (required for 'set').\",\n      enum: [\"allow\", \"deny\", \"read_only\"],\n    },\n    maxWritesPerSession: {\n      type: \"number\",\n      description: \"Optional per-session write limit for this role+scope.\",\n    },\n    rationale: {\n      type: \"string\",\n      description: \"Why this policy is being set (audit trail).\",\n    },\n  },\n  required: [\"action\"],\n  response: {\n    description: \"Policy operation result\",\n    fields: {\n      action: \"string — get | set\",\n      topicId: \"string|null — topic scope or null for global\",\n      policies: \"array — (for get) list of matching policies\",\n      role: \"string — (for set) role that was updated\",\n      permission: \"string — (for set) new permission level\",\n      maxWritesPerSession: \"number|null — (for set) session write cap\",\n    },\n  },\n  ownerModule: \"access-control\",\n  ontologyPrimitive: \"policy\",\n  tier: \"workhorse\",\n};\n\n// =============================================================================\n// ONTOLOGY TOOLS (ontology lifecycle, version management)\n// =============================================================================\n\nexport const LIST_ONTOLOGIES: McpToolContract = {\n  name: \"list_ontologies\",\n  description:\n    \"List ontology definitions with optional filters. \" +\n    \"Like `git remote -v` for ontologies — shows all registered ontology definitions \" +\n    \"with their tier, status, and tenant scope.\",\n  parameters: {\n    tenantId: {\n      type: \"string\",\n      description: \"Filter by tenant ID. Omit for platform-level ontologies.\",\n    },\n    tier: {\n      type: \"string\",\n      description: \"Filter by tier\",\n      enum: [\"platform\", \"pack\", \"tenant\"],\n    },\n    status: {\n      type: \"string\",\n      description: \"Filter by status\",\n      enum: [\"draft\", \"active\", \"deprecated\", \"archived\"],\n    },\n  },\n  required: [],\n  response: {\n    description: \"Array of ontology definitions\",\n    fields: {\n      ontologies:\n        \"array — ontology definitions with id, ontologyKey, name, tier, status\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const GET_ONTOLOGY: McpToolContract = {\n  name: \"get_ontology\",\n  description:\n    \"Get a single ontology definition by ID or ontologyKey. \" +\n    \"Like `git show` for an ontology — returns the definition metadata plus the latest \" +\n    \"published version with entity types and edge types.\",\n  parameters: {\n    id: {\n      type: \"string\",\n      description: \"Ontology definition ID (Convex document ID)\",\n    },\n    ontologyKey: {\n      type: \"string\",\n      description:\n        \"Ontology key (e.g., 'investment-ontology'). Alternative to id.\",\n    },\n    tenantId: {\n      type: \"string\",\n      description: \"Tenant scope for key lookup. Omit for platform-level.\",\n    },\n  },\n  required: [\"id\"],\n  response: {\n    description: \"Ontology definition with latest published version\",\n    fields: {\n      id: \"string — definition ID\",\n      ontologyKey: \"string — unique key\",\n      name: \"string — display name\",\n      publishedVersion:\n        \"object|null — latest published version with entityTypes and edgeTypes\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const APPLY_ONTOLOGY: McpToolContract = {\n  name: \"apply_ontology\",\n  description:\n    \"Bind an ontology definition directly to a topic. \" +\n    \"Like `git checkout` for a domain vocabulary — applies an ontology to a topic so the topic \" +\n    \"and its descendants inherit the configured entity and edge schema.\",\n  parameters: {\n    ontologyId: {\n      type: \"string\",\n      description: \"Canonical ontology identifier to bind\",\n    },\n    topicId: {\n      type: \"string\",\n      description: \"Canonical topic identifier to receive the binding\",\n    },\n  },\n  required: [\"ontologyId\", \"topicId\"],\n  response: {\n    description: \"Ontology binding summary\",\n    fields: {\n      applied: \"boolean — true when the binding was written\",\n      source: \"string — always 'direct' for an explicit bind\",\n      ontologyId: \"string — canonical ontology ID\",\n      ontologyKey: \"string — ontology key\",\n      topicId: \"string — canonical topic ID\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const MATCH_ENTITY_TYPE: McpToolContract = {\n  name: \"match_entity_type\",\n  description:\n    \"Classify free text against the effective ontology vocabulary. \" +\n    \"Like `git grep` for ontology types — ranks the most likely entity types for the supplied text \" +\n    \"using the topic-bound or explicitly selected ontology.\",\n  parameters: {\n    text: {\n      type: \"string\",\n      description: \"Free text to classify against ontology entity types\",\n    },\n    topicId: {\n      type: \"string\",\n      description:\n        \"Canonical topic ID used to resolve the effective ontology when ontologyId is omitted\",\n    },\n    ontologyId: {\n      type: \"string\",\n      description:\n        \"Optional ontology definition ID to match against instead of the topic-bound ontology\",\n    },\n    minScore: {\n      type: \"number\",\n      description: \"Optional lower similarity bound for returned matches\",\n    },\n    limit: {\n      type: \"number\",\n      description: \"Optional maximum number of ranked matches to return\",\n    },\n  },\n  required: [\"text\", \"ontologyId\"],\n  response: {\n    description: \"Ranked ontology entity type matches\",\n    fields: {\n      matches:\n        \"array — ranked entity type matches with score, entityType, label, and optional description\",\n      ontologyId: \"string|null — ontology used for matching\",\n      topicId: \"string|null — topic scope used for ontology resolution\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const CREATE_ONTOLOGY: McpToolContract = {\n  name: \"create_ontology\",\n  description:\n    \"Create a new ontology definition. \" +\n    \"Like `git init` for a domain vocabulary — creates a named, versioned container for \" +\n    \"entity types and edge types. Starts in 'draft' status.\",\n  parameters: {\n    ontologyKey: {\n      type: \"string\",\n      description:\n        \"Unique key (lowercase, hyphens, e.g., 'investment-ontology')\",\n    },\n    name: { type: \"string\", description: \"Human-readable name\" },\n    description: { type: \"string\", description: \"What this ontology covers\" },\n    tenantId: {\n      type: \"string\",\n      description: \"Tenant scope. Omit for platform-level.\",\n    },\n    tier: {\n      type: \"string\",\n      description: \"Ontology tier\",\n      enum: [\"platform\", \"pack\", \"tenant\"],\n    },\n    parentOntologyId: {\n      type: \"string\",\n      description: \"Parent ontology ID for layered composition\",\n    },\n  },\n  required: [\"ontologyKey\", \"name\", \"tier\"],\n  response: {\n    description: \"Created ontology definition\",\n    fields: {\n      id: \"string — new definition ID\",\n      ontologyKey: \"string — normalized key\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const UPDATE_ONTOLOGY: McpToolContract = {\n  name: \"update_ontology\",\n  description:\n    \"Update an ontology definition's metadata (name, description, status). \" +\n    \"Like `git config` for an ontology — updates mutable fields on the definition. \" +\n    \"Only allowed while the ontology is in draft or active status.\",\n  parameters: {\n    id: { type: \"string\", description: \"Ontology definition ID\" },\n    name: { type: \"string\", description: \"New display name\" },\n    description: { type: \"string\", description: \"New description\" },\n    status: {\n      type: \"string\",\n      description: \"New status\",\n      enum: [\"draft\", \"active\", \"deprecated\"],\n    },\n  },\n  required: [\"id\"],\n  response: {\n    description: \"Update confirmation\",\n    fields: { success: \"boolean\" },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"workhorse\",\n};\n\nexport const ARCHIVE_ONTOLOGY: McpToolContract = {\n  name: \"archive_ontology\",\n  description:\n    \"Archive an ontology definition. \" +\n    \"Like `git rm` for an ontology — soft-deletes the definition. \" +\n    \"Archived ontologies are preserved in history but no longer active.\",\n  parameters: {\n    id: { type: \"string\", description: \"Ontology definition ID to archive\" },\n  },\n  required: [\"id\"],\n  response: {\n    description: \"Archive confirmation\",\n    fields: { success: \"boolean\" },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"workhorse\",\n};\n\nexport const CREATE_ONTOLOGY_VERSION: McpToolContract = {\n  name: \"create_ontology_version\",\n  description:\n    \"Create a new version snapshot for an ontology definition. \" +\n    \"Like `git commit` for ontology content — captures entity types and edge types \" +\n    \"in a versioned snapshot. Starts in 'draft' status. Publish to freeze.\",\n  parameters: {\n    ontologyId: {\n      type: \"string\",\n      description: \"Parent ontology definition ID\",\n    },\n    version: {\n      type: \"string\",\n      description: \"Semantic version string (X.Y.Z format)\",\n    },\n    entityTypes: {\n      type: \"array\",\n      description:\n        \"Array of entity type definitions: [{ value, label, description?, schema?, subtypes? }]\",\n    },\n    edgeTypes: {\n      type: \"array\",\n      description:\n        \"Array of edge type definitions: [{ value, label, description?, sourceTypes?, targetTypes?, constraintSeverity? }]\",\n    },\n    releaseNotes: {\n      type: \"string\",\n      description: \"Optional release notes for this version\",\n    },\n  },\n  required: [\"ontologyId\", \"version\", \"entityTypes\", \"edgeTypes\"],\n  response: {\n    description: \"Created version\",\n    fields: {\n      id: \"string — new version ID\",\n      version: \"string — version string\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const PUBLISH_ONTOLOGY_VERSION: McpToolContract = {\n  name: \"publish_ontology_version\",\n  description:\n    \"Publish a draft ontology version — freezes it permanently. \" +\n    \"Like `git tag` for an ontology release — the version becomes immutable after publish. \" +\n    \"If the parent definition is still in 'draft', promotes it to 'active'.\",\n  parameters: {\n    id: { type: \"string\", description: \"Ontology version ID to publish\" },\n  },\n  required: [\"id\"],\n  response: {\n    description: \"Publish confirmation\",\n    fields: {\n      success: \"boolean\",\n      publishedAt: \"number — timestamp\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"showcase\",\n};\n\nexport const DEPRECATE_ONTOLOGY_VERSION: McpToolContract = {\n  name: \"deprecate_ontology_version\",\n  description:\n    \"Deprecate a published ontology version. \" +\n    \"Like `git tag -d` for an ontology release — marks the version as deprecated. \" +\n    \"Only published versions can be deprecated.\",\n  parameters: {\n    id: { type: \"string\", description: \"Ontology version ID to deprecate\" },\n  },\n  required: [\"id\"],\n  response: {\n    description: \"Deprecation confirmation\",\n    fields: { success: \"boolean\" },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"workhorse\",\n};\n\nexport const RESOLVE_EFFECTIVE_ONTOLOGY: McpToolContract = {\n  name: \"resolve_effective_ontology\",\n  description:\n    \"Resolve the effective ontology by composing the parent chain. \" +\n    \"Like `git merge --squash` for ontology layers — walks parentOntologyId chain \" +\n    \"(max depth 3) and merges entity/edge types additively from root (platform) to leaf (tenant).\",\n  parameters: {\n    ontologyId: {\n      type: \"string\",\n      description: \"Ontology definition ID to resolve from\",\n    },\n  },\n  required: [\"ontologyId\"],\n  response: {\n    description: \"Merged ontology with composed entity and edge types\",\n    fields: {\n      entityTypes: \"array — merged entity types from all layers\",\n      edgeTypes: \"array — merged edge types from all layers\",\n      layers: \"array — ontology keys in composition order\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"ontology\",\n  tier: \"workhorse\",\n};\n\n// =============================================================================\n// FUNCTION SURFACE WORKFLOW TOOLS\n// =============================================================================\n"]}

package/dist/tool-contracts.pipeline-coordination.d.ts

@@ -0,0 +1,25 @@
+import { McpToolContract } from './tool-contracts.types.js';
+
+declare const RECORD_SCOPE_LEARNING: McpToolContract;
+declare const PIPELINE_SNAPSHOT: McpToolContract;
+declare const DISCOVER: McpToolContract;
+declare const ANALYZE_TOPIC_DENSITY: McpToolContract;
+declare const APPLY_AUTO_BRANCHING: McpToolContract;
+declare const SEED_BELIEF_LATTICE: McpToolContract;
+declare const GET_LATTICE_COVERAGE: McpToolContract;
+declare const DISCOVER_ENTITY_CONNECTIONS: McpToolContract;
+declare const TRIGGER_BELIEF_REVIEW: McpToolContract;
+declare const EVALUATE_CONTRACT: McpToolContract;
+declare const GET_CONTRACT_STATUS: McpToolContract;
+declare const REGISTER_SESSION: McpToolContract;
+declare const HEARTBEAT_SESSION: McpToolContract;
+declare const END_SESSION: McpToolContract;
+declare const LIST_ACTIVE_SESSIONS: McpToolContract;
+declare const SEND_AGENT_MESSAGE: McpToolContract;
+declare const BROADCAST_MESSAGE: McpToolContract;
+declare const GET_AGENT_INBOX: McpToolContract;
+declare const CLAIM_FILES: McpToolContract;
+declare const GENERATE_SESSION_HANDOFF: McpToolContract;
+declare const BEGIN_BUILD_SESSION: McpToolContract;
+
+export { ANALYZE_TOPIC_DENSITY, APPLY_AUTO_BRANCHING, BEGIN_BUILD_SESSION, BROADCAST_MESSAGE, CLAIM_FILES, DISCOVER, DISCOVER_ENTITY_CONNECTIONS, END_SESSION, EVALUATE_CONTRACT, GENERATE_SESSION_HANDOFF, GET_AGENT_INBOX, GET_CONTRACT_STATUS, GET_LATTICE_COVERAGE, HEARTBEAT_SESSION, LIST_ACTIVE_SESSIONS, PIPELINE_SNAPSHOT, RECORD_SCOPE_LEARNING, REGISTER_SESSION, SEED_BELIEF_LATTICE, SEND_AGENT_MESSAGE, TRIGGER_BELIEF_REVIEW };