@joseph0926/plan-loop-core 1.0.2

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Plan Loop MCP - Core Library
+ * Exports state management and tool implementations
+ */
+export * from './types.js';
+export * as state from './state.js';
+export * from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * Plan Loop MCP - Core Library
+ * Exports state management and tool implementations
+ */
+export * from './types.js';
+export * as state from './state.js';
+export * from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Plan Loop MCP - State Management
+ * Atomic write (temp → rename) for safe concurrent access
+ */
+import type { Session, SessionStatus } from './types.js';
+/**
+ * Save session with atomic write
+ */
+export declare function save(session: Session): void;
+/**
+ * Load session by ID
+ * Returns null if not found or corrupted
+ */
+export declare function load(id: string): Session | null;
+export interface ListOptions {
+    status?: SessionStatus | SessionStatus[];
+    sort?: 'createdAt' | 'updatedAt';
+    order?: 'asc' | 'desc';
+}
+/**
+ * List all sessions (summary only)
+ * goal is truncated to 30 characters (UTF-16 units) + "..." if exceeded
+ * Supports filtering by status and sorting
+ */
+export declare function list(options?: ListOptions): {
+    id: string;
+    goal: string;
+    status: SessionStatus;
+    createdAt: string;
+    updatedAt: string;
+}[];
+/**
+ * Create a new session
+ */
+export declare function create(goal: string, maxIterations?: number): Session;
+/**
+ * Get latest plan from session
+ */
+export declare function getLatestPlan(session: Session): import("./types.js").Plan | null;
+/**
+ * Get latest feedback from session
+ */
+export declare function getLatestFeedback(session: Session): import("./types.js").Feedback | null;
+/**
+ * Delete session by ID
+ * Returns true if deleted, false if not found
+ */
+export declare function remove(id: string): boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAezD;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS3C;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAa/C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,CAkD3I;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,OAAO,CAkB/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,oCAK7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,wCAKjD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAc1C"}

package/dist/state.js

@@ -0,0 +1,154 @@
+/**
+ * Plan Loop MCP - State Management
+ * Atomic write (temp → rename) for safe concurrent access
+ */
+import { writeFileSync, readFileSync, renameSync, mkdirSync, readdirSync, existsSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { randomUUID } from 'crypto';
+// Support PLAN_LOOP_STATE_DIR env var for test isolation
+// Use function to allow dynamic env var reading
+function getStateDir() {
+    return process.env.PLAN_LOOP_STATE_DIR || join(homedir(), '.plan-loop', 'sessions');
+}
+/**
+ * Ensure state directory exists
+ */
+function ensureDir() {
+    mkdirSync(getStateDir(), { recursive: true });
+}
+/**
+ * Save session with atomic write
+ */
+export function save(session) {
+    ensureDir();
+    session.updatedAt = new Date().toISOString();
+    const filePath = join(getStateDir(), `${session.id}.json`);
+    const tempPath = `${filePath}.tmp`;
+    writeFileSync(tempPath, JSON.stringify(session, null, 2));
+    renameSync(tempPath, filePath); // atomic
+}
+/**
+ * Load session by ID
+ * Returns null if not found or corrupted
+ */
+export function load(id) {
+    try {
+        const filePath = join(getStateDir(), `${id}.json`);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const data = readFileSync(filePath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch (err) {
+        // Log to stderr (stdout is reserved for JSON-RPC)
+        console.error(`[plan-loop] Failed to load session ${id}:`, err);
+        return null;
+    }
+}
+/**
+ * List all sessions (summary only)
+ * goal is truncated to 30 characters (UTF-16 units) + "..." if exceeded
+ * Supports filtering by status and sorting
+ */
+export function list(options = {}) {
+    ensureDir();
+    const { status, sort = 'updatedAt', order = 'desc' } = options;
+    // Normalize status filter to array
+    const statusFilter = status
+        ? Array.isArray(status)
+            ? status
+            : [status]
+        : null;
+    try {
+        const files = readdirSync(getStateDir()).filter((f) => f.endsWith('.json') && !f.endsWith('.tmp'));
+        let sessions = files
+            .map((f) => {
+            const session = load(f.replace('.json', ''));
+            if (!session)
+                return null;
+            // Apply status filter
+            if (statusFilter && !statusFilter.includes(session.status)) {
+                return null;
+            }
+            const truncatedGoal = session.goal.length > 30 ? session.goal.slice(0, 30) + '...' : session.goal;
+            return {
+                id: session.id,
+                goal: truncatedGoal,
+                status: session.status,
+                createdAt: session.createdAt,
+                updatedAt: session.updatedAt,
+            };
+        })
+            .filter((s) => s !== null);
+        // Sort
+        sessions.sort((a, b) => {
+            const aTime = new Date(a[sort]).getTime();
+            const bTime = new Date(b[sort]).getTime();
+            return order === 'asc' ? aTime - bTime : bTime - aTime;
+        });
+        return sessions;
+    }
+    catch (err) {
+        console.error('[plan-loop] Failed to list sessions:', err);
+        return [];
+    }
+}
+/**
+ * Create a new session
+ */
+export function create(goal, maxIterations = 5) {
+    const now = new Date().toISOString();
+    const session = {
+        id: randomUUID(),
+        goal,
+        status: 'drafting',
+        version: 0,
+        iteration: 0,
+        maxIterations,
+        plans: [],
+        feedbacks: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+    save(session);
+    return session;
+}
+/**
+ * Get latest plan from session
+ */
+export function getLatestPlan(session) {
+    if (session.plans.length === 0) {
+        return null;
+    }
+    return session.plans[session.plans.length - 1];
+}
+/**
+ * Get latest feedback from session
+ */
+export function getLatestFeedback(session) {
+    if (session.feedbacks.length === 0) {
+        return null;
+    }
+    return session.feedbacks[session.feedbacks.length - 1];
+}
+/**
+ * Delete session by ID
+ * Returns true if deleted, false if not found
+ */
+export function remove(id) {
+    const filePath = join(getStateDir(), `${id}.json`);
+    if (!existsSync(filePath)) {
+        return false;
+    }
+    try {
+        unlinkSync(filePath);
+        return true;
+    }
+    catch (err) {
+        console.error(`[plan-loop] Failed to delete session ${id}:`, err);
+        return false;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Plan Loop MCP - Tool Implementations
+ */
+import type { PlStartInput, PlSubmitInput, PlGetPlanInput, PlFeedbackInput, PlGetFeedbackInput, PlStatusInput, PlListInput, PlForceApproveInput, PlDeleteInput } from './types.js';
+declare function successResponse(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_start - Create a new session
+ */
+export declare function plStart(input: PlStartInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_submit - Submit a plan
+ * Allowed states: drafting, pending_revision
+ */
+export declare function plSubmit(input: PlSubmitInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_get_plan - Get the latest plan
+ * Returns pending response if no plan exists
+ */
+export declare function plGetPlan(input: PlGetPlanInput): ReturnType<typeof successResponse>;
+/**
+ * pl_feedback - Submit feedback for the latest plan
+ * Allowed states: pending_review
+ */
+export declare function plFeedback(input: PlFeedbackInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_get_feedback - Get the latest feedback
+ * Returns pending response based on session status
+ */
+export declare function plGetFeedback(input: PlGetFeedbackInput): ReturnType<typeof successResponse>;
+/**
+ * pl_status - Get full session status
+ */
+export declare function plStatus(input: PlStatusInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_list - List all sessions
+ * Supports filtering by status and sorting
+ */
+export declare function plList(input?: PlListInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_force_approve - Force approve an exhausted session
+ * Allowed states: exhausted
+ */
+export declare function plForceApprove(input: PlForceApproveInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * pl_delete - Delete a session
+ * By default, only allows deleting approved/exhausted sessions
+ * Use force=true to delete active sessions
+ */
+export declare function plDelete(input: PlDeleteInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAGV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,aAAa,EAId,MAAM,YAAY,CAAC;AAYpB,iBAAS,eAAe,CAAC,IAAI,EAAE,OAAO;;;;;EAIrC;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY;;;;;EAqB1C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa;;;;;EAsC5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CA2BnF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe;;;;;EA4DhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAsC3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa;;;;;EAa5C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,GAAE,WAAgB;;;;;EAe7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB;;;;;EAqCxD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa;;;;;EA6B5C"}

package/dist/tools.js

@@ -0,0 +1,284 @@
+/**
+ * Plan Loop MCP - Tool Implementations
+ */
+import * as state from './state.js';
+// Error response helper (SDK isError format)
+function errorResponse(message) {
+    return {
+        isError: true,
+        content: [{ type: 'text', text: message }],
+    };
+}
+// Success response helper
+function successResponse(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+/**
+ * pl_start - Create a new session
+ */
+export function plStart(input) {
+    const { goal, maxIterations = 5 } = input;
+    if (!isNonEmptyString(goal)) {
+        return errorResponse('goal is required');
+    }
+    if (maxIterations !== undefined &&
+        (typeof maxIterations !== 'number' ||
+            !Number.isInteger(maxIterations) ||
+            maxIterations < 1)) {
+        return errorResponse('maxIterations must be a positive integer');
+    }
+    const session = state.create(goal, maxIterations);
+    return successResponse({
+        session_id: session.id,
+    });
+}
+/**
+ * pl_submit - Submit a plan
+ * Allowed states: drafting, pending_revision
+ */
+export function plSubmit(input) {
+    const { session_id, plan } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    const allowedStates = ['drafting', 'pending_revision'];
+    if (!allowedStates.includes(session.status)) {
+        return errorResponse(`Invalid state: current='${session.status}', expected=${JSON.stringify(allowedStates)}`);
+    }
+    if (!isNonEmptyString(plan)) {
+        return errorResponse('plan is required');
+    }
+    // Increment version and add plan
+    session.version += 1;
+    session.plans.push({
+        version: session.version,
+        content: plan,
+        submittedAt: new Date().toISOString(),
+    });
+    session.status = 'pending_review';
+    state.save(session);
+    return successResponse({
+        version: session.version,
+        status: session.status,
+    });
+}
+/**
+ * pl_get_plan - Get the latest plan
+ * Returns pending response if no plan exists
+ */
+export function plGetPlan(input) {
+    const { session_id } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    const latestPlan = state.getLatestPlan(session);
+    if (!latestPlan) {
+        const response = {
+            ready: false,
+            reason: 'no_plan_submitted',
+        };
+        return successResponse(response);
+    }
+    const response = {
+        ready: true,
+        data: latestPlan,
+    };
+    return successResponse(response);
+}
+/**
+ * pl_feedback - Submit feedback for the latest plan
+ * Allowed states: pending_review
+ */
+export function plFeedback(input) {
+    const { session_id, rating, content } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    if (session.status !== 'pending_review') {
+        return errorResponse(`Invalid state: current='${session.status}', expected=['pending_review']`);
+    }
+    const validRatings = ['🔴', '🟡', '🟢'];
+    if (!validRatings.includes(rating)) {
+        return errorResponse(`Invalid rating: ${rating}, expected one of ${JSON.stringify(validRatings)}`);
+    }
+    if (!isNonEmptyString(content)) {
+        return errorResponse('content is required');
+    }
+    const latestPlan = state.getLatestPlan(session);
+    if (!latestPlan) {
+        return errorResponse('No plan to provide feedback on');
+    }
+    // Add feedback
+    session.feedbacks.push({
+        planVersion: latestPlan.version,
+        rating,
+        content,
+        submittedAt: new Date().toISOString(),
+    });
+    // Update status based on rating
+    if (rating === '🟢') {
+        session.status = 'approved';
+    }
+    else {
+        // 🔴 or 🟡
+        session.iteration += 1;
+        if (session.iteration >= session.maxIterations) {
+            session.status = 'exhausted';
+        }
+        else {
+            session.status = 'pending_revision';
+        }
+    }
+    state.save(session);
+    return successResponse({
+        status: session.status,
+        iteration: session.iteration,
+    });
+}
+/**
+ * pl_get_feedback - Get the latest feedback
+ * Returns pending response based on session status
+ */
+export function plGetFeedback(input) {
+    const { session_id } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    const latestPlan = state.getLatestPlan(session);
+    if (!latestPlan) {
+        const response = {
+            ready: false,
+            reason: 'no_plan_submitted',
+        };
+        return successResponse(response);
+    }
+    const latestFeedback = state.getLatestFeedback(session);
+    if (!latestFeedback || latestFeedback.planVersion < latestPlan.version) {
+        // Determine reason based on status
+        const reason = session.status === 'pending_review' ? 'awaiting_feedback' : 'no_feedback_yet';
+        const response = {
+            ready: false,
+            reason,
+        };
+        return successResponse(response);
+    }
+    const response = {
+        ready: true,
+        data: latestFeedback,
+    };
+    return successResponse(response);
+}
+/**
+ * pl_status - Get full session status
+ */
+export function plStatus(input) {
+    const { session_id } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    return successResponse(session);
+}
+/**
+ * pl_list - List all sessions
+ * Supports filtering by status and sorting
+ */
+export function plList(input = {}) {
+    const { status, sort, order } = input;
+    const sessions = state.list({ status, sort, order });
+    // Remove timestamps from response (keep backward compatible)
+    const sessionsWithoutTimestamps = sessions.map(({ id, goal, status }) => ({
+        id,
+        goal,
+        status,
+    }));
+    return successResponse({
+        sessions: sessionsWithoutTimestamps,
+    });
+}
+/**
+ * pl_force_approve - Force approve an exhausted session
+ * Allowed states: exhausted
+ */
+export function plForceApprove(input) {
+    const { session_id, reason } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    if (session.status !== 'exhausted') {
+        return errorResponse(`Invalid state: current='${session.status}', expected=['exhausted']`);
+    }
+    if (!isNonEmptyString(reason)) {
+        return errorResponse('reason is required');
+    }
+    // Add a special feedback entry for force approve
+    const latestPlan = state.getLatestPlan(session);
+    session.feedbacks.push({
+        planVersion: latestPlan?.version ?? session.version,
+        rating: '🟢',
+        content: `[FORCE APPROVED] ${reason}`,
+        submittedAt: new Date().toISOString(),
+    });
+    session.status = 'approved';
+    state.save(session);
+    return successResponse({
+        status: 'approved',
+    });
+}
+/**
+ * pl_delete - Delete a session
+ * By default, only allows deleting approved/exhausted sessions
+ * Use force=true to delete active sessions
+ */
+export function plDelete(input) {
+    const { session_id, force = false } = input;
+    if (!isNonEmptyString(session_id)) {
+        return errorResponse('session_id is required');
+    }
+    const session = state.load(session_id);
+    if (!session) {
+        return errorResponse(`Session not found: ${session_id}`);
+    }
+    // Check if session can be deleted
+    const safeStates = ['approved', 'exhausted'];
+    if (!safeStates.includes(session.status) && !force) {
+        return errorResponse(`Cannot delete active session (status='${session.status}'). Use force=true to override`);
+    }
+    const deleted = state.remove(session_id);
+    if (!deleted) {
+        return errorResponse(`Failed to delete session: ${session_id}`);
+    }
+    return successResponse({
+        deleted: true,
+        session_id,
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Plan Loop MCP - Type Definitions
+ */
+export type SessionStatus = 'drafting' | 'pending_review' | 'pending_revision' | 'approved' | 'exhausted';
+export type Rating = '🔴' | '🟡' | '🟢';
+export interface Plan {
+    version: number;
+    content: string;
+    submittedAt: string;
+}
+export interface Feedback {
+    planVersion: number;
+    rating: Rating;
+    content: string;
+    submittedAt: string;
+}
+export interface Session {
+    id: string;
+    goal: string;
+    status: SessionStatus;
+    version: number;
+    iteration: number;
+    maxIterations: number;
+    plans: Plan[];
+    feedbacks: Feedback[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ReadyResponse<T> {
+    ready: true;
+    data: T;
+}
+export type PendingReason = 'no_plan_submitted' | 'no_feedback_yet' | 'awaiting_feedback';
+export interface PendingResponse {
+    ready: false;
+    reason: PendingReason;
+}
+export type Response<T> = ReadyResponse<T> | PendingResponse;
+export interface PlStartInput {
+    goal: string;
+    maxIterations?: number;
+}
+export interface PlSubmitInput {
+    session_id: string;
+    plan: string;
+}
+export interface PlGetPlanInput {
+    session_id: string;
+}
+export interface PlFeedbackInput {
+    session_id: string;
+    rating: Rating;
+    content: string;
+}
+export interface PlGetFeedbackInput {
+    session_id: string;
+}
+export interface PlStatusInput {
+    session_id: string;
+}
+export interface PlListInput {
+    status?: SessionStatus | SessionStatus[];
+    sort?: 'createdAt' | 'updatedAt';
+    order?: 'asc' | 'desc';
+}
+export interface PlForceApproveInput {
+    session_id: string;
+    reason: string;
+}
+export interface PlDeleteInput {
+    session_id: string;
+    force?: boolean;
+}
+export interface PlStartOutput {
+    session_id: string;
+}
+export interface PlSubmitOutput {
+    version: number;
+    status: SessionStatus;
+}
+export interface PlFeedbackOutput {
+    status: SessionStatus;
+    iteration: number;
+}
+export interface PlForceApproveOutput {
+    status: 'approved';
+}
+export interface PlListOutput {
+    sessions: {
+        id: string;
+        goal: string;
+        status: SessionStatus;
+    }[];
+}
+export interface PlDeleteOutput {
+    deleted: true;
+    session_id: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Plan Loop MCP - Type Definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@joseph0926/plan-loop-core",
+  "version": "1.0.2",
+  "description": "Plan Loop MCP core library - state management and tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./state": {
+      "types": "./dist/state.d.ts",
+      "import": "./dist/state.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}