@looprun-ai/core 0.1.0

package/dist/guards.js

@@ -0,0 +1,407 @@
+// ── Custom (the agent-ruleset escape hatch) ──────────────────────────────────
+export function custom(opts) {
+    return { kind: opts.kind, dim: opts.dim, check: opts.check, prose: opts.prose };
+}
+// ── helpers ──────────────────────────────────────────────────────────────────
+const lc = (s) => String(s ?? '').toLowerCase();
+const ran = (observed, tool) => observed.some((o) => o.name === tool && o.ok);
+const ranThisTurn = (ctx, tool) => ctx.observed.some((o) => o.name === tool && o.ok && o.turnIndex === ctx.turnIndex);
+function resolveLabel(args, field) {
+    const v = args[field];
+    if (v == null)
+        return null;
+    if (typeof v === 'string')
+        return v.trim() || null;
+    if (typeof v === 'object' && 'label' in v) {
+        const l = v.label;
+        return l == null ? null : String(l).trim() || null;
+    }
+    return null;
+}
+// ── SPATIAL (graph / sequencing) ─────────────────────────────────────────────
+/** T may run only after EVERY dep has already run successfully this conversation. */
+export function requiresBefore(deps) {
+    return {
+        kind: 'requiresBefore',
+        dim: 'spatial',
+        check(ctx) {
+            const missing = deps.filter((d) => !ran(ctx.observed, d));
+            return missing.length ? `Do ${missing.join(' then ')} FIRST — it must run before this tool.` : null;
+        },
+        prose: () => `only after ${deps.join(' → ')} has run`,
+    };
+}
+/** T is forbidden for this turn. */
+export function forbidThisTurn(reason) {
+    return { kind: 'forbidThisTurn', dim: 'spatial', check: () => reason, prose: () => reason };
+}
+// ── INPUT (parameter rules) ──────────────────────────────────────────────────
+/** Arg `field` must be present and non-empty. */
+export function argRequired(field) {
+    return {
+        kind: 'argRequired',
+        dim: 'input',
+        check(ctx) {
+            const v = ctx.args[field];
+            const empty = v == null || (typeof v === 'string' && v.trim() === '');
+            return empty ? `Missing required argument "${field}". Provide it.` : null;
+        },
+        prose: () => `always pass "${field}"`,
+    };
+}
+/** Arg `field` must NOT be present. */
+export function argAbsent(field) {
+    return {
+        kind: 'argAbsent',
+        dim: 'input',
+        check(ctx) {
+            return field in ctx.args && ctx.args[field] != null ? `Do not pass "${field}" to this tool — remove it.` : null;
+        },
+        prose: () => `never pass "${field}" (it is not an argument of this tool)`,
+    };
+}
+/** A label-typed arg must resolve to an EXISTING media label. */
+export function labelExists(field) {
+    return {
+        kind: 'labelExists',
+        dim: 'input',
+        check(ctx) {
+            const w = ctx.world;
+            const label = resolveLabel(ctx.args, field);
+            if (label == null)
+                return `Missing media label in "${field}".`;
+            if (!w.hasMediaLabel(label)) {
+                const known = w.mediaLabels();
+                return `Label "${label}" does not exist in Recent Media. Use one the user referenced — available: ${known.join(', ') || '(none)'}. Do NOT invent a label.`;
+            }
+            return null;
+        },
+        prose: () => `"${field}" must be a real label from Recent Media (do not invent one)`,
+    };
+}
+/** A PRESENT non-empty string arg must match `pattern`; absent/empty is left to argRequired. */
+export function argFormat(field, pattern, flags, reason) {
+    const re = new RegExp(pattern, flags ?? '');
+    const msg = reason ?? `Argument "${field}" is malformed — it must match ${pattern}. Use a REAL value (never invent one).`;
+    return {
+        kind: 'argFormat',
+        dim: 'input',
+        check(ctx) {
+            const v = ctx.args[field];
+            if (typeof v !== 'string' || v === '')
+                return null;
+            return re.test(v) ? null : msg;
+        },
+        prose: () => `"${field}" must match ${pattern}`,
+    };
+}
+/** Upload-range labels: i900+ (the attachment-sequence convention of media worlds). */
+export function isUploadLabel(label) {
+    return /^i(9\d\d|\d{4,})$/i.test(label);
+}
+/** A label-typed arg must come from the expected provenance class (upload = i900+). */
+export function labelProvenance(field, expect, reason) {
+    const msg = reason ?? (expect === 'uploaded'
+        ? `"${field}" must be an UPLOADED image label (i900+) — for generated images use the matching tool instead.`
+        : `"${field}" must be a GENERATED image label — uploads (i900+) are not valid here.`);
+    return {
+        kind: 'labelProvenance',
+        dim: 'input',
+        check(ctx) {
+            const v = ctx.args[field];
+            const label = typeof v === 'string' ? v.trim()
+                : (v && typeof v === 'object' && 'label' in v) ? String(v.label ?? '').trim() : '';
+            if (!label)
+                return null;
+            const isUp = isUploadLabel(label);
+            return (expect === 'uploaded' ? isUp : !isUp) ? null : msg;
+        },
+        prose: () => msg,
+    };
+}
+// ── RUN (execution preconditions) ────────────────────────────────────────────
+/** Generic state precondition: the call is allowed only while `ok(world)` holds. `prose` states the
+ *  CONDITION (always-rendered), separate from the deny `reason` (fires only when the condition is false). */
+export function precondition(ok, reason, prose) {
+    return {
+        kind: 'precondition',
+        dim: 'run',
+        check: (ctx) => (ok(ctx.world) ? null : reason),
+        prose: () => prose ?? reason,
+    };
+}
+/** `tool` may run at most `n` times per turn (counts the model's OWN successful calls). */
+export function maxCallsPerTurn(tool, n, reason) {
+    return {
+        kind: 'maxCallsPerTurn',
+        dim: 'run',
+        check(ctx) {
+            const count = ctx.observed.filter((o) => o.name === tool && o.ok && o.turnIndex === ctx.turnIndex).length;
+            return count >= n ? reason : null;
+        },
+        prose: () => reason,
+    };
+}
+/** Side-effect budget ACROSS turns (maxCallsPerTurn minus the turnIndex filter). */
+export function maxCallsPerConversation(tool, n, reason) {
+    return {
+        kind: 'maxCallsPerConversation',
+        dim: 'run',
+        check(ctx) {
+            const count = ctx.observed.filter((o) => o.name === tool && o.ok).length;
+            return count >= n ? reason : null;
+        },
+        prose: () => reason,
+    };
+}
+/** Key-order-independent canonical fingerprint of a call's args. */
+export function canonArgs(v) {
+    if (Array.isArray(v))
+        return `[${v.map(canonArgs).join(',')}]`;
+    if (v && typeof v === 'object') {
+        const rec = v;
+        const keys = Object.keys(rec).filter((k) => rec[k] !== undefined).sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${canonArgs(rec[k])}`).join(',')}}`;
+    }
+    return JSON.stringify(v) ?? 'null';
+}
+/** Deny a call whose (tool, canonical args) already SUCCEEDED this turn. */
+export function noDuplicateCall() {
+    return {
+        kind: 'noDuplicateCall',
+        dim: 'run',
+        check(ctx) {
+            if (!ctx.tool)
+                return null;
+            const key = canonArgs(ctx.args);
+            const dupOk = ctx.observed.some((o) => o.turnIndex === ctx.turnIndex && o.ok && o.name === ctx.tool && canonArgs(o.args) === key);
+            return dupOk
+                ? `You already called ${ctx.tool} with these EXACT arguments this turn and it succeeded — do not repeat it. Use the earlier result and move on (or reply to the user).`
+                : null;
+        },
+        prose: () => 'never repeat a tool call that already succeeded with the same arguments',
+    };
+}
+/** A destructive tool's `confirmed:true` is legal ONLY when its probe (confirmed absent/false) ran and
+ *  took effect in an EARLIER turn — never confirm your own same-turn probe, never skip it. */
+export function confirmFirst(argFlag = 'confirmed') {
+    return {
+        kind: 'confirmFirst',
+        dim: 'run',
+        check(ctx) {
+            if (!ctx.tool)
+                return null;
+            if (ctx.args[argFlag] !== true)
+                return null;
+            const probe = ctx.observed.find((o) => o.name === ctx.tool && o.ok && o.args?.[argFlag] !== true && o.turnIndex < ctx.turnIndex);
+            return probe
+                ? null
+                : `Do NOT pass ${argFlag}:true — first call ${ctx.tool} WITHOUT it, relay the confirmation question to the user, and only confirm in a LATER turn after the user agrees.`;
+        },
+        prose: () => `destructive actions need ${argFlag}:false first + the USER's explicit confirmation in a later turn`,
+    };
+}
+/** At most ONE successful destructive action per turn. */
+export function destructiveThrottle(destructiveTools) {
+    const set = new Set(destructiveTools);
+    return {
+        kind: 'destructiveThrottle',
+        dim: 'run',
+        check(ctx) {
+            if (!ctx.tool || !set.has(ctx.tool))
+                return null;
+            const prior = ctx.observed.find((o) => o.turnIndex === ctx.turnIndex && o.ok && set.has(o.name));
+            return prior
+                ? `A destructive action (${prior.name}) already ran this turn — do NOT chain another destructive call. Reply to the user first.`
+                : null;
+        },
+        prose: () => 'at most one destructive action per turn',
+    };
+}
+// ── OUTPUT (postTool result invariant) ───────────────────────────────────────
+export function resultInvariant(pred, reason) {
+    return {
+        kind: 'resultInvariant',
+        dim: 'output',
+        check(ctx) {
+            if (ctx.result === undefined)
+                return null;
+            return pred(ctx.result, ctx.world) ? null : reason;
+        },
+        prose: () => reason,
+    };
+}
+// ── BEHAVIOR (reply-checks) ──────────────────────────────────────────────────
+const VERB_FIRST_CLAIM_RE = /(gerando|criando|preparando|gerei|criei|generating|creating)\s+(\w+\s+){0,2}(imagem|image)/i;
+/** If `tool` did NOT succeed this turn, the reply must not claim/imply it did (existence-keyed). */
+export function noFabricatedSuccess(tool, opts) {
+    return {
+        kind: 'noFabricatedSuccess',
+        dim: 'behavior',
+        check(ctx) {
+            if (ranThisTurn(ctx, tool))
+                return null;
+            const reply = ctx.reply ?? '';
+            const labels = reply.match(/\bi\d{3,}\b/gi) ?? [];
+            const produced = ctx.producedThisTurn ?? [];
+            const invented = labels.filter((l) => !produced.includes(l) && !ctx.world.hasMediaLabel(l));
+            if (invented.length)
+                return opts.reason;
+            const claims = opts.claimRe.test(reply) || VERB_FIRST_CLAIM_RE.test(reply);
+            if (claims && labels.length === 0)
+                return opts.reason;
+            return null;
+        },
+        prose: () => opts.reason,
+    };
+}
+/** The reply must contain at least one of `keywords` (case-insensitive). */
+export function replyMustMention(keywords, reason) {
+    return {
+        kind: 'replyMustMention',
+        dim: 'behavior',
+        check(ctx) {
+            const r = lc(ctx.reply);
+            return keywords.some((k) => r.includes(lc(k))) ? null : reason;
+        },
+        prose: () => reason,
+    };
+}
+/** At most `n` distinct CTA lemmas from `ctas` may appear. */
+export function replyMaxOccurrences(ctas, n, reason) {
+    return {
+        kind: 'replyMaxOccurrences',
+        dim: 'behavior',
+        check(ctx) {
+            const r = lc(ctx.reply);
+            const distinct = ctas.filter((c) => r.includes(lc(c))).length;
+            return distinct > n ? reason : null;
+        },
+        prose: () => reason,
+    };
+}
+/** The reply must be a single short question (exactly one '?'). */
+export function replySingleQuestion(reason) {
+    return {
+        kind: 'replySingleQuestion',
+        dim: 'behavior',
+        check(ctx) {
+            const questionMarks = ((ctx.reply ?? '').match(/\?/g) ?? []).length;
+            return questionMarks === 1 ? null : reason;
+        },
+        prose: () => reason,
+    };
+}
+/** The reply must not match a production-claim regex. */
+export function replyNoProductionClaim(claimRe, reason) {
+    return {
+        kind: 'replyNoProductionClaim',
+        dim: 'behavior',
+        check(ctx) {
+            return claimRe.test(ctx.reply ?? '') ? reason : null;
+        },
+        prose: () => reason,
+    };
+}
+/** The reply must be non-empty and name ALL `labels`. */
+export function replyConfirmsLabels(labels, reason) {
+    return {
+        kind: 'replyConfirmsLabels',
+        dim: 'behavior',
+        check(ctx) {
+            const r = ctx.reply ?? '';
+            if (r.trim() === '')
+                return reason;
+            return labels.every((l) => r.includes(l)) ? null : reason;
+        },
+        prose: () => reason,
+    };
+}
+/** The final reply must be non-empty. */
+export function emptyReply() {
+    return {
+        kind: 'emptyReply',
+        dim: 'behavior',
+        check(ctx) {
+            return (ctx.reply ?? '').trim() === ''
+                ? 'Your reply was EMPTY — produce the complete user-facing message now, in the user\'s language.'
+                : null;
+        },
+        prose: () => 'never end a turn with an empty reply',
+    };
+}
+// A reply "seeks confirmation" if it asks a question OR carries confirm-language (EN + pt/es).
+const CONFIRM_ASK_RE = /\?|\b(confirm|are you sure|do you want|would you like|shall i|proceed\??|go ahead|confirma|confirmar|tem certeza|deseja|quer(?:es)?|gostaria|posso prosseguir|autoriz)/i;
+/** A destructive PROBE returned requiresConfirmation this turn — the reply MUST relay the question. */
+export function pendingConfirmMustAsk() {
+    return {
+        kind: 'pendingConfirmMustAsk',
+        dim: 'behavior',
+        check(ctx) {
+            const pending = ctx.observed.some((o) => o.turnIndex === ctx.turnIndex && o.resultFlags?.requiresConfirmation);
+            if (!pending)
+                return null;
+            return CONFIRM_ASK_RE.test(ctx.reply ?? '')
+                ? null
+                : 'A confirmation is PENDING — relay the confirmation question to the user (your reply must ask it), and do not summarize the action as done.';
+        },
+        prose: () => 'when a tool asks for confirmation, relay that question to the user before anything else',
+    };
+}
+/** The reply claims a deletion/removal, but no destructive tool SUCCEEDED this turn (with exemptions
+ *  for the confirm-probe two-step and honest failure/negation reports). */
+export function destructiveClaimRequiresSuccess(destructiveTools, claimRe, exemptRe) {
+    const re = claimRe ?? /(exclu[íi]d?[oa]?|apagad[oa]|apaguei|removid[oa]|removi|deletad[oa]|deleted|removed)/i;
+    const set = new Set(destructiveTools);
+    return {
+        kind: 'destructiveClaimRequiresSuccess',
+        dim: 'behavior',
+        check(ctx) {
+            const destructiveOk = ctx.observed.some((o) => o.turnIndex === ctx.turnIndex && o.ok && set.has(o.name) && o.args?.confirmed === true);
+            if (destructiveOk)
+                return null;
+            const reply = ctx.reply ?? '';
+            const probedThisTurn = ctx.observed.some((o) => o.turnIndex === ctx.turnIndex && o.ok && set.has(o.name) && o.args?.confirmed !== true);
+            if (probedThisTurn && CONFIRM_ASK_RE.test(reply))
+                return null;
+            if (exemptRe && exemptRe.test(reply))
+                return null;
+            return re.test(reply)
+                ? 'Nothing destructive succeeded this turn — do not claim a deletion/removal happened. Report the actual state.'
+                : null;
+        },
+        prose: () => 'never claim something was deleted/removed unless the destructive tool actually succeeded this turn',
+    };
+}
+/** If every tool call this turn SUCCEEDED (and at least one ran), the reply may not claim inability. */
+export function noFalseFailureClaim() {
+    const claimRe = /(n[ãa]o (consigo|foi poss[íi]vel|posso)|infelizmente n[ãa]o|cannot|can'?t|unable to|falh(ou|a)|failed)[^.!?\n]{0,40}(atualiz|update|alter|salv|sav|configur|aplic|apply|cri(ar|ei)|creat|gerar|generat|aprend|learn)/i;
+    return {
+        kind: 'noFalseFailureClaim',
+        dim: 'behavior',
+        check(ctx) {
+            const thisTurn = ctx.observed.filter((o) => o.turnIndex === ctx.turnIndex);
+            if (!thisTurn.length || thisTurn.some((o) => !o.ok))
+                return null;
+            return claimRe.test(ctx.reply ?? '')
+                ? 'Every tool you called this turn SUCCEEDED — do not claim you could not do it. Report what was actually done, grounded in the tool results.'
+                : null;
+        },
+        prose: () => 'never claim an action failed or that you are unable when your tool calls succeeded — report what actually happened',
+    };
+}
+// ── Egress mutator ───────────────────────────────────────────────────────────
+/** Deterministic egress jargon scrub (word-boundary, case-insensitive) before the reply leaves. */
+export function jargonScrub(map) {
+    const entries = Object.entries(map).map(([from, to]) => ({ re: new RegExp(`\\b${from}\\b`, 'gi'), to }));
+    return {
+        kind: 'jargonScrub',
+        apply(reply) {
+            let out = reply;
+            for (const { re, to } of entries)
+                out = out.replace(re, to);
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAWA,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,IAKtB;IACC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAClF,CAAC;AAED,gFAAgF;AAChF,MAAM,EAAE,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACjE,MAAM,GAAG,GAAG,CAAC,QAAwB,EAAE,IAAY,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;AAC/G,MAAM,WAAW,GAAG,CAAC,GAAa,EAAE,IAAY,EAAW,EAAE,CAC3D,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;AAErF,SAAS,YAAY,CAAC,IAA6B,EAAE,KAAa;IAChE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IACnD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAK,CAAY,EAAE,CAAC;QACtD,MAAM,CAAC,GAAI,CAAyB,CAAC,KAAK,CAAC;QAC3C,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAEhF,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,SAAS;QACd,KAAK,CAAC,GAAG;YACP,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtG,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;KACtD,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;AAC9F,CAAC;AAED,gFAAgF;AAEhF,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,OAAO;QACZ,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,OAAO,KAAK,CAAC,CAAC,CAAC,8BAA8B,KAAK,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,gBAAgB,KAAK,GAAG;KACtC,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,OAAO;QACZ,KAAK,CAAC,GAAG;YACP,OAAO,KAAK,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,gBAAgB,KAAK,6BAA6B,CAAC,CAAC,CAAC,IAAI,CAAC;QAClH,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,KAAK,wCAAwC;KAC1E,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,OAAO;QACZ,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;YACpB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,2BAA2B,KAAK,IAAI,CAAC;YAC/D,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC9B,OAAO,UAAU,KAAK,8EAA8E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,0BAA0B,CAAC;YAC7J,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,8DAA8D;KACrF,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,OAAe,EAAE,KAAc,EAAE,MAAe;IACvF,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,aAAa,KAAK,kCAAkC,OAAO,wCAAwC,CAAC;IAC1H,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,OAAO;QACZ,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YACnD,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACjC,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,gBAAgB,OAAO,EAAE;KAChD,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,MAAgC,EAAE,MAAe;IAC9F,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,KAAK,UAAU;QAC1C,CAAC,CAAC,IAAI,KAAK,iGAAiG;QAC5G,CAAC,CAAC,IAAI,KAAK,yEAAyE,CAAC,CAAC;IACxF,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,OAAO;QACZ,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC5C,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAK,CAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAE,CAAyB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1H,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7D,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;6GAC6G;AAC7G,MAAM,UAAU,YAAY,CAAoC,EAAyB,EAAE,MAAc,EAAE,KAAc;IACvH,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACpD,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,MAAM;KAC7B,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,CAAS,EAAE,MAAc;IACrE,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,KAAK;QACV,KAAK,CAAC,GAAG;YACP,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YAC1G,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,CAAS,EAAE,MAAc;IAC7E,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,GAAG,EAAE,KAAK;QACV,KAAK,CAAC,GAAG;YACP,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;YACzE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC/D,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,CAA4B,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QACzE,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvF,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;AACrC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,KAAK;QACV,KAAK,CAAC,GAAG;YACP,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CACjG,CAAC;YACF,OAAO,KAAK;gBACV,CAAC,CAAC,sBAAsB,GAAG,CAAC,IAAI,uIAAuI;gBACvK,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,yEAAyE;KACvF,CAAC;AACJ,CAAC;AAED;8FAC8F;AAC9F,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,WAAW;IAChD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,KAAK;QACV,KAAK,CAAC,GAAG;YACP,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC3B,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAChG,CAAC;YACF,OAAO,KAAK;gBACV,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,eAAe,OAAO,sBAAsB,GAAG,CAAC,IAAI,mHAAmH,CAAC;QAC9K,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,4BAA4B,OAAO,iEAAiE;KAClH,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,mBAAmB,CAAC,gBAA0B;IAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtC,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,KAAK;QACV,KAAK,CAAC,GAAG;YACP,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACjD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACjG,OAAO,KAAK;gBACV,CAAC,CAAC,yBAAyB,KAAK,CAAC,IAAI,2FAA2F;gBAChI,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,yCAAyC;KACvD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,eAAe,CAAoC,IAA4C,EAAE,MAAc;IAC7H,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,QAAQ;QACb,KAAK,CAAC,GAAG;YACP,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1D,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,MAAM,mBAAmB,GAAG,6FAA6F,CAAC;AAE1H,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAyC;IACzF,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,IAAI,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5F,IAAI,QAAQ,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,MAAM,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3E,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,MAAM,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM;KACzB,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,MAAc;IACjE,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACjE,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,CAAS,EAAE,MAAc;IAC3E,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9D,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACpE,OAAO,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7C,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAc;IACpE,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,MAAgB,EAAE,MAAc;IAClE,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,MAAM,CAAC;YACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5D,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;gBACpC,CAAC,CAAC,+FAA+F;gBACjG,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,sCAAsC;KACpD,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,cAAc,GAClB,yKAAyK,CAAC;AAE5K,uGAAuG;AACvG,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;YAC/G,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC1B,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACzC,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,4IAA4I,CAAC;QACnJ,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,yFAAyF;KACvG,CAAC;AACJ,CAAC;AAED;2EAC2E;AAC3E,MAAM,UAAU,+BAA+B,CAAC,gBAA0B,EAAE,OAAgB,EAAE,QAAiB;IAC7G,MAAM,EAAE,GAAG,OAAO,IAAI,uFAAuF,CAAC;IAC9G,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtC,OAAO;QACL,IAAI,EAAE,iCAAiC;QACvC,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;YACvI,IAAI,aAAa;gBAAE,OAAO,IAAI,CAAC;YAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;YACxI,IAAI,cAAc,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9D,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClD,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;gBACnB,CAAC,CAAC,8GAA8G;gBAChH,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,oGAAoG;KAClH,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,uNAAuN,CAAC;IACxO,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,UAAU;QACf,KAAK,CAAC,GAAG;YACP,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3E,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YACjE,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClC,CAAC,CAAC,4IAA4I;gBAC9I,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,oHAAoH;KAClI,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,GAA2B;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACzG,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,CAAC,KAAK;YACT,IAAI,GAAG,GAAG,KAAK,CAAC;YAChB,KAAK,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,OAAO;gBAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5D,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @looprun-ai/core — public API.
+ *
+ * AgentSpec (the map) + typed deterministic guards (the safety kit) + the scoped trunk renderer +
+ * the backend-agnostic governed-turn machine (the GPS). Framework backends live in sibling
+ * packages (@looprun-ai/mastra, …).
+ */
+export * from './rules.js';
+export * from './guards.js';
+export { AgentSpecMinimal, AgentSpecBase, AgentSpecFull, resolveBindings, resolveGuards, resolveMutators, } from './spec.js';
+export type { AgentSpec, AgentSpecConfig, AgentControls, AgentModelRef, GuardBinding, MutatorBinding, StateDirective, TerminalPolicy, ToolSchemaLike, Hook, ToolTarget, Layer, } from './spec.js';
+export { renderScopedSpecTrunk, chainOrder } from './trunk.js';
+export type { TrunkTheme } from './trunk.js';
+export { validateSpec, MAX_TOOL_SURFACE } from './validate.js';
+export type { SpecWarning } from './validate.js';
+export { geminiThinkingOff, pinnedDecoding } from './model-params.js';
+export type { ToolDef, TokenUsage, TurnInput, TurnRecord, RunResult, RuntimeTurnInput, RuntimeTurnRecord } from './runtime/types.js';
+export { createLedger, beginTurn, resultOk, recordVeto, recordToolResult, recordTerminal } from './runtime/ledger.js';
+export type { TurnLedger } from './runtime/ledger.js';
+export { TERMINAL_TOOLS, isTerminal, terminalProtocol, TERMINAL_PROTOCOL, TERMINAL_PROTOCOL_REPLY_ONLY, forcedTerminalPrompt, terminalToolDefs, } from './runtime/terminal.js';
+export { evaluatePreTool, evaluateOnInput, applyMutators, checkReply, redriveMessage, defaultExhaustionReply, finalizeReply, } from './runtime/turn.js';
+export type { PreToolVerdict, ReplyViolation, FinalizedReply } from './runtime/turn.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,SAAS,EACT,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,IAAI,EACJ,UAAU,EACV,KAAK,GACN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGtE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrI,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtH,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @looprun-ai/core — public API.
+ *
+ * AgentSpec (the map) + typed deterministic guards (the safety kit) + the scoped trunk renderer +
+ * the backend-agnostic governed-turn machine (the GPS). Framework backends live in sibling
+ * packages (@looprun-ai/mastra, …).
+ */
+export * from './rules.js';
+export * from './guards.js';
+export { AgentSpecMinimal, AgentSpecBase, AgentSpecFull, resolveBindings, resolveGuards, resolveMutators, } from './spec.js';
+export { renderScopedSpecTrunk, chainOrder } from './trunk.js';
+export { validateSpec, MAX_TOOL_SURFACE } from './validate.js';
+export { geminiThinkingOff, pinnedDecoding } from './model-params.js';
+export { createLedger, beginTurn, resultOk, recordVeto, recordToolResult, recordTerminal } from './runtime/ledger.js';
+export { TERMINAL_TOOLS, isTerminal, terminalProtocol, TERMINAL_PROTOCOL, TERMINAL_PROTOCOL_REPLY_ONLY, forcedTerminalPrompt, terminalToolDefs, } from './runtime/terminal.js';
+export { evaluatePreTool, evaluateOnInput, applyMutators, checkReply, redriveMessage, defaultExhaustionReply, finalizeReply, } from './runtime/turn.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,WAAW,CAAC;AAenB,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEtH,OAAO,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/model-params.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @looprun-ai/core — pure model-parameter presets (zero deps, no provider SDK imports).
+ *
+ * These are plain option objects spread into a backend's generate calls. They encode measured
+ * provider footguns so hosts don't re-discover them.
+ */
+/**
+ * Gemini with thinking OFF. TRAP (measured): Google's 'off' must use the NUMERIC
+ * `thinkingBudget: 0` — `thinkingLevel` does NOT turn thinking off.
+ */
+export declare function geminiThinkingOff(): Record<string, unknown>;
+/** Pinned decoding for reproducible runs (temperature 0 + optional seed — llama.cpp honors seed). */
+export declare function pinnedDecoding(opts?: {
+    seed?: number;
+}): Record<string, unknown>;
+//# sourceMappingURL=model-params.d.ts.map

package/dist/model-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-params.d.ts","sourceRoot":"","sources":["../src/model-params.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM3D;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOpF"}

package/dist/model-params.js

@@ -0,0 +1,27 @@
+/**
+ * @looprun-ai/core — pure model-parameter presets (zero deps, no provider SDK imports).
+ *
+ * These are plain option objects spread into a backend's generate calls. They encode measured
+ * provider footguns so hosts don't re-discover them.
+ */
+/**
+ * Gemini with thinking OFF. TRAP (measured): Google's 'off' must use the NUMERIC
+ * `thinkingBudget: 0` — `thinkingLevel` does NOT turn thinking off.
+ */
+export function geminiThinkingOff() {
+    return {
+        providerOptions: {
+            google: { thinkingConfig: { thinkingBudget: 0, includeThoughts: false } },
+        },
+    };
+}
+/** Pinned decoding for reproducible runs (temperature 0 + optional seed — llama.cpp honors seed). */
+export function pinnedDecoding(opts = {}) {
+    return {
+        modelSettings: {
+            temperature: 0,
+            ...(opts.seed != null ? { seed: opts.seed } : {}),
+        },
+    };
+}
+//# sourceMappingURL=model-params.js.map

package/dist/model-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-params.js","sourceRoot":"","sources":["../src/model-params.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE;SAC1E;KACF,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,cAAc,CAAC,OAA0B,EAAE;IACzD,OAAO;QACL,aAAa,EAAE;YACb,WAAW,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD;KACF,CAAC;AACJ,CAAC"}

package/dist/rules.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @looprun-ai/core — guard TYPES (framework-free).
+ *
+ * The governance primitives the agentspec skill authors: a deterministic `check` paired with an
+ * LLM-facing `prose`, keyed only on tool args / world state / observed calls — NEVER the user
+ * text (the magnet firewall: guards must not scope behavior by user intent). The world is an
+ * opaque, host-injected seam (`AgentWorld`); domain guards narrow it (e.g. `MediaWorld`) — the
+ * package itself is domain-neutral.
+ */
+/** The five enforcement dims (taxonomy metadata; the structural key is the hook it maps to). */
+export type Dim = 'spatial' | 'input' | 'run' | 'output' | 'behavior';
+/**
+ * The read/exec world seam the runtime + guards depend on — host-injected, opaque to the package.
+ * The core methods the runtime calls are typed; domain-specific accessors (hasMediaLabel,
+ * imageQuotaRemaining, hasVisualStyle, …) flow through the index signature so a domain's
+ * guards/theme can read them without the package knowing the domain.
+ */
+export interface AgentWorld {
+    exec(name: string, args: Record<string, unknown>): Promise<unknown> | unknown;
+    advanceTurn(): void;
+    ingestAttachment(url: string): string;
+    toolCalls: Array<{
+        name: string;
+        args: unknown;
+        result?: unknown;
+        tookEffect?: boolean;
+    }>;
+    sseActions: unknown[];
+    [k: string]: any;
+}
+/** The media-label capability a media domain's world exposes (narrowed by label guards). */
+export interface MediaWorld {
+    hasMediaLabel(label: string): boolean;
+    mediaLabels(): string[];
+}
+/** One tool call observed this CONVERSATION. Magnet-safe: no user text. */
+export interface ObservedCall {
+    name: string;
+    args: Record<string, unknown>;
+    ok: boolean;
+    turnIndex: number;
+    resultFlags?: {
+        requiresConfirmation?: boolean;
+    };
+}
+/** Everything a guard predicate may read — NEVER the user's text. */
+export interface GuardCtx {
+    args: Record<string, unknown>;
+    tool?: string;
+    world: AgentWorld;
+    observed: ObservedCall[];
+    turnIndex: number;
+    reply?: string;
+    producedThisTurn?: string[];
+    attachmentsThisTurn?: string[];
+    result?: unknown;
+    notes?: string[];
+}
+/** A typed guard instance: deterministic gate + LLM-facing explanation (the prose+check pairing). */
+export interface Guard {
+    kind: string;
+    dim: Dim;
+    check(ctx: GuardCtx): string | null | Promise<string | null>;
+    prose(): string;
+}
+/** A deterministic egress TRANSFORM on the final reply (no LLM call), applied before the onReply checks. */
+export interface ReplyMutator {
+    kind: string;
+    apply(reply: string, ctx: GuardCtx): string;
+}
+/** A producer→consumer flow edge, rendered as a FLOW line in the trunk. */
+export interface SpatialEdge {
+    from: string;
+    to: string;
+}
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gGAAgG;AAChG,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,WAAW,IAAI,IAAI,CAAC;IACpB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1F,UAAU,EAAE,OAAO,EAAE,CAAC;IAEtB,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClB;AAED,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,WAAW,IAAI,MAAM,EAAE,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAClD;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qGAAqG;AACrG,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,KAAK,IAAI,MAAM,CAAC;CACjB;AAED,4GAA4G;AAC5G,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC7C;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/rules.js

@@ -0,0 +1,11 @@
+/**
+ * @looprun-ai/core — guard TYPES (framework-free).
+ *
+ * The governance primitives the agentspec skill authors: a deterministic `check` paired with an
+ * LLM-facing `prose`, keyed only on tool args / world state / observed calls — NEVER the user
+ * text (the magnet firewall: guards must not scope behavior by user intent). The world is an
+ * opaque, host-injected seam (`AgentWorld`); domain guards narrow it (e.g. `MediaWorld`) — the
+ * package itself is domain-neutral.
+ */
+export {};
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}