@talocode/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,398 @@
+export interface UsageMeta {
+    credits: number;
+    action: string;
+}
+export interface ApiErrorShape {
+    code: string;
+    message: string;
+    requestId?: string;
+    details?: Record<string, unknown>;
+    required?: number;
+    available?: number;
+}
+export interface TeraRewriteInput {
+    text: string;
+    style?: string;
+    tone?: string;
+    maxLength?: number;
+}
+export interface TeraRewriteResult {
+    text: string;
+    notes: string[];
+}
+export interface TeraDraftInput {
+    type: 'email' | 'social_post' | 'announcement' | 'article' | 'doc' | 'custom';
+    brief: string;
+    audience?: string;
+    tone?: string;
+    maxLength?: number;
+    customType?: string;
+    points?: string[];
+}
+export interface TeraDraftResult {
+    text: string;
+    notes: string[];
+}
+export interface TeraExplainInput {
+    language: string;
+    code: string;
+    level?: 'beginner' | 'intermediate' | 'advanced';
+    focus?: string[];
+}
+export interface TeraExplainResult {
+    explanation: string;
+    keyConcepts: string[];
+    suggestions?: string[];
+}
+export interface TeraReviewInput {
+    language: string;
+    code: string;
+    focus?: string[];
+    strictness?: 'gentle' | 'normal' | 'strict';
+}
+export interface TeraReviewResult {
+    issues: TeraReviewIssue[];
+    summary: string;
+    score: number;
+}
+export interface TeraReviewIssue {
+    severity: 'critical' | 'warning' | 'info';
+    category: string;
+    title: string;
+    description: string;
+    line?: number;
+    suggestion?: string;
+}
+export interface TeraCapabilityEntry {
+    id: string;
+    object: string;
+    description: string;
+    credits: number;
+    methods: string[];
+    routes: string[];
+}
+export interface TeraPricingEntry {
+    action: string;
+    credits: number;
+    usdValue: number;
+}
+export interface TeraSuccessResponse<T> {
+    id: string;
+    object: string;
+    result: T;
+    usage: UsageMeta;
+}
+export interface TeraListResponse<T> {
+    object: 'list';
+    data: T[];
+}
+export interface TeraHealthResponse {
+    status: string;
+    version: string;
+    endpoints: string[];
+}
+export interface RouterChatInput {
+    model: string;
+    messages: RouterMessage[];
+    max_tokens?: number;
+    temperature?: number;
+    stream?: boolean;
+    requestId?: string;
+}
+export interface RouterMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface RouterChatResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    provider: string;
+    choices: RouterChoice[];
+    usage: RouterUsage;
+}
+export interface RouterChoice {
+    index: number;
+    message: RouterMessage;
+    finish_reason: string;
+}
+export interface RouterUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface RouterModel {
+    id: string;
+    object: string;
+    created: number;
+    owned_by: string;
+    context_length?: number;
+}
+export interface RouterModelsResponse {
+    object: 'list';
+    data: RouterModel[];
+}
+export interface RouterHealthResponse {
+    status: string;
+    provider: string;
+    model: string;
+    requestId: string;
+}
+export interface RouterProviderInfo {
+    name: string;
+    status: string;
+    models: string[];
+}
+export interface RouterProvidersResponse {
+    object: 'list';
+    data: RouterProviderInfo[];
+}
+export interface AgentBrowserCheckInput {
+    url: string;
+    screenshot?: boolean;
+    vision?: boolean;
+    sessionId?: string;
+}
+export interface AgentBrowserCheckResult {
+    status: 'up' | 'down' | 'error';
+    statusCode: number;
+    title?: string;
+    screenshot?: string;
+    vision?: string;
+    checks: AgentBrowserCheck[];
+    durationMs: number;
+    url: string;
+    finalUrl?: string;
+}
+export interface AgentBrowserCheck {
+    name: string;
+    passed: boolean;
+    detail?: string;
+}
+export interface AgentBrowserScreenshotInput {
+    url: string;
+    fullPage?: boolean;
+    width?: number;
+    height?: number;
+    sessionId?: string;
+}
+export interface AgentBrowserScreenshotResult {
+    url: string;
+    screenshot: string;
+    width: number;
+    height: number;
+    durationMs: number;
+}
+export interface AgentBrowserTraceReportInput {
+    url: string;
+    sessionId?: string;
+    steps: {
+        action: string;
+        selector?: string;
+        value?: string;
+    }[];
+}
+export interface AgentBrowserTraceReportResult {
+    url: string;
+    steps: number;
+    passed: number;
+    failed: number;
+    durationMs: number;
+    reportUrl?: string;
+}
+export interface ClipLoopBriefInput {
+    prompt: string;
+    channel?: 'youtube' | 'tiktok' | 'instagram' | 'twitter' | 'linkedin';
+    tone?: string;
+    duration?: number;
+    cta?: string;
+}
+export interface ClipLoopBriefResult {
+    id: string;
+    brief: string;
+    channel: string;
+    estimatedDuration: number;
+}
+export interface ClipLoopScriptInput {
+    briefId: string;
+    style?: string;
+}
+export interface ClipLoopScriptResult {
+    id: string;
+    script: string;
+    scenes: ClipLoopScriptScene[];
+}
+export interface ClipLoopScriptScene {
+    index: number;
+    visual: string;
+    narration: string;
+    duration: number;
+}
+export interface ClipLoopVideoRenderInput {
+    scriptId: string;
+    format?: 'portrait' | 'landscape' | 'square';
+    quality?: 'draft' | 'standard' | 'high';
+}
+export interface ClipLoopVideoRenderResult {
+    id: string;
+    status: 'rendering' | 'completed' | 'failed';
+    url?: string;
+    duration: number;
+    creditsCharged: number;
+}
+export interface ClipLoopCampaignCreateInput {
+    name: string;
+    platform: string;
+    schedule?: string;
+}
+export interface ClipLoopCampaignResult {
+    id: string;
+    name: string;
+    status: string;
+    videos: string[];
+}
+export interface CodraFileInput {
+    path: string;
+    content: string;
+}
+export interface CodraRepoSummaryInput {
+    files: CodraFileInput[];
+    focus?: string[];
+}
+export interface CodraRepoSummaryResult {
+    summary: string;
+    architecture: string[];
+    risks: string[];
+    nextSteps: string[];
+}
+export interface CodraExplainInput {
+    language: string;
+    code: string;
+    level?: 'beginner' | 'intermediate' | 'expert';
+}
+export interface CodraExplainResult {
+    explanation: string;
+    keyConcepts: string[];
+    suggestions?: string[];
+}
+export interface CodraReviewInput {
+    language: string;
+    code: string;
+    focus?: string[];
+    strictness?: 'gentle' | 'normal' | 'strict';
+}
+export interface CodraReviewResult {
+    issues: CodraReviewIssue[];
+    summary: string;
+    score: number;
+}
+export interface CodraReviewIssue {
+    severity: 'critical' | 'warning' | 'info';
+    category: string;
+    title: string;
+    description: string;
+    line?: number;
+    suggestion?: string;
+}
+export interface CodraPlanInput {
+    task: string;
+    context?: string;
+    constraints?: string[];
+}
+export interface CodraPlanResult {
+    plan: string;
+    steps: CodraPlanStep[];
+    risks: string[];
+    estimatedEffort: string;
+}
+export interface CodraPlanStep {
+    order: number;
+    title: string;
+    description: string;
+    files?: string[];
+    effort: 'small' | 'medium' | 'large';
+}
+export interface CodraSuccessResponse<T> {
+    id: string;
+    object: string;
+    result: T;
+    usage: {
+        credits: number;
+        action: string;
+    };
+}
+export interface SkillsGenerateProfileInput {
+    username: string;
+    target: 'cursor' | 'claude' | 'opencode' | 'codra';
+    focus?: string[];
+    includeRepositories?: boolean;
+    maxRepositories?: number;
+}
+export interface SkillsGenerateRepoInput {
+    repoUrl: string;
+    target: 'cursor' | 'claude' | 'opencode' | 'codra';
+    focus?: string[];
+}
+export interface SkillsGenerateDocsInput {
+    url: string;
+    target: 'cursor' | 'claude' | 'opencode' | 'codra';
+    focus?: string[];
+}
+export interface SkillsGenerateTextInput {
+    name: string;
+    content: string;
+    target: 'cursor' | 'claude' | 'opencode' | 'codra';
+    focus?: string[];
+}
+export interface SkillsExportInput {
+    skill: {
+        name: string;
+        skillMd: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface SkillsExportFile {
+    path: string;
+    content: string;
+}
+export interface SkillsExportResult {
+    files: SkillsExportFile[];
+}
+export interface SkillsGenerated {
+    name: string;
+    title: string;
+    description: string;
+    skillMd: string;
+    references?: {
+        path: string;
+        content: string;
+    }[];
+    metadata: Record<string, unknown>;
+}
+export interface SkillsGenerateResult {
+    id: string;
+    object: string;
+    source: {
+        type: 'github_profile' | 'github_repo' | 'docs' | 'text';
+        username?: string;
+        repoUrl?: string;
+        url?: string;
+        name?: string;
+    };
+    skill: SkillsGenerated;
+    exports: {
+        cursor?: {
+            files: SkillsExportFile[];
+        };
+        claude?: {
+            files: SkillsExportFile[];
+        };
+    };
+    usage: UsageMeta;
+}
+export interface SkillsHealthResponse {
+    status: string;
+    version: string;
+    endpoints: string[];
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Common ───
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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,iBAAiB"}

package/dist/ugclane.d.ts

@@ -0,0 +1,105 @@
+import { TalocodeApiClient } from './talocode.js';
+export interface UGCLaneStrategyInput {
+    goal: string;
+    niche?: string;
+    platform?: string;
+    constraints?: string[];
+}
+export interface UGCLaneCompetitorInput {
+    competitors: string[];
+    niche?: string;
+    depth?: 'basic' | 'detailed' | 'deep';
+}
+export interface UGCLaneHooksInput {
+    topic: string;
+    platform?: string;
+    count?: number;
+    tone?: string;
+}
+export interface UGCLaneScriptsInput {
+    topic: string;
+    format?: 'short' | 'long' | 'series';
+    platform?: string;
+    tone?: string;
+    cta?: string;
+}
+export interface UGCLaneAccountsPlanInput {
+    platform: string;
+    goal: string;
+    metrics?: Record<string, unknown>;
+    timeline?: string;
+}
+export interface UGCLaneCalendarInput {
+    platform: string;
+    month?: string;
+    goals?: string[];
+    themes?: string[];
+    postFrequency?: string;
+}
+export interface UGCLaneExperimentsInput {
+    platform: string;
+    goal: string;
+    variables?: string[];
+    durationDays?: number;
+}
+export interface UGCLaneReportInput {
+    platform: string;
+    period: string;
+    metrics: Record<string, unknown>;
+    goal?: string;
+}
+export interface UGCLaneExportMarkdownInput {
+    content: Record<string, unknown>;
+    title?: string;
+    sections?: string[];
+}
+export interface UGCLaneExportJsonInput {
+    content: Record<string, unknown>;
+    format?: 'pretty' | 'compact';
+}
+export interface UGCLaneResponse<T> {
+    data: T;
+    usage: {
+        action: string;
+        credits: number;
+        remaining: number;
+    };
+}
+export declare class UGCLaneClient {
+    private api;
+    constructor(api: TalocodeApiClient);
+    health(): Promise<{
+        ok: boolean;
+        service: string;
+        version: string;
+        timestamp: string;
+    }>;
+    strategy: {
+        generate: (input: UGCLaneStrategyInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    competitor: {
+        analyze: (input: UGCLaneCompetitorInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    hooks: {
+        generate: (input: UGCLaneHooksInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    scripts: {
+        generate: (input: UGCLaneScriptsInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    accounts: {
+        plan: (input: UGCLaneAccountsPlanInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    calendar: {
+        generate: (input: UGCLaneCalendarInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    experiments: {
+        generate: (input: UGCLaneExperimentsInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    report: {
+        generate: (input: UGCLaneReportInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+    export: {
+        markdown: (input: UGCLaneExportMarkdownInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+        json: (input: UGCLaneExportJsonInput) => Promise<UGCLaneResponse<Record<string, unknown>>>;
+    };
+}

package/dist/ugclane.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UGCLaneClient = void 0;
+class UGCLaneClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async health() {
+        const res = await this.api.request('/v1/ugclane/health');
+        return res;
+    }
+    strategy = {
+        generate: async (input) => {
+            return this.api.request('/v1/ugclane/strategy/generate', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    competitor = {
+        analyze: async (input) => {
+            return this.api.request('/v1/ugclane/competitor/analyze', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    hooks = {
+        generate: async (input) => {
+            return this.api.request('/v1/ugclane/hooks/generate', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    scripts = {
+        generate: async (input) => {
+            return this.api.request('/v1/ugclane/scripts/generate', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    accounts = {
+        plan: async (input) => {
+            return this.api.request('/v1/ugclane/accounts/plan', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    calendar = {
+        generate: async (input) => {
+            return this.api.request('/v1/ugclane/calendar/generate', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    experiments = {
+        generate: async (input) => {
+            return this.api.request('/v1/ugclane/experiments/generate', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    report = {
+        generate: async (input) => {
+            return this.api.request('/v1/ugclane/report/generate', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+    export = {
+        markdown: async (input) => {
+            return this.api.request('/v1/ugclane/export/markdown', {
+                method: 'POST',
+                body: input,
+            });
+        },
+        json: async (input) => {
+            return this.api.request('/v1/ugclane/export/json', {
+                method: 'POST',
+                body: input,
+            });
+        },
+    };
+}
+exports.UGCLaneClient = UGCLaneClient;
+//# sourceMappingURL=ugclane.js.map

package/dist/ugclane.js.map

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

package/dist/webdatalane.d.ts

@@ -0,0 +1,74 @@
+import { TalocodeApiClient } from './talocode.js';
+export interface WebDataLaneFetchInput {
+    url: string;
+    timeoutMs?: number;
+    userAgent?: string;
+    maxBytes?: number;
+}
+export interface WebDataLaneExtractInput {
+    url?: string;
+    html?: string;
+    include?: string[];
+    timeoutMs?: number;
+}
+export interface WebDataLaneMarkdownInput {
+    url?: string;
+    html?: string;
+    stripNavigation?: boolean;
+    includeLinks?: boolean;
+}
+export interface WebDataLaneMetadataInput {
+    url?: string;
+    html?: string;
+}
+export interface WebDataLaneLinksInput {
+    url?: string;
+    html?: string;
+    internalOnly?: boolean;
+}
+export interface WebDataLaneStructuredInput {
+    url?: string;
+    html?: string;
+    schema: Record<string, string>;
+    hints?: Record<string, string[]>;
+}
+export interface WebDataLaneCrawlPlanInput {
+    url?: string;
+    html?: string;
+    maxPages?: number;
+    sameDomainOnly?: boolean;
+    includePatterns?: string[];
+    excludePatterns?: string[];
+}
+export interface WebDataLaneScreenshotInput {
+    url: string;
+    width?: number;
+    height?: number;
+    fullPage?: boolean;
+}
+export interface WebDataLaneResponse<T> {
+    data: T;
+    usage: {
+        action: string;
+        credits: number;
+        remaining: number;
+    };
+}
+export declare class WebDataLaneClient {
+    private api;
+    constructor(api: TalocodeApiClient);
+    health(): Promise<{
+        ok: boolean;
+        service: string;
+        version: string;
+        timestamp: string;
+    }>;
+    fetch(input: WebDataLaneFetchInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    extract(input: WebDataLaneExtractInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    markdown(input: WebDataLaneMarkdownInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    metadata(input: WebDataLaneMetadataInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    links(input: WebDataLaneLinksInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    structured(input: WebDataLaneStructuredInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    crawlPlan(input: WebDataLaneCrawlPlanInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+    screenshot(input: WebDataLaneScreenshotInput): Promise<WebDataLaneResponse<Record<string, unknown>>>;
+}