opentasks 0.0.1 → 0.0.2

package/dist/tools/annotate.js

@@ -0,0 +1,218 @@
+/**
+ * Annotate Tool
+ *
+ * Complete feedback lifecycle management.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const TITLE_MAX_LENGTH = 50;
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Truncate string to max length with ellipsis
+ */
+function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.substring(0, maxLength - 3) + '...';
+}
+/**
+ * Build an Anchor from FeedbackAnchor params
+ */
+function buildAnchor(anchor) {
+    if (!anchor)
+        return undefined;
+    if (anchor.line !== undefined) {
+        return {
+            line: anchor.line,
+            anchor_status: 'valid',
+        };
+    }
+    if (anchor.text !== undefined) {
+        return {
+            text: anchor.text,
+            anchor_status: 'valid',
+        };
+    }
+    return undefined;
+}
+/**
+ * Count how many operations are specified
+ */
+function countOperations(params) {
+    let count = 0;
+    if (params.create !== undefined)
+        count++;
+    if (params.resolve !== undefined)
+        count++;
+    if (params.dismiss !== undefined)
+        count++;
+    if (params.reopen !== undefined)
+        count++;
+    return count;
+}
+// ============================================================================
+// Annotate Tool Implementation
+// ============================================================================
+/**
+ * Manage feedback lifecycle
+ *
+ * @param store - Graph store for data operations
+ * @param params - Annotate parameters
+ * @param context - Optional operation context for tracking agent activity
+ * @returns Annotate result with success status
+ */
+export async function annotate(store, params, context) {
+    // Validate targetId is provided
+    if (!params.targetId) {
+        return { success: false, error: 'Missing required parameter: targetId' };
+    }
+    // Validate exactly one operation
+    const operationCount = countOperations(params);
+    if (operationCount === 0) {
+        return {
+            success: false,
+            error: 'No operation specified. Provide one of: create, resolve, dismiss, reopen',
+        };
+    }
+    if (operationCount > 1) {
+        return {
+            success: false,
+            error: 'Multiple operations specified. Provide exactly one of: create, resolve, dismiss, reopen',
+        };
+    }
+    try {
+        // Dispatch to appropriate operation handler
+        if (params.create !== undefined) {
+            return await createFeedback(store, params.targetId, params.create, params.fromId, context);
+        }
+        if (params.resolve !== undefined) {
+            return await resolveFeedback(store, params.resolve, context);
+        }
+        if (params.dismiss !== undefined) {
+            return await dismissFeedback(store, params.dismiss, context);
+        }
+        if (params.reopen !== undefined) {
+            return await reopenFeedback(store, params.reopen, context);
+        }
+        // Should never reach here
+        return { success: false, error: 'Unknown operation' };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return { success: false, error: error.message };
+        }
+        return { success: false, error: 'Unknown error occurred' };
+    }
+}
+// ============================================================================
+// Operation Handlers
+// ============================================================================
+/**
+ * Create new feedback on a target node
+ */
+async function createFeedback(store, targetId, params, fromId, context) {
+    // Validate target exists
+    const targetNode = await store.getNode(targetId);
+    if (!targetNode) {
+        return { success: false, error: `Target node not found: ${targetId}` };
+    }
+    // Validate content is provided
+    if (!params.content) {
+        return { success: false, error: 'Missing required parameter: content' };
+    }
+    // Build anchor
+    const anchor = buildAnchor(params.anchor);
+    // Build metadata with context if provided
+    const metadata = context
+        ? {
+            _context: {
+                agentId: context.agentId,
+                agentName: context.agentName,
+                sessionId: context.sessionId,
+                timestamp: context.timestamp ?? new Date().toISOString(),
+            },
+        }
+        : undefined;
+    // Create feedback node (underlying storage uses snake_case)
+    const feedbackNode = await store.createNode({
+        type: 'feedback',
+        title: truncate(params.content.replace(/\n/g, ' '), TITLE_MAX_LENGTH),
+        content: params.content,
+        target_id: targetId,
+        target_anchor: anchor,
+        feedback_type: params.type || 'comment',
+        metadata,
+    });
+    // If fromId provided, create edge linking issue to feedback
+    if (fromId) {
+        const edgeMetadata = context
+            ? {
+                _context: {
+                    agentId: context.agentId,
+                    agentName: context.agentName,
+                    sessionId: context.sessionId,
+                    timestamp: context.timestamp ?? new Date().toISOString(),
+                },
+            }
+            : undefined;
+        await store.createEdge({
+            from_id: fromId,
+            to_id: feedbackNode.id,
+            type: 'discovered-from',
+            metadata: edgeMetadata,
+        });
+    }
+    return { success: true, feedbackId: feedbackNode.id };
+}
+/**
+ * Mark feedback as resolved
+ */
+async function resolveFeedback(store, feedbackId, _context) {
+    // Validate feedback exists
+    const feedbackNode = await store.getNode(feedbackId);
+    if (!feedbackNode) {
+        return { success: false, error: `Feedback not found: ${feedbackId}` };
+    }
+    if (feedbackNode.type !== 'feedback') {
+        return { success: false, error: `Node is not feedback: ${feedbackId}` };
+    }
+    // Update to resolved
+    await store.updateNode(feedbackId, { resolved: true });
+    return { success: true, feedbackId };
+}
+/**
+ * Mark feedback as dismissed
+ */
+async function dismissFeedback(store, feedbackId, _context) {
+    // Validate feedback exists
+    const feedbackNode = await store.getNode(feedbackId);
+    if (!feedbackNode) {
+        return { success: false, error: `Feedback not found: ${feedbackId}` };
+    }
+    if (feedbackNode.type !== 'feedback') {
+        return { success: false, error: `Node is not feedback: ${feedbackId}` };
+    }
+    // Update to dismissed
+    await store.updateNode(feedbackId, { dismissed: true });
+    return { success: true, feedbackId };
+}
+/**
+ * Reopen resolved or dismissed feedback
+ */
+async function reopenFeedback(store, feedbackId, _context) {
+    // Validate feedback exists
+    const feedbackNode = await store.getNode(feedbackId);
+    if (!feedbackNode) {
+        return { success: false, error: `Feedback not found: ${feedbackId}` };
+    }
+    if (feedbackNode.type !== 'feedback') {
+        return { success: false, error: `Node is not feedback: ${feedbackId}` };
+    }
+    // Update to reopen (clear resolved and dismissed)
+    await store.updateNode(feedbackId, { resolved: false, dismissed: false });
+    return { success: true, feedbackId };
+}
+//# sourceMappingURL=annotate.js.map

package/dist/tools/annotate.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OpenTasks Tools Module
+ *
+ * The 3-tool agent interface for graph operations.
+ *
+ * @packageDocumentation
+ */
+export type { LinkParams, LinkResult, QueryParams, QueryResult, NodeSummary, EdgeSummary, FeedbackSummary, BlockerQueryParams, FeedbackQueryParams, AnnotateParams, AnnotateResult, CreateFeedbackParams, FeedbackAnchor, FeedbackType, TaskParams, TaskResult, TaskTransitionData, TaskReadyData, TaskAssignData, TaskValidActionsData, EdgeType, NodeType, Node, Edge, NodeFilter, EdgeFilter, ReadyOptions, BlockerOptions, FeedbackOptions, OperationContext, ToolErrorCode, } from './types.js';
+export { ToolError } from './types.js';
+export { link } from './link.js';
+export { query } from './query.js';
+export { annotate } from './annotate.js';
+export { task } from './task.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAEV,UAAU,EACV,UAAU,EAEV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EAEnB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,YAAY,EAEZ,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,oBAAoB,EAEpB,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EAEf,gBAAgB,EAEhB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,14 @@
+/**
+ * OpenTasks Tools Module
+ *
+ * The 3-tool agent interface for graph operations.
+ *
+ * @packageDocumentation
+ */
+export { ToolError } from './types.js';
+// Tools
+export { link } from './link.js';
+export { query } from './query.js';
+export { annotate } from './annotate.js';
+export { task } from './task.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4CH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,QAAQ;AACR,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/link.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Link Tool
+ *
+ * Create and remove edges between nodes in the graph.
+ */
+import type { GraphStore } from '../graph/store.js';
+import type { LinkParams, LinkResult, OperationContext } from './types.js';
+/**
+ * Create or remove an edge between nodes
+ *
+ * @param store - Graph store for data operations
+ * @param params - Link parameters
+ * @param context - Optional operation context for tracking agent activity
+ * @returns Link result with success status
+ */
+export declare function link(store: GraphStore, params: LinkParams, context?: OperationContext): Promise<LinkResult>;
+//# sourceMappingURL=link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/tools/link.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkC3E;;;;;;;GAOG;AACH,wBAAsB,IAAI,CACxB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

package/dist/tools/link.js

@@ -0,0 +1,127 @@
+/**
+ * Link Tool
+ *
+ * Create and remove edges between nodes in the graph.
+ */
+import { ToolError } from './types.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Pattern for local node IDs (c-xxx, t-xxx, f-xxx, e-xxx)
+ */
+const LOCAL_ID_PATTERN = /^[ctfex]-[a-z0-9]+$/;
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Check if an ID is a local node ID (vs a provider URI)
+ */
+function isLocalId(id) {
+    return LOCAL_ID_PATTERN.test(id);
+}
+/**
+ * Check if an ID is a provider URI
+ */
+function isProviderUri(id) {
+    return id.includes('://');
+}
+// ============================================================================
+// Link Tool Implementation
+// ============================================================================
+/**
+ * Create or remove an edge between nodes
+ *
+ * @param store - Graph store for data operations
+ * @param params - Link parameters
+ * @param context - Optional operation context for tracking agent activity
+ * @returns Link result with success status
+ */
+export async function link(store, params, context) {
+    const { fromId, toId, type, remove = false, metadata } = params;
+    // Validate parameters
+    if (!fromId) {
+        return { success: false, error: 'Missing required parameter: fromId' };
+    }
+    if (!toId) {
+        return { success: false, error: 'Missing required parameter: toId' };
+    }
+    if (!type) {
+        return { success: false, error: 'Missing required parameter: type' };
+    }
+    try {
+        if (remove) {
+            return await removeEdge(store, fromId, toId, type, context);
+        }
+        else {
+            return await createEdge(store, fromId, toId, type, metadata, context);
+        }
+    }
+    catch (error) {
+        if (error instanceof ToolError) {
+            return { success: false, error: error.message };
+        }
+        if (error instanceof Error) {
+            // Check for cycle detection
+            if (error.message.includes('cycle')) {
+                return { success: false, error: 'Would create cycle in dependency graph' };
+            }
+            return { success: false, error: error.message };
+        }
+        return { success: false, error: 'Unknown error occurred' };
+    }
+}
+/**
+ * Create a new edge between nodes
+ */
+async function createEdge(store, fromId, toId, type, metadata, context) {
+    // Validate local nodes exist (skip for provider URIs)
+    if (isLocalId(fromId) && !isProviderUri(fromId)) {
+        const fromNode = await store.getNode(fromId);
+        if (!fromNode) {
+            return { success: false, error: `Node not found: ${fromId}` };
+        }
+    }
+    if (isLocalId(toId) && !isProviderUri(toId)) {
+        const toNode = await store.getNode(toId);
+        if (!toNode) {
+            return { success: false, error: `Node not found: ${toId}` };
+        }
+    }
+    // Merge context into metadata for tracking
+    const edgeMetadata = context
+        ? {
+            ...metadata,
+            _context: {
+                agentId: context.agentId,
+                agentName: context.agentName,
+                sessionId: context.sessionId,
+                timestamp: context.timestamp ?? new Date().toISOString(),
+            },
+        }
+        : metadata;
+    // Create the edge (underlying storage uses snake_case)
+    const edge = await store.createEdge({
+        from_id: fromId,
+        to_id: toId,
+        type,
+        metadata: edgeMetadata,
+    });
+    return { success: true, edgeId: edge.id };
+}
+/**
+ * Remove an existing edge between nodes
+ */
+async function removeEdge(store, fromId, toId, type, _context) {
+    // Find the edge (underlying storage uses snake_case)
+    const edges = await store.query.edges({ from_id: fromId, type });
+    const targetEdge = edges.find((e) => e.to_id === toId);
+    if (!targetEdge) {
+        // Idempotent: removing non-existent edge succeeds
+        return { success: true };
+    }
+    // Delete the edge
+    await store.deleteEdge(targetEdge.id);
+    return { success: true };
+}
+//# sourceMappingURL=link.js.map

package/dist/tools/link.js.map

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

package/dist/tools/query.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Query Tool
+ *
+ * Unified query interface for graph traversal.
+ */
+import type { GraphStore } from '../graph/store.js';
+import type { QueryParams, QueryResult, OperationContext } from './types.js';
+/**
+ * Query the graph with unified interface
+ *
+ * @param store - Graph store for data operations
+ * @param params - Query parameters
+ * @param _context - Optional operation context (unused but kept for API consistency)
+ * @returns Query result with items and pagination info
+ */
+export declare function query(store: GraphStore, params: QueryParams, _context?: OperationContext): Promise<QueryResult>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAIX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAqHpB;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,WAAW,EACnB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,WAAW,CAAC,CA2DtB"}