@semiont/ontology 0.2.33 → 0.2.34-build.89

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { components } from '@semiont/api-client';
+import { components } from '@semiont/core';
 
 /**
  * Default entity types for the Semiont system

package/dist/index.js

@@ -201,7 +201,9 @@ function isTag(annotation) {
 function getTagCategory(annotation) {
   if (!isTag(annotation)) return void 0;
   const bodies = Array.isArray(annotation.body) ? annotation.body : [annotation.body];
-  const taggingBody = bodies.find((b) => b && "purpose" in b && b.purpose === "tagging");
+  const taggingBody = bodies.find(
+    (b) => b !== null && typeof b === "object" && "purpose" in b && b.purpose === "tagging"
+  );
   if (taggingBody && "value" in taggingBody) {
     return taggingBody.value;
   }
@@ -210,7 +212,9 @@ function getTagCategory(annotation) {
 function getTagSchemaId(annotation) {
   if (!isTag(annotation)) return void 0;
   const bodies = Array.isArray(annotation.body) ? annotation.body : [annotation.body];
-  const classifyingBody = bodies.find((b) => b && "purpose" in b && b.purpose === "classifying");
+  const classifyingBody = bodies.find(
+    (b) => b !== null && typeof b === "object" && "purpose" in b && b.purpose === "classifying"
+  );
   if (classifyingBody && "value" in classifyingBody) {
     return classifyingBody.value;
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/entity-types.ts","../src/tag-schemas.ts","../src/entity-extraction.ts","../src/tag-extraction.ts"],"sourcesContent":["/**\n * Default entity types for the Semiont system\n *\n * Entity types are used to tag resources and annotations with semantic categories.\n * These types serve as initial seed data for the entity types collection.\n */\nexport const DEFAULT_ENTITY_TYPES = [\n  'Person',\n  'Organization',\n  'Location',\n  'Event',\n  'Concept',\n  'Product',\n  'Technology',\n  'Date',\n  'Author'\n];\n","/**\n * Tag Schema Registry\n *\n * Defines structural analysis frameworks for automatic tagging detection.\n * Each schema provides categories that passages can be classified into\n * based on their structural role (not their semantic content).\n *\n * Examples: IRAC (legal), IMRAD (scientific), Toulmin (argumentation)\n */\n\nexport interface TagCategory {\n  name: string;\n  description: string;\n  examples: string[];\n}\n\nexport interface TagSchema {\n  id: string;\n  name: string;\n  description: string;\n  domain: 'legal' | 'scientific' | 'general';\n  tags: TagCategory[];\n}\n\nexport const TAG_SCHEMAS: Record<string, TagSchema> = {\n  'legal-irac': {\n    id: 'legal-irac',\n    name: 'Legal Analysis (IRAC)',\n    description: 'Issue, Rule, Application, Conclusion framework for legal reasoning',\n    domain: 'legal',\n    tags: [\n      {\n        name: 'Issue',\n        description: 'The legal question or problem to be resolved',\n        examples: [\n          'What is the central legal question?',\n          'What must the court decide?',\n          'What is the dispute about?'\n        ]\n      },\n      {\n        name: 'Rule',\n        description: 'The relevant law, statute, or legal principle',\n        examples: [\n          'What law applies?',\n          'What is the legal standard?',\n          'What statute governs this case?'\n        ]\n      },\n      {\n        name: 'Application',\n        description: 'How the rule applies to the specific facts',\n        examples: [\n          'How does the law apply to these facts?',\n          'Analysis of the case',\n          'How do the facts satisfy the legal standard?'\n        ]\n      },\n      {\n        name: 'Conclusion',\n        description: 'The resolution or outcome based on the analysis',\n        examples: [\n          'What is the court\\'s decision?',\n          'What is the final judgment?',\n          'What is the holding?'\n        ]\n      }\n    ]\n  },\n\n  'scientific-imrad': {\n    id: 'scientific-imrad',\n    name: 'Scientific Paper (IMRAD)',\n    description: 'Introduction, Methods, Results, Discussion structure for research papers',\n    domain: 'scientific',\n    tags: [\n      {\n        name: 'Introduction',\n        description: 'Background, context, and research question',\n        examples: [\n          'What is the research question?',\n          'Why is this important?',\n          'What is the hypothesis?'\n        ]\n      },\n      {\n        name: 'Methods',\n        description: 'Experimental design and procedures',\n        examples: [\n          'How was the study conducted?',\n          'What methods were used?',\n          'What was the experimental design?'\n        ]\n      },\n      {\n        name: 'Results',\n        description: 'Findings and observations',\n        examples: [\n          'What did the study find?',\n          'What are the data?',\n          'What were the observations?'\n        ]\n      },\n      {\n        name: 'Discussion',\n        description: 'Interpretation and implications of results',\n        examples: [\n          'What do the results mean?',\n          'What are the implications?',\n          'How do these findings relate to prior work?'\n        ]\n      }\n    ]\n  },\n\n  'argument-toulmin': {\n    id: 'argument-toulmin',\n    name: 'Argument Structure (Toulmin)',\n    description: 'Claim, Evidence, Warrant, Counterargument, Rebuttal framework for argumentation',\n    domain: 'general',\n    tags: [\n      {\n        name: 'Claim',\n        description: 'The main assertion or thesis',\n        examples: [\n          'What is being argued?',\n          'What is the main point?',\n          'What position is being taken?'\n        ]\n      },\n      {\n        name: 'Evidence',\n        description: 'Data or facts supporting the claim',\n        examples: [\n          'What supports this claim?',\n          'What are the facts?',\n          'What data is provided?'\n        ]\n      },\n      {\n        name: 'Warrant',\n        description: 'Reasoning connecting evidence to claim',\n        examples: [\n          'Why does this evidence support the claim?',\n          'What is the logic?',\n          'How does this reasoning work?'\n        ]\n      },\n      {\n        name: 'Counterargument',\n        description: 'Opposing viewpoints or objections',\n        examples: [\n          'What are the objections?',\n          'What do critics say?',\n          'What are alternative views?'\n        ]\n      },\n      {\n        name: 'Rebuttal',\n        description: 'Response to counterarguments',\n        examples: [\n          'How is the objection addressed?',\n          'Why is the counterargument wrong?',\n          'How is the criticism answered?'\n        ]\n      }\n    ]\n  }\n};\n\n/**\n * Get a tag schema by ID\n */\nexport function getTagSchema(schemaId: string): TagSchema | null {\n  return TAG_SCHEMAS[schemaId] || null;\n}\n\n/**\n * Get all available tag schemas\n */\nexport function getAllTagSchemas(): TagSchema[] {\n  return Object.values(TAG_SCHEMAS);\n}\n\n/**\n * Get tag schemas filtered by domain\n */\nexport function getTagSchemasByDomain(domain: 'legal' | 'scientific' | 'general'): TagSchema[] {\n  return Object.values(TAG_SCHEMAS).filter(schema => schema.domain === domain);\n}\n\n/**\n * Validate that a category name is valid for a schema\n */\nexport function isValidCategory(schemaId: string, categoryName: string): boolean {\n  const schema = getTagSchema(schemaId);\n  if (!schema) return false;\n  return schema.tags.some(tag => tag.name === categoryName);\n}\n\n/**\n * Get a specific category from a schema\n */\nexport function getSchemaCategory(schemaId: string, categoryName: string): TagCategory | null {\n  const schema = getTagSchema(schemaId);\n  if (!schema) return null;\n  return schema.tags.find(tag => tag.name === categoryName) || null;\n}\n","/**\n * Entity Type Extraction Utilities\n *\n * Extract entity types from annotation bodies.\n * Entity types are stored as TextualBody with purpose: \"tagging\"\n */\n\nimport type { components } from '@semiont/api-client';\n\ntype Annotation = components['schemas']['Annotation'];\n\n/**\n * Extract entity types from annotation bodies\n * Entity types are stored as TextualBody with purpose: \"tagging\"\n * Accepts any object with a body property matching Annotation['body']\n */\nexport function getEntityTypes(annotation: { body: Annotation['body'] }): string[] {\n  // Extract from TextualBody bodies with purpose: \"tagging\"\n  if (Array.isArray(annotation.body)) {\n    const entityTags: string[] = [];\n\n    for (const item of annotation.body) {\n      // Runtime check for TextualBody with tagging purpose\n      // TypeScript incorrectly narrows the union type here, so we use runtime checks only\n      if (\n        typeof item === 'object' &&\n        item !== null &&\n        'type' in item &&\n        'value' in item &&\n        'purpose' in item\n      ) {\n        // Access properties as unknown first to avoid TypeScript narrowing issues\n        const itemType = (item as { type: unknown }).type;\n        const itemValue = (item as { value: unknown }).value;\n        const itemPurpose = (item as { purpose: unknown }).purpose;\n\n        if (itemType === 'TextualBody' && itemPurpose === 'tagging' && typeof itemValue === 'string' && itemValue.length > 0) {\n          entityTags.push(itemValue);\n        }\n      }\n    }\n\n    return entityTags;\n  }\n\n  return [];\n}\n","/**\n * Tag Schema Extraction Utilities\n *\n * Extract tag categories and schema IDs from tag annotations.\n * Tags use dual-body structure:\n * - First body has purpose: \"tagging\" with category value\n * - Second body has purpose: \"classifying\" with schema ID\n */\n\nimport type { components } from '@semiont/api-client';\n\ntype Annotation = components['schemas']['Annotation'];\n\n/**\n * Type guard to check if an annotation is a tag\n */\nfunction isTag(annotation: Annotation): boolean {\n  return annotation.motivation === 'tagging';\n}\n\n/**\n * Extract tag category from a tag annotation's body\n * Tags use dual-body structure: first body has purpose: \"tagging\" with category value\n * @param annotation - The annotation to extract category from\n * @returns The tag category (e.g., \"Issue\", \"Rule\"), or undefined if not a tag or no category found\n */\nexport function getTagCategory(annotation: Annotation): string | undefined {\n  if (!isTag(annotation)) return undefined;\n  const bodies = Array.isArray(annotation.body) ? annotation.body : [annotation.body];\n  const taggingBody = bodies.find(b => b && 'purpose' in b && b.purpose === 'tagging');\n  if (taggingBody && 'value' in taggingBody) {\n    return taggingBody.value;\n  }\n  return undefined;\n}\n\n/**\n * Extract tag schema ID from a tag annotation's body\n * Tags use dual-body structure: second body has purpose: \"classifying\" with schema ID\n * @param annotation - The annotation to extract schema ID from\n * @returns The schema ID (e.g., \"legal-irac\"), or undefined if not a tag or no schema found\n */\nexport function getTagSchemaId(annotation: Annotation): string | undefined {\n  if (!isTag(annotation)) return undefined;\n  const bodies = Array.isArray(annotation.body) ? annotation.body : [annotation.body];\n  const classifyingBody = bodies.find(b => b && 'purpose' in b && b.purpose === 'classifying');\n  if (classifyingBody && 'value' in classifyingBody) {\n    return classifyingBody.value;\n  }\n  return undefined;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/entity-types.ts","../src/tag-schemas.ts","../src/entity-extraction.ts","../src/tag-extraction.ts"],"sourcesContent":["/**\n * Default entity types for the Semiont system\n *\n * Entity types are used to tag resources and annotations with semantic categories.\n * These types serve as initial seed data for the entity types collection.\n */\nexport const DEFAULT_ENTITY_TYPES = [\n  'Person',\n  'Organization',\n  'Location',\n  'Event',\n  'Concept',\n  'Product',\n  'Technology',\n  'Date',\n  'Author'\n];\n","/**\n * Tag Schema Registry\n *\n * Defines structural analysis frameworks for automatic tagging detection.\n * Each schema provides categories that passages can be classified into\n * based on their structural role (not their semantic content).\n *\n * Examples: IRAC (legal), IMRAD (scientific), Toulmin (argumentation)\n */\n\nexport interface TagCategory {\n  name: string;\n  description: string;\n  examples: string[];\n}\n\nexport interface TagSchema {\n  id: string;\n  name: string;\n  description: string;\n  domain: 'legal' | 'scientific' | 'general';\n  tags: TagCategory[];\n}\n\nexport const TAG_SCHEMAS: Record<string, TagSchema> = {\n  'legal-irac': {\n    id: 'legal-irac',\n    name: 'Legal Analysis (IRAC)',\n    description: 'Issue, Rule, Application, Conclusion framework for legal reasoning',\n    domain: 'legal',\n    tags: [\n      {\n        name: 'Issue',\n        description: 'The legal question or problem to be resolved',\n        examples: [\n          'What is the central legal question?',\n          'What must the court decide?',\n          'What is the dispute about?'\n        ]\n      },\n      {\n        name: 'Rule',\n        description: 'The relevant law, statute, or legal principle',\n        examples: [\n          'What law applies?',\n          'What is the legal standard?',\n          'What statute governs this case?'\n        ]\n      },\n      {\n        name: 'Application',\n        description: 'How the rule applies to the specific facts',\n        examples: [\n          'How does the law apply to these facts?',\n          'Analysis of the case',\n          'How do the facts satisfy the legal standard?'\n        ]\n      },\n      {\n        name: 'Conclusion',\n        description: 'The resolution or outcome based on the analysis',\n        examples: [\n          'What is the court\\'s decision?',\n          'What is the final judgment?',\n          'What is the holding?'\n        ]\n      }\n    ]\n  },\n\n  'scientific-imrad': {\n    id: 'scientific-imrad',\n    name: 'Scientific Paper (IMRAD)',\n    description: 'Introduction, Methods, Results, Discussion structure for research papers',\n    domain: 'scientific',\n    tags: [\n      {\n        name: 'Introduction',\n        description: 'Background, context, and research question',\n        examples: [\n          'What is the research question?',\n          'Why is this important?',\n          'What is the hypothesis?'\n        ]\n      },\n      {\n        name: 'Methods',\n        description: 'Experimental design and procedures',\n        examples: [\n          'How was the study conducted?',\n          'What methods were used?',\n          'What was the experimental design?'\n        ]\n      },\n      {\n        name: 'Results',\n        description: 'Findings and observations',\n        examples: [\n          'What did the study find?',\n          'What are the data?',\n          'What were the observations?'\n        ]\n      },\n      {\n        name: 'Discussion',\n        description: 'Interpretation and implications of results',\n        examples: [\n          'What do the results mean?',\n          'What are the implications?',\n          'How do these findings relate to prior work?'\n        ]\n      }\n    ]\n  },\n\n  'argument-toulmin': {\n    id: 'argument-toulmin',\n    name: 'Argument Structure (Toulmin)',\n    description: 'Claim, Evidence, Warrant, Counterargument, Rebuttal framework for argumentation',\n    domain: 'general',\n    tags: [\n      {\n        name: 'Claim',\n        description: 'The main assertion or thesis',\n        examples: [\n          'What is being argued?',\n          'What is the main point?',\n          'What position is being taken?'\n        ]\n      },\n      {\n        name: 'Evidence',\n        description: 'Data or facts supporting the claim',\n        examples: [\n          'What supports this claim?',\n          'What are the facts?',\n          'What data is provided?'\n        ]\n      },\n      {\n        name: 'Warrant',\n        description: 'Reasoning connecting evidence to claim',\n        examples: [\n          'Why does this evidence support the claim?',\n          'What is the logic?',\n          'How does this reasoning work?'\n        ]\n      },\n      {\n        name: 'Counterargument',\n        description: 'Opposing viewpoints or objections',\n        examples: [\n          'What are the objections?',\n          'What do critics say?',\n          'What are alternative views?'\n        ]\n      },\n      {\n        name: 'Rebuttal',\n        description: 'Response to counterarguments',\n        examples: [\n          'How is the objection addressed?',\n          'Why is the counterargument wrong?',\n          'How is the criticism answered?'\n        ]\n      }\n    ]\n  }\n};\n\n/**\n * Get a tag schema by ID\n */\nexport function getTagSchema(schemaId: string): TagSchema | null {\n  return TAG_SCHEMAS[schemaId] || null;\n}\n\n/**\n * Get all available tag schemas\n */\nexport function getAllTagSchemas(): TagSchema[] {\n  return Object.values(TAG_SCHEMAS);\n}\n\n/**\n * Get tag schemas filtered by domain\n */\nexport function getTagSchemasByDomain(domain: 'legal' | 'scientific' | 'general'): TagSchema[] {\n  return Object.values(TAG_SCHEMAS).filter(schema => schema.domain === domain);\n}\n\n/**\n * Validate that a category name is valid for a schema\n */\nexport function isValidCategory(schemaId: string, categoryName: string): boolean {\n  const schema = getTagSchema(schemaId);\n  if (!schema) return false;\n  return schema.tags.some(tag => tag.name === categoryName);\n}\n\n/**\n * Get a specific category from a schema\n */\nexport function getSchemaCategory(schemaId: string, categoryName: string): TagCategory | null {\n  const schema = getTagSchema(schemaId);\n  if (!schema) return null;\n  return schema.tags.find(tag => tag.name === categoryName) || null;\n}\n","/**\n * Entity Type Extraction Utilities\n *\n * Extract entity types from annotation bodies.\n * Entity types are stored as TextualBody with purpose: \"tagging\"\n */\n\nimport type { components } from '@semiont/core';\n\ntype Annotation = components['schemas']['Annotation'];\n\n/**\n * Extract entity types from annotation bodies\n * Entity types are stored as TextualBody with purpose: \"tagging\"\n * Accepts any object with a body property matching Annotation['body']\n */\nexport function getEntityTypes(annotation: { body: Annotation['body'] }): string[] {\n  // Extract from TextualBody bodies with purpose: \"tagging\"\n  if (Array.isArray(annotation.body)) {\n    const entityTags: string[] = [];\n\n    for (const item of annotation.body) {\n      // Runtime check for TextualBody with tagging purpose\n      // TypeScript incorrectly narrows the union type here, so we use runtime checks only\n      if (\n        typeof item === 'object' &&\n        item !== null &&\n        'type' in item &&\n        'value' in item &&\n        'purpose' in item\n      ) {\n        // Access properties as unknown first to avoid TypeScript narrowing issues\n        const itemType = (item as { type: unknown }).type;\n        const itemValue = (item as { value: unknown }).value;\n        const itemPurpose = (item as { purpose: unknown }).purpose;\n\n        if (itemType === 'TextualBody' && itemPurpose === 'tagging' && typeof itemValue === 'string' && itemValue.length > 0) {\n          entityTags.push(itemValue);\n        }\n      }\n    }\n\n    return entityTags;\n  }\n\n  return [];\n}\n","/**\n * Tag Schema Extraction Utilities\n *\n * Extract tag categories and schema IDs from tag annotations.\n * Tags use dual-body structure:\n * - First body has purpose: \"tagging\" with category value\n * - Second body has purpose: \"classifying\" with schema ID\n */\n\nimport type { components } from '@semiont/core';\n\ntype Annotation = components['schemas']['Annotation'];\n\n/**\n * Type guard to check if an annotation is a tag\n */\nfunction isTag(annotation: Annotation): boolean {\n  return annotation.motivation === 'tagging';\n}\n\n/**\n * Extract tag category from a tag annotation's body\n * Tags use dual-body structure: first body has purpose: \"tagging\" with category value\n * @param annotation - The annotation to extract category from\n * @returns The tag category (e.g., \"Issue\", \"Rule\"), or undefined if not a tag or no category found\n */\nexport function getTagCategory(annotation: Annotation): string | undefined {\n  if (!isTag(annotation)) return undefined;\n  const bodies = Array.isArray(annotation.body) ? annotation.body : [annotation.body];\n  const taggingBody = bodies.find((b): b is Extract<typeof b, { purpose?: string }> =>\n    b !== null && typeof b === 'object' && 'purpose' in b && b.purpose === 'tagging'\n  );\n  if (taggingBody && 'value' in taggingBody) {\n    return taggingBody.value as string;\n  }\n  return undefined;\n}\n\n/**\n * Extract tag schema ID from a tag annotation's body\n * Tags use dual-body structure: second body has purpose: \"classifying\" with schema ID\n * @param annotation - The annotation to extract schema ID from\n * @returns The schema ID (e.g., \"legal-irac\"), or undefined if not a tag or no schema found\n */\nexport function getTagSchemaId(annotation: Annotation): string | undefined {\n  if (!isTag(annotation)) return undefined;\n  const bodies = Array.isArray(annotation.body) ? annotation.body : [annotation.body];\n  const classifyingBody = bodies.find((b): b is Extract<typeof b, { purpose?: string }> =>\n    b !== null && typeof b === 'object' && 'purpose' in b && b.purpose === 'classifying'\n  );\n  if (classifyingBody && 'value' in classifyingBody) {\n    return classifyingBody.value as string;\n  }\n  return undefined;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/ontology",
-  "version": "0.2.33",
+  "version": "0.2.34-build.89",
   "type": "module",
   "description": "Entity types, tag schemas, and W3C annotation vocabularies",
   "main": "./dist/index.js",