@doist/outline-cli 0.0.1 → 1.0.0

package/dist/lib/oauth-server.js

@@ -0,0 +1,203 @@
+import http from "node:http";
+export const DEFAULT_OAUTH_CALLBACK_PORT = 54969;
+function escapeHtml(text) {
+    return text
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+function renderPage(title, subtitle, body) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtml(title)} - Outline CLI</title>
+  <style>
+    :root {
+      --bg: #f5f7fb;
+      --surface: #ffffff;
+      --border: #e6e9f0;
+      --text: #1e2430;
+      --muted: #586178;
+      --ok: #15803d;
+      --ok-soft: #dcfce7;
+      --err: #b91c1c;
+      --err-soft: #fee2e2;
+      --radius: 14px;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      display: grid;
+      place-items: center;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+      background: radial-gradient(1200px 500px at 50% -10%, #dbeafe 0%, var(--bg) 60%);
+      color: var(--text);
+      line-height: 1.5;
+      padding: 20px;
+    }
+    .card {
+      width: min(560px, 100%);
+      background: var(--surface);
+      border: 1px solid var(--border);
+      border-radius: var(--radius);
+      padding: 24px;
+      box-shadow: 0 16px 40px rgba(15, 23, 42, 0.08);
+    }
+    h1 {
+      margin: 0 0 8px;
+      font-size: 24px;
+      letter-spacing: -0.01em;
+    }
+    .subtitle {
+      margin: 0 0 16px;
+      color: var(--muted);
+      font-size: 15px;
+    }
+    .message {
+      border-radius: 12px;
+      padding: 14px 16px;
+      font-size: 14px;
+    }
+    .success {
+      background: var(--ok-soft);
+      color: #14532d;
+    }
+    .error {
+      background: var(--err-soft);
+      color: #7f1d1d;
+    }
+    .hint {
+      margin-top: 14px;
+      color: var(--muted);
+      font-size: 13px;
+    }
+    code {
+      font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+      background: #eef2ff;
+      border-radius: 6px;
+      padding: 2px 6px;
+    }
+  </style>
+</head>
+<body>
+  <main class="card">
+    <h1>${escapeHtml(title)}</h1>
+    <p class="subtitle">${escapeHtml(subtitle)}</p>
+    ${body}
+    <p class="hint">Return to your terminal and continue with <code>ol</code> commands.</p>
+  </main>
+</body>
+</html>`;
+}
+function renderSuccessPage() {
+    return renderPage("Login complete", "Outline CLI is now authenticated.", '<div class="message success">You can close this tab now.</div>');
+}
+function renderErrorPage(message) {
+    return renderPage("Authentication failed", "Outline CLI could not finish OAuth login.", `<div class="message error">${escapeHtml(message)}</div>`);
+}
+export async function startOAuthCallbackServer(options) {
+    const { state, timeoutMs = 3 * 60 * 1000, port = DEFAULT_OAUTH_CALLBACK_PORT, } = options;
+    let origin = "http://localhost";
+    let resolved = false;
+    let resolveCode;
+    let rejectCode;
+    const waitForCode = new Promise((resolve, reject) => {
+        resolveCode = resolve;
+        rejectCode = reject;
+    });
+    const server = http.createServer((req, res) => {
+        if (resolved) {
+            res.writeHead(409, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(renderErrorPage("Authorization was already received."));
+            return;
+        }
+        if (req.method !== "GET" || !req.url) {
+            res.writeHead(405, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(renderErrorPage("Invalid callback request method."));
+            return;
+        }
+        const url = new URL(req.url, origin);
+        if (url.pathname !== "/callback") {
+            res.writeHead(404, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(renderErrorPage("Unknown callback path."));
+            return;
+        }
+        // Check for OAuth error response first
+        const error = url.searchParams.get("error");
+        if (error) {
+            const errorDescription = url.searchParams.get("error_description") || error;
+            res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(renderErrorPage(`Authorization failed: ${errorDescription}`));
+            rejectCode(new Error(`OAuth authorization denied: ${errorDescription}`));
+            resolved = true;
+            return;
+        }
+        const code = url.searchParams.get("code");
+        const returnedState = url.searchParams.get("state");
+        if (!code || !returnedState) {
+            res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(renderErrorPage("Missing OAuth code or state parameter."));
+            rejectCode(new Error("Missing OAuth authorization code."));
+            resolved = true;
+            return;
+        }
+        if (returnedState !== state) {
+            res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(renderErrorPage("Invalid OAuth state parameter."));
+            rejectCode(new Error("OAuth state mismatch."));
+            resolved = true;
+            return;
+        }
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(renderSuccessPage());
+        resolved = true;
+        resolveCode(code);
+    });
+    server.on("error", (err) => {
+        if (resolved)
+            return;
+        resolved = true;
+        rejectCode(err);
+    });
+    await new Promise((resolve, reject) => {
+        const onListening = () => {
+            server.off("error", onError);
+            resolve();
+        };
+        const onError = (err) => {
+            server.off("listening", onListening);
+            reject(err);
+        };
+        server.once("listening", onListening);
+        server.once("error", onError);
+        server.listen(port, "127.0.0.1");
+    });
+    const { port: listeningPort } = server.address();
+    origin = `http://localhost:${listeningPort}`;
+    const redirectUri = `${origin}/callback`;
+    const timeout = setTimeout(() => {
+        if (resolved)
+            return;
+        resolved = true;
+        rejectCode(new Error("Timed out waiting for OAuth callback."));
+        server.close();
+    }, timeoutMs);
+    const close = () => {
+        clearTimeout(timeout);
+        server.close();
+    };
+    waitForCode.then(() => {
+        clearTimeout(timeout);
+        server.close();
+    }, () => {
+        clearTimeout(timeout);
+        server.close();
+    });
+    return { port: listeningPort, redirectUri, waitForCode, close };
+}
+//# sourceMappingURL=oauth-server.js.map

package/dist/lib/oauth-server.js.map

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

package/dist/lib/oauth.d.ts

@@ -0,0 +1,17 @@
+interface AuthorizationUrlOptions {
+    baseUrl: string;
+    clientId: string;
+    redirectUri: string;
+    codeChallenge: string;
+    state: string;
+}
+interface TokenExchangeOptions {
+    baseUrl: string;
+    clientId: string;
+    redirectUri: string;
+    codeVerifier: string;
+    code: string;
+}
+export declare function buildAuthorizationUrl(options: AuthorizationUrlOptions): string;
+export declare function exchangeCodeForToken(options: TokenExchangeOptions): Promise<string>;
+export {};

package/dist/lib/oauth.js

@@ -0,0 +1,38 @@
+export function buildAuthorizationUrl(options) {
+    const { baseUrl, clientId, redirectUri, codeChallenge, state } = options;
+    const url = new URL(`${baseUrl}/oauth/authorize`);
+    url.searchParams.set("client_id", clientId);
+    url.searchParams.set("response_type", "code");
+    url.searchParams.set("code_challenge", codeChallenge);
+    url.searchParams.set("code_challenge_method", "S256");
+    url.searchParams.set("redirect_uri", redirectUri);
+    url.searchParams.set("state", state);
+    return url.toString();
+}
+export async function exchangeCodeForToken(options) {
+    const { baseUrl, clientId, redirectUri, codeVerifier, code } = options;
+    const params = new URLSearchParams({
+        grant_type: "authorization_code",
+        client_id: clientId,
+        redirect_uri: redirectUri,
+        code_verifier: codeVerifier,
+        code,
+    });
+    const res = await fetch(`${baseUrl}/oauth/token`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: params.toString(),
+    });
+    const json = (await res.json());
+    if (!res.ok) {
+        const message = json.error_description || json.message || json.error || res.statusText;
+        throw new Error(`OAuth token exchange failed: ${message}`);
+    }
+    if (!json.access_token) {
+        throw new Error("OAuth token exchange did not return an access token.");
+    }
+    return json.access_token;
+}
+//# sourceMappingURL=oauth.js.map

package/dist/lib/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../src/lib/oauth.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,qBAAqB,CACpC,OAAgC;IAEhC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACzE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO,kBAAkB,CAAC,CAAC;IAClD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACtD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IACtD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAClD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,OAA6B;IAE7B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QAClC,UAAU,EAAE,oBAAoB;QAChC,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,WAAW;QACzB,aAAa,EAAE,YAAY;QAC3B,IAAI;KACJ,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,cAAc,EAAE;QACjD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACR,cAAc,EAAE,mCAAmC;SACnD;QACD,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;KACvB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAkB,CAAC;IACjD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,OAAO,GACZ,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,IAAI,CAAC,YAAY,CAAC;AAC1B,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,11 @@
+import type { Pagination } from "./api.js";
+interface OutputOptions {
+    json?: boolean;
+    ndjson?: boolean;
+    full?: boolean;
+}
+export declare function getOutputOptions(opts: Record<string, unknown>): OutputOptions;
+export declare function outputItem<T extends object>(item: T, humanFormatter: (item: T) => string, essentialKeys?: (keyof T)[], opts?: OutputOptions): void;
+export declare function outputList<T extends object>(items: T[], humanFormatter: (item: T) => string, essentialKeys?: (keyof T)[], opts?: OutputOptions, pagination?: Pagination): void;
+export declare function formatError(code: string, message: string, hints?: string[]): string;
+export {};

package/dist/lib/output.js

@@ -0,0 +1,60 @@
+import chalk from "chalk";
+export function getOutputOptions(opts) {
+    return {
+        json: Boolean(opts.json),
+        ndjson: Boolean(opts.ndjson),
+        full: Boolean(opts.full),
+    };
+}
+export function outputItem(item, humanFormatter, essentialKeys, opts = {}) {
+    if (opts.ndjson) {
+        const data = opts.full || !essentialKeys ? item : pick(item, essentialKeys);
+        console.log(JSON.stringify(data));
+        return;
+    }
+    if (opts.json) {
+        const data = opts.full || !essentialKeys ? item : pick(item, essentialKeys);
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(humanFormatter(item));
+}
+export function outputList(items, humanFormatter, essentialKeys, opts = {}, pagination) {
+    if (opts.ndjson) {
+        for (const item of items) {
+            const data = opts.full || !essentialKeys ? item : pick(item, essentialKeys);
+            console.log(JSON.stringify(data));
+        }
+    }
+    else if (opts.json) {
+        const data = items.map((item) => opts.full || !essentialKeys ? item : pick(item, essentialKeys));
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        for (const item of items) {
+            console.log(humanFormatter(item));
+        }
+    }
+    if (pagination?.nextPath && !opts.ndjson) {
+        console.log(chalk.dim(`\n(more results available — use --offset ${pagination.offset + pagination.limit})`));
+    }
+}
+function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj)
+            result[key] = obj[key];
+    }
+    return result;
+}
+export function formatError(code, message, hints) {
+    const lines = [`Error: ${code}`, message];
+    if (hints && hints.length > 0) {
+        lines.push("");
+        for (const hint of hints) {
+            lines.push(`  - ${hint}`);
+        }
+    }
+    return chalk.red(lines.join("\n"));
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/dist/lib/pkce.d.ts

@@ -0,0 +1,3 @@
+export declare function generateCodeVerifier(): string;
+export declare function generateCodeChallenge(codeVerifier: string): string;
+export declare function generateState(): string;

package/dist/lib/pkce.js

@@ -0,0 +1,20 @@
+import { createHash, randomBytes } from "node:crypto";
+function base64UrlEncode(buffer) {
+    return buffer
+        .toString("base64")
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+export function generateCodeVerifier() {
+    // 64 bytes => 86 chars, within 43-128 requirement.
+    return base64UrlEncode(randomBytes(64));
+}
+export function generateCodeChallenge(codeVerifier) {
+    const hash = createHash("sha256").update(codeVerifier).digest();
+    return base64UrlEncode(hash);
+}
+export function generateState() {
+    return base64UrlEncode(randomBytes(32));
+}
+//# sourceMappingURL=pkce.js.map

package/dist/lib/pkce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.js","sourceRoot":"","sources":["../../src/lib/pkce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,SAAS,eAAe,CAAC,MAAc;IACtC,OAAO,MAAM;SACX,QAAQ,CAAC,QAAQ,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACzD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;IAChE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,OAAO,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/lib/refs.d.ts

@@ -0,0 +1,33 @@
+export interface Document {
+    id: string;
+    title: string;
+    url: string;
+    urlId: string;
+    text?: string;
+}
+export interface Collection {
+    id: string;
+    name: string;
+    description?: string;
+    color?: string;
+    permission?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    documentCount?: number;
+}
+/**
+ * Resolve a document reference by ID, URL, or name
+ */
+export declare function resolveDocumentRef(ref: string): Promise<Document>;
+/**
+ * Resolve a document reference and return just the ID
+ */
+export declare function resolveDocumentId(ref: string): Promise<string>;
+/**
+ * Resolve a collection reference by ID or name
+ */
+export declare function resolveCollectionRef(ref: string): Promise<Collection>;
+/**
+ * Resolve a collection reference and return just the ID
+ */
+export declare function resolveCollectionId(ref: string): Promise<string>;

package/dist/lib/refs.js

@@ -0,0 +1,180 @@
+import { apiRequest } from "./api.js";
+/**
+ * Check if the input looks like a UUID
+ */
+function isUuid(input) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(input);
+}
+/**
+ * Check if the input looks like an Outline ID (UUID or URL ID format)
+ */
+function looksLikeId(input) {
+    // UUID format
+    if (isUuid(input)) {
+        return true;
+    }
+    // Short alphanumeric ID (like urlId) - must be 6+ chars and no spaces
+    if (/^[a-zA-Z0-9]{6,}$/.test(input) && !/\s/.test(input)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract document ID from URL or slug (document-only)
+ * Only extracts from slugs (e.g., "my-doc-abc123" -> "abc123")
+ * Preserves full UUIDs and raw IDs
+ */
+function extractDocumentIdFromSlug(input) {
+    // Preserve UUIDs as-is
+    if (isUuid(input)) {
+        return input;
+    }
+    // If it looks like a URL, extract the slug suffix
+    const parts = input.replace(/\/$/, "").split("/");
+    const last = parts[parts.length - 1];
+    // Outline URL IDs are the part after the last hyphen in the slug
+    // Only extract if it's a slug with hyphen, not just a raw ID
+    const match = last.match(/-([a-zA-Z0-9]+)$/);
+    if (match)
+        return match[1];
+    return input;
+}
+/**
+ * Format suggestions for error messages
+ */
+function formatSuggestions(items, getName, getDisplayId, max = 5) {
+    const suggestions = items.slice(0, max);
+    return suggestions
+        .map((item) => `  - "${getName(item)}" (${getDisplayId(item)})`)
+        .join("\n");
+}
+/**
+ * Generic fuzzy reference resolver
+ */
+async function resolveRef(options) {
+    const { ref, fetchById, fetchAllPaginated, getName, getDisplayId, entityType, extractSlugId, } = options;
+    // Try direct ID lookup first if it looks like an ID
+    // Only extract slug ID for documents, not collections
+    const extractedId = extractSlugId ? extractDocumentIdFromSlug(ref) : ref;
+    if (looksLikeId(extractedId)) {
+        try {
+            return await fetchById(extractedId);
+        }
+        catch {
+            // If direct ID lookup fails, fall through to name matching
+        }
+    }
+    // Fetch all items with pagination and search by name
+    const items = await fetchAllPaginated();
+    const refLower = ref.toLowerCase();
+    // Try exact match first (case-insensitive)
+    const exactMatches = items.filter((item) => getName(item).toLowerCase() === refLower);
+    if (exactMatches.length === 1) {
+        return exactMatches[0];
+    }
+    // Multiple exact matches are ambiguous
+    if (exactMatches.length > 1) {
+        const suggestions = formatSuggestions(exactMatches, getName, getDisplayId);
+        throw new Error(`Ambiguous ${entityType} reference "${ref}". Multiple items have this exact name:\n${suggestions}`);
+    }
+    // Try partial match
+    const partialMatches = items.filter((item) => getName(item).toLowerCase().includes(refLower));
+    if (partialMatches.length === 1) {
+        return partialMatches[0];
+    }
+    if (partialMatches.length > 1) {
+        const suggestions = formatSuggestions(partialMatches, getName, getDisplayId);
+        throw new Error(`Ambiguous ${entityType} reference "${ref}". Did you mean:\n${suggestions}`);
+    }
+    // No matches found
+    throw new Error(`${entityType} not found: "${ref}"`);
+}
+/**
+ * Fetch all documents with pagination
+ */
+async function fetchAllDocuments() {
+    const allDocs = [];
+    const limit = 100;
+    let offset = 0;
+    while (true) {
+        const { data } = await apiRequest("documents.list", {
+            limit,
+            offset,
+        });
+        allDocs.push(...data);
+        if (data.length < limit) {
+            break;
+        }
+        offset += limit;
+    }
+    return allDocs;
+}
+/**
+ * Fetch all collections with pagination
+ */
+async function fetchAllCollections() {
+    const allCollections = [];
+    const limit = 100;
+    let offset = 0;
+    while (true) {
+        const { data } = await apiRequest("collections.list", {
+            limit,
+            offset,
+        });
+        allCollections.push(...data);
+        if (data.length < limit) {
+            break;
+        }
+        offset += limit;
+    }
+    return allCollections;
+}
+/**
+ * Resolve a document reference by ID, URL, or name
+ */
+export async function resolveDocumentRef(ref) {
+    return resolveRef({
+        ref,
+        fetchById: async (id) => {
+            const { data } = await apiRequest("documents.info", { id });
+            return data;
+        },
+        fetchAllPaginated: fetchAllDocuments,
+        getName: (doc) => doc.title,
+        getDisplayId: (doc) => doc.urlId,
+        entityType: "Document",
+        extractSlugId: true,
+    });
+}
+/**
+ * Resolve a document reference and return just the ID
+ */
+export async function resolveDocumentId(ref) {
+    const doc = await resolveDocumentRef(ref);
+    return doc.id;
+}
+/**
+ * Resolve a collection reference by ID or name
+ */
+export async function resolveCollectionRef(ref) {
+    return resolveRef({
+        ref,
+        fetchById: async (id) => {
+            const { data } = await apiRequest("collections.info", { id });
+            return data;
+        },
+        fetchAllPaginated: fetchAllCollections,
+        getName: (col) => col.name,
+        getDisplayId: (col) => col.id,
+        entityType: "Collection",
+        extractSlugId: false,
+    });
+}
+/**
+ * Resolve a collection reference and return just the ID
+ */
+export async function resolveCollectionId(ref) {
+    const col = await resolveCollectionRef(ref);
+    return col.id;
+}
+//# sourceMappingURL=refs.js.map

package/dist/lib/refs.js.map

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

package/dist/lib/skills/content.d.ts

@@ -0,0 +1,3 @@
+export declare const SKILL_NAME = "outline";
+export declare const SKILL_DESCRIPTION = "Search and manage Outline wiki documents and collections via the ol CLI";
+export declare const SKILL_CONTENT = "# Outline CLI (ol)\n\nUse this skill when the user wants to interact with their Outline wiki/knowledge base.\n\n## Quick Reference\n\n- `ol search \"query\"` - Search documents\n- `ol doc list` - List documents\n- `ol doc get <id>` - Read a document\n- `ol doc open <id>` - Open document in browser\n- `ol doc create --title \"Title\" --collection <id>` - Create document\n- `ol col list` - List collections\n\n## Output Formats\n\nAll list commands support:\n- `--json` - JSON output (essential fields)\n- `--ndjson` - Newline-delimited JSON (streaming)\n- `--full` - Include all fields in JSON\n\n## Document References\n\nDocuments can be referenced by:\n- URL ID (the slug suffix after the last hyphen)\n- Full Outline URL (auto-extracted)\n- Document ID\n\n## Commands\n\n### Search\n```bash\nol search \"query\"\nol search \"query\" --limit 10\nol search \"query\" --collection <id>\nol search \"query\" --status published\nol search \"query\" --json\n```\n\n### Documents\n```bash\nol doc list --collection <id> --limit 25\nol doc list --sort title --direction ASC\nol doc get <id>                           # Rendered markdown\nol doc get <id> --raw                     # Raw markdown\nol doc get <id> --json\nol doc open <id>                          # Open in browser\nol doc create --title \"Title\" --collection <id> --text \"# Content\"\nol doc create --title \"Title\" --collection <id> --file ./doc.md\nol doc update <id> --title \"New Title\"\nol doc update <id> --file ./updated.md\nol doc move <id> --collection <target-id>\nol doc archive <id>\nol doc unarchive <id>\nol doc delete <id> --confirm\n```\n\n### Collections\n```bash\nol col list\nol col get <id>\nol col create --name \"Name\" --description \"Desc\" --color \"#hex\"\nol col create --name \"Private\" --private\nol col update <id> --name \"New Name\"\nol col delete <id> --confirm\n```\n\n### Authentication\n```bash\nol auth login                 # Configure API token and base URL\nol auth status                # Show current auth state\nol auth logout                # Clear saved credentials\n```\n\n## Examples\n\n### Find and read a document\n```bash\nol search \"onboarding\" --json | jq '.[0].document.urlId'\nol doc get <urlId>\n```\n\n### Create a document from a file\n```bash\nol doc create --title \"Meeting Notes\" --collection <id> --file ./notes.md --publish\n```\n\n### List all collections and their documents\n```bash\nol col list --json\nol doc list --collection <id> --sort title --direction ASC\n```\n\n### Bulk export with ndjson\n```bash\nol doc list --ndjson --full | jq -r '.title'\n```\n";