@qduc/term2 0.11.0 → 0.12.0

package/dist/services/subagents/codename-run-id.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LLM-friendly run identifiers.
+ *
+ * A UUID v4 works as a uniqueness key but is a poor primary handle for a model
+ * to cite in tool calls: 32 hex characters tokenize into rare sub-word fragments
+ * with no phonology or structure to self-correct against, so a dropped nibble
+ * silently mistargets a run. A short `adjective-noun-number` codename instead
+ * tokenizes into high-frequency words the model already knows, is visually
+ * distinguishable from siblings in a transcript, and reconstructs far more
+ * robustly than flat hex.
+ *
+ * The format intentionally matches {@link SUBAGENT_RUN_NAME_PATTERN} so a
+ * system-generated runId is also a valid user-chosen name — the two namespaces
+ * stay interchangeable under {@link resolveActiveTarget}'s runId-then-name
+ * resolution order.
+ */
+export declare const CODENAME_RUN_ID_PATTERN: RegExp;
+export interface CodenameParts {
+    adjective: string;
+    noun: string;
+    number: number;
+}
+/**
+ * Parse a codename runId into its parts, or `undefined` if it is not a codename.
+ * Used only for inspection in tests; the registry treats the id as an opaque
+ * string.
+ */
+export declare function parseCodenameRunId(id: string): CodenameParts | undefined;
+/**
+ * Number of distinct codenames the current word lists can express, including
+ * the number suffix range. Exposed for documentation and assertion in tests.
+ */
+export declare function codenameRunIdSpace(): number;
+/**
+ * Generate a single LLM-friendly codename runId of the form
+ * `adjective-noun-number`, e.g. `calm-otter-42`. The number suffix doubles as
+ * collision insurance against a user-chosen name matching a generated one.
+ *
+ * Determinism is intentionally not offered here: tests that need stable ids
+ * inject their own `createRunId` into the registry.
+ */
+export declare function createCodenameRunId(): string;
+//# sourceMappingURL=codename-run-id.d.ts.map

package/dist/services/subagents/codename-run-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codename-run-id.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/codename-run-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqnBH,eAAO,MAAM,uBAAuB,QAAoD,CAAC;AAEzF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAaxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C"}

package/dist/services/subagents/codename-run-id.js

@@ -0,0 +1,683 @@
+/**
+ * LLM-friendly run identifiers.
+ *
+ * A UUID v4 works as a uniqueness key but is a poor primary handle for a model
+ * to cite in tool calls: 32 hex characters tokenize into rare sub-word fragments
+ * with no phonology or structure to self-correct against, so a dropped nibble
+ * silently mistargets a run. A short `adjective-noun-number` codename instead
+ * tokenizes into high-frequency words the model already knows, is visually
+ * distinguishable from siblings in a transcript, and reconstructs far more
+ * robustly than flat hex.
+ *
+ * The format intentionally matches {@link SUBAGENT_RUN_NAME_PATTERN} so a
+ * system-generated runId is also a valid user-chosen name — the two namespaces
+ * stay interchangeable under {@link resolveActiveTarget}'s runId-then-name
+ * resolution order.
+ */
+const ADJECTIVES = [
+    'amber',
+    'ample',
+    'airy',
+    'ardent',
+    'ashen',
+    'auric',
+    'azure',
+    'bold',
+    'brave',
+    'breezy',
+    'bright',
+    'brisk',
+    'bronze',
+    'calm',
+    'candid',
+    'cardinal',
+    'cerean',
+    'cheery',
+    'cirrose',
+    'clear',
+    'cobalt',
+    'copper',
+    'coral',
+    'crisp',
+    'curious',
+    'daring',
+    'dazzling',
+    'deep',
+    'deft',
+    'diligent',
+    'dusky',
+    'eager',
+    'ebon',
+    'elate',
+    'ember',
+    'empty',
+    'enblithe',
+    'ernest',
+    'ethic',
+    'fair',
+    'fancy',
+    'fervid',
+    'festive',
+    'flaxen',
+    'fleet',
+    'fluid',
+    'forthright',
+    'frank',
+    'fresh',
+    'gentle',
+    'glad',
+    'golden',
+    'graceful',
+    'granite',
+    'grateful',
+    'green',
+    'hardy',
+    'hasty',
+    'hazel',
+    'hearty',
+    'hewn',
+    'honest',
+    'humble',
+    'idle',
+    'indigo',
+    'ivory',
+    'jade',
+    'jolly',
+    'joyous',
+    'keen',
+    'kind',
+    'kindly',
+    'kempt',
+    'lacy',
+    'lavender',
+    'leafy',
+    'lesser',
+    'lilac',
+    'lively',
+    'lucid',
+    'lunar',
+    'lustrous',
+    'magenta',
+    'mellow',
+    'merry',
+    'mild',
+    'mint',
+    'modest',
+    'mossy',
+    'muted',
+    'narrow',
+    'native',
+    'natty',
+    'nestling',
+    'new',
+    'noble',
+    'noisy',
+    'novice',
+    'numinous',
+    'oblique',
+    'ochre',
+    'olive',
+    'opal',
+    'open',
+    'ordinal',
+    'ornate',
+    'pale',
+    'pastel',
+    'patient',
+    'peachy',
+    'pearly',
+    'pelagic',
+    'pensive',
+    'phanic',
+    'placid',
+    'plain',
+    'plume',
+    'polite',
+    'prime',
+    'primrose',
+    'punctual',
+    'pure',
+    'quiet',
+    'quill',
+    'quintic',
+    'radiant',
+    'rapid',
+    'rare',
+    'ready',
+    'regal',
+    'reluctant',
+    'resolute',
+    'restive',
+    'rightful',
+    'ripe',
+    'robust',
+    'rose',
+    'rough',
+    'ruddy',
+    'rugged',
+    'rustic',
+    'safe',
+    'sage',
+    'sallow',
+    'sandy',
+    'scarlet',
+    'searer',
+    'serene',
+    'settled',
+    'severe',
+    'shady',
+    'sharp',
+    'sheen',
+    'sievert',
+    'silken',
+    'silvern',
+    'simple',
+    'sincere',
+    'sleek',
+    'snug',
+    'sober',
+    'soft',
+    'solid',
+    'soothing',
+    'sound',
+    'sparoid',
+    'steady',
+    'steel',
+    'stern',
+    'stoic',
+    'stout',
+    'sturdy',
+    'sunny',
+    'sure',
+    'svelte',
+    'swart',
+    'swift',
+    'tame',
+    'tan',
+    'tawny',
+    'tepid',
+    'terse',
+    'thistle',
+    'tidy',
+    'timely',
+    'tip',
+    'titanic',
+    'topaz',
+    'trim',
+    'true',
+    'tundra',
+    'umber',
+    'upbeat',
+    'upright',
+    'urbane',
+    'valiant',
+    'vast',
+    'verdant',
+    'vermilion',
+    'vibrant',
+    'violet',
+    'vivid',
+    'wary',
+    'weal',
+    'wee',
+    'western',
+    'wilde',
+    'willing',
+    'windy',
+    'wise',
+    'witty',
+    'wonted',
+    'xeric',
+    'yellow',
+    'zealous',
+    'zesty',
+];
+const NOUNS = [
+    'anteater',
+    'apollo',
+    'apple',
+    'apricot',
+    'arrow',
+    'ash',
+    'aspen',
+    'aurora',
+    'avocet',
+    'axiom',
+    'badger',
+    'balsa',
+    'bamboo',
+    'barley',
+    'basil',
+    'beech',
+    'beet',
+    'bell',
+    'berry',
+    'birch',
+    'bison',
+    'bluebell',
+    'bobcat',
+    'bramble',
+    'bream',
+    'breeze',
+    'briar',
+    'brook',
+    'buffalo',
+    'bunting',
+    'buttercup',
+    'cabin',
+    'cactus',
+    'camel',
+    'campion',
+    'canyon',
+    'cardinal',
+    'carnation',
+    'cascade',
+    'cashew',
+    'cedar',
+    'cherry',
+    'chestnut',
+    'chickadee',
+    'chiffchaff',
+    'chive',
+    'cinder',
+    'cinnamon',
+    'citron',
+    'civet',
+    'clarion',
+    'cliff',
+    'clover',
+    'cobalt',
+    'comet',
+    'condor',
+    'conifer',
+    'copper',
+    'coral',
+    'cormorant',
+    'cosmos',
+    'cougar',
+    'cove',
+    'crab',
+    'cranberry',
+    'crane',
+    'cress',
+    'crocus',
+    'crow',
+    'currant',
+    'daffodil',
+    'dahlia',
+    'daisy',
+    'dandelion',
+    'darter',
+    'delta',
+    'dill',
+    'dingo',
+    'dolphin',
+    'dove',
+    'duck',
+    'eagle',
+    'echinus',
+    'edelweiss',
+    'egret',
+    'elder',
+    'elm',
+    'emu',
+    'ermine',
+    'evening',
+    'falcon',
+    'fawn',
+    'fennel',
+    'fern',
+    'feverfew',
+    'finch',
+    'fir',
+    'firefly',
+    'fjord',
+    'flax',
+    'flicker',
+    'flora',
+    'flounder',
+    'forgetmenot',
+    'forsythia',
+    'fox',
+    'freesia',
+    'gannet',
+    'gardenia',
+    'garlic',
+    'gentian',
+    'geranium',
+    'glade',
+    'gladiolus',
+    'globe',
+    'goat',
+    'goose',
+    'gorm',
+    'gourd',
+    'grape',
+    'grouse',
+    'gull',
+    'halcyon',
+    'hare',
+    'harrier',
+    'hawthorn',
+    'hazel',
+    'heather',
+    'heaven',
+    'hedge',
+    'hellebore',
+    'hemlock',
+    'henna',
+    'heron',
+    'hibiscus',
+    'hill',
+    'holly',
+    'honey',
+    'horizon',
+    'hornbeam',
+    'hyacinth',
+    'hydra',
+    'ibex',
+    'iris',
+    'ivy',
+    'jacamar',
+    'jackal',
+    'jasmine',
+    'junco',
+    'juniper',
+    'kale',
+    'kestrel',
+    'kingfisher',
+    'kite',
+    'kiwi',
+    'koala',
+    'kohl',
+    'lagoon',
+    'lamb',
+    'lavender',
+    'lark',
+    'laurel',
+    'lava',
+    'leek',
+    'legume',
+    'lemur',
+    'lentil',
+    'lettuce',
+    'lily',
+    'linden',
+    'lion',
+    'lobster',
+    'locust',
+    'loft',
+    'loon',
+    'lotus',
+    'lupine',
+    'lyrebird',
+    'mango',
+    'mantis',
+    'maple',
+    'marigold',
+    'marjoram',
+    'marsh',
+    'meadow',
+    'merlin',
+    'mica',
+    'mineral',
+    'minnow',
+    'mint',
+    'mistletoe',
+    'mocking',
+    'mollusk',
+    'monsoon',
+    'moose',
+    'moraine',
+    'morning',
+    'moth',
+    'muffin',
+    'mulberry',
+    'myrtle',
+    'narcissus',
+    'nebula',
+    'nettle',
+    'newt',
+    'nightingale',
+    'nimbus',
+    'nougat',
+    'nuthatch',
+    'oak',
+    'oat',
+    'ocean',
+    'ochre',
+    'okra',
+    'olive',
+    'onion',
+    'opal',
+    'orchard',
+    'orchid',
+    'oriole',
+    'oryx',
+    'otter',
+    'owl',
+    'oxlip',
+    'panda',
+    'panther',
+    'papaya',
+    'parsley',
+    'parrot',
+    'partridge',
+    'passage',
+    'pasture',
+    'pea',
+    'peach',
+    'peafowl',
+    'peanut',
+    'pear',
+    'peat',
+    'pelican',
+    'penguin',
+    'pennon',
+    'pepper',
+    'perch',
+    'petrel',
+    'phalarope',
+    'pheasant',
+    'pickle',
+    'pigeon',
+    'pine',
+    'pistachio',
+    'planet',
+    'plateau',
+    'plum',
+    'pollard',
+    'pomegranate',
+    'pond',
+    'poplar',
+    'poppy',
+    'porpoise',
+    'prairie',
+    'primrose',
+    'puffin',
+    'pumpkin',
+    'quail',
+    'quartz',
+    'quince',
+    'rabbit',
+    'raccoon',
+    'radish',
+    'raisin',
+    'rampion',
+    'rapeseed',
+    'raven',
+    'redstart',
+    'reed',
+    'reindeer',
+    'reverie',
+    'rhubarb',
+    'ridge',
+    'river',
+    'robin',
+    'rock',
+    'rocket',
+    'rook',
+    'rose',
+    'rosemary',
+    'rowan',
+    'runner',
+    'rye',
+    'safflower',
+    'saffron',
+    'sage',
+    'salamander',
+    'salmon',
+    'sapphire',
+    'savanna',
+    'saxifrage',
+    'scarab',
+    'scoter',
+    'seal',
+    'seagull',
+    'sequoia',
+    'shamrock',
+    'shark',
+    'sheldrake',
+    'shrew',
+    'shrub',
+    'silver',
+    'skink',
+    'skua',
+    'skylark',
+    'slosh',
+    'snail',
+    'snipe',
+    'snowdrop',
+    'sodium',
+    'sorrel',
+    'sparrow',
+    'spawn',
+    'spinach',
+    'spruce',
+    'squash',
+    'starling',
+    'stilton',
+    'stoat',
+    'stone',
+    'stork',
+    'stream',
+    'sumac',
+    'sunfish',
+    'sunflower',
+    'swallow',
+    'swan',
+    'sycamore',
+    'tamarind',
+    'tanager',
+    'tarn',
+    'tarragon',
+    'teal',
+    'thistle',
+    'thorn',
+    'thrush',
+    'thuja',
+    'tiger',
+    'toad',
+    'tomato',
+    'topaz',
+    'tor',
+    'tortoise',
+    'toucan',
+    'towhee',
+    'trefoil',
+    'trillium',
+    'trot',
+    'trout',
+    'tulip',
+    'turmeric',
+    'turtledove',
+    'twee',
+    'umbel',
+    'underwing',
+    'ungulate',
+    'urchin',
+    'urial',
+    'valley',
+    'vanilla',
+    'varmint',
+    'veldon',
+    'verbena',
+    'verge',
+    'vervain',
+    'vetch',
+    'violet',
+    'viper',
+    'volk',
+    'walnut',
+    'warbler',
+    'wasp',
+    'watercress',
+    'weasel',
+    'wheat',
+    'wheatear',
+    'whimbrel',
+    'whinchat',
+    'whitethroat',
+    'wigeon',
+    'willow',
+    'windflower',
+    'wolf',
+    'wombat',
+    'worm',
+    'wren',
+    'yarrow',
+    'yew',
+    'zinnia',
+    'zucchini',
+];
+/**
+ * Space of distinct codenames: a few hundred thousand adjective×noun pairs each
+ * multiplied by a three-digit number is tens of millions of combinations — far
+ * beyond any single session's run count even at the 50-session eviction cap.
+ */
+const NUMBER_MIN = 10;
+const NUMBER_MAX = 999;
+const NUMBER_RANGE = NUMBER_MAX - NUMBER_MIN + 1;
+export const CODENAME_RUN_ID_PATTERN = /^[a-z][a-z0-9]{1,}-[a-z][a-z0-9]{1,}-(\d{2,3})$/;
+/**
+ * Parse a codename runId into its parts, or `undefined` if it is not a codename.
+ * Used only for inspection in tests; the registry treats the id as an opaque
+ * string.
+ */
+export function parseCodenameRunId(id) {
+    const match = id.match(CODENAME_RUN_ID_PATTERN);
+    if (!match)
+        return undefined;
+    // The number suffix is the final hyphen-delimited segment; the remainder is
+    // adjective-noun (neither word list contains a hyphen).
+    const lastHyphen = id.lastIndexOf('-');
+    const prefix = id.slice(0, lastHyphen);
+    const splitHyphen = prefix.lastIndexOf('-');
+    return {
+        adjective: prefix.slice(0, splitHyphen),
+        noun: prefix.slice(splitHyphen + 1),
+        number: Number(match[1]),
+    };
+}
+/**
+ * Number of distinct codenames the current word lists can express, including
+ * the number suffix range. Exposed for documentation and assertion in tests.
+ */
+export function codenameRunIdSpace() {
+    return ADJECTIVES.length * NOUNS.length * NUMBER_RANGE;
+}
+/**
+ * Generate a single LLM-friendly codename runId of the form
+ * `adjective-noun-number`, e.g. `calm-otter-42`. The number suffix doubles as
+ * collision insurance against a user-chosen name matching a generated one.
+ *
+ * Determinism is intentionally not offered here: tests that need stable ids
+ * inject their own `createRunId` into the registry.
+ */
+export function createCodenameRunId() {
+    const adjective = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+    const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+    const number = NUMBER_MIN + Math.floor(Math.random() * NUMBER_RANGE);
+    return `${adjective}-${noun}-${number}`;
+}
+//# sourceMappingURL=codename-run-id.js.map