@thenavidm/threads-mcp-cli 1.1.1 → 2.0.0

package/dist/tools/kit.d.ts

@@ -1,51 +1,29 @@
 /**
- * Shared plumbing every tool uses.
+ * Shared plumbing every tool uses, now on Slipway.
  *
- * Registering thirty tools by hand is thirty chances to forget an annotation,
- * leak a stack trace, or return a shape the model cannot read. This wraps all
- * of it once so a tool module only describes what it actually does.
+ * Tool modules keep describing themselves with a Zod shape, a risk and a
+ * handler. This adapter turns each into a Slipway tool, so the MCP server, the
+ * CLI, the write guard, annotations and errors all come from the framework
+ * instead of a copy kept in this repo.
  */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z, type ZodRawShape } from "zod";
+import { z, type Risk, type SlipwayError, type Tool } from "@thenavidm/slipway";
 import type { ThreadsClient } from "../api/client.js";
+import { ThreadsError } from "../api/errors.js";
 import type { Account, Config } from "../config.js";
-import { type Risk, type WriteGuard } from "../safety.js";
 export type ToolContext = {
     client: ThreadsClient;
     config: Config;
-    guard: WriteGuard;
     /** Resolve which profile this call acts as. */
     account: (hint?: string) => Account;
 };
-export type ToolResult = {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: boolean;
-};
-/**
- * A tool returns either a pre-rendered string or a value to serialise.
- *
- * The reading tools return the tagged format from `format/posts.ts`, which is
- * already text. The writing tools return a small object, an id and a permalink,
- * where JSON is clearer than tags. Both go through here so neither has to think
- * about the MCP content envelope.
- */
-export declare function ok(data: unknown): ToolResult;
-/**
- * Errors come back as a normal result with `isError`, not a thrown exception.
- *
- * A thrown MCP error reaches the model as a protocol failure with no structure.
- * A result it can read tells it what went wrong and usually how to fix it,
- * which is the difference between a correct retry and a give-up.
- */
-export declare function fail(error: unknown): ToolResult;
 /** The optional argument that picks a profile, on every account-scoped tool. */
 export declare const accountArg: {
     account: z.ZodOptional<z.ZodString>;
 };
-/** The confirmation argument required by every public or irreversible tool. */
+/**
+ * Kept so tool modules read the same, but never sent: Slipway adds `confirm`
+ * to every irreversible tool itself, with one description everywhere.
+ */
 export declare const confirmArg: {
     confirm: z.ZodOptional<z.ZodBoolean>;
 };
@@ -54,7 +32,8 @@ export declare const pageArgs: {
     limit: z.ZodOptional<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
 };
-export type ToolSpec<S extends ZodRawShape> = {
+type Shape = Record<string, z.ZodType>;
+export type ToolSpec<S extends Shape> = {
     name: string;
     /** One line, imperative. Shown in tool pickers. */
     title: string;
@@ -67,24 +46,19 @@ export type ToolSpec<S extends ZodRawShape> = {
     /** One line for the audit log and the confirm message, when this is a write. */
     summary?: (args: z.infer<z.ZodObject<S>>) => string;
 };
-export declare function defineTool<S extends ZodRawShape>(spec: ToolSpec<S>): ToolSpec<S>;
+export type AnyToolSpec = Tool<ToolContext>;
 /**
- * A tool of any shape, for the one place tools are held together in a list.
- *
- * `ToolSpec` is generic over its schema, so a list of tools with different
- * schemas has no single type: each handler takes a different argument shape and
- * function parameters are contravariant. The type safety that matters lives
- * inside each `defineTool` call, where schema and handler are checked against
- * each other. This only loosens the seam where they are collected.
+ * Meta answers almost every failure with HTTP 400, an expired token and a
+ * spent quota included, and puts what happened in `code` and `error_subcode`.
+ * `api/errors.ts` already sorts them into classes, so the exit code and error
+ * code follow the class, not the status, and Meta's own fields ride along in
+ * `details` for the model to read.
  */
-export type AnyToolSpec = Omit<ToolSpec<ZodRawShape>, "handler" | "summary"> & {
-    handler: (args: never, ctx: ToolContext) => Promise<unknown>;
-    summary?: (args: never) => string;
-};
-/** Register one tool against the server, with guarding and error handling applied. */
-export declare function register(server: McpServer, contextFor: (extra: unknown) => ToolContext, spec: AnyToolSpec): void;
-export declare function makeContext(client: ThreadsClient, config: Config, guard: WriteGuard): ToolContext;
+export declare function toSlipway(error: ThreadsError): SlipwayError;
+export declare function defineTool<S extends Shape>(spec: ToolSpec<S>): Tool<ToolContext>;
+export declare function makeContext(client: ThreadsClient, config: Config): ToolContext;
 /** Clamp a caller-supplied limit into a range Threads will accept. */
 export declare function clamp(value: number | undefined, fallback: number, max?: number): number;
 /** Trim a summary to one readable line for the audit log. */
 export declare function snippet(text: string | undefined, length?: number): string;
+export {};

package/dist/tools/kit.js

@@ -1,39 +1,15 @@
 /**
- * Shared plumbing every tool uses.
+ * Shared plumbing every tool uses, now on Slipway.
  *
- * Registering thirty tools by hand is thirty chances to forget an annotation,
- * leak a stack trace, or return a shape the model cannot read. This wraps all
- * of it once so a tool module only describes what it actually does.
+ * Tool modules keep describing themselves with a Zod shape, a risk and a
+ * handler. This adapter turns each into a Slipway tool, so the MCP server, the
+ * CLI, the write guard, annotations and errors all come from the framework
+ * instead of a copy kept in this repo.
  */
-import { z } from "zod";
-import { ThreadsError } from "../api/errors.js";
+import { ApiError, AuthError, NotFoundError as SlipwayNotFound, RateLimitError as SlipwayRateLimit, RefusedError, TimeoutError as SlipwayTimeout, toolkit, UsageError, z, } from "@thenavidm/slipway";
+import { AuthenticationError, NotFoundError, PermissionError, RateLimitError, TextTooLongError, ThreadsError, TimeoutError, ValidationError, WriteBlockedError, } from "../api/errors.js";
 import { selectAccount } from "../config.js";
-import { annotationsFor } from "../safety.js";
-/**
- * A tool returns either a pre-rendered string or a value to serialise.
- *
- * The reading tools return the tagged format from `format/posts.ts`, which is
- * already text. The writing tools return a small object, an id and a permalink,
- * where JSON is clearer than tags. Both go through here so neither has to think
- * about the MCP content envelope.
- */
-export function ok(data) {
-    const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
-    return { content: [{ type: "text", text }] };
-}
-/**
- * Errors come back as a normal result with `isError`, not a thrown exception.
- *
- * A thrown MCP error reaches the model as a protocol failure with no structure.
- * A result it can read tells it what went wrong and usually how to fix it,
- * which is the difference between a correct retry and a give-up.
- */
-export function fail(error) {
-    const payload = error instanceof ThreadsError
-        ? error.toJSON()
-        : { error: error?.message ?? String(error) };
-    return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }], isError: true };
-}
+const kit = toolkit();
 /** The optional argument that picks a profile, on every account-scoped tool. */
 export const accountArg = {
     account: z
@@ -41,67 +17,76 @@ export const accountArg = {
         .optional()
         .describe("Which connected Threads profile to act as, by username (for example 'thenavidm'). Defaults to the first connected profile. Call list_accounts to see them."),
 };
-/** The confirmation argument required by every public or irreversible tool. */
+/**
+ * Kept so tool modules read the same, but never sent: Slipway adds `confirm`
+ * to every irreversible tool itself, with one description everywhere.
+ */
 export const confirmArg = {
-    confirm: z
-        .boolean()
-        .optional()
-        .describe("Must be true for this to run. The result is public immediately or cannot be undone, so it is refused without an explicit confirmation. Threads has no edit endpoint and no unsend."),
+    confirm: z.boolean().optional(),
 };
 /** Cursor and limit, on every paginating tool. */
 export const pageArgs = {
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(100)
-        .optional()
-        .describe("How many to return, 1-100."),
+    limit: z.number().int().min(1).max(100).optional().describe("How many to return, 1-100."),
     cursor: z
         .string()
         .optional()
         .describe("Continue from a previous page. Pass the `cursor` attribute from the last result."),
 };
-export function defineTool(spec) {
-    return spec;
+/**
+ * Meta answers almost every failure with HTTP 400, an expired token and a
+ * spent quota included, and puts what happened in `code` and `error_subcode`.
+ * `api/errors.ts` already sorts them into classes, so the exit code and error
+ * code follow the class, not the status, and Meta's own fields ride along in
+ * `details` for the model to read.
+ */
+export function toSlipway(error) {
+    const details = Object.fromEntries(Object.entries({
+        endpoint: error.endpoint,
+        meta_code: error.code || undefined,
+        meta_subcode: error.subcode || undefined,
+        meta_type: error.type || undefined,
+        detail: error.detail || undefined,
+        trace_id: error.traceId || undefined,
+    }).filter(([, value]) => value !== undefined));
+    const options = { ...(error.status ? { status: error.status } : {}), details, cause: error };
+    if (error instanceof AuthenticationError || error instanceof PermissionError)
+        return new AuthError(error.message, options);
+    if (error instanceof NotFoundError)
+        return new SlipwayNotFound(error.message, options);
+    if (error instanceof RateLimitError)
+        return new SlipwayRateLimit(error.message, options);
+    if (error instanceof ValidationError || error instanceof TextTooLongError)
+        return new UsageError(error.message, options);
+    if (error instanceof WriteBlockedError)
+        return new RefusedError(error.message, options);
+    if (error instanceof TimeoutError)
+        return new SlipwayTimeout(error.message, options);
+    // A server error, a container that never finished processing, or no answer at all: the service's failure, worth a retry.
+    return new ApiError(error.message, options);
 }
-/** Register one tool against the server, with guarding and error handling applied. */
-export function register(server, contextFor, spec) {
-    server.registerTool(spec.name, {
+export function defineTool(spec) {
+    const { confirm: _confirm, ...shape } = spec.schema;
+    const handler = spec.handler;
+    return kit.defineTool({
+        name: spec.name,
         title: spec.title,
         description: spec.description,
-        inputSchema: spec.schema,
-        annotations: {
-            title: spec.title,
-            ...annotationsFor(spec.risk, { idempotent: spec.idempotent }),
-        },
-    }, 
-    // The SDK derives its callback type from the schema generic. This wrapper is
-    // generic over the same shape, but TypeScript cannot prove the two are equal
-    // through the indirection, so the cast lives at this single boundary rather
-    // than in every tool definition.
-    (async (args, extra) => {
-        try {
-            const ctx = contextFor(extra);
-            if (spec.risk !== "read") {
-                const summary = spec.summary?.(args) ?? spec.name;
-                const confirm = args.confirm;
-                ctx.guard.check(spec.name, spec.risk, confirm, summary);
+        input: z.object(shape),
+        risk: spec.risk,
+        ...(spec.idempotent !== undefined ? { idempotent: spec.idempotent } : {}),
+        ...(spec.summary ? { summary: spec.summary } : {}),
+        handler: async (args, ctx) => {
+            try {
+                return await handler(args, ctx);
             }
-            return ok(await spec.handler(args, ctx));
-        }
-        catch (error) {
-            return fail(error);
-        }
-    }));
+            catch (error) {
+                throw error instanceof ThreadsError ? toSlipway(error) : error;
+            }
+        },
+    });
 }
-export function makeContext(client, config, guard) {
-    return {
-        client,
-        config,
-        guard,
-        account: (hint) => selectAccount(config, hint),
-    };
+export function makeContext(client, config) {
+    return { client, config, account: (hint) => selectAccount(config, hint) };
 }
 /** Clamp a caller-supplied limit into a range Threads will accept. */
 export function clamp(value, fallback, max = 100) {

package/dist/tools/kit.js.map

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

package/dist/tools/posts.d.ts

@@ -7,164 +7,13 @@
  * has: invisible, valid for 24 hours, publishable later by id. That is exactly
  * what an agent needs when a human wants to see something before it is public.
  */
-import { z } from "zod";
-export declare const createPost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}>;
-export declare const createThread: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    posts: z.ZodArray<z.ZodString, "many">;
-}>;
-export declare const createCarousel: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    items: z.ZodArray<z.ZodObject<{
-        image_url: z.ZodOptional<z.ZodString>;
-        video_url: z.ZodOptional<z.ZodString>;
-        alt_text: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }>, "many">;
-    text: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-}>;
-export declare const stagePost: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}>;
-export declare const publishStaged: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}>;
-export declare const getContainerStatus: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}>;
-export declare const quotePost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    text: z.ZodString;
-    quoted_post_id: z.ZodString;
-}>;
-export declare const repost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>;
-export declare const deletePost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>;
-export declare const POST_TOOLS: (import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    posts: z.ZodArray<z.ZodString, "many">;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    items: z.ZodArray<z.ZodObject<{
-        image_url: z.ZodOptional<z.ZodString>;
-        video_url: z.ZodOptional<z.ZodString>;
-        alt_text: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }>, "many">;
-    text: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    text: z.ZodString;
-    quoted_post_id: z.ZodString;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>)[];
+export declare const createPost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const createThread: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const createCarousel: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const stagePost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const publishStaged: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getContainerStatus: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const quotePost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const repost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const deletePost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const POST_TOOLS: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>[];

package/dist/tools/read.d.ts

@@ -5,27 +5,6 @@
  * because "what did I post this week" is a question about time and turning it
  * into a guess at a post count is how you end up missing half of it.
  */
-import { z } from "zod";
-export declare const getPosts: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-    since: z.ZodOptional<z.ZodString>;
-    until: z.ZodOptional<z.ZodString>;
-}>;
-export declare const getPost: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>;
-export declare const READ_TOOLS: (import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-    since: z.ZodOptional<z.ZodString>;
-    until: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>)[];
+export declare const getPosts: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getPost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const READ_TOOLS: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>[];

package/dist/tools/replies.d.ts

@@ -11,82 +11,11 @@
  * The third is the one an agent actually wants when asked "what needs
  * answering", and it is the one nothing surfaces by default.
  */
-import { z } from "zod";
-export declare const replyToPost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    text: z.ZodString;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-}>;
-export declare const getReplies: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-}>;
-export declare const getConversation: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-}>;
-export declare const getAllReplies: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-}>;
-export declare const hideReply: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    hide: z.ZodOptional<z.ZodBoolean>;
-}>;
-export declare const getPendingReplies: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-}>;
-export declare const managePendingReply: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    action: z.ZodEnum<["approve", "ignore"]>;
-}>;
-export declare const REPLY_TOOLS: (import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    text: z.ZodString;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    hide: z.ZodOptional<z.ZodBoolean>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    action: z.ZodEnum<["approve", "ignore"]>;
-}>)[];
+export declare const replyToPost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getReplies: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getConversation: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getAllReplies: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const hideReply: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getPendingReplies: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const managePendingReply: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const REPLY_TOOLS: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>[];