@husk-ai/sessions 0.1.1

package/dist/chat.d.ts

@@ -0,0 +1,11 @@
+import type { ChatRequest, ChatResponse } from '@husk-ai/core';
+/**
+ * The only thing this package needs from a model.
+ *
+ * `ModelRouter` from @husk-ai/models satisfies it, and so does a three-line stub in
+ * a test, which is the point: nothing here opens a socket on its own.
+ */
+export interface ChatLike {
+    chat(req: ChatRequest): Promise<ChatResponse>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/C"}

package/dist/chat.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/distill.d.ts

@@ -0,0 +1,130 @@
+import type { DistilledAgent, HuskSpec, HuskSpecInput, Transcript, TranscriptMessage } from '@husk-ai/core';
+import type { ChatLike } from './chat.js';
+interface DirectivePattern {
+    re: RegExp;
+    weight: number;
+    kind: 'identity' | 'rule' | 'preference' | 'style';
+}
+export declare const DIRECTIVES: DirectivePattern[];
+/**
+ * Real user turns: what a person typed, with the plumbing removed.
+ *
+ * When the importer recorded `promptSource` -- Claude Code does -- that field is
+ * authoritative and the text heuristics are skipped. It is the difference
+ * between a prompt the user wrote and a skill document the harness pasted in
+ * wearing the user's role.
+ */
+export declare function humanTurns(messages: TranscriptMessage[]): TranscriptMessage[];
+export interface MinedRule {
+    text: string;
+    kind: DirectivePattern['kind'];
+    occurrences: number;
+    score: number;
+}
+/**
+ * Standing instructions, ranked.
+ *
+ * Recurrence is the signal that matters: a sentence the user typed once might be
+ * about today's task, and one they typed four times is how they want to be
+ * worked with.
+ */
+export declare function mineRules(messages: TranscriptMessage[], limit?: number): MinedRule[];
+/**
+ * The quality floor for a knowledge item.
+ *
+ * Everything here is a way of asking one question: would this still be true,
+ * and still be useful, in a conversation that happens next week? A tool-use id
+ * would not. A temp path would not. "Agent X finished" would not.
+ */
+export declare function isUsableKnowledge(title: string, content: string): boolean;
+export declare function mineKnowledge(messages: TranscriptMessage[], limit?: number): Array<{
+    title: string;
+    content: string;
+}>;
+/**
+ * Exchanges worth imitating.
+ *
+ * A turn the user immediately corrected is a counter-example, so it is excluded
+ * rather than held up as how the bot should behave.
+ */
+export declare function mineExamples(messages: TranscriptMessage[], limit?: number): Array<{
+    user: string;
+    assistant: string;
+}>;
+export interface ObservedTools {
+    raw: string[];
+    bundles: string[];
+    suggested: string[];
+    needsComputer: boolean;
+}
+export declare function observedTools(transcript: Transcript): ObservedTools;
+export interface HeuristicOptions {
+    maxRules?: number;
+    maxKnowledge?: number;
+    maxExamples?: number;
+    /** Scrub secrets, home paths and emails from the result. Default true. */
+    redact?: boolean;
+}
+/**
+ * No model, no network, no key. Mines the transcript for standing instructions,
+ * durable facts, uncorrected exchanges and observed tools.
+ */
+export declare function distillHeuristic(transcript: Transcript, opts?: HeuristicOptions): DistilledAgent;
+/** Map an observed provider model id onto a Husk alias. Unknown ids stay unset. */
+export declare function modelAlias(model: string): string | undefined;
+export interface ModelDistillOptions extends HeuristicOptions {
+    model?: string;
+    /** Rough token budget per map window. */
+    windowTokens?: number;
+    /** Messages of context repeated at each window boundary. */
+    overlap?: number;
+    concurrency?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Split the whole transcript into windows.
+ *
+ * Every message lands in exactly one window plus an overlap. Nothing is dropped:
+ * truncating a 500-message transcript to its first 50 throws away the part where
+ * the user finally explained what they wanted.
+ */
+export declare function windowMessages(messages: TranscriptMessage[], windowTokens: number, overlap: number): TranscriptMessage[][];
+/**
+ * Map over every window to extract candidates, then one reduce pass to merge.
+ * Any failure degrades to `distillHeuristic` rather than throwing.
+ */
+export declare function distillWithModel(transcript: Transcript, router: ChatLike, opts?: ModelDistillOptions): Promise<DistilledAgent>;
+/** Model path when a router is given, free path otherwise. */
+export declare function distill(transcript: Transcript, opts?: ModelDistillOptions & {
+    router?: ChatLike;
+}): Promise<DistilledAgent>;
+export interface ToSpecOverrides extends Partial<HuskSpecInput> {
+    /** Provenance. Filled from the transcript when omitted. */
+    transcript?: Transcript;
+}
+/**
+ * `suggestedTools` is advisory; `spec.tools` is executable.
+ *
+ * The transcript contributes whatever the host tool happened to call things --
+ * `Bash`, `WebFetch`, `mcp__foo__bar` -- and the model path lets the model add
+ * more. Writing those through verbatim produces a husk.yaml that validates and
+ * then resolves to nothing at run time, which is the worst of both. Names are
+ * mapped onto bundles, unrecognised ones are dropped, and a husk always ends up
+ * with at least one tool.
+ */
+export declare function normaliseTools(suggested: string[], needsComputer: boolean): string[];
+/**
+ * Turn a distilled agent into a spec that `parseSpec` accepts, every time.
+ * Names are slugged, strings are clamped to the schema's limits, and `origin`
+ * records where the husk came from.
+ *
+ * This is the **only** `DistilledAgent -> HuskSpec` mapper. The CLI's
+ * `specFromDistilled` and the server's `/v1/sessions/distill` both call it, so a
+ * husk distilled at the terminal and the same husk distilled over HTTP are the
+ * same file. They were not: the two call sites wrote `metadata.distilledConfidence`
+ * and `metadata.distillConfidence` respectively, and disagreed about what
+ * `origin.source` meant.
+ */
+export declare function toSpec(agent: DistilledAgent, overrides?: ToSpecOverrides): HuskSpec;
+export {};
+//# sourceMappingURL=distill.d.ts.map

package/dist/distill.d.ts.map

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