@graphext/cuery 0.5.2 → 0.6.0

package/README.md

@@ -1,5 +1,10 @@
 # Cuery
 
+[![JSR](https://jsr.io/badges/@graphext/cuery)](https://jsr.io/@graphext/cuery)
+[![npm](https://img.shields.io/npm/v/@graphext/cuery)](https://www.npmjs.com/package/@graphext/cuery)
+[![Release](https://github.com/graphext/cueryjs/actions/workflows/release.yml/badge.svg)](https://github.com/graphext/cueryjs/actions/workflows/release.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
 Internal utilities for data processing and analysis.
 
 ## Installation

package/esm/mod.d.ts

@@ -16,6 +16,7 @@ export * from './src/helpers/utils.js';
 export * from './src/tools/brands.js';
 export * from './src/tools/translate.js';
 export * from './src/tools/sentiment.js';
+export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
 export * from './src/helpers/seedKeywords.js';

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/esm/mod.js

@@ -18,6 +18,7 @@ export * from './src/helpers/utils.js';
 export * from './src/tools/brands.js';
 export * from './src/tools/translate.js';
 export * from './src/tools/sentiment.js';
+export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
 export * from './src/helpers/seedKeywords.js';

package/esm/src/schemas/index.d.ts

@@ -18,4 +18,5 @@ export type * from './pipeline.schema.js';
 export type * from './models.schema.js';
 export type * from './seedKeyword.schema.js';
 export type * from './topics.schema.js';
+export type * from './summary.schema.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/src/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC"}

package/esm/src/schemas/summary.schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+export declare const SummarySchema: z.ZodObject<{
+    summary: z.ZodString;
+}, z.core.$strip>;
+export type Summary = z.infer<typeof SummarySchema>;
+//# sourceMappingURL=summary.schema.d.ts.map

package/esm/src/schemas/summary.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/summary.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/esm/src/schemas/summary.schema.js

@@ -0,0 +1,4 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+export const SummarySchema = z.object({
+    summary: z.string().describe('The summarized text, condensed to approximately the target word count while preserving key information.')
+});

package/esm/src/tools/classifier.d.ts

@@ -25,6 +25,44 @@ export declare class Classifier extends Tool<Record<string, unknown> | null, {
         label: string;
     }): string;
 }
+/**
+ * Predefined communicative intent labels based on the PIE+ framework.
+ * These represent the core purposes of communication, writing, and rhetoric.
+ */
+export declare const SPEECH_INTENT_LABELS: Record<string, string>;
+/**
+ * Configuration for the SpeechIntentClassifier tool.
+ */
+export interface SpeechIntentClassifierConfig {
+    /** Additional instructions for the classifier */
+    instructions?: string;
+}
+/**
+ * A tool that classifies text into communicative/speech intents (inform, persuade, entertain, educate, express emotions).
+ * Based on the PIE+ framework for understanding author's purpose.
+ */
+export declare class SpeechIntentClassifier extends Classifier {
+    constructor(config: SpeechIntentClassifierConfig | undefined, modelConfig: ModelConfig);
+}
+/**
+ * Predefined emotion labels based on Plutchik's wheel of emotions.
+ * These represent the 8 primary emotions organized as 4 opposing pairs.
+ */
+export declare const PLUTCHIK_EMOTION_LABELS: Record<string, string>;
+/**
+ * Configuration for the PlutchikEmotionClassifier tool.
+ */
+export interface PlutchikEmotionClassifierConfig {
+    /** Additional instructions for the classifier */
+    instructions?: string;
+}
+/**
+ * A tool that classifies text into dominant emotions based on Plutchik's wheel of emotions.
+ * The 8 primary emotions are organized as 4 opposing pairs: joy/sadness, trust/disgust, fear/anger, surprise/anticipation.
+ */
+export declare class PlutchikEmotionClassifier extends Classifier {
+    constructor(config: PlutchikEmotionClassifierConfig | undefined, modelConfig: ModelConfig);
+}
 /**
  * Configuration for the Labeler tool.
  */

package/esm/src/tools/classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/src/tools/classifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/src/tools/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAmGpD,UAAU,gBAAgB;IACzB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC;IAC9F,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW;cAS3C,MAAM;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;cAIpC,aAAa,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;CAG1D;AAMD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMvD,CAAC;AAWF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;gBACzC,MAAM,EAAE,4BAA4B,YAAK,EAAE,WAAW,EAAE,WAAW;CAO/E;AAMD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS1D,CAAC;AAWF;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC/C,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,UAAU;gBAC5C,MAAM,EAAE,+BAA+B,YAAK,EAAE,WAAW,EAAE,WAAW;CAOlF;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1G,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4C;IAC7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW;cASxC,MAAM;;;IAIzB,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;cAIpC,aAAa,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE;CAGlE;AAwCD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,IAAI,CACvC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9B;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EACxD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACtB;IACA,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,oBAAoB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBpD,MAAM;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;cAQrC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO;cAIzD,aAAa,CAC/B,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAC9D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGzB"}

package/esm/src/tools/classifier.js

@@ -104,6 +104,79 @@ export class Classifier extends Tool {
         return parsed.label;
     }
 }
+// =============================================================================
+// SpeechIntentClassifier (communicative intent classification)
+// =============================================================================
+/**
+ * Predefined communicative intent labels based on the PIE+ framework.
+ * These represent the core purposes of communication, writing, and rhetoric.
+ */
+export const SPEECH_INTENT_LABELS = {
+    inform: 'Provides facts, data, and knowledge about a topic. Uses clear, objective language, numbers, dates, and evidence. Examples: news articles, encyclopedia entries, reports.',
+    persuade: 'Aims to influence the audience\'s point of view, convince them of an idea, or move them to action. Uses emotional appeals (pathos), logical reasoning (logos), and expert credibility (ethos). Examples: speeches, advertisements, editorials.',
+    entertain: 'Aims to amuse, provide enjoyment, or create a pleasant experience. Uses humor, suspense, vivid imagery, and engaging characters. Examples: novels, poems, stories, comics.',
+    educate: 'Aims to teach the audience, instruct them on how to do something, or increase their understanding. Uses step-by-step instructions, clear explanations, and breaks down complex topics. Examples: textbooks, tutorials, how-to guides.',
+    express_emotions: 'Shares personal feelings, evokes a specific mood, or connects emotionally with the reader. Uses vivid, emotive, or sensory language. Examples: diary entries, poetry, journals, personal essays.'
+};
+/**
+ * Predefined instructions for speech intent classification.
+ */
+const SPEECH_INTENT_CLASSIFIER_INSTRUCTIONS = dedent(`
+Focus on the author's PURPOSE, not the topic. A news article about entertainment is "inform", not "entertain".
+Ask yourself: What is the author trying to achieve with this text?
+If the text blends multiple purposes, identify the DOMINANT intent based on the overall structure and goal.
+`);
+/**
+ * A tool that classifies text into communicative/speech intents (inform, persuade, entertain, educate, express emotions).
+ * Based on the PIE+ framework for understanding author's purpose.
+ */
+export class SpeechIntentClassifier extends Classifier {
+    constructor(config = {}, modelConfig) {
+        const { instructions = '' } = config;
+        const combinedInstructions = instructions
+            ? `${SPEECH_INTENT_CLASSIFIER_INSTRUCTIONS}\n\n${instructions}`
+            : SPEECH_INTENT_CLASSIFIER_INSTRUCTIONS;
+        super({ labels: SPEECH_INTENT_LABELS, instructions: combinedInstructions }, modelConfig);
+    }
+}
+// =============================================================================
+// PlutchikEmotionClassifier (emotion classification)
+// =============================================================================
+/**
+ * Predefined emotion labels based on Plutchik's wheel of emotions.
+ * These represent the 8 primary emotions organized as 4 opposing pairs.
+ */
+export const PLUTCHIK_EMOTION_LABELS = {
+    joy: 'A positive, high-energy state of pleasure, happiness, or contentment. Expressed through uplifting language, celebration, gratitude, or satisfaction.',
+    sadness: 'A low-energy state associated with loss, grief, disappointment, or melancholy. Expressed through somber tone, themes of loss, or expressions of sorrow.',
+    trust: 'A positive acceptance or affinity for others. Expressed through confidence, reliability, loyalty, or openness to connection.',
+    disgust: 'A feeling of revulsion, rejection, or strong disapproval. Expressed through aversion, contempt, or moral judgment.',
+    fear: 'An emotional response to danger, threat, or uncertainty. Expressed through anxiety, worry, caution, or alarm.',
+    anger: 'A high-arousal response to frustration, injustice, or provocation. Expressed through criticism, outrage, hostility, or aggression.',
+    surprise: 'A reaction to unexpected events or information. Expressed through astonishment, disbelief, or sudden realization.',
+    anticipation: 'Looking forward to, or preparing for, future events. Expressed through expectation, excitement, hope, or vigilance.'
+};
+/**
+ * Predefined instructions for emotion classification.
+ */
+const PLUTCHIK_EMOTION_CLASSIFIER_INSTRUCTIONS = dedent(`
+Identify the DOMINANT emotion conveyed by the text, considering both explicit emotional language and implicit tone.
+Focus on what the author/speaker is feeling or trying to evoke in the reader, not the topic being discussed.
+If multiple emotions are present, choose the one that is most central to the text's emotional impact.
+`);
+/**
+ * A tool that classifies text into dominant emotions based on Plutchik's wheel of emotions.
+ * The 8 primary emotions are organized as 4 opposing pairs: joy/sadness, trust/disgust, fear/anger, surprise/anticipation.
+ */
+export class PlutchikEmotionClassifier extends Classifier {
+    constructor(config = {}, modelConfig) {
+        const { instructions = '' } = config;
+        const combinedInstructions = instructions
+            ? `${PLUTCHIK_EMOTION_CLASSIFIER_INSTRUCTIONS}\n\n${instructions}`
+            : PLUTCHIK_EMOTION_CLASSIFIER_INSTRUCTIONS;
+        super({ labels: PLUTCHIK_EMOTION_LABELS, instructions: combinedInstructions }, modelConfig);
+    }
+}
 /**
  * A tool that assigns one or more labels to records from provided options.
  */

package/esm/src/tools/entities.d.ts

@@ -25,6 +25,28 @@ export declare class EntityExtractor extends Tool<string | null, Entities, Array
     protected isEmpty(text: string | null): boolean;
     protected extractResult(parsed: Entities): Array<Entity>;
 }
+/**
+ * Predefined common entity types for general-purpose extraction.
+ */
+export declare const COMMON_ENTITY_DEFINITIONS: Record<string, string>;
+/**
+ * Configuration for the CommonEntityExtractor tool.
+ */
+export interface CommonEntityExtractorConfig {
+    /** Additional entity definitions to merge with common ones */
+    additionalDefinitions?: Record<string, string>;
+    /** Entity types to exclude from common definitions */
+    excludeTypes?: Array<string>;
+    /** Additional instructions */
+    instructions?: string;
+}
+/**
+ * A tool that extracts common entity types (person, organization, location, etc.) from text.
+ * Extends EntityExtractor with predefined entity definitions.
+ */
+export declare class CommonEntityExtractor extends EntityExtractor {
+    constructor(config: CommonEntityExtractorConfig | undefined, modelConfig: ModelConfig);
+}
 export type { Entity, Entities } from '../schemas/entity.schema.js';
 export { EntitySchema, EntitiesSchema } from '../schemas/entity.schema.js';
 //# sourceMappingURL=entities.d.ts.map

package/esm/src/tools/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/src/tools/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAkCzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,qBAAqB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBrD,MAAM;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;cAIjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;CAGjE;AAGD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/src/tools/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAkCzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,qBAAqB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBrD,MAAM;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;cAIjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;CAGjE;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS5D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,sDAAsD;IACtD,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC7C,MAAM,EAAE,2BAA2B,YAAK,EAAE,WAAW,EAAE,WAAW;CAe9E;AAGD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/esm/src/tools/entities.js

@@ -57,4 +57,36 @@ export class EntityExtractor extends Tool {
         return parsed.entities;
     }
 }
+// =============================================================================
+// CommonEntityExtractor
+// =============================================================================
+/**
+ * Predefined common entity types for general-purpose extraction.
+ */
+export const COMMON_ENTITY_DEFINITIONS = {
+    person: 'Names of people, individuals, celebrities, public figures',
+    organization: 'Companies, institutions, agencies, teams, corporations',
+    location: 'Places, cities, countries, regions, addresses, landmarks',
+    product: 'Products, services, software, apps, models',
+    brand: 'Brand names, trademarks',
+    date: 'Dates, time periods, years, seasons',
+    money: 'Monetary values, prices, currencies, financial amounts',
+    event: 'Events, conferences, meetings, holidays, incidents'
+};
+/**
+ * A tool that extracts common entity types (person, organization, location, etc.) from text.
+ * Extends EntityExtractor with predefined entity definitions.
+ */
+export class CommonEntityExtractor extends EntityExtractor {
+    constructor(config = {}, modelConfig) {
+        const { additionalDefinitions = {}, excludeTypes = [], instructions = '' } = config;
+        // Filter out excluded types and merge with additional definitions
+        const filteredDefinitions = Object.fromEntries(Object.entries(COMMON_ENTITY_DEFINITIONS).filter(([type]) => !excludeTypes.includes(type)));
+        const mergedDefinitions = {
+            ...filteredDefinitions,
+            ...additionalDefinitions
+        };
+        super({ entityDefinitions: mergedDefinitions, instructions }, modelConfig);
+    }
+}
 export { EntitySchema, EntitiesSchema } from '../schemas/entity.schema.js';

package/esm/src/tools/sentiment.d.ts

@@ -1,7 +1,8 @@
-import { Tool, type ModelConfig } from '../tool.js';
 import type { Message } from '../llm.js';
 import type { BrandContext } from '../schemas/brand.schema.js';
 import { type ABSentiment, type ABSentiments } from '../schemas/sentiment.schema.js';
+import { Tool, type ModelConfig } from '../tool.js';
+import { Classifier } from './classifier.js';
 export interface SentimentExtractorConfig {
     /** Additional instructions for sentiment extraction */
     instructions?: string;
@@ -28,6 +29,23 @@ export declare class SentimentExtractor extends Tool<string | null, ABSentiments
     protected isEmpty(text: string | null): boolean;
     protected extractResult(parsed: ABSentiments): Array<ABSentiment>;
 }
-export type { ABSentiment, ABSentiments } from '../schemas/sentiment.schema.js';
+/**
+ * Sentiment polarity labels for classification.
+ */
+export declare const SENTIMENT_POLARITY_LABELS: Record<string, string>;
+/**
+ * Configuration for the SentimentPolarityClassifier tool.
+ */
+export interface SentimentPolarityClassifierConfig {
+    /** Additional instructions for the classifier */
+    instructions?: string;
+}
+/**
+ * A tool that classifies the overall sentiment polarity of text into positive, neutral, or negative.
+ */
+export declare class SentimentPolarityClassifier extends Classifier {
+    constructor(config: SentimentPolarityClassifierConfig | undefined, modelConfig: ModelConfig);
+}
 export { ABSentimentSchema, ABSentimentsSchema } from '../schemas/sentiment.schema.js';
+export type { ABSentiment, ABSentiments } from '../schemas/sentiment.schema.js';
 //# sourceMappingURL=sentiment.d.ts.map

package/esm/src/tools/sentiment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sentiment.d.ts","sourceRoot":"","sources":["../../../src/src/tools/sentiment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAwCzG,MAAM,WAAW,wBAAwB;IACxC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,wBAAwB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBxD,MAAM;;;;;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAQ7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;CAG1E;AAED,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"sentiment.d.ts","sourceRoot":"","sources":["../../../src/src/tools/sentiment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACzG,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwC7C,MAAM,WAAW,wBAAwB;IACxC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,wBAAwB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBxD,MAAM;;;;;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAQ7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;CAG1E;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI5D,CAAC;AAWF;;GAEG;AACH,MAAM,WAAW,iCAAiC;IACjD,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,UAAU;gBAC9C,MAAM,EAAE,iCAAiC,YAAK,EAAE,WAAW,EAAE,WAAW;CAOpF;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}

package/esm/src/tools/sentiment.js

@@ -1,6 +1,7 @@
-import { Tool } from '../tool.js';
-import { ABSentimentsSchema } from '../schemas/sentiment.schema.js';
 import { dedent } from '../helpers/utils.js';
+import { ABSentimentsSchema } from '../schemas/sentiment.schema.js';
+import { Tool } from '../tool.js';
+import { Classifier } from './classifier.js';
 const ABS_PROMPT_SYSTEM = dedent(`
 You're an expert in Aspect-Based Sentiment Analysis. Your task involves identifying specific
 entities mentioned in a text (e.g. a person, product, service, or experience) and determining the
@@ -70,4 +71,35 @@ export class SentimentExtractor extends Tool {
         return parsed.aspects;
     }
 }
+// =============================================================================
+// SentimentPolarityClassifier (overall sentiment polarity)
+// =============================================================================
+/**
+ * Sentiment polarity labels for classification.
+ */
+export const SENTIMENT_POLARITY_LABELS = {
+    positive: 'Expresses favorable opinions, approval, satisfaction, or optimism.',
+    neutral: 'No clear sentiment expressed; factual, balanced, or ambiguous.',
+    negative: 'Expresses unfavorable opinions, criticism, dissatisfaction, or pessimism.'
+};
+/**
+ * Predefined instructions for sentiment polarity classification.
+ */
+const SENTIMENT_POLARITY_INSTRUCTIONS = dedent(`
+Analyze the overall sentiment polarity of the text.
+Focus on the dominant emotional tone, not individual aspects or entities.
+Consider both explicit sentiment expressions and implicit tone.
+`);
+/**
+ * A tool that classifies the overall sentiment polarity of text into positive, neutral, or negative.
+ */
+export class SentimentPolarityClassifier extends Classifier {
+    constructor(config = {}, modelConfig) {
+        const { instructions = '' } = config;
+        const combinedInstructions = instructions
+            ? `${SENTIMENT_POLARITY_INSTRUCTIONS}\n\n${instructions}`
+            : SENTIMENT_POLARITY_INSTRUCTIONS;
+        super({ labels: SENTIMENT_POLARITY_LABELS, instructions: combinedInstructions }, modelConfig);
+    }
+}
 export { ABSentimentSchema, ABSentimentsSchema } from '../schemas/sentiment.schema.js';

package/esm/src/tools/summarize.d.ts

@@ -0,0 +1,26 @@
+import { Tool, type ModelConfig } from '../tool.js';
+import type { Message } from '../llm.js';
+import { type Summary } from '../schemas/summary.schema.js';
+export interface SummarizerConfig {
+    /** Target word count for the summary (default: 100) */
+    targetWordCount?: number;
+    /** Additional instructions for summarization */
+    instructions?: string;
+}
+/**
+ * A tool that summarizes long texts into shorter ones.
+ */
+export declare class Summarizer extends Tool<string | null, Summary, string> {
+    private readonly systemPrompt;
+    private readonly targetWordCount;
+    constructor(config: SummarizerConfig | undefined, modelConfig: ModelConfig);
+    protected schema(): import("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js").ZodObject<{
+        summary: import("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js").ZodString;
+    }, import("../../deps/jsr.io/@zod/zod/4.3.6/src/v4/core/schemas.js").$strip>;
+    protected prompt(text: string | null): Message[];
+    protected isEmpty(text: string | null): boolean;
+    protected extractResult(parsed: Summary): string;
+}
+export type { Summary } from '../schemas/summary.schema.js';
+export { SummarySchema } from '../schemas/summary.schema.js';
+//# sourceMappingURL=summarize.d.ts.map

package/esm/src/tools/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/src/tools/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAyB3E,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,MAAM,EAAE,gBAAgB,YAAK,EAAE,WAAW,EAAE,WAAW;cAUhD,MAAM;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAU7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;CAGzD;AAED,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}

package/esm/src/tools/summarize.js

@@ -0,0 +1,57 @@
+import { Tool } from '../tool.js';
+import { SummarySchema } from '../schemas/summary.schema.js';
+import { dedent } from '../helpers/utils.js';
+const SUMMARIZE_PROMPT_SYSTEM = dedent(`
+You are an expert at summarizing text. Your task is to condense the given text while preserving
+the most important information, key points, and main ideas.
+
+Guidelines:
+1. Maintain the original tone and style where possible
+2. Preserve key facts, figures, and important details
+3. Remove redundant or less important information
+4. Keep the summary coherent and well-structured
+5. Target approximately {wordCount} words (some variance is acceptable)
+
+{instructions}
+`);
+const SUMMARIZE_PROMPT_USER = dedent(`
+Summarize the following text to approximately {wordCount} words.
+
+# Text
+
+{text}
+`);
+/**
+ * A tool that summarizes long texts into shorter ones.
+ */
+export class Summarizer extends Tool {
+    systemPrompt;
+    targetWordCount;
+    constructor(config = {}, modelConfig) {
+        super(modelConfig);
+        const { targetWordCount = 100, instructions = '' } = config;
+        this.targetWordCount = targetWordCount;
+        this.systemPrompt = SUMMARIZE_PROMPT_SYSTEM
+            .replace('{wordCount}', String(targetWordCount))
+            .replace('{instructions}', instructions);
+    }
+    schema() {
+        return SummarySchema;
+    }
+    prompt(text) {
+        const userPrompt = SUMMARIZE_PROMPT_USER
+            .replace('{wordCount}', String(this.targetWordCount))
+            .replace('{text}', text ?? '');
+        return [
+            { role: 'system', content: this.systemPrompt },
+            { role: 'user', content: userPrompt }
+        ];
+    }
+    isEmpty(text) {
+        return text == null || text.trim() === '';
+    }
+    extractResult(parsed) {
+        return parsed.summary;
+    }
+}
+export { SummarySchema } from '../schemas/summary.schema.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphext/cuery",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Cuery tools for AI-powered keyword research and brand analysis",
   "repository": {
     "type": "git",

package/script/mod.d.ts

@@ -16,6 +16,7 @@ export * from './src/helpers/utils.js';
 export * from './src/tools/brands.js';
 export * from './src/tools/translate.js';
 export * from './src/tools/sentiment.js';
+export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
 export * from './src/helpers/seedKeywords.js';

package/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/script/mod.js

@@ -41,6 +41,7 @@ __exportStar(require("./src/helpers/utils.js"), exports);
 __exportStar(require("./src/tools/brands.js"), exports);
 __exportStar(require("./src/tools/translate.js"), exports);
 __exportStar(require("./src/tools/sentiment.js"), exports);
+__exportStar(require("./src/tools/summarize.js"), exports);
 __exportStar(require("./src/tools/sources.js"), exports);
 __exportStar(require("./src/tools/entities.js"), exports);
 __exportStar(require("./src/helpers/seedKeywords.js"), exports);

package/script/src/schemas/index.d.ts

@@ -18,4 +18,5 @@ export type * from './pipeline.schema.js';
 export type * from './models.schema.js';
 export type * from './seedKeyword.schema.js';
 export type * from './topics.schema.js';
+export type * from './summary.schema.js';
 //# sourceMappingURL=index.d.ts.map

package/script/src/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC"}

package/script/src/schemas/summary.schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+export declare const SummarySchema: z.ZodObject<{
+    summary: z.ZodString;
+}, z.core.$strip>;
+export type Summary = z.infer<typeof SummarySchema>;
+//# sourceMappingURL=summary.schema.d.ts.map

package/script/src/schemas/summary.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/summary.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/script/src/schemas/summary.schema.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SummarySchema = void 0;
+const index_js_1 = require("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js");
+exports.SummarySchema = index_js_1.z.object({
+    summary: index_js_1.z.string().describe('The summarized text, condensed to approximately the target word count while preserving key information.')
+});

package/script/src/tools/classifier.d.ts

@@ -25,6 +25,44 @@ export declare class Classifier extends Tool<Record<string, unknown> | null, {
         label: string;
     }): string;
 }
+/**
+ * Predefined communicative intent labels based on the PIE+ framework.
+ * These represent the core purposes of communication, writing, and rhetoric.
+ */
+export declare const SPEECH_INTENT_LABELS: Record<string, string>;
+/**
+ * Configuration for the SpeechIntentClassifier tool.
+ */
+export interface SpeechIntentClassifierConfig {
+    /** Additional instructions for the classifier */
+    instructions?: string;
+}
+/**
+ * A tool that classifies text into communicative/speech intents (inform, persuade, entertain, educate, express emotions).
+ * Based on the PIE+ framework for understanding author's purpose.
+ */
+export declare class SpeechIntentClassifier extends Classifier {
+    constructor(config: SpeechIntentClassifierConfig | undefined, modelConfig: ModelConfig);
+}
+/**
+ * Predefined emotion labels based on Plutchik's wheel of emotions.
+ * These represent the 8 primary emotions organized as 4 opposing pairs.
+ */
+export declare const PLUTCHIK_EMOTION_LABELS: Record<string, string>;
+/**
+ * Configuration for the PlutchikEmotionClassifier tool.
+ */
+export interface PlutchikEmotionClassifierConfig {
+    /** Additional instructions for the classifier */
+    instructions?: string;
+}
+/**
+ * A tool that classifies text into dominant emotions based on Plutchik's wheel of emotions.
+ * The 8 primary emotions are organized as 4 opposing pairs: joy/sadness, trust/disgust, fear/anger, surprise/anticipation.
+ */
+export declare class PlutchikEmotionClassifier extends Classifier {
+    constructor(config: PlutchikEmotionClassifierConfig | undefined, modelConfig: ModelConfig);
+}
 /**
  * Configuration for the Labeler tool.
  */

package/script/src/tools/classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/src/tools/classifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/src/tools/classifier.ts"],"names":[],"mappings":"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"}

package/script/src/tools/classifier.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LabelExtractor = exports.Labeler = exports.Classifier = void 0;
+exports.LabelExtractor = exports.Labeler = exports.PlutchikEmotionClassifier = exports.PLUTCHIK_EMOTION_LABELS = exports.SpeechIntentClassifier = exports.SPEECH_INTENT_LABELS = exports.Classifier = void 0;
 const index_js_1 = require("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js");
 const tool_js_1 = require("../tool.js");
 const utils_js_1 = require("../helpers/utils.js");
@@ -108,6 +108,81 @@ class Classifier extends tool_js_1.Tool {
     }
 }
 exports.Classifier = Classifier;
+// =============================================================================
+// SpeechIntentClassifier (communicative intent classification)
+// =============================================================================
+/**
+ * Predefined communicative intent labels based on the PIE+ framework.
+ * These represent the core purposes of communication, writing, and rhetoric.
+ */
+exports.SPEECH_INTENT_LABELS = {
+    inform: 'Provides facts, data, and knowledge about a topic. Uses clear, objective language, numbers, dates, and evidence. Examples: news articles, encyclopedia entries, reports.',
+    persuade: 'Aims to influence the audience\'s point of view, convince them of an idea, or move them to action. Uses emotional appeals (pathos), logical reasoning (logos), and expert credibility (ethos). Examples: speeches, advertisements, editorials.',
+    entertain: 'Aims to amuse, provide enjoyment, or create a pleasant experience. Uses humor, suspense, vivid imagery, and engaging characters. Examples: novels, poems, stories, comics.',
+    educate: 'Aims to teach the audience, instruct them on how to do something, or increase their understanding. Uses step-by-step instructions, clear explanations, and breaks down complex topics. Examples: textbooks, tutorials, how-to guides.',
+    express_emotions: 'Shares personal feelings, evokes a specific mood, or connects emotionally with the reader. Uses vivid, emotive, or sensory language. Examples: diary entries, poetry, journals, personal essays.'
+};
+/**
+ * Predefined instructions for speech intent classification.
+ */
+const SPEECH_INTENT_CLASSIFIER_INSTRUCTIONS = (0, utils_js_1.dedent)(`
+Focus on the author's PURPOSE, not the topic. A news article about entertainment is "inform", not "entertain".
+Ask yourself: What is the author trying to achieve with this text?
+If the text blends multiple purposes, identify the DOMINANT intent based on the overall structure and goal.
+`);
+/**
+ * A tool that classifies text into communicative/speech intents (inform, persuade, entertain, educate, express emotions).
+ * Based on the PIE+ framework for understanding author's purpose.
+ */
+class SpeechIntentClassifier extends Classifier {
+    constructor(config = {}, modelConfig) {
+        const { instructions = '' } = config;
+        const combinedInstructions = instructions
+            ? `${SPEECH_INTENT_CLASSIFIER_INSTRUCTIONS}\n\n${instructions}`
+            : SPEECH_INTENT_CLASSIFIER_INSTRUCTIONS;
+        super({ labels: exports.SPEECH_INTENT_LABELS, instructions: combinedInstructions }, modelConfig);
+    }
+}
+exports.SpeechIntentClassifier = SpeechIntentClassifier;
+// =============================================================================
+// PlutchikEmotionClassifier (emotion classification)
+// =============================================================================
+/**
+ * Predefined emotion labels based on Plutchik's wheel of emotions.
+ * These represent the 8 primary emotions organized as 4 opposing pairs.
+ */
+exports.PLUTCHIK_EMOTION_LABELS = {
+    joy: 'A positive, high-energy state of pleasure, happiness, or contentment. Expressed through uplifting language, celebration, gratitude, or satisfaction.',
+    sadness: 'A low-energy state associated with loss, grief, disappointment, or melancholy. Expressed through somber tone, themes of loss, or expressions of sorrow.',
+    trust: 'A positive acceptance or affinity for others. Expressed through confidence, reliability, loyalty, or openness to connection.',
+    disgust: 'A feeling of revulsion, rejection, or strong disapproval. Expressed through aversion, contempt, or moral judgment.',
+    fear: 'An emotional response to danger, threat, or uncertainty. Expressed through anxiety, worry, caution, or alarm.',
+    anger: 'A high-arousal response to frustration, injustice, or provocation. Expressed through criticism, outrage, hostility, or aggression.',
+    surprise: 'A reaction to unexpected events or information. Expressed through astonishment, disbelief, or sudden realization.',
+    anticipation: 'Looking forward to, or preparing for, future events. Expressed through expectation, excitement, hope, or vigilance.'
+};
+/**
+ * Predefined instructions for emotion classification.
+ */
+const PLUTCHIK_EMOTION_CLASSIFIER_INSTRUCTIONS = (0, utils_js_1.dedent)(`
+Identify the DOMINANT emotion conveyed by the text, considering both explicit emotional language and implicit tone.
+Focus on what the author/speaker is feeling or trying to evoke in the reader, not the topic being discussed.
+If multiple emotions are present, choose the one that is most central to the text's emotional impact.
+`);
+/**
+ * A tool that classifies text into dominant emotions based on Plutchik's wheel of emotions.
+ * The 8 primary emotions are organized as 4 opposing pairs: joy/sadness, trust/disgust, fear/anger, surprise/anticipation.
+ */
+class PlutchikEmotionClassifier extends Classifier {
+    constructor(config = {}, modelConfig) {
+        const { instructions = '' } = config;
+        const combinedInstructions = instructions
+            ? `${PLUTCHIK_EMOTION_CLASSIFIER_INSTRUCTIONS}\n\n${instructions}`
+            : PLUTCHIK_EMOTION_CLASSIFIER_INSTRUCTIONS;
+        super({ labels: exports.PLUTCHIK_EMOTION_LABELS, instructions: combinedInstructions }, modelConfig);
+    }
+}
+exports.PlutchikEmotionClassifier = PlutchikEmotionClassifier;
 /**
  * A tool that assigns one or more labels to records from provided options.
  */

package/script/src/tools/entities.d.ts

@@ -25,6 +25,28 @@ export declare class EntityExtractor extends Tool<string | null, Entities, Array
     protected isEmpty(text: string | null): boolean;
     protected extractResult(parsed: Entities): Array<Entity>;
 }
+/**
+ * Predefined common entity types for general-purpose extraction.
+ */
+export declare const COMMON_ENTITY_DEFINITIONS: Record<string, string>;
+/**
+ * Configuration for the CommonEntityExtractor tool.
+ */
+export interface CommonEntityExtractorConfig {
+    /** Additional entity definitions to merge with common ones */
+    additionalDefinitions?: Record<string, string>;
+    /** Entity types to exclude from common definitions */
+    excludeTypes?: Array<string>;
+    /** Additional instructions */
+    instructions?: string;
+}
+/**
+ * A tool that extracts common entity types (person, organization, location, etc.) from text.
+ * Extends EntityExtractor with predefined entity definitions.
+ */
+export declare class CommonEntityExtractor extends EntityExtractor {
+    constructor(config: CommonEntityExtractorConfig | undefined, modelConfig: ModelConfig);
+}
 export type { Entity, Entities } from '../schemas/entity.schema.js';
 export { EntitySchema, EntitiesSchema } from '../schemas/entity.schema.js';
 //# sourceMappingURL=entities.d.ts.map

package/script/src/tools/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/src/tools/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAkCzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,qBAAqB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBrD,MAAM;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;cAIjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;CAGjE;AAGD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/src/tools/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAkCzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,qBAAqB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBrD,MAAM;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;cAIjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;CAGjE;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS5D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,sDAAsD;IACtD,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC7C,MAAM,EAAE,2BAA2B,YAAK,EAAE,WAAW,EAAE,WAAW;CAe9E;AAGD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/script/src/tools/entities.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntitiesSchema = exports.EntitySchema = exports.EntityExtractor = void 0;
+exports.EntitiesSchema = exports.EntitySchema = exports.CommonEntityExtractor = exports.COMMON_ENTITY_DEFINITIONS = exports.EntityExtractor = void 0;
 const tool_js_1 = require("../tool.js");
 const entity_schema_js_1 = require("../schemas/entity.schema.js");
 const utils_js_1 = require("../helpers/utils.js");
@@ -61,6 +61,39 @@ class EntityExtractor extends tool_js_1.Tool {
     }
 }
 exports.EntityExtractor = EntityExtractor;
+// =============================================================================
+// CommonEntityExtractor
+// =============================================================================
+/**
+ * Predefined common entity types for general-purpose extraction.
+ */
+exports.COMMON_ENTITY_DEFINITIONS = {
+    person: 'Names of people, individuals, celebrities, public figures',
+    organization: 'Companies, institutions, agencies, teams, corporations',
+    location: 'Places, cities, countries, regions, addresses, landmarks',
+    product: 'Products, services, software, apps, models',
+    brand: 'Brand names, trademarks',
+    date: 'Dates, time periods, years, seasons',
+    money: 'Monetary values, prices, currencies, financial amounts',
+    event: 'Events, conferences, meetings, holidays, incidents'
+};
+/**
+ * A tool that extracts common entity types (person, organization, location, etc.) from text.
+ * Extends EntityExtractor with predefined entity definitions.
+ */
+class CommonEntityExtractor extends EntityExtractor {
+    constructor(config = {}, modelConfig) {
+        const { additionalDefinitions = {}, excludeTypes = [], instructions = '' } = config;
+        // Filter out excluded types and merge with additional definitions
+        const filteredDefinitions = Object.fromEntries(Object.entries(exports.COMMON_ENTITY_DEFINITIONS).filter(([type]) => !excludeTypes.includes(type)));
+        const mergedDefinitions = {
+            ...filteredDefinitions,
+            ...additionalDefinitions
+        };
+        super({ entityDefinitions: mergedDefinitions, instructions }, modelConfig);
+    }
+}
+exports.CommonEntityExtractor = CommonEntityExtractor;
 var entity_schema_js_2 = require("../schemas/entity.schema.js");
 Object.defineProperty(exports, "EntitySchema", { enumerable: true, get: function () { return entity_schema_js_2.EntitySchema; } });
 Object.defineProperty(exports, "EntitiesSchema", { enumerable: true, get: function () { return entity_schema_js_2.EntitiesSchema; } });

package/script/src/tools/sentiment.d.ts

@@ -1,7 +1,8 @@
-import { Tool, type ModelConfig } from '../tool.js';
 import type { Message } from '../llm.js';
 import type { BrandContext } from '../schemas/brand.schema.js';
 import { type ABSentiment, type ABSentiments } from '../schemas/sentiment.schema.js';
+import { Tool, type ModelConfig } from '../tool.js';
+import { Classifier } from './classifier.js';
 export interface SentimentExtractorConfig {
     /** Additional instructions for sentiment extraction */
     instructions?: string;
@@ -28,6 +29,23 @@ export declare class SentimentExtractor extends Tool<string | null, ABSentiments
     protected isEmpty(text: string | null): boolean;
     protected extractResult(parsed: ABSentiments): Array<ABSentiment>;
 }
-export type { ABSentiment, ABSentiments } from '../schemas/sentiment.schema.js';
+/**
+ * Sentiment polarity labels for classification.
+ */
+export declare const SENTIMENT_POLARITY_LABELS: Record<string, string>;
+/**
+ * Configuration for the SentimentPolarityClassifier tool.
+ */
+export interface SentimentPolarityClassifierConfig {
+    /** Additional instructions for the classifier */
+    instructions?: string;
+}
+/**
+ * A tool that classifies the overall sentiment polarity of text into positive, neutral, or negative.
+ */
+export declare class SentimentPolarityClassifier extends Classifier {
+    constructor(config: SentimentPolarityClassifierConfig | undefined, modelConfig: ModelConfig);
+}
 export { ABSentimentSchema, ABSentimentsSchema } from '../schemas/sentiment.schema.js';
+export type { ABSentiment, ABSentiments } from '../schemas/sentiment.schema.js';
 //# sourceMappingURL=sentiment.d.ts.map

package/script/src/tools/sentiment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sentiment.d.ts","sourceRoot":"","sources":["../../../src/src/tools/sentiment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAwCzG,MAAM,WAAW,wBAAwB;IACxC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,wBAAwB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBxD,MAAM;;;;;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAQ7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;CAG1E;AAED,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"sentiment.d.ts","sourceRoot":"","sources":["../../../src/src/tools/sentiment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACzG,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwC7C,MAAM,WAAW,wBAAwB;IACxC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,wBAAwB,YAAK,EAAE,WAAW,EAAE,WAAW;cAgBxD,MAAM;;;;;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAQ7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;CAG1E;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI5D,CAAC;AAWF;;GAEG;AACH,MAAM,WAAW,iCAAiC;IACjD,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,UAAU;gBAC9C,MAAM,EAAE,iCAAiC,YAAK,EAAE,WAAW,EAAE,WAAW;CAOpF;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}

package/script/src/tools/sentiment.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ABSentimentsSchema = exports.ABSentimentSchema = exports.SentimentExtractor = void 0;
-const tool_js_1 = require("../tool.js");
-const sentiment_schema_js_1 = require("../schemas/sentiment.schema.js");
+exports.ABSentimentsSchema = exports.ABSentimentSchema = exports.SentimentPolarityClassifier = exports.SENTIMENT_POLARITY_LABELS = exports.SentimentExtractor = void 0;
 const utils_js_1 = require("../helpers/utils.js");
+const sentiment_schema_js_1 = require("../schemas/sentiment.schema.js");
+const tool_js_1 = require("../tool.js");
+const classifier_js_1 = require("./classifier.js");
 const ABS_PROMPT_SYSTEM = (0, utils_js_1.dedent)(`
 You're an expert in Aspect-Based Sentiment Analysis. Your task involves identifying specific
 entities mentioned in a text (e.g. a person, product, service, or experience) and determining the
@@ -74,6 +75,38 @@ class SentimentExtractor extends tool_js_1.Tool {
     }
 }
 exports.SentimentExtractor = SentimentExtractor;
+// =============================================================================
+// SentimentPolarityClassifier (overall sentiment polarity)
+// =============================================================================
+/**
+ * Sentiment polarity labels for classification.
+ */
+exports.SENTIMENT_POLARITY_LABELS = {
+    positive: 'Expresses favorable opinions, approval, satisfaction, or optimism.',
+    neutral: 'No clear sentiment expressed; factual, balanced, or ambiguous.',
+    negative: 'Expresses unfavorable opinions, criticism, dissatisfaction, or pessimism.'
+};
+/**
+ * Predefined instructions for sentiment polarity classification.
+ */
+const SENTIMENT_POLARITY_INSTRUCTIONS = (0, utils_js_1.dedent)(`
+Analyze the overall sentiment polarity of the text.
+Focus on the dominant emotional tone, not individual aspects or entities.
+Consider both explicit sentiment expressions and implicit tone.
+`);
+/**
+ * A tool that classifies the overall sentiment polarity of text into positive, neutral, or negative.
+ */
+class SentimentPolarityClassifier extends classifier_js_1.Classifier {
+    constructor(config = {}, modelConfig) {
+        const { instructions = '' } = config;
+        const combinedInstructions = instructions
+            ? `${SENTIMENT_POLARITY_INSTRUCTIONS}\n\n${instructions}`
+            : SENTIMENT_POLARITY_INSTRUCTIONS;
+        super({ labels: exports.SENTIMENT_POLARITY_LABELS, instructions: combinedInstructions }, modelConfig);
+    }
+}
+exports.SentimentPolarityClassifier = SentimentPolarityClassifier;
 var sentiment_schema_js_2 = require("../schemas/sentiment.schema.js");
 Object.defineProperty(exports, "ABSentimentSchema", { enumerable: true, get: function () { return sentiment_schema_js_2.ABSentimentSchema; } });
 Object.defineProperty(exports, "ABSentimentsSchema", { enumerable: true, get: function () { return sentiment_schema_js_2.ABSentimentsSchema; } });

package/script/src/tools/summarize.d.ts

@@ -0,0 +1,26 @@
+import { Tool, type ModelConfig } from '../tool.js';
+import type { Message } from '../llm.js';
+import { type Summary } from '../schemas/summary.schema.js';
+export interface SummarizerConfig {
+    /** Target word count for the summary (default: 100) */
+    targetWordCount?: number;
+    /** Additional instructions for summarization */
+    instructions?: string;
+}
+/**
+ * A tool that summarizes long texts into shorter ones.
+ */
+export declare class Summarizer extends Tool<string | null, Summary, string> {
+    private readonly systemPrompt;
+    private readonly targetWordCount;
+    constructor(config: SummarizerConfig | undefined, modelConfig: ModelConfig);
+    protected schema(): import("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js").ZodObject<{
+        summary: import("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js").ZodString;
+    }, import("../../deps/jsr.io/@zod/zod/4.3.6/src/v4/core/schemas.js").$strip>;
+    protected prompt(text: string | null): Message[];
+    protected isEmpty(text: string | null): boolean;
+    protected extractResult(parsed: Summary): string;
+}
+export type { Summary } from '../schemas/summary.schema.js';
+export { SummarySchema } from '../schemas/summary.schema.js';
+//# sourceMappingURL=summarize.d.ts.map

package/script/src/tools/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/src/tools/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAyB3E,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,MAAM,EAAE,gBAAgB,YAAK,EAAE,WAAW,EAAE,WAAW;cAUhD,MAAM;;;IAIzB,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAU7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAIrC,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;CAGzD;AAED,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}

package/script/src/tools/summarize.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SummarySchema = exports.Summarizer = void 0;
+const tool_js_1 = require("../tool.js");
+const summary_schema_js_1 = require("../schemas/summary.schema.js");
+const utils_js_1 = require("../helpers/utils.js");
+const SUMMARIZE_PROMPT_SYSTEM = (0, utils_js_1.dedent)(`
+You are an expert at summarizing text. Your task is to condense the given text while preserving
+the most important information, key points, and main ideas.
+
+Guidelines:
+1. Maintain the original tone and style where possible
+2. Preserve key facts, figures, and important details
+3. Remove redundant or less important information
+4. Keep the summary coherent and well-structured
+5. Target approximately {wordCount} words (some variance is acceptable)
+
+{instructions}
+`);
+const SUMMARIZE_PROMPT_USER = (0, utils_js_1.dedent)(`
+Summarize the following text to approximately {wordCount} words.
+
+# Text
+
+{text}
+`);
+/**
+ * A tool that summarizes long texts into shorter ones.
+ */
+class Summarizer extends tool_js_1.Tool {
+    systemPrompt;
+    targetWordCount;
+    constructor(config = {}, modelConfig) {
+        super(modelConfig);
+        const { targetWordCount = 100, instructions = '' } = config;
+        this.targetWordCount = targetWordCount;
+        this.systemPrompt = SUMMARIZE_PROMPT_SYSTEM
+            .replace('{wordCount}', String(targetWordCount))
+            .replace('{instructions}', instructions);
+    }
+    schema() {
+        return summary_schema_js_1.SummarySchema;
+    }
+    prompt(text) {
+        const userPrompt = SUMMARIZE_PROMPT_USER
+            .replace('{wordCount}', String(this.targetWordCount))
+            .replace('{text}', text ?? '');
+        return [
+            { role: 'system', content: this.systemPrompt },
+            { role: 'user', content: userPrompt }
+        ];
+    }
+    isEmpty(text) {
+        return text == null || text.trim() === '';
+    }
+    extractResult(parsed) {
+        return parsed.summary;
+    }
+}
+exports.Summarizer = Summarizer;
+var summary_schema_js_2 = require("../schemas/summary.schema.js");
+Object.defineProperty(exports, "SummarySchema", { enumerable: true, get: function () { return summary_schema_js_2.SummarySchema; } });