@gencode/agents 0.0.8 → 0.0.10

package/dist/config/types.d.ts

@@ -1,87 +0,0 @@
-/**
- * Agent configuration types for AIMax multi-agent support.
- * Compatible with the .aimax/agents.json config file.
- */
-/**
- * Single agent configuration.
- * Each agent can have its own model, skills, identity, and subagent settings.
- */
-export type AgentConfig = {
-    /** Unique agent identifier */
-    id: string;
-    /** Whether this is the default agent */
-    default?: boolean;
-    /** Display name (overrides identity.name) */
-    name?: string;
-    /** Model configuration (string or object with primary/fallbacks) */
-    model?: string | AgentModelConfig;
-    /** Skills allowlist (omit = all skills; empty = none) */
-    skills?: string[];
-    /** Identity configuration for display/persona */
-    identity?: {
-        name?: string;
-        theme?: string;
-        emoji?: string;
-        avatar?: string;
-    };
-    /** Subagent configuration for this agent */
-    subagents?: {
-        /** Allow spawning subagents under other agent ids. Use "*" to allow any. */
-        allowAgents?: string[];
-        /** Per-agent default model for spawned subagents (string or {primary,fallbacks}). */
-        model?: string | AgentModelConfig;
-    };
-};
-/**
- * Model configuration with primary and optional fallbacks.
- */
-export type AgentModelConfig = {
-    primary: string;
-    fallbacks?: string[];
-};
-/**
- * Routing binding configuration.
- * Maps channel/account/peer to a specific agent.
- */
-export type AgentBinding = {
-    /** Target agent ID for this binding */
-    agentId: string;
-    /** Optional comment/description */
-    comment?: string;
-    /** Match conditions for this binding */
-    match: {
-        /** Channel type: H5 | WEB | KLPA | CRON | EIP_ASSISTANT */
-        channel: "H5" | "WEB" | "KLPA" | "CRON" | "EIP_ASSISTANT";
-        /** Account ID (optional, for multi-account routing) */
-        accountId?: string;
-        /** User ID (optional, for user-specific routing) */
-        userId?: string;
-    };
-};
-/**
- * Root agents configuration structure.
- * Stored in .aimax/agents.json
- */
-export type AgentsConfig = {
-    /** List of configured agents */
-    agents: AgentConfig[];
-    /** Routing bindings (channel -> agent mapping) */
-    bindings?: AgentBinding[];
-    /** Default configuration (optional) */
-    defaults?: {
-        model?: string | AgentModelConfig;
-        /**
-         * Maximum number of recent user turns to keep in context.
-         * 0 or undefined means no limit.
-         */
-        historyLimit?: number;
-        /** LLM-based history compaction settings */
-        compaction?: {
-            /** Whether to enable automatic LLM summarisation; defaults to true */
-            enabled?: boolean;
-            /** Fraction of context window that triggers compaction; defaults to 0.6 */
-            thresholdRatio?: number;
-        };
-    };
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAClC,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,4CAA4C;IAC5C,SAAS,CAAC,EAAE;QACV,4EAA4E;QAC5E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,qFAAqF;QACrF,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;KACnC,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE;QACL,2DAA2D;QAC3D,OAAO,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;QAC1D,uDAAuD;QACvD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,oDAAoD;QACpD,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,gCAAgC;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;QAClC;;;WAGG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,4CAA4C;QAC5C,UAAU,CAAC,EAAE;YACX,sEAAsE;YACtE,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,2EAA2E;YAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;CACH,CAAC"}

package/dist/config/types.js

@@ -1,6 +0,0 @@
-/**
- * Agent configuration types for AIMax multi-agent support.
- * Compatible with the .aimax/agents.json config file.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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

package/dist/config-DJX-VM7S.js

@@ -1,198 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-//#region src/config/agents-config.ts
-/**
-* Agent configuration management for Pingclaw.
-* Handles loading/saving agents.json from .pingclaw directory.
-*/
-const AGENTS_CONFIG_FILE = "agents.json";
-/**
-* Resolves the .pingclaw directory path within a data directory.
-*/
-function pingclawDir(dataDir) {
-	return path.join(dataDir, ".pingclaw");
-}
-/**
-* Resolves the agents configuration file path.
-*/
-function resolveAgentsConfigPath(dataDir) {
-	return path.join(pingclawDir(dataDir), AGENTS_CONFIG_FILE);
-}
-/**
-* Resolves the agent-specific directory path.
-*/
-function resolveAgentDir(dataDir, agentId) {
-	return path.join(pingclawDir(dataDir), "agents", agentId);
-}
-/**
-* Loads the agents configuration from disk.
-* Returns a default config if the file doesn't exist.
-*/
-async function loadAgentsConfig(dataDir) {
-	const configPath = resolveAgentsConfigPath(dataDir);
-	try {
-		const content = await fs.readFile(configPath, "utf-8");
-		const parsed = JSON.parse(content);
-		if (!parsed || typeof parsed !== "object") throw new Error("Invalid agents config: not an object");
-		if (!Array.isArray(parsed.agents)) parsed.agents = [];
-		if (!Array.isArray(parsed.bindings)) parsed.bindings = [];
-		return parsed;
-	} catch (err) {
-		if (err.code === "ENOENT") return { agents: [{
-			id: "main",
-			default: true
-		}] };
-		throw err;
-	}
-}
-/**
-* Saves the agents configuration to disk.
-*/
-async function saveAgentsConfig(dataDir, config) {
-	const configPath = resolveAgentsConfigPath(dataDir);
-	await fs.mkdir(path.dirname(configPath), { recursive: true });
-	await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
-}
-/**
-* Lists all valid agent configurations.
-*/
-function listAgents(config) {
-	if (!Array.isArray(config.agents)) return [];
-	return config.agents.filter((a) => a && typeof a === "object" && typeof a.id === "string");
-}
-/**
-* Gets the default agent ID.
-* Returns the first agent marked as default, or "main" if none found.
-*/
-function resolveDefaultAgentId(config) {
-	return listAgents(config).find((a) => a.default === true)?.id ?? "main";
-}
-/**
-* Normalizes an agent ID (lowercase, trimmed).
-*/
-function normalizeAgentId(id) {
-	if (!id) return "main";
-	return id.trim().toLowerCase();
-}
-/**
-* Gets an agent configuration by ID.
-*/
-function getAgentConfig(config, agentId) {
-	const normalizedId = normalizeAgentId(agentId);
-	return listAgents(config).find((a) => normalizeAgentId(a.id) === normalizedId);
-}
-/**
-* Lists all routing bindings.
-*/
-function listBindings(config) {
-	if (!Array.isArray(config.bindings)) return [];
-	return config.bindings.filter((b) => b && typeof b === "object" && typeof b.agentId === "string");
-}
-/**
-* Resolves the agent ID for a given channel/account/user combination.
-* Returns the agent ID from the first matching binding, or the default agent ID.
-*/
-function resolveAgentIdByBinding(config, channel, accountId, userId) {
-	for (const binding of listBindings(config)) {
-		const match = binding.match;
-		if (!match) continue;
-		if (match.channel !== channel) continue;
-		if (match.accountId && match.accountId !== accountId) continue;
-		if (match.userId && match.userId !== userId) continue;
-		return binding.agentId;
-	}
-	return resolveDefaultAgentId(config);
-}
-/**
-* Resolves the model string from an AgentModelConfig or plain string.
-*/
-function resolveModelString(model) {
-	if (!model) return void 0;
-	if (typeof model === "string") return model;
-	return model.primary;
-}
-/**
-* Resolves the model fallbacks from an AgentModelConfig.
-*/
-function resolveModelFallbacks(model) {
-	if (!model || typeof model === "string") return void 0;
-	return model.fallbacks;
-}
-/**
-* Adds a new agent to the configuration.
-* Returns false if an agent with the same ID already exists.
-*/
-async function addAgent(dataDir, agent) {
-	const config = await loadAgentsConfig(dataDir);
-	if (getAgentConfig(config, normalizeAgentId(agent.id))) return false;
-	config.agents = config.agents ?? [];
-	config.agents.push(agent);
-	await saveAgentsConfig(dataDir, config);
-	const agentDir = resolveAgentDir(dataDir, agent.id);
-	await fs.mkdir(agentDir, { recursive: true });
-	return true;
-}
-/**
-* Removes an agent from the configuration.
-* Returns false if the agent doesn't exist or is the default agent.
-*/
-async function removeAgent(dataDir, agentId) {
-	const config = await loadAgentsConfig(dataDir);
-	const normalizedId = normalizeAgentId(agentId);
-	const index = config.agents?.findIndex((a) => a && normalizeAgentId(a.id) === normalizedId);
-	if (index === void 0 || index < 0) return false;
-	if (config.agents?.[index]?.default === true) return false;
-	config.agents?.splice(index, 1);
-	config.bindings = config.bindings?.filter((b) => normalizeAgentId(b.agentId) !== normalizedId);
-	await saveAgentsConfig(dataDir, config);
-	return true;
-}
-/**
-* Adds a routing binding to the configuration.
-*/
-async function addBinding(dataDir, binding) {
-	const config = await loadAgentsConfig(dataDir);
-	config.bindings = config.bindings ?? [];
-	config.bindings.push(binding);
-	await saveAgentsConfig(dataDir, config);
-}
-/**
-* Removes routing bindings matching the given criteria.
-* If channel is "*", removes all bindings for the agent.
-*/
-async function removeBindings(dataDir, agentId, channel, accountId) {
-	const config = await loadAgentsConfig(dataDir);
-	const normalizedAgentId = normalizeAgentId(agentId);
-	const originalLength = config.bindings?.length ?? 0;
-	if (channel === "*") config.bindings = config.bindings?.filter((b) => normalizeAgentId(b.agentId) !== normalizedAgentId);
-	else config.bindings = config.bindings?.filter((b) => {
-		if (normalizeAgentId(b.agentId) !== normalizedAgentId) return true;
-		if (channel && b.match?.channel !== channel) return true;
-		if (accountId && b.match?.accountId !== accountId) return true;
-		return false;
-	});
-	const removed = originalLength - (config.bindings?.length ?? 0);
-	if (removed > 0) await saveAgentsConfig(dataDir, config);
-	return removed;
-}
-/**
-* Updates an agent's identity configuration.
-*/
-async function updateAgentIdentity(dataDir, agentId, identity) {
-	const config = await loadAgentsConfig(dataDir);
-	const agent = getAgentConfig(config, agentId);
-	if (!agent) return false;
-	const updatedIdentity = { ...agent.identity ?? {} };
-	if (identity.name !== void 0) updatedIdentity.name = identity.name;
-	if (identity.theme !== void 0) updatedIdentity.theme = identity.theme;
-	if (identity.emoji !== void 0) updatedIdentity.emoji = identity.emoji;
-	if (identity.avatar !== void 0) updatedIdentity.avatar = identity.avatar;
-	agent.identity = updatedIdentity;
-	await saveAgentsConfig(dataDir, config);
-	return true;
-}
-
-//#endregion
-export { saveAgentsConfig as _, listBindings as a, pingclawDir as c, resolveAgentDir as d, resolveAgentIdByBinding as f, resolveModelString as g, resolveModelFallbacks as h, listAgents as i, removeAgent as l, resolveDefaultAgentId as m, addBinding as n, loadAgentsConfig as o, resolveAgentsConfigPath as p, getAgentConfig as r, normalizeAgentId as s, addAgent as t, removeBindings as u, updateAgentIdentity as v };
-//# sourceMappingURL=config-DJX-VM7S.js.map

package/dist/config-DJX-VM7S.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-DJX-VM7S.js","names":[],"sources":["../src/config/agents-config.ts"],"sourcesContent":["/**\n * Agent configuration management for Pingclaw.\n * Handles loading/saving agents.json from .pingclaw directory.\n */\n\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { AgentsConfig, AgentConfig, AgentBinding, AgentModelConfig } from \"./types.js\";\n\nexport const AGENTS_CONFIG_FILE = \"agents.json\";\n\n/**\n * Resolves the .pingclaw directory path within a data directory.\n */\nexport function pingclawDir(dataDir: string): string {\n  return path.join(dataDir, \".pingclaw\");\n}\n\n/**\n * Resolves the agents configuration file path.\n */\nexport function resolveAgentsConfigPath(dataDir: string): string {\n  return path.join(pingclawDir(dataDir), AGENTS_CONFIG_FILE);\n}\n\n/**\n * Resolves the agent-specific directory path.\n */\nexport function resolveAgentDir(dataDir: string, agentId: string): string {\n  return path.join(pingclawDir(dataDir), \"agents\", agentId);\n}\n\n/**\n * Loads the agents configuration from disk.\n * Returns a default config if the file doesn't exist.\n */\nexport async function loadAgentsConfig(dataDir: string): Promise<AgentsConfig> {\n  const configPath = resolveAgentsConfigPath(dataDir);\n  try {\n    const content = await fs.readFile(configPath, \"utf-8\");\n    const parsed = JSON.parse(content);\n    // Validate and normalize the config\n    if (!parsed || typeof parsed !== \"object\") {\n      throw new Error(\"Invalid agents config: not an object\");\n    }\n    if (!Array.isArray(parsed.agents)) {\n      parsed.agents = [];\n    }\n    if (!Array.isArray(parsed.bindings)) {\n      parsed.bindings = [];\n    }\n    return parsed as AgentsConfig;\n  } catch (err) {\n    const code = (err as { code?: string }).code;\n    if (code === \"ENOENT\") {\n      // Return default config for new installations\n      return { agents: [{ id: \"main\", default: true }] };\n    }\n    throw err;\n  }\n}\n\n/**\n * Saves the agents configuration to disk.\n */\nexport async function saveAgentsConfig(\n  dataDir: string,\n  config: AgentsConfig,\n): Promise<void> {\n  const configPath = resolveAgentsConfigPath(dataDir);\n  await fs.mkdir(path.dirname(configPath), { recursive: true });\n  await fs.writeFile(configPath, JSON.stringify(config, null, 2), \"utf-8\");\n}\n\n/**\n * Lists all valid agent configurations.\n */\nexport function listAgents(config: AgentsConfig): AgentConfig[] {\n  if (!Array.isArray(config.agents)) {\n    return [];\n  }\n  return config.agents.filter((a): a is AgentConfig =>\n    a && typeof a === \"object\" && typeof a.id === \"string\"\n  );\n}\n\n/**\n * Gets the default agent ID.\n * Returns the first agent marked as default, or \"main\" if none found.\n */\nexport function resolveDefaultAgentId(config: AgentsConfig): string {\n  const agents = listAgents(config);\n  const defaultAgent = agents.find(a => a.default === true);\n  return defaultAgent?.id ?? \"main\";\n}\n\n/**\n * Normalizes an agent ID (lowercase, trimmed).\n */\nexport function normalizeAgentId(id: string | undefined): string {\n  if (!id) return \"main\";\n  return id.trim().toLowerCase();\n}\n\n/**\n * Gets an agent configuration by ID.\n */\nexport function getAgentConfig(\n  config: AgentsConfig,\n  agentId: string,\n): AgentConfig | undefined {\n  const normalizedId = normalizeAgentId(agentId);\n  return listAgents(config).find(a => normalizeAgentId(a.id) === normalizedId);\n}\n\n/**\n * Lists all routing bindings.\n */\nexport function listBindings(config: AgentsConfig): AgentBinding[] {\n  if (!Array.isArray(config.bindings)) {\n    return [];\n  }\n  return config.bindings.filter((b): b is AgentBinding =>\n    b && typeof b === \"object\" && typeof b.agentId === \"string\"\n  );\n}\n\n/**\n * Resolves the agent ID for a given channel/account/user combination.\n * Returns the agent ID from the first matching binding, or the default agent ID.\n */\nexport function resolveAgentIdByBinding(\n  config: AgentsConfig,\n  channel: string,\n  accountId?: string,\n  userId?: string,\n): string {\n  for (const binding of listBindings(config)) {\n    const match = binding.match;\n    if (!match) continue;\n\n    // Match channel\n    if (match.channel !== channel) continue;\n\n    // Match account if specified\n    if (match.accountId && match.accountId !== accountId) continue;\n\n    // Match user if specified\n    if (match.userId && match.userId !== userId) continue;\n\n    return binding.agentId;\n  }\n\n  // No matching binding, use default agent\n  return resolveDefaultAgentId(config);\n}\n\n/**\n * Resolves the model string from an AgentModelConfig or plain string.\n */\nexport function resolveModelString(\n  model: string | AgentModelConfig | undefined,\n): string | undefined {\n  if (!model) return undefined;\n  if (typeof model === \"string\") return model;\n  return model.primary;\n}\n\n/**\n * Resolves the model fallbacks from an AgentModelConfig.\n */\nexport function resolveModelFallbacks(\n  model: string | AgentModelConfig | undefined,\n): string[] | undefined {\n  if (!model || typeof model === \"string\") return undefined;\n  return model.fallbacks;\n}\n\n/**\n * Adds a new agent to the configuration.\n * Returns false if an agent with the same ID already exists.\n */\nexport async function addAgent(\n  dataDir: string,\n  agent: AgentConfig,\n): Promise<boolean> {\n  const config = await loadAgentsConfig(dataDir);\n  const normalizedId = normalizeAgentId(agent.id);\n\n  // Check for existing agent\n  if (getAgentConfig(config, normalizedId)) {\n    return false;\n  }\n\n  config.agents = config.agents ?? [];\n  config.agents.push(agent);\n  await saveAgentsConfig(dataDir, config);\n\n  // Create agent directory\n  const agentDir = resolveAgentDir(dataDir, agent.id);\n  await fs.mkdir(agentDir, { recursive: true });\n\n  return true;\n}\n\n/**\n * Removes an agent from the configuration.\n * Returns false if the agent doesn't exist or is the default agent.\n */\nexport async function removeAgent(\n  dataDir: string,\n  agentId: string,\n): Promise<boolean> {\n  const config = await loadAgentsConfig(dataDir);\n  const normalizedId = normalizeAgentId(agentId);\n\n  const index = config.agents?.findIndex(\n    a => a && normalizeAgentId(a.id) === normalizedId\n  );\n\n  if (index === undefined || index < 0) {\n    return false;\n  }\n\n  // Don't allow removing the default agent\n  if (config.agents?.[index]?.default === true) {\n    return false;\n  }\n\n  config.agents?.splice(index, 1);\n\n  // Remove associated bindings\n  config.bindings = config.bindings?.filter(\n    b => normalizeAgentId(b.agentId) !== normalizedId\n  );\n\n  await saveAgentsConfig(dataDir, config);\n  return true;\n}\n\n/**\n * Adds a routing binding to the configuration.\n */\nexport async function addBinding(\n  dataDir: string,\n  binding: AgentBinding,\n): Promise<void> {\n  const config = await loadAgentsConfig(dataDir);\n  config.bindings = config.bindings ?? [];\n  config.bindings.push(binding);\n  await saveAgentsConfig(dataDir, config);\n}\n\n/**\n * Removes routing bindings matching the given criteria.\n * If channel is \"*\", removes all bindings for the agent.\n */\nexport async function removeBindings(\n  dataDir: string,\n  agentId: string,\n  channel?: string,\n  accountId?: string,\n): Promise<number> {\n  const config = await loadAgentsConfig(dataDir);\n  const normalizedAgentId = normalizeAgentId(agentId);\n\n  const originalLength = config.bindings?.length ?? 0;\n\n  if (channel === \"*\") {\n    // Remove all bindings for this agent\n    config.bindings = config.bindings?.filter(\n      b => normalizeAgentId(b.agentId) !== normalizedAgentId\n    );\n  } else {\n    // Remove matching bindings\n    config.bindings = config.bindings?.filter(b => {\n      if (normalizeAgentId(b.agentId) !== normalizedAgentId) return true;\n      if (channel && b.match?.channel !== channel) return true;\n      if (accountId && b.match?.accountId !== accountId) return true;\n      return false;\n    });\n  }\n\n  const removed = originalLength - (config.bindings?.length ?? 0);\n  if (removed > 0) {\n    await saveAgentsConfig(dataDir, config);\n  }\n\n  return removed;\n}\n\n/**\n * Updates an agent's identity configuration.\n */\nexport async function updateAgentIdentity(\n  dataDir: string,\n  agentId: string,\n  identity: Partial<NonNullable<AgentConfig[\"identity\"]>>,\n): Promise<boolean> {\n  const config = await loadAgentsConfig(dataDir);\n  const agent = getAgentConfig(config, agentId);\n\n  if (!agent) {\n    return false;\n  }\n\n  // Initialize identity if not present\n  const currentIdentity = agent.identity ?? {};\n  const updatedIdentity: NonNullable<AgentConfig[\"identity\"]> = {\n    ...currentIdentity,\n  };\n\n  // Type-safe property updates\n  if (identity.name !== undefined) {\n    updatedIdentity.name = identity.name;\n  }\n  if (identity.theme !== undefined) {\n    updatedIdentity.theme = identity.theme;\n  }\n  if (identity.emoji !== undefined) {\n    updatedIdentity.emoji = identity.emoji;\n  }\n  if (identity.avatar !== undefined) {\n    updatedIdentity.avatar = identity.avatar;\n  }\n\n  agent.identity = updatedIdentity;\n\n  await saveAgentsConfig(dataDir, config);\n  return true;\n}\n"],"mappings":"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"}

package/dist/history/compaction.d.ts

@@ -1,42 +0,0 @@
-import type { MessageEntry } from "../types.js";
-import type { PluginHookAgentContext, PluginHookRegistry } from "../plugins/hooks.js";
-/** Ratio of context window that triggers compaction when history exceeds it */
-export declare const DEFAULT_COMPACTION_THRESHOLD_RATIO = 0.6;
-export type SummariseParams = {
-    entries: MessageEntry[];
-    llm: {
-        baseUrl: string;
-        apiKey: string;
-        model: string;
-    };
-    previousSummary?: string;
-    instructions?: string;
-    signal?: AbortSignal;
-    hooks?: PluginHookRegistry;
-    hookCtx?: PluginHookAgentContext;
-};
-/**
- * Call the LLM to produce a summary of the provided entries.
- * If `previousSummary` is given, the LLM is asked to incorporate it so the
- * new summary builds on prior compaction rounds.
- */
-export declare function generateSummary(params: SummariseParams): Promise<string>;
-/**
- * Return true when the total estimated token count of `entries` exceeds the
- * compaction threshold fraction of `contextWindowTokens`.
- */
-export declare function shouldCompact(params: {
-    entries: MessageEntry[];
-    contextWindowTokens: number;
-    thresholdRatio?: number;
-}): boolean;
-/**
- * Partition `entries` into two slices:
- * - `toKeep`: the most-recent entries that fit within the keep budget
- * - `toSummarise`: the older entries that will be summarised
- */
-export declare function splitForCompaction(entries: MessageEntry[], contextWindowTokens: number): {
-    toKeep: MessageEntry[];
-    toSummarise: MessageEntry[];
-};
-//# sourceMappingURL=compaction.d.ts.map

package/dist/history/compaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/history/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAsBtD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC9E;AA+CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAKV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,mBAAmB,EAAE,MAAM,GAC1B;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,WAAW,EAAE,YAAY,EAAE,CAAA;CAAE,CAgBzD"}

package/dist/history/compaction.js

@@ -1,135 +0,0 @@
-import { estimateEntryTokens, estimateEntriesTokens } from "./token-estimate.js";
-import { createLlmClient } from "../llm/client.js";
-/** Ratio of context window that triggers compaction when history exceeds it */
-export const DEFAULT_COMPACTION_THRESHOLD_RATIO = 0.6;
-/**
- * Ratio of context window reserved for the message slice kept after compaction.
- * The older portion (beyond this budget) is summarised.
- */
-const KEEP_BUDGET_RATIO = 0.35;
-const SUMMARIZATION_PROMPT = [
-    "You are a conversation history summariser. Compress the conversation below into a concise summary.",
-    "",
-    "MUST PRESERVE:",
-    "- Active tasks and their current status (including batch progress e.g. '5/17 items done')",
-    "- The last thing the user requested and what was being done about it",
-    "- Decisions made and their rationale",
-    "- TODOs, open questions, and constraints",
-    "- All opaque identifiers exactly as written: UUIDs, hashes, file paths, URLs, IPs, ports (never shorten or reconstruct them)",
-    "",
-    "Prioritise recent context over older history.",
-    "Output only the summary text — no preamble, no headings.",
-].join("\n");
-/**
- * Call the LLM to produce a summary of the provided entries.
- * If `previousSummary` is given, the LLM is asked to incorporate it so the
- * new summary builds on prior compaction rounds.
- */
-export async function generateSummary(params) {
-    const { entries, llm, previousSummary, instructions, signal, hooks, hookCtx } = params;
-    const userContent = buildSummarisationUserMessage(entries, previousSummary, instructions);
-    const MAX_ATTEMPTS = 3;
-    let lastError;
-    const client = createLlmClient({
-        baseUrl: llm.baseUrl,
-        apiKey: llm.apiKey,
-        defaultModel: llm.model,
-        hooks,
-        hookCtx,
-    });
-    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-        try {
-            const result = await client.chat({
-                system: SUMMARIZATION_PROMPT,
-                user: userContent,
-                temperature: 0,
-                maxTokens: 2048,
-                signal,
-            });
-            const text = result.text.trim();
-            if (!text) {
-                throw new Error("LLM summarisation returned empty content");
-            }
-            return text;
-        }
-        catch (err) {
-            if (err instanceof Error && err.name === "AbortError")
-                throw err;
-            lastError = err;
-            if (attempt < MAX_ATTEMPTS) {
-                // Simple backoff: 500ms, 1000ms between retries
-                await sleep(500 * attempt);
-            }
-        }
-    }
-    throw lastError;
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function buildSummarisationUserMessage(entries, previousSummary, instructions) {
-    const parts = [];
-    if (instructions?.trim()) {
-        parts.push(`[Extra instructions]\n${instructions.trim()}\n`);
-    }
-    if (previousSummary?.trim()) {
-        parts.push(`[Prior summary]\n${previousSummary.trim()}\n`);
-        parts.push("[Conversation to incorporate]");
-    }
-    else {
-        parts.push("[Conversation to summarise]");
-    }
-    for (const entry of entries) {
-        if (entry.role === "user") {
-            parts.push(`User: ${entry.content}`);
-        }
-        else if (entry.role === "assistant") {
-            const toolLine = entry.toolCalls && entry.toolCalls.length > 0
-                ? ` [called tools: ${entry.toolCalls.map((t) => t.name).join(", ")}]`
-                : "";
-            parts.push(`Assistant:${toolLine} ${entry.content}`.trimEnd());
-        }
-        else if (entry.role === "tool_result") {
-            const status = entry.isError ? "error" : "ok";
-            // Truncate very long tool outputs to avoid blowing the summarisation context
-            const truncated = entry.content.length > 2000
-                ? `${entry.content.slice(0, 2000)}… [truncated]`
-                : entry.content;
-            parts.push(`Tool(${entry.toolName})[${status}]: ${truncated}`);
-        }
-    }
-    return parts.join("\n");
-}
-/**
- * Return true when the total estimated token count of `entries` exceeds the
- * compaction threshold fraction of `contextWindowTokens`.
- */
-export function shouldCompact(params) {
-    const { entries, contextWindowTokens, thresholdRatio = DEFAULT_COMPACTION_THRESHOLD_RATIO } = params;
-    if (entries.length === 0)
-        return false;
-    const threshold = Math.floor(contextWindowTokens * thresholdRatio);
-    return estimateEntriesTokens(entries) > threshold;
-}
-/**
- * Partition `entries` into two slices:
- * - `toKeep`: the most-recent entries that fit within the keep budget
- * - `toSummarise`: the older entries that will be summarised
- */
-export function splitForCompaction(entries, contextWindowTokens) {
-    const keepBudget = Math.floor(contextWindowTokens * KEEP_BUDGET_RATIO);
-    let accumulated = 0;
-    let keepFrom = entries.length; // default: summarise everything
-    for (let i = entries.length - 1; i >= 0; i--) {
-        const t = estimateEntryTokens(entries[i]);
-        if (accumulated + t > keepBudget)
-            break;
-        accumulated += t;
-        keepFrom = i;
-    }
-    return {
-        toKeep: entries.slice(keepFrom),
-        toSummarise: entries.slice(0, keepFrom),
-    };
-}
-//# sourceMappingURL=compaction.js.map

package/dist/history/compaction.js.map

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

package/dist/history/index.d.ts

@@ -1,57 +0,0 @@
-import type { AgentMessage } from "@mariozechner/pi-agent-core";
-import type { TranscriptEntry, MessageEntry, CompactionEntry } from "../types.js";
-import type { PluginHookAgentContext, PluginHookRegistry } from "../plugins/hooks.js";
-export type ManageHistoryParams = {
-    /** Full transcript entries including any prior compaction records */
-    entries: TranscriptEntry[];
-    modelInfo: {
-        model: string;
-        api: string;
-    };
-    contextWindowTokens: number;
-    llm: {
-        baseUrl: string;
-        apiKey: string;
-        model: string;
-    };
-    /** Max user turns to keep; 0/undefined = no limit */
-    historyLimit?: number;
-    /** Set to false to skip LLM-based compaction; defaults to true */
-    compactionEnabled?: boolean;
-    /** Fraction of context window that triggers compaction; defaults to 0.6 */
-    thresholdRatio?: number;
-    signal?: AbortSignal;
-    hooks?: PluginHookRegistry;
-    hookCtx?: PluginHookAgentContext;
-};
-export type HistoryManagementResult = {
-    /** Messages ready to pass to agent.replaceMessages() */
-    messages: AgentMessage[];
-    /** Summary text to inject into the system prompt (from existing or new compaction) */
-    priorSummary: string | undefined;
-    /** New compaction record to append to the transcript (undefined if no compaction ran) */
-    compactionEntry: CompactionEntry | undefined;
-    stats: {
-        originalCount: number;
-        keptCount: number;
-        estimatedTokens: number;
-        compacted: boolean;
-    };
-};
-/**
- * Manage conversation history before each agent run:
- * 1. Extract message entries that follow the last compaction record.
- * 2. Apply the turn limit (drop oldest user turns beyond `historyLimit`).
- * 3. Repair orphaned tool_result entries created by truncation.
- * 4. If token count exceeds the threshold, generate an LLM summary and
- *    return a compaction record to persist.
- */
-export declare function manageHistory(params: ManageHistoryParams): Promise<HistoryManagementResult>;
-/**
- * Convert MessageEntry[] to AgentMessage[] for use with agent.replaceMessages().
- */
-export declare function entriesToMessages(entries: MessageEntry[], modelInfo: {
-    model: string;
-    api: string;
-}): AgentMessage[];
-//# sourceMappingURL=index.d.ts.map

package/dist/history/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAIZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAatF,MAAM,MAAM,mBAAmB,GAAG;IAChC,qEAAqE;IACrE,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,wDAAwD;IACxD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,sFAAsF;IACtF,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yFAAyF;IACzF,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAoFjG;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACxC,YAAY,EAAE,CAEhB"}