@decibelsystems/tools 2.0.0

package/dist/tools/dojo.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Dojo MCP Tools - AI Feature Incubator
+ *
+ * Provides MCP tools for AI to:
+ * - Create proposals for new features
+ * - Scaffold experiments from proposals
+ * - Run experiments in sandbox mode
+ * - Track wishes (capabilities AI wants)
+ * - View experiment results
+ *
+ * Safety: AI cannot enable/disable/graduate experiments.
+ * Those actions are human-only via CLI.
+ *
+ * Project-scoped: All operations require project_id and work within {project_root}/dojo
+ * Role-based: caller_role determines what operations are allowed
+ */
+import { CallerRole } from './dojoPolicy.js';
+export type ExperimentType = 'script' | 'tool' | 'check' | 'prompt';
+/**
+ * Base input for all Dojo operations
+ * project_id: Optional - identifies which project's Dojo to use (uses default if not provided)
+ * caller_role: Optional - determines permissions (default: 'human')
+ * agent_id: Optional - identifies the calling agent for audit trails
+ */
+export interface DojoBaseInput {
+    project_id?: string;
+    caller_role?: CallerRole;
+    agent_id?: string;
+}
+export interface CreateProposalInput extends DojoBaseInput {
+    title: string;
+    problem: string;
+    hypothesis: string;
+    owner?: 'ai' | 'human';
+    target_module?: string;
+    scope_in?: string[];
+    scope_out?: string[];
+    acceptance?: string[];
+    risks?: string[];
+    follows?: string;
+    insight?: string;
+    wish_id?: string;
+}
+export interface CreateProposalOutput {
+    proposal_id: string;
+    filepath: string;
+    title: string;
+}
+export interface ScaffoldExperimentInput extends DojoBaseInput {
+    proposal_id: string;
+    script_type?: 'py' | 'ts';
+    experiment_type?: ExperimentType;
+}
+export interface ScaffoldExperimentOutput {
+    experiment_id: string;
+    proposal_id: string;
+    directory: string;
+    entrypoint: string;
+    files_created: string[];
+}
+export interface ListDojoInput extends DojoBaseInput {
+    filter?: 'proposals' | 'experiments' | 'wishes' | 'all';
+}
+export interface ProposalSummary {
+    id: string;
+    title: string;
+    owner: 'ai' | 'human';
+    state: 'draft' | 'has_experiment' | 'enabled';
+}
+export interface ExperimentSummary {
+    id: string;
+    proposal_id: string;
+    title: string;
+    type: string;
+    enabled: boolean;
+}
+export interface WishSummary {
+    id: string;
+    capability: string;
+    reason: string;
+    resolved_by?: string;
+}
+export interface ListDojoOutput {
+    proposals: ProposalSummary[];
+    experiments: ExperimentSummary[];
+    wishes: WishSummary[];
+    summary: {
+        total_proposals: number;
+        total_experiments: number;
+        total_wishes: number;
+        enabled_count: number;
+    };
+}
+export interface RunExperimentInput extends DojoBaseInput {
+    experiment_id: string;
+}
+export interface RunExperimentOutput {
+    experiment_id: string;
+    run_id: string;
+    status: 'success' | 'failure';
+    exit_code: number;
+    duration_seconds: number;
+    artifacts: string[];
+    stdout?: string;
+}
+export interface GetResultsInput extends DojoBaseInput {
+    experiment_id: string;
+    run_id?: string;
+}
+export interface GetResultsOutput {
+    experiment_id: string;
+    run_id: string;
+    timestamp: string;
+    exit_code: number;
+    artifacts: string[];
+    stdout?: string;
+    stderr?: string;
+}
+export interface ReadArtifactInput extends DojoBaseInput {
+    experiment_id: string;
+    run_id: string;
+    filename: string;
+}
+export interface ReadArtifactOutput {
+    experiment_id: string;
+    run_id: string;
+    filename: string;
+    content_type: 'yaml' | 'json' | 'text' | 'binary';
+    content: unknown;
+}
+export interface AddWishInput extends DojoBaseInput {
+    capability: string;
+    reason: string;
+    inputs: string[];
+    outputs: Record<string, unknown> | string;
+    integration_point?: string;
+    success_metric?: string;
+    risks?: string[];
+    mvp?: string;
+    algorithm_outline?: string;
+    context?: Record<string, unknown>;
+}
+export interface AddWishOutput {
+    wish_id: string;
+    capability: string;
+    timestamp: string;
+}
+export interface ListWishesInput extends DojoBaseInput {
+    unresolved_only?: boolean;
+}
+export interface ListWishesOutput {
+    wishes: WishSummary[];
+    total: number;
+    unresolved: number;
+}
+export interface CanGraduateInput extends DojoBaseInput {
+    experiment_id: string;
+}
+export interface CanGraduateOutput {
+    experiment_id: string;
+    can_graduate: boolean;
+    has_tool_definition: boolean;
+    is_enabled: boolean;
+    reasons: string[];
+}
+export interface DojoError {
+    error: string;
+    exitCode: number;
+    stderr: string;
+}
+export interface DojoContext {
+    projectId: string;
+    projectRoot: string;
+    dojoRoot: string;
+    callerRole: CallerRole;
+    agentId?: string;
+}
+/**
+ * Resolve the Dojo root for a project.
+ * Returns the path to {project_root}/.decibel/dojo
+ * If projectId is not provided, attempts to use the default project.
+ */
+export declare function resolveDojoRoot(projectId?: string): Promise<{
+    projectId: string;
+    projectRoot: string;
+    dojoRoot: string;
+}>;
+/**
+ * Build a full Dojo context with policy and rate limit enforcement
+ */
+export declare function buildDojoContext(projectId: string | undefined, callerRole: CallerRole | undefined, toolName: string, agentId?: string): Promise<DojoContext>;
+/**
+ * Mark a Dojo request as complete (call in finally block)
+ */
+export declare function finishDojoRequest(callerRole?: CallerRole): void;
+/**
+ * Create a new Dojo proposal (native file operations)
+ */
+export declare function createProposal(input: CreateProposalInput): Promise<CreateProposalOutput | DojoError>;
+/**
+ * Scaffold an experiment from a proposal (native file operations)
+ */
+export declare function scaffoldExperiment(input: ScaffoldExperimentInput): Promise<ScaffoldExperimentOutput | DojoError>;
+/**
+ * List proposals, experiments, and wishes (native file operations)
+ */
+export declare function listDojo(input: ListDojoInput): Promise<ListDojoOutput | DojoError>;
+/**
+ * Run an experiment in sandbox mode (native file operations)
+ * Note: This still uses spawn() to run the experiment script, but not the CLI
+ */
+export declare function runExperiment(input: RunExperimentInput): Promise<RunExperimentOutput | DojoError>;
+/**
+ * Get results from a previous experiment run (native file operations)
+ */
+export declare function getExperimentResults(input: GetResultsInput): Promise<GetResultsOutput | DojoError>;
+/**
+ * Add a wish to the wishlist (native file operations)
+ */
+export declare function addWish(input: AddWishInput): Promise<AddWishOutput | DojoError>;
+/**
+ * List wishes (native file operations)
+ */
+export declare function listWishes(input: ListWishesInput): Promise<ListWishesOutput | DojoError>;
+/**
+ * Check if an experiment can be graduated (read-only)
+ */
+export declare function canGraduate(input: CanGraduateInput): Promise<CanGraduateOutput | DojoError>;
+/**
+ * Read an artifact file from experiment results
+ * Returns parsed content for yaml/json, raw text for others
+ */
+export declare function readArtifact(input: ReadArtifactInput): Promise<ReadArtifactOutput | DojoError>;
+/**
+ * Type guard for DojoError
+ */
+export declare function isDojoError(result: unknown): result is DojoError;
+export interface ListProjectsOutput {
+    projects: {
+        id: string;
+        name?: string;
+        path: string;
+        aliases?: string[];
+        isDefault: boolean;
+    }[];
+    defaultProject?: string;
+    hint: string;
+}
+/**
+ * List all available projects for Dojo operations.
+ * Helps AI callers discover what projects they can use.
+ */
+export declare function dojoListProjects(): ListProjectsOutput;
+//# sourceMappingURL=dojo.d.ts.map

package/dist/tools/dojo.d.ts.map

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