@aelinrezende/pipa-core 1.0.0

package/extensions/pipa/features/teammate/prompts.d.ts

@@ -0,0 +1,13 @@
+import { Task } from '../task/task.entity';
+/**
+ * Gera o prompt de squad para o spawned.
+ * @param squad O squad herdado pela tarefa atual (se houver).
+ * @param epics A lista de tarefas que possuem squad.
+ */
+export declare function getSquadPrompt(squad?: string, epics?: Task[]): string;
+export declare const PIPA_AGENTS_PROMPT: {
+    main: string;
+    subagent: string;
+};
+export declare const TEAMMATE_SPAWN_PROMPT: string;
+//# sourceMappingURL=prompts.d.ts.map

package/extensions/pipa/features/teammate/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/teammate/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,CA2BrE;AAED,eAAO,MAAM,kBAAkB;IAC7B,IAAI;IAQJ,QAAQ;CAMT,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAQjC,CAAC"}

package/extensions/pipa/features/teammate/teammate.definitions.d.ts

@@ -0,0 +1,42 @@
+import Type from 'typebox';
+export declare const TEAMMATE_TOOL_SCHEMA: {
+    instantiate: Type.TObject<{
+        action: Type.TLiteral<"instantiate">;
+        name: Type.TString;
+        goal: Type.TString;
+    }>;
+    list: Type.TObject<{
+        action: Type.TLiteral<"list">;
+    }>;
+    online: Type.TObject<{
+        action: Type.TLiteral<"online">;
+    }>;
+    'send-inbox': Type.TObject<{
+        action: Type.TLiteral<"send-inbox">;
+        teammateId: Type.TString;
+        message: Type.TString;
+    }>;
+    chat: Type.TObject<{
+        action: Type.TLiteral<"chat">;
+        teammateId: Type.TString;
+        message: Type.TString;
+    }>;
+    'read-inbox': Type.TObject<{
+        action: Type.TLiteral<"read-inbox">;
+    }>;
+    dismiss: Type.TObject<{
+        action: Type.TLiteral<"dismiss">;
+        teammateId: Type.TString;
+        reason: Type.TString;
+    }>;
+};
+export declare const TEAMMATE_TOOL_ACTIONS_MESSAGE: {
+    instantiate: string;
+    list: string;
+    online: string;
+    chat: string;
+    'send-inbox': string;
+    'read-inbox': string;
+    dismiss: string;
+};
+//# sourceMappingURL=teammate.definitions.d.ts.map

package/extensions/pipa/features/teammate/teammate.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate.definitions.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/teammate/teammate.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B,eAAO,MAAM,oBAAoB;IAE/B,WAAW;;;;;IAgBX,IAAI;;;IAUJ,MAAM;;;IAWN,YAAY;;;;;IAgBZ,IAAI;;;;;IAmBJ,YAAY;;;IAUZ,OAAO;;;;;CAWR,CAAC;AAEF,eAAO,MAAM,6BAA6B;IACxC,WAAW;IACX,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,YAAY;IACZ,YAAY;IACZ,OAAO;CACR,CAAC"}

package/extensions/pipa/features/teammate/teammate.entity.d.ts

@@ -0,0 +1,68 @@
+import { AgentSession } from '@earendil-works/pi-coding-agent';
+import { PiEvent } from '../../constants/pipa';
+import { PipaApi } from '../../interfaces/pipa';
+import { OmitGetters, ToolActionPayload, ToolParams } from '../../interfaces/common';
+import { TEAMMATE_TOOL_SCHEMA } from './teammate.definitions';
+export type TeammateToolParams = ToolParams<typeof TEAMMATE_TOOL_SCHEMA>;
+/** Payload de cada ação da tool teammates */
+export type TeammateToolSchema<K extends keyof typeof TEAMMATE_TOOL_SCHEMA> = ToolActionPayload<typeof TEAMMATE_TOOL_SCHEMA, K>;
+export declare class Teammate {
+    constructor(data: OmitGetters<Teammate>);
+    /** Nome do agente */
+    name: string;
+    /** Identificador da sessão do agente */
+    sessionId: string;
+    /** ID da sessão (agente) pai */
+    parentSessionId?: string;
+    /** Status atual do agente */
+    status: TeammateStatus;
+    /** Último evento do agente */
+    lastEvent?: PiEvent;
+    /** Profundidade do agente na hierarquia (0 para o agente principal) */
+    depth: number;
+    /** Papel do agente (ex: "main", "subagent") */
+    role: 'main' | 'subagent';
+    /** Objetivo principal do agente */
+    goal: string;
+    /** Definição do agente (obrigatório para subagentes) */
+    body?: string;
+    /** Descrição do agente (obrigatória para subagentes) */
+    description?: string;
+    /** Metadados opcionais do agente */
+    frontmatter?: TeammateFrontmatter;
+    /** Instancia `PipaApi` do teammate */
+    pipa?: PipaApi;
+    /** Instancia `AgentSession` do teammate */
+    session?: AgentSession;
+    /** Diretório de arquivos (logs, inbox, resultados) do agente */
+    workspaceDir: string;
+    /** Diretório da sessão */
+    sessionDir?: string;
+    /** Timestamp de quando o agente começou */
+    startedAt: number;
+    /** Timestamp de quando o agente foi ativado pela última vez */
+    lastActiveAt: number;
+    /** Nome da última ferramenta utilizada */
+    lastTool?: string;
+    /** Indica se o agente foi montado */
+    eventsMountMap?: Record<string, boolean>;
+    /** Indica se o agente está rodando */
+    get isRunning(): boolean;
+    /** Indica se o agente está sendo encerrado */
+    get isStopping(): boolean;
+}
+export type TeammateStatus = 'running' | 'idle' | 'failed' | 'stopping';
+export interface TeammateFrontmatter {
+    name: string;
+    description: string;
+    body: string;
+    spawnableTeammates?: Record<string, string>;
+}
+export type TeammatesStore = Map<string, Teammate>;
+export interface TeammateInboxMessage {
+    from: string;
+    content: string;
+    timestamp: number;
+}
+export declare const TeammateStatusEmojis: Record<TeammateStatus, string>;
+//# sourceMappingURL=teammate.entity.d.ts.map

package/extensions/pipa/features/teammate/teammate.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate.entity.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/teammate/teammate.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,OAAO,oBAAoB,IAAI,iBAAiB,CAC7F,OAAO,oBAAoB,EAC3B,CAAC,CACF,CAAC;AAEF,qBAAa,QAAQ;IACnB,YAAY,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,EAEtC;IAED,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAC;IAEvB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAE1B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAElB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE9C,sCAAsC;IACtC,IAAI,SAAS,YAEZ;IAED,8CAA8C;IAC9C,IAAI,UAAU,YAEb;CACF;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAK/D,CAAC"}

package/extensions/pipa/features/teammate/teammate.feature.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeature } from '../base-feature';
+import { TeammateExecutionContext, TeammateLifecycle, TeammateObservability, TeammateReminders, TeammateShutdownContext, TeammateTuiRegister } from './hooks';
+declare const TeammateFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature & TeammateExecutionContext & TeammateLifecycle & TeammateReminders & TeammateShutdownContext & TeammateObservability & TeammateTuiRegister, typeof PipaBaseFeature & typeof TeammateExecutionContext & typeof TeammateLifecycle & typeof TeammateReminders & typeof TeammateShutdownContext & typeof TeammateObservability & typeof TeammateTuiRegister>;
+/**
+ * Feature para gerenciamento de subagentes.
+ */
+export declare class TeammateFeature extends TeammateFeature_base {
+    initialize(pi: ExtensionAPI): Promise<void> | void;
+}
+export {};
+//# sourceMappingURL=teammate.feature.d.ts.map

package/extensions/pipa/features/teammate/teammate.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/teammate/teammate.feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,SAAS,CAAC;;AAOjB;;GAEG;AACH,qBAAa,eAAgB,SAAQ,oBAQpC;IACC,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAgCjD;CACF"}

package/extensions/pipa/features/teammate/teammate.hub.d.ts

@@ -0,0 +1,24 @@
+import { PipaApi } from '../../interfaces/pipa';
+import { Teammate, TeammateToolSchema } from './teammate.entity';
+import { TeammateCore, TeammateExchange, TeammateFrontmatter, TeammateState, TeammateValidator } from './hub';
+declare const TeammateHub_base: import("ts-mixer/dist/types/types").Class<any[], TeammateFrontmatter & TeammateState & TeammateExchange & TeammateValidator & TeammateCore, typeof TeammateFrontmatter & typeof TeammateState & typeof TeammateExchange & typeof TeammateValidator & typeof TeammateCore>;
+/**
+ * Gerencia os teammates (subagentes) do agente principal, incluindo criação,
+ * armazenamento e comunicação.
+ *
+ * Os métodos seguem a convenção do padrão backlog: nome camelCase da action
+ * (instantiate/list/online/sendInbox/readInbox/chat/dismiss) recebendo payload único tipado.
+ */
+export declare class TeammateHub extends TeammateHub_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    private get teammatesFileManager();
+    /**
+     * Aciona um teammate e inicia uma nova sessão para ele.
+     * @param data Payload único da action 'instantiate'.
+     * @returns O teammate criado (sem session/pipa, não serializáveis).
+     */
+    instantiate(data: TeammateToolSchema<'instantiate'>): Promise<Teammate>;
+}
+export {};
+//# sourceMappingURL=teammate.hub.d.ts.map

package/extensions/pipa/features/teammate/teammate.hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate.hub.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/teammate/teammate.hub.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMhD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;;AAG9G;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,gBAMhC;IACa,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED,OAAO,KAAK,oBAAoB,GAE/B;IAED;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiG5E;CACF"}

package/extensions/pipa/features/teammate/tui/index.d.ts

@@ -0,0 +1,3 @@
+export * from './teammate-tree.widget';
+export * from './tui-animator.mixin';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/teammate/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/teammate/tui/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/extensions/pipa/features/teammate/tui/teammate-tree.widget.d.ts

@@ -0,0 +1,23 @@
+import type { Theme } from '@earendil-works/pi-coding-agent';
+import type { TUI } from '@earendil-works/pi-tui';
+import { AbstractTreeWidget, type TreeNode } from '../../../lib';
+import type { Teammate } from '../teammate.entity';
+import { TuiAnimatorMixin } from './tui-animator.mixin';
+type TeammateNode = TreeNode<Teammate>;
+declare const TeammateTreeWidget_base: import("ts-mixer/dist/types/types").Class<any[], AbstractTreeWidget<Teammate> & TuiAnimatorMixin, (abstract new () => AbstractTreeWidget<Teammate>) & typeof TuiAnimatorMixin>;
+export declare class TeammateTreeWidget extends TeammateTreeWidget_base {
+    private readonly tui;
+    private readonly getTeammates;
+    private readonly theme;
+    constructor(tui: TUI, getTeammates: () => Teammate[], theme: Theme);
+    start(): void;
+    stop(): void;
+    render(width: number): string[];
+    invalidate(): void;
+    protected renderLabel(node: TeammateNode): string;
+    private statusIcon;
+    private colorStatus;
+    private elapsedLabel;
+}
+export {};
+//# sourceMappingURL=teammate-tree.widget.d.ts.map

package/extensions/pipa/features/teammate/tui/teammate-tree.widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate-tree.widget.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/teammate/tui/teammate-tree.widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAMlD,OAAO,EACL,kBAAkB,EAKlB,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,KAAK,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;;AAEvC,qBAAa,kBAAmB,SAAQ,uBAAqD;IAEzF,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHxB,YACmB,GAAG,EAAE,GAAG,EACR,YAAY,EAAE,MAAM,QAAQ,EAAE,EAC9B,KAAK,EAAE,KAAK,EAG9B;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,IAAI,IAAI,IAAI,CAEX;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB9B;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAoDhD;IAED,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,YAAY;CA4BrB"}

package/extensions/pipa/features/teammate/tui/tui-animator.mixin.d.ts

@@ -0,0 +1,16 @@
+import type { TUI } from '@earendil-works/pi-tui';
+export declare class TuiAnimatorMixin {
+    step: number;
+    private animationInterval?;
+    /**
+     * Inicia o intervalo da animação.
+     * @param tui A instância do TUI para solicitar repintura
+     * @param intervalMs Duração do intervalo em milissegundos
+     */
+    startAnimation(tui: TUI, intervalMs?: number): void;
+    /**
+     * Interrompe o intervalo da animação e limpa a referência.
+     */
+    stopAnimation(): void;
+}
+//# sourceMappingURL=tui-animator.mixin.d.ts.map

package/extensions/pipa/features/teammate/tui/tui-animator.mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-animator.mixin.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/teammate/tui/tui-animator.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAElD,qBAAa,gBAAgB;IACpB,IAAI,SAAK;IAChB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAE3C;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,GAAE,MAAW,GAAG,IAAI,CAStD;IAED;;OAEG;IACH,aAAa,IAAI,IAAI,CAKpB;CACF"}

package/extensions/pipa/features/todo/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './reminders';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/todo/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/todo/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/extensions/pipa/features/todo/hooks/reminders.d.ts

@@ -0,0 +1,16 @@
+import { type PipaApi } from '../../../interfaces';
+/**
+ * Hook responsável por gerenciar lembretes e notificações
+ * relacionados aos afazeres (todos) pendentes.
+ */
+export declare class TodoReminders {
+    /**
+     * Orienta o colega a criar uma lista de afazeres caso não tenha nenhuma no início da iteração.
+     */
+    promptTodoCreation(_: unknown, pipa: PipaApi): void;
+    /**
+     * Notifica o usuário/agente sobre tarefas pendentes ao final de uma interação.
+     */
+    notifyPendingTodos(_: unknown, pipa: PipaApi): void;
+}
+//# sourceMappingURL=reminders.d.ts.map

package/extensions/pipa/features/todo/hooks/reminders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminders.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/todo/hooks/reminders.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;GAGG;AACH,qBAAa,aAAa;IACxB;;OAEG;IAEH,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,QAiB3C;IAED;;OAEG;IAEH,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,QAqB3C;CACF"}

package/extensions/pipa/features/todo/hub/core.d.ts

@@ -0,0 +1,35 @@
+import { TodoValidator } from './validator';
+import { PipaApi } from '../../../interfaces';
+import { FileManager } from '../../../lib';
+import { TodoItem, TodoToolSchema } from '../todo.entity';
+/**
+ * Mixin central responsável pela manipulação persistente da lista de afazeres no TodoHub.
+ */
+export declare class TodoCore extends TodoValidator {
+    readonly pipa: PipaApi;
+    readonly fileManager: FileManager<TodoItem[]>;
+    constructor(pipa: PipaApi);
+    get sessionId(): string;
+    persist(): void;
+    /**
+     * Atualiza um item de afazer existente e persiste as mudanças.
+     * @param data Payload único da action 'update'.
+     * @returns O item atualizado.
+     */
+    update({ id, action, ...updates }: TodoToolSchema<'update'>): TodoItem;
+    /**
+     * Remove uma etapa da lista e persiste o novo estado.
+     * @param data Payload único da action 'remove'.
+     */
+    remove({ id }: TodoToolSchema<'remove'>): void;
+    /**
+     * Limpa inteiramente o histórico e os afazeres da lista.
+     */
+    clear(): void;
+    /**
+     * Recupera todos os passos atuais da lista de afazeres.
+     * @returns Os itens da lista de afazeres.
+     */
+    list(): TodoItem[];
+}
+//# sourceMappingURL=core.d.ts.map

package/extensions/pipa/features/todo/hub/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/todo/hub/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAI1D;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAAa;IAG7B,QAAQ,CAAC,IAAI,EAAE,OAAO;IAFlC,SAAgB,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD,YAAqB,IAAI,EAAE,OAAO,EAIjC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAEM,OAAO,IAAI,IAAI,CAErB;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAOrE;IAED;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAK7C;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED;;;OAGG;IACH,IAAI,IAAI,QAAQ,EAAE,CAEjB;CACF"}

package/extensions/pipa/features/todo/hub/index.d.ts

@@ -0,0 +1,4 @@
+export * from './state';
+export * from './validator';
+export * from './core';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/todo/hub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/todo/hub/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC"}

package/extensions/pipa/features/todo/hub/state.d.ts

@@ -0,0 +1,40 @@
+import { TodoItem } from '../todo.entity';
+/**
+ * Mantém e gerencia o estado em memória da lista de afazeres dos agentes.
+ */
+export declare class TodoState {
+    /**
+     * Recupera a store global de todos.
+     */
+    static get store(): Map<string, TodoItem>;
+    /**
+     * Carrega os afazeres persistidos em disco (todo.json do workspace do agente)
+     * para a store em memória, substituindo os itens atuais da sessão.
+     */
+    static load(workspaceDir: string, sessionId: string): void;
+    /**
+     * Adiciona um novo item ao estado.
+     */
+    static add(item: TodoItem): TodoItem;
+    /**
+     * Atualiza parcialmente um item existente no estado.
+     */
+    static update(id: string, data: Partial<TodoItem>): TodoItem | undefined;
+    /**
+     * Remove permanentemente um item do estado através de seu ID.
+     */
+    static delete(id: string): void;
+    /**
+     * Limpa integralmente a lista de afazeres de um agente específico.
+     */
+    static clear(sessionId: string): void;
+    /**
+     * Recupera a lista contendo todos os itens atuais da lista de afazeres de um agente.
+     */
+    static list(sessionId: string): TodoItem[];
+    /**
+     * Obtém um item específico da lista de afazeres por seu ID.
+     */
+    static get(id: string): TodoItem | undefined;
+}
+//# sourceMappingURL=state.d.ts.map

package/extensions/pipa/features/todo/hub/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/todo/hub/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,WAAkB,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAQ/C;IAED;;;OAGG;IACH,OAAc,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAMhE;IAED;;OAEG;IACH,OAAc,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAI1C;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,SAAS,CAW9E;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAErC;IAED;;OAEG;IACH,OAAc,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM3C;IAED;;OAEG;IACH,OAAc,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEhD;IAED;;OAEG;IACH,OAAc,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAElD;CACF"}

package/extensions/pipa/features/todo/hub/validator.d.ts

@@ -0,0 +1,24 @@
+import { TodoItem } from '../todo.entity';
+/**
+ * Classe responsável por validar as ações executadas na lista de afazeres,
+ * retornando falhas seguras para notificação em caso de operações inválidas.
+ */
+export declare class TodoValidator {
+    /**
+     * Valida se um item é passível de ser atualizado.
+     *
+     * @param sessionId O ID da sessão do agente.
+     * @param id O ID do item que está sendo buscado.
+     * @returns Um objeto ValidationResult atestando se a ação pode prosseguir, com erro no caso negativo.
+     */
+    canUpdate(sessionId: string, id: string): TodoItem;
+    /**
+     * Valida se um item é passível de ser removido.
+     *
+     * @param sessionId O ID da sessão do agente.
+     * @param id O ID do item que está sendo buscado.
+     * @returns Um objeto ValidationResult atestando se a ação pode prosseguir, com erro no caso negativo.
+     */
+    canRemove(sessionId: string, id: string): TodoItem;
+}
+//# sourceMappingURL=validator.d.ts.map

package/extensions/pipa/features/todo/hub/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/todo/hub/validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAWjD;IAED;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAWjD;CACF"}

package/extensions/pipa/features/todo/todo.definitions.d.ts

@@ -0,0 +1,31 @@
+import Type from 'typebox';
+export declare const TODO_TOOL_SCHEMA: {
+    instantiate: Type.TObject<{
+        action: Type.TLiteral<"instantiate">;
+        item: Type.TString;
+    }>;
+    update: Type.TObject<{
+        action: Type.TLiteral<"update">;
+        id: Type.TString;
+        status: Type.TOptional<Type.TUnion<boolean[]>>;
+        text: Type.TOptional<Type.TString>;
+    }>;
+    remove: Type.TObject<{
+        action: Type.TLiteral<"remove">;
+        id: Type.TString;
+    }>;
+    list: Type.TObject<{
+        action: Type.TLiteral<"list">;
+    }>;
+    clear: Type.TObject<{
+        action: Type.TLiteral<"clear">;
+    }>;
+};
+export declare const TODO_TOOL_ACTIONS_MESSAGE: {
+    instantiate: string;
+    update: string;
+    remove: string;
+    list: string;
+    clear: string;
+};
+//# sourceMappingURL=todo.definitions.d.ts.map

package/extensions/pipa/features/todo/todo.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.definitions.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/todo/todo.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAO3B,eAAO,MAAM,gBAAgB;IAC3B,WAAW;;;;IAMX,MAAM;;;;;;IAgBN,MAAM;;;;IAMN,IAAI;;;IAKJ,KAAK;;;CAGN,CAAC;AAEF,eAAO,MAAM,yBAAyB;IACpC,WAAW;IACX,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;CACN,CAAC"}

package/extensions/pipa/features/todo/todo.entity.d.ts

@@ -0,0 +1,44 @@
+import { BaseClass, ToolActionPayload, ToolParams } from '../../interfaces/common';
+import { TODO_TOOL_SCHEMA } from './todo.definitions';
+/**
+ * Status possíveis para um item na lista de afazeres.
+ */
+export type TodoStatus = 'pending' | 'in_progress' | 'completed';
+export type TodoToolParams = ToolParams<typeof TODO_TOOL_SCHEMA>;
+/** Payload de cada ação da tool todo */
+export type TodoToolSchema<K extends keyof typeof TODO_TOOL_SCHEMA> = ToolActionPayload<typeof TODO_TOOL_SCHEMA, K>;
+/**
+ * Representa um único passo na lista de afazeres do agente.
+ */
+export declare class TodoItem {
+    constructor(data: BaseClass<TodoItem>);
+    /**
+     * Identificador único do item.
+     */
+    id: string;
+    /**
+     * Identificador da sessão do agente que é dono deste item.
+     */
+    sessionId: string;
+    /**
+     * Texto descrevendo a etapa ou tarefa a ser realizada.
+     */
+    text: string;
+    /**
+     * Status atual do item.
+     */
+    status: TodoStatus;
+    /**
+     * Indica se o item está pendente.
+     */
+    get isPending(): boolean;
+    /**
+     * Indica se o item está em andamento.
+     */
+    get isInProgress(): boolean;
+    /**
+     * Indica se o item está concluído.
+     */
+    get isCompleted(): boolean;
+}
+//# sourceMappingURL=todo.entity.d.ts.map

package/extensions/pipa/features/todo/todo.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.entity.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/todo/todo.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEjE,wCAAwC;AACxC,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,OAAO,gBAAgB,IAAI,iBAAiB,CAAC,OAAO,gBAAgB,EAAE,CAAC,CAAC,CAAC;AAEpH;;GAEG;AACH,qBAAa,QAAQ;IACnB,YAAY,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,EAEpC;IAED;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}

package/extensions/pipa/features/todo/todo.feature.d.ts

@@ -0,0 +1,18 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeature } from '../base-feature';
+import { TodoReminders } from './hooks';
+declare const TodoFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature & TodoReminders, typeof PipaBaseFeature & typeof TodoReminders>;
+/**
+ * Feature principal do sistema "todo", responsável por acoplar a ferramenta (tool)
+ * correspondente ao agente e gerenciar seu fluxo.
+ */
+export declare class TodoFeature extends TodoFeature_base {
+    private mountPipa;
+    /**
+     * Inicializa o suporte à ferramenta 'todo' no ecossistema do Pi.
+     * Registra a tool e delega o dispatch das actions ao setToolActions (padrão backlog).
+     */
+    initialize(pi: ExtensionAPI): void;
+}
+export {};
+//# sourceMappingURL=todo.feature.d.ts.map

package/extensions/pipa/features/todo/todo.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/todo/todo.feature.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQlD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;;AAGxC;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAAqC;IAIpE,OAAO,CAAC,SAAS;IAIjB;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAgCjC;CACF"}

package/extensions/pipa/features/todo/todo.hub.d.ts

@@ -0,0 +1,24 @@
+import { PipaApi } from '../../interfaces';
+import { TodoItem, TodoToolSchema } from './todo.entity';
+import { TodoValidator, TodoCore } from './hub';
+declare const TodoHub_base: import("ts-mixer/dist/types/types").Class<any[], TodoValidator & TodoCore, typeof TodoValidator & typeof TodoCore>;
+/**
+ * Gerencia a ferramenta local de TODO do agente (Subagente).
+ * Responsável pela persistência em disco do passo-a-passo.
+ *
+ * Os métodos seguem a convenção do padrão backlog: nome camelCase da action
+ * (instantiate/update/remove/list/clear) recebendo payload único tipado.
+ */
+export declare class TodoHub extends TodoHub_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    /**
+     * Adiciona um novo item à lista de afazeres, persistindo-o no arquivo local.
+     *
+     * @param data Payload único da action 'instantiate' contendo o texto descritivo do passo.
+     * @returns O item criado.
+     */
+    instantiate(data: TodoToolSchema<'instantiate'>): TodoItem;
+}
+export {};
+//# sourceMappingURL=todo.hub.d.ts.map

package/extensions/pipa/features/todo/todo.hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.hub.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/todo/todo.hub.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAa,aAAa,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;;AAE3D;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,YAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,QAAQ,CAMzD;CACF"}

package/extensions/pipa/features/tool-result-compactor/hooks/compactor.d.ts

@@ -0,0 +1,22 @@
+import type { ContextEvent, TurnEndEvent } from '@earendil-works/pi-coding-agent';
+import type { ContextEventResult } from '@earendil-works/pi-coding-agent/extensions';
+import type { PipaApi } from '../../../interfaces';
+/**
+ * Substitui o conteúdo de tool results antigos e volumosos por um stub com caminho de arquivo,
+ * reduzindo o contexto enviado ao LLM a cada turn (micro-compact periódico).
+ *
+ * Regras de elegibilidade (todas devem ser satisfeitas):
+ *   1. O tool result não é de erro (`isError === false`).
+ *   2. O turn em que foi produzido é anterior à janela de turns recentes (`COMPACTOR_RECENT_TURNS`).
+ *   3. O conteúdo textual total supera `COMPACTOR_MIN_CHARS` caracteres.
+ *
+ * Idempotente: resultados já compactados (conteúdo curto) não serão reprocessados.
+ * Sem estado persistido: o Map é reconstruído a cada sessão via eventos `turn_end`.
+ */
+export declare class ToolResultCompactor {
+    private readonly toolResultTurns;
+    private currentTurn;
+    trackTurn(event: TurnEndEvent, _pipa: PipaApi): void;
+    compact(event: ContextEvent, pipa: PipaApi): ContextEventResult | void;
+}
+//# sourceMappingURL=compactor.d.ts.map

package/extensions/pipa/features/tool-result-compactor/hooks/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/tool-result-compactor/hooks/compactor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAGrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,WAAW,CAAK;IAGxB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAMnD;IAGD,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA0DrE;CACF"}

package/extensions/pipa/features/tool-result-compactor/tool-result-compactor.feature.d.ts

@@ -0,0 +1,12 @@
+import { PipaBaseFeature } from '../base-feature';
+import { ToolResultCompactor } from './hooks/compactor';
+declare const ToolResultCompactorFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature & ToolResultCompactor, typeof PipaBaseFeature & typeof ToolResultCompactor>;
+/**
+ * Feature de higiene de contexto: substitui o conteúdo de tool results antigos e volumosos
+ * por um stub com caminho de arquivo, realizando micro-compactações periódicas sem intervenção
+ * do usuário.
+ */
+export declare class ToolResultCompactorFeature extends ToolResultCompactorFeature_base {
+}
+export {};
+//# sourceMappingURL=tool-result-compactor.feature.d.ts.map

package/extensions/pipa/features/tool-result-compactor/tool-result-compactor.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-compactor.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/tool-result-compactor/tool-result-compactor.feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;;AAExD;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,+BAA2C;CAAG"}

package/extensions/pipa/index.d.ts

@@ -0,0 +1,5 @@
+import './core/config';
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import './cross-cutting/store';
+export default function main(pi: ExtensionAPI): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../extensions/pipa/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,uBAAuB,CAAC;AAa/B,wBAA8B,IAAI,CAAC,EAAE,EAAE,YAAY,iBAelD"}