@tangle-network/agent-app 0.57.20 → 0.58.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,275 +1,14 @@
1
1
  import {
2
- canonicalizeValue,
3
- valuesInText
4
- } from "../chunk-3NVVBQ2U.js";
5
-
6
- // src/copy-quality/index.ts
7
- var BAN_WORDS = [
8
- "delve",
9
- "delves",
10
- "delving",
11
- "delved",
12
- "tapestry",
13
- "testament to",
14
- "realm",
15
- "embark",
16
- "embarks",
17
- "embarking",
18
- "beacon",
19
- "multifaceted",
20
- "paradigm",
21
- "paradigm shift",
22
- "synergy",
23
- "synergies",
24
- "myriad",
25
- "plethora",
26
- "meticulous",
27
- "meticulously",
28
- "intricate",
29
- "utilize",
30
- "utilizes",
31
- "utilizing",
32
- "utilized",
33
- "leverage",
34
- "leverages",
35
- "leveraging",
36
- "leveraged",
37
- "supercharge",
38
- "supercharges",
39
- "supercharged",
40
- "supercharging",
41
- "turbocharge",
42
- "turbocharged",
43
- "game-changer",
44
- "game changer",
45
- "game-changing",
46
- "ever-evolving landscape",
47
- "plays a crucial role"
48
- ];
49
- var CAP_WORDS = [
50
- "seamless",
51
- "seamlessly",
52
- "robust",
53
- "streamline",
54
- "streamlines",
55
- "streamlined",
56
- "empower",
57
- "empowers",
58
- "elevate",
59
- "elevates",
60
- "unlock",
61
- "unlocks",
62
- "unleash",
63
- "harness",
64
- "foster",
65
- "enhance",
66
- "enhances",
67
- "optimize",
68
- "optimizes",
69
- "cutting-edge",
70
- "innovative",
71
- "revolutionary",
72
- "transformative",
73
- "holistic",
74
- "comprehensive",
75
- "pivotal",
76
- "crucial",
77
- "vital",
78
- "powerful",
79
- "next-level",
80
- "world-class",
81
- "best-in-class",
82
- "landscape",
83
- "navigate",
84
- "ecosystem",
85
- "journey",
86
- "truly",
87
- "genuinely",
88
- "incredibly",
89
- "deeply",
90
- "fundamentally",
91
- "significantly",
92
- "simply",
93
- "actually",
94
- "literally",
95
- "quietly"
96
- ];
97
- var rule = (category, fix) => (pattern) => ({ pattern, category, fix });
98
- var CONTRAST_FIX = "State the real point directly with its reason; do not stage a denial first.";
99
- var PHRASE_RULES = [
100
- ...[
101
- /\bin today'?s (?:fast-paced |digital |modern )?(?:world|landscape|market|age)\b/i,
102
- /\bwhether you'?re an? [^,.]{1,40},? or an? /i,
103
- /(?:^|[.!?]\s+)imagine\b/i,
104
- /\bwhen it comes to\b/i,
105
- /\bhere'?s the thing\b|\bthe truth is\b|\blet me be clear\b|\bhere'?s what nobody tells you\b/i,
106
- /\bin this (?:guide|post|article),? we'?ll\b|\blet'?s dive in(?:to)?\b/i,
107
- /\bin conclusion\b|\bat the end of the day\b/i,
108
- /(?:^|[.!?]\s+)(?:it'?s worth noting|moreover|additionally|importantly|ultimately)\b/i
109
- ].map(rule("opener-closer", "Delete the wind-up and start with the point.")),
110
- ...[
111
- /\bsay (?:goodbye|hello) to\b/i,
112
- /\b(?:unlock|unleash) the (?:full )?power of\b/i,
113
- /\b\w+, (?:reimagined|redefined)\b/i,
114
- /\bto the next level\b/i,
115
- /\btransform the way you\b/i,
116
- /\bthe \w+ you deserve\b/i,
117
- /\bthe future of [\w ]{1,30} is here\b/i,
118
- /\bbuilt for teams (?:who|that) move fast\b/i,
119
- /\beverything you need to\b|\ball-in-one\b/i,
120
- /\beffortless(?:ly)?\b|\bin just a few clicks\b/i,
121
- /\bjoin (?:thousands|millions|hundreds) of\b/i,
122
- /\bchanges everything\b/i,
123
- /\bexperience the power of\b/i
124
- ].map(rule("marketing-phrase", "Replace with the concrete outcome, number or workflow.")),
125
- rule("puffery", "State the fact; let the reader judge it.")(/\b(?:marks|represents) a pivotal moment\b|\bredefines the category\b/i),
126
- rule("weasel-source", "Name the source or the customer, or cut the claim.")(/\bexperts agree\b|\bstudies show\b|\btrusted by (?:industry )?leaders\b/i),
127
- rule("chummy-opener", "Cut the chummy opener.")(/^(?:great question|let'?s be honest|we get it)\b/im),
128
- rule("contrast-reveal", CONTRAST_FIX)(
129
- /\bit'?s not (?:just )?[^.,;!?]{1,60}[,;.]\s*it'?s\b|\b(?:this|that) isn'?t [^.;!?]{1,60}\.\s*(?:this|that|it) is\b|\bnot just [^.;!?]{1,60},? but\b|\bnot because [^.;!?]{1,60}\.\s*because\b|\bless [a-z]+, more [a-z]+\b|\bthe question isn'?t\b|\?\s*think again\b/i
130
- ),
131
- rule("contrast-reveal", CONTRAST_FIX)(/(?:^|[.!?]\s+)Not [^.;!?]{1,40}\.\s+[A-Z][^.;!?]{1,60}\./),
132
- rule("negation-list", 'Say what does happen. One plain "No card required" beside the CTA is fine.')(
133
- /\bno [a-z-]+(?: [a-z-]+)?[,.]\s*no [a-z-]+/i
134
- ),
135
- rule("question-reveal", "Delete the question and keep the answer.")(
136
- /\bthe (?:result|catch|best part|secret|kicker|twist|answer|difference|outcome|upshot)\?\s+\S/i
137
- ),
138
- rule("colon-reveal", "Write it as a normal sentence.")(
139
- /\b(?:the best part|here'?s the (?:secret|thing|kicker|catch)|one word|the result|the truth|the secret)\s*:\s/i
140
- ),
141
- rule("hype-punctuation", "Remove the stacked punctuation.")(/[!?]{2,}/),
142
- rule("decoration", "Remove decorative unicode letters and emoji bullets.")(
143
- /[\u{1D400}-\u{1D7FF}]|^\s*(?:[-*•]\s*)?[\u{1F300}-\u{1FAFF}\u{2600}-\u{27BF}]/mu
144
- )
145
- ];
146
- var CHAT_WRAPPERS = [
147
- /^\s*(?:sure|certainly|absolutely|of course|great)[!,.]/i,
148
- /^\s*here(?:'s| is| are) (?:a|an|the|your|my) (?:draft|version|post|email|ad|headline|copy|subject|options?|revised)/i,
149
- /\bi hope (?:this|that) helps\b/i,
150
- /\blet me know if you(?:'d like| want| need)\b/i,
151
- /\b(?:want|would you like) me to\b/i,
152
- /\bfeel free to (?:adjust|tweak|edit)\b/i
153
- ];
154
- var DASH = /—|(?<=\S)[ \t]+(?:–|--?)[ \t]+(?=\S)/g;
155
- var CURLY = /[‘’“”]/;
156
- function escapeRegExp(value) {
157
- return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
158
- }
159
- function wordRegex(word) {
160
- return new RegExp(`(?<![\\w-])${escapeRegExp(word).replace(/ /g, "\\s+")}(?![\\w-])`, "gi");
161
- }
162
- var BAN_REGEXES = BAN_WORDS.map((word) => ({ word, regex: wordRegex(word) }));
163
- var CAP_REGEXES = CAP_WORDS.map((word) => ({ word, regex: wordRegex(word) }));
164
- function proseOf(text) {
165
- return text.replace(/```[\s\S]*?```/g, "\n\n").replace(/`[^`\n]*`/g, "code").replace(/https?:\/\/\S+/g, "link").replace(/[‘’]/g, "'").replace(/[“”]/g, '"');
166
- }
167
- function paragraphsOf(prose) {
168
- return prose.split(/\n\s*\n/).map((p) => p.trim()).filter(Boolean);
169
- }
170
- function wordCount(text) {
171
- return (text.match(/[A-Za-z0-9][\w'-]*/g) ?? []).length;
172
- }
173
- function repeatedTrigramRate(prose) {
174
- const words = prose.toLowerCase().match(/[a-z0-9][a-z0-9'-]*/g) ?? [];
175
- if (words.length < 12) return 0;
176
- const seen = /* @__PURE__ */ new Map();
177
- for (let i = 0; i + 2 < words.length; i += 1) {
178
- const key = `${words[i]} ${words[i + 1]} ${words[i + 2]}`;
179
- seen.set(key, (seen.get(key) ?? 0) + 1);
180
- }
181
- let repeats = 0;
182
- for (const count of seen.values()) if (count > 1) repeats += count - 1;
183
- return repeats / (words.length - 2);
184
- }
185
- function scanCopy(text, options = {}) {
186
- const surface = options.surface ?? "long";
187
- const prose = proseOf(text);
188
- const paragraphs = paragraphsOf(prose);
189
- const banned = [...BAN_REGEXES, ...(options.extraBanned ?? []).map((word) => ({ word, regex: wordRegex(word) }))];
190
- const findings = [];
191
- let contrastParagraphs = 0;
192
- let tellWords = 0;
193
- paragraphs.forEach((paragraph, index) => {
194
- for (const { word, regex } of banned) {
195
- for (const match of paragraph.matchAll(regex)) {
196
- tellWords += 1;
197
- findings.push({ tier: "ban", category: "banned-word", match: match[0], paragraph: index, fix: `Replace "${word}" with the fact it stands in for.` });
198
- }
199
- }
200
- const capMatches = CAP_REGEXES.flatMap(({ regex }) => [...paragraph.matchAll(regex)].map((match) => match[0]));
201
- tellWords += capMatches.length;
202
- if (capMatches.length >= 2) {
203
- findings.push({ tier: "cap", category: "cap-words", match: capMatches.join(", "), paragraph: index, fix: "Two cap-tier words in one paragraph: rewrite it from the facts." });
204
- }
205
- let contrast = false;
206
- for (const { pattern, category, fix } of PHRASE_RULES) {
207
- const match = paragraph.match(pattern);
208
- if (!match) continue;
209
- if (category === "contrast-reveal") {
210
- if (contrast) continue;
211
- contrast = true;
212
- }
213
- findings.push({ tier: "ban", category, match: match[0].trim(), paragraph: index, fix });
214
- }
215
- if (contrast) contrastParagraphs += 1;
216
- let run = 0;
217
- for (const sentence of paragraph.split(/(?<=[.!?])\s+/)) {
218
- const count = wordCount(sentence);
219
- run = count > 0 && count <= 3 ? run + 1 : 0;
220
- if (run === 3) {
221
- findings.push({ tier: "cap", category: "fragment-drumbeat", match: sentence, paragraph: index, fix: "Merge the fragments into one sentence that carries a fact." });
222
- break;
223
- }
224
- }
225
- });
226
- const dashes = prose.match(DASH)?.length ?? 0;
227
- if (dashes > 0) {
228
- const tier = surface === "short" ? "ban" : dashes > 2 ? "cap" : "weak";
229
- const fix = surface === "short" ? "Short copy uses no dashes between words: use a period, comma or colon." : "Long copy allows two dashes per page at most; prefer a period or comma.";
230
- findings.push({ tier, category: "dash", match: `${dashes} dash${dashes === 1 ? "" : "es"}`, paragraph: -1, fix });
231
- }
232
- if (CURLY.test(text)) {
233
- findings.push({ tier: "weak", category: "decoration", match: "curly quotes", paragraph: -1, fix: "Weak alone: use the quote style the target format uses." });
234
- }
235
- const wrapper = chatWrapperIn(text);
236
- if (wrapper !== null) {
237
- findings.push({ tier: "ban", category: "chat-wrapper", match: wrapper, paragraph: -1, fix: "Return only the deliverable, with no chat around it." });
238
- }
239
- const counts = { ban: 0, cap: 0, weak: 0 };
240
- for (const finding of findings) counts[finding.tier] += 1;
241
- const words = wordCount(prose);
242
- const wordRate = Math.min(1, tellWords * 1e3 / Math.max(1, words) / 40);
243
- const contrastRate = paragraphs.length === 0 ? 0 : contrastParagraphs / paragraphs.length;
244
- const trigramRate = Math.min(1, repeatedTrigramRate(prose) * 10);
245
- const slopScore = Math.round(100 * (0.6 * wordRate + 0.25 * contrastRate + 0.15 * trigramRate));
246
- return { pass: counts.ban === 0 && counts.cap === 0, findings, counts, slopScore, words };
247
- }
248
- function chatWrapperIn(text) {
249
- const prose = proseOf(text);
250
- for (const pattern of CHAT_WRAPPERS) {
251
- const match = prose.match(pattern);
252
- if (match) return match[0].trim();
253
- }
254
- return null;
255
- }
256
- function bannedCopyVocabulary(extra = []) {
257
- return [...new Set([...extra, ...BAN_WORDS].map((word) => word.toLowerCase()))];
258
- }
259
- var METRIC = /[$€£¥₹]\s?\d[\d,]*(?:\.\d+)?(?:\s?[kKmMbB]\b)?|\b\d[\d,]*(?:\.\d+)?\s?(?:%|x\b|×|ms\b|s\b|sec\b|secs\b|seconds?\b|mins?\b|minutes?\b|hrs?\b|hours?\b|days?\b|[kKmMbB]\+?(?=\s|$|[.,;])|[KMGT]B\b|rps\b|qps\b|tokens?\b)|\b\d{1,3}(?:,\d{3})+(?:\.\d+)?\b/g;
260
- function metricClaims(text) {
261
- const claims = [];
262
- for (const match of proseOf(text).matchAll(METRIC)) {
263
- const numeric = match[0].match(/[$€£¥₹]?\s?\d[\d,]*(?:\.\d+)?/)?.[0];
264
- const value = numeric ? canonicalizeValue(numeric) : null;
265
- if (value !== null) claims.push({ text: match[0].trim(), value });
266
- }
267
- return claims;
268
- }
269
- function unsourcedMetrics(copy, sources) {
270
- const known = new Set(sources.flatMap((source) => valuesInText(source)));
271
- return metricClaims(copy).filter((claim) => !known.has(claim.value));
272
- }
2
+ BAN_WORDS,
3
+ CAP_WORDS,
4
+ bannedCopyVocabulary,
5
+ chatWrapperIn,
6
+ metricClaims,
7
+ proseOf,
8
+ scanCopy,
9
+ unsourcedMetrics
10
+ } from "../chunk-4VBM5KRG.js";
11
+ import "../chunk-3NVVBQ2U.js";
273
12
  export {
274
13
  BAN_WORDS,
275
14
  CAP_WORDS,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/copy-quality/index.ts"],"sourcesContent":["/**\n * `@tangle-network/agent-app/copy-quality` — deterministic checks for copy an\n * agent writes for a reader: ads, posts, subject lines, emails, landing pages.\n *\n * No model call. A scan returns findings an agent can fix before a person sees\n * the draft, and the same findings feed a product's outcome checks, so the\n * in-run feedback and the scored episode never disagree.\n *\n * Tiers follow the \"AI tells\" list in coreyhaines31/marketingskills (MIT,\n * revision f719a8079c694e3267d47b6b60a62aa926055f2c,\n * skills/copywriting/references/ai-tells.md):\n * - ban: a tell on one sighting.\n * - cap: fine once; a tell when two land in one paragraph.\n * - weak: reported, never failing on its own.\n * Weighting follows blader/humanizer (MIT, revision\n * 225a6f39ac85f76ee48dbad772ea4abe4ed6c9d8): staged contrasts, negation lists\n * and staged reveals count on one sighting; a dash or a curly quote in long\n * copy is weak alone. The density score mirrors the EQ-Bench Slop Score mix:\n * 60% tell-word rate, 25% contrast constructions, 15% repeated trigrams.\n *\n * Code blocks, inline code and URLs are removed before scanning: an SDK\n * snippet in a post is the product, not prose.\n */\n\nimport { canonicalizeValue, valuesInText } from '../work-product/claim-support'\n\nexport type CopySurface = 'short' | 'long'\n\nexport type CopyTellTier = 'ban' | 'cap' | 'weak'\n\nexport type CopyTellCategory =\n | 'banned-word'\n | 'cap-words'\n | 'contrast-reveal'\n | 'negation-list'\n | 'question-reveal'\n | 'colon-reveal'\n | 'opener-closer'\n | 'marketing-phrase'\n | 'puffery'\n | 'weasel-source'\n | 'chummy-opener'\n | 'hype-punctuation'\n | 'decoration'\n | 'fragment-drumbeat'\n | 'dash'\n | 'chat-wrapper'\n\nexport interface CopyTellFinding {\n tier: CopyTellTier\n category: CopyTellCategory\n /** The text that triggered the finding. */\n match: string\n /** Zero-based paragraph index, or -1 for a whole-text finding. */\n paragraph: number\n /** What to do instead, written for the agent that will fix it. */\n fix: string\n}\n\nexport interface CopyScanOptions {\n /**\n * `short` = headline, subject line, ad, social post, SMS, hero, CTA: no\n * dashes at all. `long` = article, email body, page: two dashes allowed.\n * Default `long`.\n */\n surface?: CopySurface\n /** Product-specific banned words or phrases (case-insensitive, whole word). */\n extraBanned?: readonly string[]\n}\n\nexport interface CopyScanResult {\n /** No ban-tier and no cap-tier findings. Weak findings never fail alone. */\n pass: boolean\n findings: CopyTellFinding[]\n counts: Record<CopyTellTier, number>\n /** 0 (clean) to 100 (dense with tells). Informational; `pass` is the gate. */\n slopScore: number\n words: number\n}\n\n/** Ban-tier vocabulary: ai-tells.md \"Vocabulary → Ban\", with inflections. */\nexport const BAN_WORDS: readonly string[] = [\n 'delve', 'delves', 'delving', 'delved',\n 'tapestry', 'testament to', 'realm', 'embark', 'embarks', 'embarking',\n 'beacon', 'multifaceted', 'paradigm', 'paradigm shift', 'synergy', 'synergies',\n 'myriad', 'plethora', 'meticulous', 'meticulously', 'intricate',\n 'utilize', 'utilizes', 'utilizing', 'utilized',\n 'leverage', 'leverages', 'leveraging', 'leveraged',\n 'supercharge', 'supercharges', 'supercharged', 'supercharging',\n 'turbocharge', 'turbocharged', 'game-changer', 'game changer', 'game-changing',\n 'ever-evolving landscape', 'plays a crucial role',\n]\n\n/** Cap-tier vocabulary: ai-tells.md \"Vocabulary → Cap\" plus empty intensifiers. */\nexport const CAP_WORDS: readonly string[] = [\n 'seamless', 'seamlessly', 'robust', 'streamline', 'streamlines', 'streamlined',\n 'empower', 'empowers', 'elevate', 'elevates', 'unlock', 'unlocks', 'unleash',\n 'harness', 'foster', 'enhance', 'enhances', 'optimize', 'optimizes',\n 'cutting-edge', 'innovative', 'revolutionary', 'transformative', 'holistic',\n 'comprehensive', 'pivotal', 'crucial', 'vital', 'powerful', 'next-level',\n 'world-class', 'best-in-class', 'landscape', 'navigate', 'ecosystem', 'journey',\n 'truly', 'genuinely', 'incredibly', 'deeply', 'fundamentally', 'significantly',\n 'simply', 'actually', 'literally', 'quietly',\n]\n\ninterface PhraseRule {\n readonly pattern: RegExp\n readonly category: CopyTellCategory\n readonly fix: string\n}\n\nconst rule = (category: CopyTellCategory, fix: string) => (pattern: RegExp): PhraseRule => ({ pattern, category, fix })\n\nconst CONTRAST_FIX = 'State the real point directly with its reason; do not stage a denial first.'\n\nconst PHRASE_RULES: readonly PhraseRule[] = [\n ...[\n /\\bin today'?s (?:fast-paced |digital |modern )?(?:world|landscape|market|age)\\b/i,\n /\\bwhether you'?re an? [^,.]{1,40},? or an? /i,\n /(?:^|[.!?]\\s+)imagine\\b/i,\n /\\bwhen it comes to\\b/i,\n /\\bhere'?s the thing\\b|\\bthe truth is\\b|\\blet me be clear\\b|\\bhere'?s what nobody tells you\\b/i,\n /\\bin this (?:guide|post|article),? we'?ll\\b|\\blet'?s dive in(?:to)?\\b/i,\n /\\bin conclusion\\b|\\bat the end of the day\\b/i,\n /(?:^|[.!?]\\s+)(?:it'?s worth noting|moreover|additionally|importantly|ultimately)\\b/i,\n ].map(rule('opener-closer', 'Delete the wind-up and start with the point.')),\n ...[\n /\\bsay (?:goodbye|hello) to\\b/i,\n /\\b(?:unlock|unleash) the (?:full )?power of\\b/i,\n /\\b\\w+, (?:reimagined|redefined)\\b/i,\n /\\bto the next level\\b/i,\n /\\btransform the way you\\b/i,\n /\\bthe \\w+ you deserve\\b/i,\n /\\bthe future of [\\w ]{1,30} is here\\b/i,\n /\\bbuilt for teams (?:who|that) move fast\\b/i,\n /\\beverything you need to\\b|\\ball-in-one\\b/i,\n /\\beffortless(?:ly)?\\b|\\bin just a few clicks\\b/i,\n /\\bjoin (?:thousands|millions|hundreds) of\\b/i,\n /\\bchanges everything\\b/i,\n /\\bexperience the power of\\b/i,\n ].map(rule('marketing-phrase', 'Replace with the concrete outcome, number or workflow.')),\n rule('puffery', 'State the fact; let the reader judge it.')(/\\b(?:marks|represents) a pivotal moment\\b|\\bredefines the category\\b/i),\n rule('weasel-source', 'Name the source or the customer, or cut the claim.')(/\\bexperts agree\\b|\\bstudies show\\b|\\btrusted by (?:industry )?leaders\\b/i),\n rule('chummy-opener', 'Cut the chummy opener.')(/^(?:great question|let'?s be honest|we get it)\\b/im),\n rule('contrast-reveal', CONTRAST_FIX)(\n /\\bit'?s not (?:just )?[^.,;!?]{1,60}[,;.]\\s*it'?s\\b|\\b(?:this|that) isn'?t [^.;!?]{1,60}\\.\\s*(?:this|that|it) is\\b|\\bnot just [^.;!?]{1,60},? but\\b|\\bnot because [^.;!?]{1,60}\\.\\s*because\\b|\\bless [a-z]+, more [a-z]+\\b|\\bthe question isn'?t\\b|\\?\\s*think again\\b/i,\n ),\n rule('contrast-reveal', CONTRAST_FIX)(/(?:^|[.!?]\\s+)Not [^.;!?]{1,40}\\.\\s+[A-Z][^.;!?]{1,60}\\./),\n rule('negation-list', 'Say what does happen. One plain \"No card required\" beside the CTA is fine.')(\n /\\bno [a-z-]+(?: [a-z-]+)?[,.]\\s*no [a-z-]+/i,\n ),\n rule('question-reveal', 'Delete the question and keep the answer.')(\n /\\bthe (?:result|catch|best part|secret|kicker|twist|answer|difference|outcome|upshot)\\?\\s+\\S/i,\n ),\n rule('colon-reveal', 'Write it as a normal sentence.')(\n /\\b(?:the best part|here'?s the (?:secret|thing|kicker|catch)|one word|the result|the truth|the secret)\\s*:\\s/i,\n ),\n rule('hype-punctuation', 'Remove the stacked punctuation.')(/[!?]{2,}/),\n rule('decoration', 'Remove decorative unicode letters and emoji bullets.')(\n /[\\u{1D400}-\\u{1D7FF}]|^\\s*(?:[-*•]\\s*)?[\\u{1F300}-\\u{1FAFF}\\u{2600}-\\u{27BF}]/mu,\n ),\n]\n\nconst CHAT_WRAPPERS: readonly RegExp[] = [\n /^\\s*(?:sure|certainly|absolutely|of course|great)[!,.]/i,\n /^\\s*here(?:'s| is| are) (?:a|an|the|your|my) (?:draft|version|post|email|ad|headline|copy|subject|options?|revised)/i,\n /\\bi hope (?:this|that) helps\\b/i,\n /\\blet me know if you(?:'d like| want| need)\\b/i,\n /\\b(?:want|would you like) me to\\b/i,\n /\\bfeel free to (?:adjust|tweak|edit)\\b/i,\n]\n\n// An em dash anywhere; an en dash, double hyphen or single hyphen used as a\n// dash between words. A range like 10–20 has no spaces and is not a dash.\nconst DASH = /—|(?<=\\S)[ \\t]+(?:–|--?)[ \\t]+(?=\\S)/g\nconst CURLY = /[‘’“”]/\n\nfunction escapeRegExp(value: string): string {\n return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nfunction wordRegex(word: string): RegExp {\n return new RegExp(`(?<![\\\\w-])${escapeRegExp(word).replace(/ /g, '\\\\s+')}(?![\\\\w-])`, 'gi')\n}\n\nconst BAN_REGEXES = BAN_WORDS.map((word) => ({ word, regex: wordRegex(word) }))\nconst CAP_REGEXES = CAP_WORDS.map((word) => ({ word, regex: wordRegex(word) }))\n\n/** The prose a reader reads: code, URLs and quote styles normalized away. */\nexport function proseOf(text: string): string {\n return text\n .replace(/```[\\s\\S]*?```/g, '\\n\\n')\n .replace(/`[^`\\n]*`/g, 'code')\n .replace(/https?:\\/\\/\\S+/g, 'link')\n .replace(/[‘’]/g, \"'\")\n .replace(/[“”]/g, '\"')\n}\n\nfunction paragraphsOf(prose: string): string[] {\n return prose.split(/\\n\\s*\\n/).map((p) => p.trim()).filter(Boolean)\n}\n\nfunction wordCount(text: string): number {\n return (text.match(/[A-Za-z0-9][\\w'-]*/g) ?? []).length\n}\n\nfunction repeatedTrigramRate(prose: string): number {\n const words = prose.toLowerCase().match(/[a-z0-9][a-z0-9'-]*/g) ?? []\n if (words.length < 12) return 0\n const seen = new Map<string, number>()\n for (let i = 0; i + 2 < words.length; i += 1) {\n const key = `${words[i]} ${words[i + 1]} ${words[i + 2]}`\n seen.set(key, (seen.get(key) ?? 0) + 1)\n }\n let repeats = 0\n for (const count of seen.values()) if (count > 1) repeats += count - 1\n return repeats / (words.length - 2)\n}\n\n/** Scan copy for AI tells. Deterministic and cheap; run it on every draft. */\nexport function scanCopy(text: string, options: CopyScanOptions = {}): CopyScanResult {\n const surface = options.surface ?? 'long'\n const prose = proseOf(text)\n const paragraphs = paragraphsOf(prose)\n const banned = [...BAN_REGEXES, ...(options.extraBanned ?? []).map((word) => ({ word, regex: wordRegex(word) }))]\n const findings: CopyTellFinding[] = []\n let contrastParagraphs = 0\n let tellWords = 0\n\n paragraphs.forEach((paragraph, index) => {\n for (const { word, regex } of banned) {\n for (const match of paragraph.matchAll(regex)) {\n tellWords += 1\n findings.push({ tier: 'ban', category: 'banned-word', match: match[0], paragraph: index, fix: `Replace \"${word}\" with the fact it stands in for.` })\n }\n }\n const capMatches = CAP_REGEXES.flatMap(({ regex }) => [...paragraph.matchAll(regex)].map((match) => match[0]))\n tellWords += capMatches.length\n if (capMatches.length >= 2) {\n findings.push({ tier: 'cap', category: 'cap-words', match: capMatches.join(', '), paragraph: index, fix: 'Two cap-tier words in one paragraph: rewrite it from the facts.' })\n }\n let contrast = false\n for (const { pattern, category, fix } of PHRASE_RULES) {\n const match = paragraph.match(pattern)\n if (!match) continue\n if (category === 'contrast-reveal') {\n if (contrast) continue\n contrast = true\n }\n findings.push({ tier: 'ban', category, match: match[0].trim(), paragraph: index, fix })\n }\n if (contrast) contrastParagraphs += 1\n let run = 0\n for (const sentence of paragraph.split(/(?<=[.!?])\\s+/)) {\n const count = wordCount(sentence)\n run = count > 0 && count <= 3 ? run + 1 : 0\n if (run === 3) {\n findings.push({ tier: 'cap', category: 'fragment-drumbeat', match: sentence, paragraph: index, fix: 'Merge the fragments into one sentence that carries a fact.' })\n break\n }\n }\n })\n\n const dashes = prose.match(DASH)?.length ?? 0\n if (dashes > 0) {\n const tier: CopyTellTier = surface === 'short' ? 'ban' : dashes > 2 ? 'cap' : 'weak'\n const fix = surface === 'short'\n ? 'Short copy uses no dashes between words: use a period, comma or colon.'\n : 'Long copy allows two dashes per page at most; prefer a period or comma.'\n findings.push({ tier, category: 'dash', match: `${dashes} dash${dashes === 1 ? '' : 'es'}`, paragraph: -1, fix })\n }\n if (CURLY.test(text)) {\n findings.push({ tier: 'weak', category: 'decoration', match: 'curly quotes', paragraph: -1, fix: 'Weak alone: use the quote style the target format uses.' })\n }\n const wrapper = chatWrapperIn(text)\n if (wrapper !== null) {\n findings.push({ tier: 'ban', category: 'chat-wrapper', match: wrapper, paragraph: -1, fix: 'Return only the deliverable, with no chat around it.' })\n }\n\n const counts: Record<CopyTellTier, number> = { ban: 0, cap: 0, weak: 0 }\n for (const finding of findings) counts[finding.tier] += 1\n const words = wordCount(prose)\n // Saturates at 40 tell words per 1,000, a contrast in every paragraph, and 10% repeated trigrams.\n const wordRate = Math.min(1, (tellWords * 1000) / Math.max(1, words) / 40)\n const contrastRate = paragraphs.length === 0 ? 0 : contrastParagraphs / paragraphs.length\n const trigramRate = Math.min(1, repeatedTrigramRate(prose) * 10)\n const slopScore = Math.round(100 * (0.6 * wordRate + 0.25 * contrastRate + 0.15 * trigramRate))\n return { pass: counts.ban === 0 && counts.cap === 0, findings, counts, slopScore, words }\n}\n\n/** The chat wrapper around a deliverable (\"Here's a draft…\", \"Hope this helps\"), or null. */\nexport function chatWrapperIn(text: string): string | null {\n const prose = proseOf(text)\n for (const pattern of CHAT_WRAPPERS) {\n const match = prose.match(pattern)\n if (match) return match[0].trim()\n }\n return null\n}\n\n/** Banned words and phrases, lowercased and deduplicated, for prompts that list them. */\nexport function bannedCopyVocabulary(extra: readonly string[] = []): string[] {\n return [...new Set([...extra, ...BAN_WORDS].map((word) => word.toLowerCase()))]\n}\n\nexport interface MetricClaim {\n /** The figure as written, e.g. \"$0.02/hr\", \"40%\", \"10x\", \"300ms\". */\n text: string\n /** Canonical value used to match it against sources (claim-support rules). */\n value: string\n}\n\n// A figure a reader takes as a measured fact: money, a percentage, a multiple,\n// a duration or size with its unit, a scaled count, or a grouped number.\n// Bare small integers (\"3 steps\") and years are not metrics.\nconst METRIC =\n /[$€£¥₹]\\s?\\d[\\d,]*(?:\\.\\d+)?(?:\\s?[kKmMbB]\\b)?|\\b\\d[\\d,]*(?:\\.\\d+)?\\s?(?:%|x\\b|×|ms\\b|s\\b|sec\\b|secs\\b|seconds?\\b|mins?\\b|minutes?\\b|hrs?\\b|hours?\\b|days?\\b|[kKmMbB]\\+?(?=\\s|$|[.,;])|[KMGT]B\\b|rps\\b|qps\\b|tokens?\\b)|\\b\\d{1,3}(?:,\\d{3})+(?:\\.\\d+)?\\b/g\n\n/** Every figure in `text` a reader would take as a measured fact. */\nexport function metricClaims(text: string): MetricClaim[] {\n const claims: MetricClaim[] = []\n for (const match of proseOf(text).matchAll(METRIC)) {\n const numeric = match[0].match(/[$€£¥₹]?\\s?\\d[\\d,]*(?:\\.\\d+)?/)?.[0]\n const value = numeric ? canonicalizeValue(numeric) : null\n if (value !== null) claims.push({ text: match[0].trim(), value })\n }\n return claims\n}\n\n/**\n * Metric claims in `copy` whose value appears in none of `sources`: figures\n * the writer cannot point to. Values match with claim-support's\n * canonicalization, so \"$1,200\" in copy matches \"1200.00\" in a source.\n */\nexport function unsourcedMetrics(copy: string, sources: readonly string[]): MetricClaim[] {\n const known = new Set(sources.flatMap((source) => valuesInText(source)))\n return metricClaims(copy).filter((claim) => !known.has(claim.value))\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,91 @@
1
+ /**
2
+ * The product system-prompt renderer: one layout for every product agent.
3
+ *
4
+ * identity who the agent is (product-owned, no heading)
5
+ * ## Operating contract the shared, versioned rules (./operating-contract)
6
+ * ## Environment facts about the machine and tools this turn has
7
+ * ## Tool conventions product tool rules beyond the contract
8
+ * ## Skills the task skill index (bodies stay mounted)
9
+ * ## Domain guidance fixed product standards, then learned guidance
10
+ * ## Workspace context the per-workspace overlay
11
+ *
12
+ * Products previously rendered this through agent-eval's `renderProfile` with a
13
+ * hand-copied operating discipline, learned-guidance loader, and overlay. Two
14
+ * defects came with the copies: an empty skill roster still rendered
15
+ * `_No skills configured._` ahead of the product's real skill index, and an
16
+ * empty learned-guidance section rendered a placeholder sentence. Empty
17
+ * sections are omitted here instead.
18
+ *
19
+ * Learned guidance is the one section the self-improvement loop changes. The
20
+ * loop renders a candidate by passing its body as `learnedGuidance`, so the
21
+ * prompt it scores is byte-identical to the prompt production would render if
22
+ * that candidate were promoted.
23
+ */
24
+ import { type ComposeProfileBudget } from './budget';
25
+ import { type OperatingContractClauseId, type OperatingContractOptions } from './operating-contract';
26
+ /** Section id of the evolvable learned guidance, shared by every product and its loop. */
27
+ export declare const LEARNED_GUIDANCE_SECTION_ID = "learned-guidance";
28
+ /** A titled prompt section a product supplies. */
29
+ export interface AgentPromptSection {
30
+ id: string;
31
+ title: string;
32
+ body: string;
33
+ }
34
+ /** Inputs to {@link renderAgentPrompt}. */
35
+ export interface AgentPromptInput {
36
+ /** Who the agent is and what it is for. Rendered first, without a heading. */
37
+ identity: string;
38
+ /** Product adjustments to the shared operating contract, which always renders. */
39
+ contract?: OperatingContractOptions;
40
+ /** Facts about the machine and tools this turn runs with. Pass the lane the
41
+ * turn actually executes on; a sandbox description on a lane without one
42
+ * sends the model after tools it does not have. */
43
+ environment: string;
44
+ /** Product tool rules beyond the shared contract. Omitted when empty. */
45
+ toolConventions?: string;
46
+ /** The task skill index, normally `composeSkillsForHarness(...).promptSection`.
47
+ * A `## Skills` heading is added when the index has none. Omitted when empty. */
48
+ skillIndex?: string;
49
+ /** Fixed product standards, rendered in order under `## Domain guidance`. */
50
+ standards?: readonly AgentPromptSection[];
51
+ /** Deployed or candidate learned guidance. Raw file content is fine: HTML
52
+ * comments are stripped, and a body that is empty after stripping falls back
53
+ * to {@link learnedGuidanceBaseline}. */
54
+ learnedGuidance?: string;
55
+ /** In-tree guidance used until the loop promotes a body. */
56
+ learnedGuidanceBaseline?: string;
57
+ /** Per-workspace overlay: workspace configuration, custom instructions, and
58
+ * profile knowledge. Rendered last under `## Workspace context`; sections
59
+ * with empty bodies are dropped. */
60
+ overlay?: readonly AgentPromptSection[];
61
+ /** Byte budget, enforced only when supplied. Pass the product's ceiling when
62
+ * this render is the final system prompt; when later turn sections are
63
+ * appended, gate the final string with `assertSystemPromptWithinBudget`. */
64
+ budget?: ComposeProfileBudget;
65
+ }
66
+ /** One rendered section, in prompt order. */
67
+ export interface RenderedAgentPromptSection {
68
+ /** `identity`, `operating-contract`, `environment`, `tool-conventions`,
69
+ * `skills`, a standard's id, {@link LEARNED_GUIDANCE_SECTION_ID}, or an
70
+ * overlay section's id. */
71
+ id: string;
72
+ title: string;
73
+ /** Exact text this section contributes, including its heading. */
74
+ text: string;
75
+ bytes: number;
76
+ }
77
+ export interface RenderedAgentPrompt {
78
+ /** Sections joined with a blank line. */
79
+ prompt: string;
80
+ bytes: number;
81
+ contractVersion: number;
82
+ /** Shared contract clauses this prompt carries. */
83
+ contractClauseIds: OperatingContractClauseId[];
84
+ sections: RenderedAgentPromptSection[];
85
+ }
86
+ /** Body of a loaded markdown file with HTML comments removed and whitespace
87
+ * trimmed, so an all-comment placeholder counts as empty. */
88
+ export declare function stripComments(raw: string): string;
89
+ /** Render the product system prompt. Throws on duplicate section ids, an empty
90
+ * identity or environment, or a prompt over a supplied budget. */
91
+ export declare function renderAgentPrompt(input: AgentPromptInput): RenderedAgentPrompt;
@@ -0,0 +1,23 @@
1
+ /**
2
+ * `humanizer`: a shared review-and-rewrite skill for prose, vendored from
3
+ * blader/humanizer (MIT) and pinned to one revision.
4
+ *
5
+ * It complements `human-prose`. That skill is the short rule set an agent
6
+ * loads before writing; this one is the full pass for a long draft, with the
7
+ * strong-versus-weak weighting the copy-quality scanner also uses. Products
8
+ * mount it and name it as the review step:
9
+ * `humanProseSkill({ reviewSkillId: HUMANIZER_SKILL_ID })`.
10
+ */
11
+ import { type SkillEntry } from '../skills/index';
12
+ import { HUMANIZER_LICENSE } from './humanizer-skill.vendored';
13
+ export declare const HUMANIZER_SKILL_ID = "humanizer";
14
+ export declare const HUMANIZER_SOURCE: {
15
+ readonly repository: 'https://github.com/blader/humanizer';
16
+ readonly revision: '225a6f39ac85f76ee48dbad772ea4abe4ed6c9d8';
17
+ readonly path: 'SKILL.md';
18
+ readonly license: 'MIT';
19
+ readonly sha256: '0612f1dfb1672b0ea9b97e139bf1f06cabe98d8b27424fe8ff01e1fb4cc99cad';
20
+ };
21
+ /** The vendored skill as a mountable entry, with the upstream license beside it. */
22
+ export declare function humanizerSkill(): SkillEntry;
23
+ export { HUMANIZER_LICENSE };
@@ -0,0 +1,4 @@
1
+ /** blader/humanizer SKILL.md at the pinned revision, byte for byte. */
2
+ export declare const HUMANIZER_SKILL_MD: string;
3
+ /** The upstream MIT license, shipped with the vendored file. */
4
+ export declare const HUMANIZER_LICENSE: string;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Profile composer + evolvable-section seam for agent products.
2
+ * Profile composer and system-prompt renderer for agent products.
3
3
  *
4
4
  * The standard "load a deployable AgentProfile, including skills, plus the
5
5
  * skills the end user added to their own instance" entry point. A product holds
@@ -24,14 +24,12 @@
24
24
  * delegation/app-tool MCP map, and the override strings; nothing here reaches
25
25
  * for env, a glob, or a specific product's profile.
26
26
  *
27
- * The evolvable-section seam is the loader closure. A product's single
28
- * self-improvable domain section (the one `applyDomainPatch` targets) loads its
29
- * body from a deployed markdown override, falling back to an in-tree baseline.
30
- * The `import.meta.glob('<lit>', ...)` literal must stay at the CONSUMER call
31
- * site (Vite static-analyzes it), so `makeEvolvableSection` takes the loader as
32
- * a closure and a REQUIRED `baseline` — it never constructs a glob and never
33
- * defaults the baseline, so a product can't render an empty learned-guidance
34
- * section. `stripComments` is the shared "is this addendum really empty?" test.
27
+ * The system prompt itself comes from `renderAgentPrompt` (./agent-prompt):
28
+ * identity, the shared operating contract (./operating-contract), environment,
29
+ * tool conventions, the skill index, domain guidance ending in the evolvable
30
+ * learned guidance, and the workspace overlay. The default quality skills
31
+ * (./quality-skills) join the product's skills, and `captureModelInput`
32
+ * (./model-input) stores what the model saw for the turn's receipt.
35
33
  */
36
34
  import type { AgentProfile, AgentProfileFileMount, AgentProfileMcpServer, AgentProfileResourceRef } from '@tangle-network/agent-interface';
37
35
  import { profile } from '@tangle-network/agent-eval';
@@ -41,13 +39,16 @@ import { type ComposeProfileBudget } from './budget';
41
39
  * run the same gate without pulling agent-eval through this module. Re-exported
42
40
  * here so the published `/profile` surface is unchanged. */
43
41
  export { assertProfilePromptWithinBudget, assertSystemPromptWithinBudget, DEFAULT_MAX_SYSTEM_PROMPT_BYTES, largestPromptSections, type ComposeProfileBudget, } from './budget';
44
- /** Re-expose the agent-eval section/render substrate so a product wires the
45
- * evolvable surface through ONE subpath: `makeEvolvableSection` builds the
46
- * section, `profile.renderProfile` renders it, `profile.applyDomainPatch` lets
47
- * the loop patch it by id. The rendering/patching engine stays in agent-eval;
48
- * reach it through this namespace (re-exporting the bare fns would leak
49
- * agent-eval's un-nameable AgentProfile type into our generated d.ts). */
42
+ /** Re-expose agent-eval's `profile` namespace for products that still render
43
+ * through `profile.renderProfile`; new prompts use {@link renderAgentPrompt}.
44
+ * Re-exporting the bare functions would leak agent-eval's un-nameable
45
+ * AgentProfile type into our generated d.ts. */
50
46
  export { profile };
47
+ export { LEARNED_GUIDANCE_SECTION_ID, renderAgentPrompt, stripComments, type AgentPromptInput, type AgentPromptSection, type RenderedAgentPrompt, type RenderedAgentPromptSection, } from './agent-prompt';
48
+ export { OPERATING_CONTRACT_CLAUSES, OPERATING_CONTRACT_VERSION, renderOperatingContract, type OperatingContractClause, type OperatingContractClauseId, type OperatingContractOptions, type RenderedOperatingContract, } from './operating-contract';
49
+ export { defaultQualitySkills, HUMAN_PROSE_SKILL_ID, humanProseSkill, withDefaultQualitySkills, type HumanProseSkillOptions, type QualitySkillOptions, } from './quality-skills';
50
+ export { HUMANIZER_LICENSE, HUMANIZER_SKILL_ID, HUMANIZER_SOURCE, humanizerSkill } from './humanizer-skill';
51
+ export { captureModelInput, createMemoryModelInputStore, MODEL_INPUT_RECORD_SCHEMA, modelInputBlob, readModelInput, type CaptureModelInputInput, type ModelInputBlob, type ModelInputKind, type ModelInputMediaType, type ModelInputOutcome, type ModelInputRecord, type ModelInputRef, type ModelInputSectionRef, type ModelInputStore, } from './model-input';
51
52
  /** The file-mount channels layered onto `resources.files`. The first three
52
53
  * mirror {@link ComposeShellResourcesInput}; `userSkills` is the per-user /
53
54
  * per-workspace channel — skills the END USER added to their own instance,
@@ -134,40 +135,6 @@ export declare function userSkillMounts(userSkills: UserSkill[]): AgentProfileFi
134
135
  * default {@link DEFAULT_MAX_SYSTEM_PROMPT_BYTES}, `warnOnly` escape hatch).
135
136
  */
136
137
  export declare function composeAgentProfile(base: AgentProfile, channels?: ProfileChannels, overlay?: ProfileOverlay, budget?: ComposeProfileBudget): AgentProfile;
137
- /** True body of an addendum file with HTML comments stripped — an all-comment
138
- * placeholder counts as empty, so the loader falls back to the baseline. */
139
- export declare function stripComments(raw: string): string;
140
- /** Inputs to {@link makeEvolvableSection}. */
141
- export interface EvolvableSectionInput {
142
- /** Section id the self-improvement loop targets with `applyDomainPatch`. */
143
- id: string;
144
- /** Section title rendered as `### <title>`. */
145
- title: string;
146
- /**
147
- * Load the deployed section body. The CONSUMER supplies this closure and runs
148
- * its own `import.meta.glob('<lit>', { eager: true, query: '?raw', import:
149
- * 'default' })` inside it — the literal must stay at the call site so Vite can
150
- * static-analyze it; a glob constructed here would not resolve the product's
151
- * files. Return the raw markdown (comments and all); `makeEvolvableSection`
152
- * applies {@link stripComments} to decide whether it is really populated.
153
- */
154
- load: () => string;
155
- /**
156
- * The in-tree fallback body, used when `load()` returns an
157
- * all-comments/empty placeholder. REQUIRED — no internal default — so a
158
- * product can never accidentally render an empty evolvable section.
159
- */
160
- baseline: string;
161
- }
162
- /**
163
- * Build the one evolvable (`evolvable: true`) domain section whose body comes
164
- * from the product's loader, falling back to the required baseline when the
165
- * loaded body is empty after stripping comments. Returns the agent-eval
166
- * `AgentProfileSection` shape — drop it straight into `prodProfile`'s shipped
167
- * sections. The loader is the only seam; the empty-vs-populated rule and the
168
- * baseline fallback are the lifted algebra.
169
- */
170
- export declare function makeEvolvableSection(input: EvolvableSectionInput): profile.AgentProfileSection;
171
138
  export { assertSkillDeliveryDisjoint, composeShellResources, composeSkills, corpusSkills, loadMarkdownCorpus, mergeComposedSkills, parseCorpusSkills, parseSkillFrontmatter, registrySkills, renderInlineSkills, renderSkillIndex, skillEntryFromMarkdown, skillMountPath, skillRefs, } from '../skills/index';
172
139
  export type { ComposedSkills, ComposeShellResourcesInput, CorpusEntry, CorpusLoadResult, GlobModules, LoadCorpusOptions, ParsedSkill, SkillDeliveryMode, SkillEntry, SkillFrontmatter, } from '../skills/index';
173
140
  export { diffProfileFingerprints, fingerprintAgentProfile, formatProfileDrift, } from './fingerprint';