tnega 0.1.0 → 0.3.0

package/dist/types/packages/tools/src/index.d.ts

@@ -0,0 +1,107 @@
+import type { Context, Disposable } from "../../core/src/index.js";
+import { Service } from "../../core/src/index.js";
+import type { ToolPolicy } from './policy.js';
+export * from './builtins.js';
+export * from './calc.js';
+export * from './path.js';
+export * from './execution.js';
+export { ToolAuthorizationError, validateSchema, validateToolInput, type ToolAuthorizer, type ToolInputValidator, type ToolPolicy, type ToolResultTruncator, } from './policy.js';
+export interface ToolParameterSchema {
+    type?: string;
+    properties?: Record<string, unknown>;
+    required?: string[];
+    [key: string]: unknown;
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters?: ToolParameterSchema;
+}
+export interface ToolExecuteOptions {
+    callId?: string;
+    signal?: AbortSignal;
+    /** Runtime opt-in: mark a successful result as concluding the agent turn. */
+    concludesTurn?: boolean;
+    [key: string]: unknown;
+}
+export type ToolExecutor = (input: unknown, options: ToolExecuteOptions) => unknown | Promise<unknown>;
+export interface ToolDefinition {
+    schema: ToolSchema;
+    execute: ToolExecutor;
+    metadata?: Record<string, unknown>;
+    policy?: ToolPolicy;
+}
+export interface ToolError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export interface ToolResult {
+    ok: boolean;
+    name: string;
+    callId?: string;
+    input: unknown;
+    output?: unknown;
+    error?: ToolError;
+    /** When true, the agent turn should stop after this tool result. */
+    concludesTurn?: boolean;
+    startedAt: number;
+    durationMs: number;
+}
+export interface ToolRequest {
+    tool: ToolDefinition;
+    name: string;
+    input: unknown;
+    options: ToolExecuteOptions;
+    startedAt: number;
+}
+export interface ToolStagePayload {
+    request: ToolRequest;
+    result: ToolResult;
+}
+export interface ToolsConfig extends ToolPolicy {
+    [key: string]: unknown;
+}
+/**
+ * Final pre-dispatch check evaluated after the `tools/pre-execute` waterfall.
+ * A returned reason denies the call; `undefined` leaves it unchanged. Guards
+ * are monotonic: no later listener can re-allow a denied call.
+ */
+export type ToolGuard = (request: ToolRequest) => string | undefined | Promise<string | undefined>;
+export declare class ToolNotFoundError extends Error {
+    readonly toolName: string;
+    name: string;
+    constructor(toolName: string);
+}
+export declare class ToolAlreadyRegisteredError extends Error {
+    readonly toolName: string;
+    name: string;
+    constructor(toolName: string);
+}
+export declare class ToolsService extends Service<never> {
+    static provide: string;
+    private _tools;
+    private _guards;
+    private _policy;
+    constructor(ctx: Context, config?: ToolsConfig);
+    register(definition: ToolDefinition): Disposable;
+    unregister(name: string): boolean;
+    /** Register a monotonic guard evaluated after pre-execute policy. */
+    guard(guard: ToolGuard): Disposable;
+    has(name: string): boolean;
+    list(): readonly ToolDefinition[];
+    toSpecs(): readonly ToolSchema[];
+    execute(name: string, input: unknown, options?: ToolExecuteOptions): Promise<ToolResult>;
+    private _finish;
+    private _applyPolicy;
+    private _checkGuards;
+    private _validate;
+    private _success;
+    private _failure;
+    private _applyConcludesTurn;
+}
+export declare const tools: {
+    name: string;
+    apply(ctx: Context, config?: ToolsConfig): void;
+};
+export declare const name = "index.js";

package/dist/types/packages/tools/src/path.d.ts

@@ -0,0 +1,4 @@
+export declare class PathSandboxError extends Error {
+    name: string;
+}
+export declare function resolveInside(cwd: string, input: string): Promise<string>;

package/dist/types/packages/tools/src/policy.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition, ToolParameterSchema, ToolRequest, ToolResult } from './index.js';
+export type ToolInputValidator = (input: unknown, tool: ToolDefinition) => void | Promise<void>;
+export type ToolAuthorizer = (request: ToolRequest) => boolean | Promise<boolean>;
+export type ToolResultTruncator = (result: ToolResult, request: ToolRequest) => ToolResult | Promise<ToolResult>;
+export interface ToolPolicy {
+    validator?: ToolInputValidator;
+    authorizer?: ToolAuthorizer;
+    truncator?: ToolResultTruncator;
+}
+export declare class ToolAuthorizationError extends Error {
+    name: string;
+}
+export declare function validateSchema(input: unknown, schema: ToolParameterSchema | undefined): string[];
+export declare function validateToolInput(input: unknown, tool: ToolDefinition): void;

package/dist/types/src/events.d.ts

@@ -0,0 +1 @@
+export { EventsService, isBailed, type DispatchMode, type EventOptions, type Events, type Hook, } from '../packages/core/src/events.js';

package/dist/types/src/index.d.ts

@@ -0,0 +1,15 @@
+export * as coreApi from '../packages/core/src/index.js';
+export * as sessionApi from '../packages/session/src/index.js';
+export * as toolsApi from '../packages/tools/src/index.js';
+export * as agentApi from '../packages/agent/src/index.js';
+export * as evalApi from '../packages/eval/src/index.js';
+export * as evolveApi from '../packages/evolve/src/index.js';
+export * as llmApi from '../packages/llm/src/index.js';
+export { CordisError, CordisErrorCode, Context, DisposableList, EventsService, Fiber, FiberState, Inject, InvariantRegistry, InvariantViolationError, Logger, LoggerService, ReflectService, RegistryService, Service, ValidationError, assertInvariants, invariant, resolveConfig, symbols, type Any, type AnyFunction, type Dict, type Effect, type InjectKey, type InvariantContext, type InvariantCheck, type InvariantDefinition, type Plugin, type PluginBase, } from '../packages/core/src/index.js';
+export { DEFAULT_CONTEXT_LIMIT, SESSION_FORMAT_VERSION, SessionFormatError, SessionLog, estimateContextUsage, estimateEventTokens, estimateMessageTokens, foldSessionMeta, projectEvents, repairUnclosed, resolveCompactKeep, safeCompactSplit, session, suffixStartIndexForTokens, checkBalancedSteps, checkBalancedToolCalls, checkBalancedTurns, checkMonotonicSeq, checkSessionInvariants, deriveEventMessage, foldRequestContext, foldRequestHeader, foldSurface, isAppendSurfaceEvent, isSurfaceEventType, type AgentType, type CheckpointPayload, type CompactOptions, type ContextUsage, type InboxSplicePayload, type MetaPatchPayload, type MessageEventPayload, type MessageEventType, type ModelMessage, type ModelRole, type ModelToolCall, type ReplayReducer, type SessionBroadcast, type SessionConfig, type SessionEvent, type SessionEventBase, type SessionEventType, type SessionInvariantFailure, type SessionMode, type AssistantChunkPayload, type StepEndPayload, type StepStartPayload, type ToolCallPayload, type ToolResultErrorPayload, type ToolResultPayload, type TurnEndPayload, type TurnEndReason, type TurnStartPayload, type CompactionEndPayload, type CompactionStartPayload, type LlmCallConfig, type RequestContextPayload, type RequestHeaderPayload, type RequestHeaderReason, type SurfaceEventType, type SurfaceFoldReplacement, type SurfaceFoldResult, type SurfaceOp, } from '../packages/session/src/index.js';
+export { CalculatorError, PathSandboxError, ToolAuthorizationError, ToolAlreadyRegisteredError, ToolInputError, ToolNotFoundError, ToolsService, builtinTools, createBuiltinToolDefinitions, evaluateExpression, localExecutionProvider, tools, validateSchema, validateToolInput, type ToolAuthorizer, type BuiltinToolsConfig, type ToolDefinition, type ToolError, type ToolExecuteOptions, type ToolExecutor, type ToolInputValidator, type ToolParameterSchema, type ToolPolicy, type ToolRequest, type ToolResult, type ToolResultTruncator, type ToolSchema, type ToolStagePayload, type ToolsConfig, type ExecutionProvider, type HttpRequest, type HttpResponse, type ShellRequest, type ShellResult, } from '../packages/tools/src/index.js';
+export { AgentError, AgentInbox, AgentRegistry, AgentService, DurableInbox, LlmService, agent, agents, llmService, systemPrompt, type AgentCreationOptions, type AgentConfig, type AgentCancelOptions, type AgentContextBudget, type AgentContextCompactEvent, type AgentEndEvent, type AgentFinishReason, type AgentHooks, type AgentInput, type AgentLoop, type AgentRunOptions, type AgentRunResult, type AgentStartEvent, type AgentStep, type AgentStepEvent, type AgentStreamEvent, type AgentPreStepEvent, type AgentRequestEvent, type AgentToolCallEvent, type AgentToolEndEvent, type AgentToolResultEvent, type AgentToolStartEvent, type AgentTurnEndEvent, type AgentTurnStoppingEvent, type AgentTurnStartEvent, type CompleteOptions, type AgentDefinition, type AgentDefinitionHooks, type AgentHandle, type AgentStatus, type AgentFactory, type DurableInboxMessage, type DurableTarget, type LiveAgent, type PromptAssembly, type PromptSection, type SystemPromptAssemblyOptions, type SystemPromptService, type DefineAgentConfig, type LLMAdapter, type LLMCompletion, type LLMMessageDeltaEvent, type LLMMessageStartEvent, type LLMMessageStopEvent, type LLMStreamRequestEvent, type LLMStreamEvent, type LLMToolCall, type LLMToolCallEndEvent, type LLMToolCallStartEvent, defineAgent, } from '../packages/agent/src/index.js';
+export { EvalService, allStrategy, assertStrategy, createStrategyRegistry, defaultStrategyDefinitions, evalPlugin, gateStrategy, hashJson, judgeStrategy, recordJudgeOutput, recordedJudgeOutput, regressionStrategy, stableStringify, weightedStrategy, type AllStrategyOptions, type AssertStrategyOptions, type BudgetUsage, type CandidateMetadata, type CandidatePreset, type CompareResult, type Evidence, type EvalAbortEvent, type EvalPluginConfig, type EvalRun, type EvalRunEndEvent, type EvalRunOptions, type EvalStartEvent, type EvalStrategy, type EvalStrategyDefinition, type EvalTaskEndEvent, type EvalTaskStartEvent, type EvalVerdictEvent, type GateStrategyOptions, type JudgeStrategyOptions, type RegressionStrategyOptions, type RunBudget, type StrategyContext, type StrategyRegistry, type Task, type TaskAssertion, type TaskBudget, type Verdict, type VerdictStatus, type WeightedStrategyOptions, } from '../packages/eval/src/index.js';
+export { ExperimentLog, EvolveService, candidateKey, createLlmProposeRule, diagnose, emptyDiagnosis, evolvePlugin, llmCandidate, parseLlmProposal, proposalContext, toCandidatePreset, toCandidateSnapshot, withSystemPrompt, type ApprovalRequest, type Candidate, type CandidateMutation, type CandidateSnapshot, type Diagnosis, type EvolveApprovalEvent, type EvolveDecisionEvent, type EvolveOptions, type EvolvePluginConfig, type EvolveProposeEvent, type EvolveRunEvent, type EvolveStepOptions, type EvolveStepResult, type ExperimentNode, type ExperimentReplay, type ExperimentStatus, type FailureMode, type GateCheck, type LlmCandidateConfig, type LlmCandidateOptions, type LlmProposal, type LlmProposeRuleOptions, type LlmProposalError, type ProposeRule, type ProposeRuleResult, type ProposalContext, type SelectionDecision, type SelectionPolicy, type StrategySummary, } from '../packages/evolve/src/index.js';
+export { DEFAULT_MODEL, DEFAULT_DEEPSEEK_MODEL, DEFAULT_LLM_MAX_RETRIES, DEFAULT_LLM_RETRY_DELAY_MS, DEFAULT_LLM_TIMEOUT_MS, DEFAULT_OPENCODE_GO_BASE_URL, MODEL_CATALOG, OpenAICompatibleError, anthropicMessagesAdapter, createLlmAdapter, lookupModel, openaiCompatAdapter, type LlmConfig, type LlmProtocol, type ModelDefinition, type ModelPricing, type ModelPricingMeta, type OpenAICompatibleConfig, } from '../packages/llm/src/index.js';
+export { CliError, bootAgentRuntime, compareCommand, createAgentRuntime, formatAgentRun, formatCompare, formatEvolveResult, formatRun, loadTasksFile, main, parseYaml, generalAgentProfile, resolveLlmEnv, runAgentCommand, runCommand, runEvolveCommand, type AgentRuntime, type AgentRuntimeOptions, type AgentProfile, type EvolveFileConfig, type LlmEnvConfig, type RunAgentCommandOptions, type RunAgentCommandResult, type RunEvolveCommandOptions, type RunEvolveCommandResult, type TasksFile, } from '../packages/cli/src/index.js';

package/dist/types/src/services.d.ts

@@ -0,0 +1,4 @@
+export * from '../packages/core/src/service.js';
+export * from '../packages/core/src/registry.js';
+export * from '../packages/core/src/reflect.js';
+export * from '../packages/core/src/logger.js';