@warmdrift/kgauto-compiler 2.0.0-alpha.10

package/dist/chunk-5TI6PNSK.mjs

@@ -0,0 +1,95 @@
+// src/dialect.ts
+var DIALECT_VERSION = "v1";
+var INTENT_ARCHETYPES = {
+  ask: {
+    name: "ask",
+    description: "Filter, search, or interrogate existing data",
+    examples: ["filter creators by criteria", "find docs matching query", "lookup a record"]
+  },
+  hunt: {
+    name: "hunt",
+    description: "Discover new entities not in the current dataset",
+    examples: ["find new prospects", "crawl for unindexed sources", "expand a seed list"]
+  },
+  classify: {
+    name: "classify",
+    description: "Assign a category from a finite set",
+    examples: ["intent detection", "sentiment", "route-to-team"]
+  },
+  summarize: {
+    name: "summarize",
+    description: "Compress text or data while preserving meaning",
+    examples: ["dashboard insight", "meeting notes", "briefing"]
+  },
+  generate: {
+    name: "generate",
+    description: "Produce new content from a prompt or template",
+    examples: ["draft email", "create marketing copy", "co-founder conversation"]
+  },
+  extract: {
+    name: "extract",
+    description: "Pull structured data from unstructured input",
+    examples: ["parse invoice", "extract entities", "transcript \u2192 action items"]
+  },
+  plan: {
+    name: "plan",
+    description: "Multi-step decomposition of a goal",
+    examples: ["build a roadmap", "sequence tasks", "break a feature into steps"]
+  },
+  critique: {
+    name: "critique",
+    description: "Quality assessment, review, or scoring",
+    examples: ["code review", "design feedback", "oracle judgment"]
+  },
+  transform: {
+    name: "transform",
+    description: "Change format or style while preserving content",
+    examples: ["markdown \u2192 html", "formal \u2192 casual", "translate"]
+  }
+};
+var ALL_ARCHETYPES = Object.keys(INTENT_ARCHETYPES);
+function isArchetype(name) {
+  return name in INTENT_ARCHETYPES;
+}
+function bucketContext(tokens) {
+  if (tokens < 1e3) return "tiny";
+  if (tokens < 4e3) return "small";
+  if (tokens < 16e3) return "medium";
+  if (tokens < 64e3) return "large";
+  return "huge";
+}
+function bucketToolCount(count) {
+  if (count === 0) return "none";
+  if (count <= 5) return "few";
+  if (count <= 20) return "many";
+  return "massive";
+}
+function bucketHistory(turnCount) {
+  if (turnCount <= 1) return "single_turn";
+  if (turnCount <= 6) return "short";
+  return "long";
+}
+function hashShape(s) {
+  return [
+    s.contextBucket,
+    s.toolCountBucket,
+    s.historyDepth,
+    s.outputMode,
+    s.hasExamples ? "ex" : "no_ex"
+  ].join("-");
+}
+function learningKey(archetype, model, shape) {
+  return `${DIALECT_VERSION}::${archetype}::${model}::${hashShape(shape)}`;
+}
+
+export {
+  DIALECT_VERSION,
+  INTENT_ARCHETYPES,
+  ALL_ARCHETYPES,
+  isArchetype,
+  bucketContext,
+  bucketToolCount,
+  bucketHistory,
+  hashShape,
+  learningKey
+};

package/dist/dialect.d.mts

@@ -0,0 +1,99 @@
+/**
+ * kgauto dialect-v1 — the cross-app vocabulary.
+ *
+ * For learnings to flow between apps, every app must speak the same vocabulary
+ * about (a) what kind of work it's asking for and (b) the rough shape of the
+ * call. This file is that vocabulary. It is versioned.
+ *
+ * Two primitives:
+ *   - IntentArchetype: WHAT the call is doing (semantic category)
+ *   - ShapeSignature:  HOW the call is shaped (size, tools, history, output)
+ *
+ * The brain learns by `(archetype, model, shape)` tuples. Apps that declare
+ * the same tuple inherit each other's mutations.
+ *
+ * v1 is intentionally small (9 archetypes, 5 shape dimensions). New entries
+ * arrive in v2/v3 from real usage signals — never speculatively.
+ */
+declare const DIALECT_VERSION: "v1";
+declare const INTENT_ARCHETYPES: {
+    readonly ask: {
+        readonly name: "ask";
+        readonly description: "Filter, search, or interrogate existing data";
+        readonly examples: ["filter creators by criteria", "find docs matching query", "lookup a record"];
+    };
+    readonly hunt: {
+        readonly name: "hunt";
+        readonly description: "Discover new entities not in the current dataset";
+        readonly examples: ["find new prospects", "crawl for unindexed sources", "expand a seed list"];
+    };
+    readonly classify: {
+        readonly name: "classify";
+        readonly description: "Assign a category from a finite set";
+        readonly examples: ["intent detection", "sentiment", "route-to-team"];
+    };
+    readonly summarize: {
+        readonly name: "summarize";
+        readonly description: "Compress text or data while preserving meaning";
+        readonly examples: ["dashboard insight", "meeting notes", "briefing"];
+    };
+    readonly generate: {
+        readonly name: "generate";
+        readonly description: "Produce new content from a prompt or template";
+        readonly examples: ["draft email", "create marketing copy", "co-founder conversation"];
+    };
+    readonly extract: {
+        readonly name: "extract";
+        readonly description: "Pull structured data from unstructured input";
+        readonly examples: ["parse invoice", "extract entities", "transcript → action items"];
+    };
+    readonly plan: {
+        readonly name: "plan";
+        readonly description: "Multi-step decomposition of a goal";
+        readonly examples: ["build a roadmap", "sequence tasks", "break a feature into steps"];
+    };
+    readonly critique: {
+        readonly name: "critique";
+        readonly description: "Quality assessment, review, or scoring";
+        readonly examples: ["code review", "design feedback", "oracle judgment"];
+    };
+    readonly transform: {
+        readonly name: "transform";
+        readonly description: "Change format or style while preserving content";
+        readonly examples: ["markdown → html", "formal → casual", "translate"];
+    };
+};
+type IntentArchetypeName = keyof typeof INTENT_ARCHETYPES;
+declare const ALL_ARCHETYPES: IntentArchetypeName[];
+declare function isArchetype(name: string): name is IntentArchetypeName;
+type ContextBucket = 'tiny' | 'small' | 'medium' | 'large' | 'huge';
+type ToolCountBucket = 'none' | 'few' | 'many' | 'massive';
+type HistoryDepth = 'single_turn' | 'short' | 'long';
+type OutputMode = 'text' | 'json' | 'tool_call';
+interface ShapeSignature {
+    /** Log-binned input token count. */
+    contextBucket: ContextBucket;
+    /** Tool count bucket. */
+    toolCountBucket: ToolCountBucket;
+    /** Conversation depth. */
+    historyDepth: HistoryDepth;
+    /** Expected output shape. */
+    outputMode: OutputMode;
+    /** Whether the prompt includes few-shot examples. */
+    hasExamples: boolean;
+}
+declare function bucketContext(tokens: number): ContextBucket;
+declare function bucketToolCount(count: number): ToolCountBucket;
+declare function bucketHistory(turnCount: number): HistoryDepth;
+/**
+ * Hash a shape signature into a compact string key. Stable across runs.
+ * Format: `<context>-<tools>-<history>-<output>-<examples>`.
+ */
+declare function hashShape(s: ShapeSignature): string;
+/**
+ * Compose the full learning key. This is what the brain learns by — a tuple
+ * any app can produce and any app can benefit from.
+ */
+declare function learningKey(archetype: IntentArchetypeName, model: string, shape: ShapeSignature): string;
+
+export { ALL_ARCHETYPES, type ContextBucket, DIALECT_VERSION, type HistoryDepth, INTENT_ARCHETYPES, type IntentArchetypeName, type OutputMode, type ShapeSignature, type ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey };

package/dist/dialect.d.ts

@@ -0,0 +1,99 @@
+/**
+ * kgauto dialect-v1 — the cross-app vocabulary.
+ *
+ * For learnings to flow between apps, every app must speak the same vocabulary
+ * about (a) what kind of work it's asking for and (b) the rough shape of the
+ * call. This file is that vocabulary. It is versioned.
+ *
+ * Two primitives:
+ *   - IntentArchetype: WHAT the call is doing (semantic category)
+ *   - ShapeSignature:  HOW the call is shaped (size, tools, history, output)
+ *
+ * The brain learns by `(archetype, model, shape)` tuples. Apps that declare
+ * the same tuple inherit each other's mutations.
+ *
+ * v1 is intentionally small (9 archetypes, 5 shape dimensions). New entries
+ * arrive in v2/v3 from real usage signals — never speculatively.
+ */
+declare const DIALECT_VERSION: "v1";
+declare const INTENT_ARCHETYPES: {
+    readonly ask: {
+        readonly name: "ask";
+        readonly description: "Filter, search, or interrogate existing data";
+        readonly examples: ["filter creators by criteria", "find docs matching query", "lookup a record"];
+    };
+    readonly hunt: {
+        readonly name: "hunt";
+        readonly description: "Discover new entities not in the current dataset";
+        readonly examples: ["find new prospects", "crawl for unindexed sources", "expand a seed list"];
+    };
+    readonly classify: {
+        readonly name: "classify";
+        readonly description: "Assign a category from a finite set";
+        readonly examples: ["intent detection", "sentiment", "route-to-team"];
+    };
+    readonly summarize: {
+        readonly name: "summarize";
+        readonly description: "Compress text or data while preserving meaning";
+        readonly examples: ["dashboard insight", "meeting notes", "briefing"];
+    };
+    readonly generate: {
+        readonly name: "generate";
+        readonly description: "Produce new content from a prompt or template";
+        readonly examples: ["draft email", "create marketing copy", "co-founder conversation"];
+    };
+    readonly extract: {
+        readonly name: "extract";
+        readonly description: "Pull structured data from unstructured input";
+        readonly examples: ["parse invoice", "extract entities", "transcript → action items"];
+    };
+    readonly plan: {
+        readonly name: "plan";
+        readonly description: "Multi-step decomposition of a goal";
+        readonly examples: ["build a roadmap", "sequence tasks", "break a feature into steps"];
+    };
+    readonly critique: {
+        readonly name: "critique";
+        readonly description: "Quality assessment, review, or scoring";
+        readonly examples: ["code review", "design feedback", "oracle judgment"];
+    };
+    readonly transform: {
+        readonly name: "transform";
+        readonly description: "Change format or style while preserving content";
+        readonly examples: ["markdown → html", "formal → casual", "translate"];
+    };
+};
+type IntentArchetypeName = keyof typeof INTENT_ARCHETYPES;
+declare const ALL_ARCHETYPES: IntentArchetypeName[];
+declare function isArchetype(name: string): name is IntentArchetypeName;
+type ContextBucket = 'tiny' | 'small' | 'medium' | 'large' | 'huge';
+type ToolCountBucket = 'none' | 'few' | 'many' | 'massive';
+type HistoryDepth = 'single_turn' | 'short' | 'long';
+type OutputMode = 'text' | 'json' | 'tool_call';
+interface ShapeSignature {
+    /** Log-binned input token count. */
+    contextBucket: ContextBucket;
+    /** Tool count bucket. */
+    toolCountBucket: ToolCountBucket;
+    /** Conversation depth. */
+    historyDepth: HistoryDepth;
+    /** Expected output shape. */
+    outputMode: OutputMode;
+    /** Whether the prompt includes few-shot examples. */
+    hasExamples: boolean;
+}
+declare function bucketContext(tokens: number): ContextBucket;
+declare function bucketToolCount(count: number): ToolCountBucket;
+declare function bucketHistory(turnCount: number): HistoryDepth;
+/**
+ * Hash a shape signature into a compact string key. Stable across runs.
+ * Format: `<context>-<tools>-<history>-<output>-<examples>`.
+ */
+declare function hashShape(s: ShapeSignature): string;
+/**
+ * Compose the full learning key. This is what the brain learns by — a tuple
+ * any app can produce and any app can benefit from.
+ */
+declare function learningKey(archetype: IntentArchetypeName, model: string, shape: ShapeSignature): string;
+
+export { ALL_ARCHETYPES, type ContextBucket, DIALECT_VERSION, type HistoryDepth, INTENT_ARCHETYPES, type IntentArchetypeName, type OutputMode, type ShapeSignature, type ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey };

package/dist/dialect.js

@@ -0,0 +1,127 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/dialect.ts
+var dialect_exports = {};
+__export(dialect_exports, {
+  ALL_ARCHETYPES: () => ALL_ARCHETYPES,
+  DIALECT_VERSION: () => DIALECT_VERSION,
+  INTENT_ARCHETYPES: () => INTENT_ARCHETYPES,
+  bucketContext: () => bucketContext,
+  bucketHistory: () => bucketHistory,
+  bucketToolCount: () => bucketToolCount,
+  hashShape: () => hashShape,
+  isArchetype: () => isArchetype,
+  learningKey: () => learningKey
+});
+module.exports = __toCommonJS(dialect_exports);
+var DIALECT_VERSION = "v1";
+var INTENT_ARCHETYPES = {
+  ask: {
+    name: "ask",
+    description: "Filter, search, or interrogate existing data",
+    examples: ["filter creators by criteria", "find docs matching query", "lookup a record"]
+  },
+  hunt: {
+    name: "hunt",
+    description: "Discover new entities not in the current dataset",
+    examples: ["find new prospects", "crawl for unindexed sources", "expand a seed list"]
+  },
+  classify: {
+    name: "classify",
+    description: "Assign a category from a finite set",
+    examples: ["intent detection", "sentiment", "route-to-team"]
+  },
+  summarize: {
+    name: "summarize",
+    description: "Compress text or data while preserving meaning",
+    examples: ["dashboard insight", "meeting notes", "briefing"]
+  },
+  generate: {
+    name: "generate",
+    description: "Produce new content from a prompt or template",
+    examples: ["draft email", "create marketing copy", "co-founder conversation"]
+  },
+  extract: {
+    name: "extract",
+    description: "Pull structured data from unstructured input",
+    examples: ["parse invoice", "extract entities", "transcript \u2192 action items"]
+  },
+  plan: {
+    name: "plan",
+    description: "Multi-step decomposition of a goal",
+    examples: ["build a roadmap", "sequence tasks", "break a feature into steps"]
+  },
+  critique: {
+    name: "critique",
+    description: "Quality assessment, review, or scoring",
+    examples: ["code review", "design feedback", "oracle judgment"]
+  },
+  transform: {
+    name: "transform",
+    description: "Change format or style while preserving content",
+    examples: ["markdown \u2192 html", "formal \u2192 casual", "translate"]
+  }
+};
+var ALL_ARCHETYPES = Object.keys(INTENT_ARCHETYPES);
+function isArchetype(name) {
+  return name in INTENT_ARCHETYPES;
+}
+function bucketContext(tokens) {
+  if (tokens < 1e3) return "tiny";
+  if (tokens < 4e3) return "small";
+  if (tokens < 16e3) return "medium";
+  if (tokens < 64e3) return "large";
+  return "huge";
+}
+function bucketToolCount(count) {
+  if (count === 0) return "none";
+  if (count <= 5) return "few";
+  if (count <= 20) return "many";
+  return "massive";
+}
+function bucketHistory(turnCount) {
+  if (turnCount <= 1) return "single_turn";
+  if (turnCount <= 6) return "short";
+  return "long";
+}
+function hashShape(s) {
+  return [
+    s.contextBucket,
+    s.toolCountBucket,
+    s.historyDepth,
+    s.outputMode,
+    s.hasExamples ? "ex" : "no_ex"
+  ].join("-");
+}
+function learningKey(archetype, model, shape) {
+  return `${DIALECT_VERSION}::${archetype}::${model}::${hashShape(shape)}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ALL_ARCHETYPES,
+  DIALECT_VERSION,
+  INTENT_ARCHETYPES,
+  bucketContext,
+  bucketHistory,
+  bucketToolCount,
+  hashShape,
+  isArchetype,
+  learningKey
+});

package/dist/dialect.mjs

@@ -0,0 +1,22 @@
+import {
+  ALL_ARCHETYPES,
+  DIALECT_VERSION,
+  INTENT_ARCHETYPES,
+  bucketContext,
+  bucketHistory,
+  bucketToolCount,
+  hashShape,
+  isArchetype,
+  learningKey
+} from "./chunk-5TI6PNSK.mjs";
+export {
+  ALL_ARCHETYPES,
+  DIALECT_VERSION,
+  INTENT_ARCHETYPES,
+  bucketContext,
+  bucketHistory,
+  bucketToolCount,
+  hashShape,
+  isArchetype,
+  learningKey
+};