@madewithremy/admin 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -15,6 +15,145 @@ interface AdminContext {
     baseUrl: string;
 }
 
+/**
+ * Response types for the v2 agent-chat thread log.
+ *
+ * Transcribed from youai-api:
+ *   src/http/routes/V2Apps/manage/agentThreads.ts                    — routes
+ *   src/http/routes/V2Apps/manage/_helpers/projectAgentMessages.ts   — transcript shape
+ *   src/common/Db/v2Apps/V2AgentThreadsDao.ts                        — list row shape
+ */
+/** One tool the assistant asked for, with the arguments it chose. */
+interface AgentToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** A platform/model failure that ended a turn instead of a reply. */
+interface AgentTurnError {
+    message: string;
+    code?: string;
+    /** Milliseconds since epoch. */
+    at: number;
+}
+/**
+ * One message in a thread transcript.
+ *
+ * Roles are the stored conversation's own: `user` for a person's message AND
+ * for a tool result (which carries `toolCallId`), `assistant` for the agent.
+ */
+interface AgentTranscriptMessage {
+    role: string;
+    content: string;
+    /** CDN URLs the user attached (user messages only). */
+    attachments?: string[];
+    /** Present on an assistant message that requested tools. */
+    toolCalls?: AgentToolCall[];
+    /** Present on a tool result — matches the `toolCalls[].id` it answers. */
+    toolCallId?: string;
+    /** The tool reported a failure. */
+    isToolError?: boolean;
+    /**
+     * Request-log id for a method tool call — `requests get <id>` for its input,
+     * output, stdout and error. Absent on client-tool results, which run in the
+     * browser and never reach the backend.
+     */
+    requestId?: string;
+    /** The turn ended in a platform/model failure rather than a reply. */
+    turnError?: AgentTurnError;
+    /**
+     * The model saw extracted document text from an attachment on top of
+     * `content`. Only its presence is reported — the text can run to megabytes.
+     */
+    hasProcessedContent?: true;
+}
+/** One item in the thread list (transcript excluded). */
+interface AgentThreadListItem {
+    id: string;
+    /** Auto-generated from the first user message, or renamed by the user. */
+    title: string | null;
+    userId: string | null;
+    userName: string | null;
+    userEmail: string | null;
+    /** Browser identity — the only id an anonymous conversation has. */
+    visitorId: string | null;
+    /** True identifies a builder test conversation through the dev tunnel. */
+    devSession: boolean;
+    messageCount: number;
+    /** Tool results reported as failures — the conversations worth opening. */
+    toolErrorCount: number;
+    /** A turn broke (model error, rate limit, credits) rather than replying. */
+    hasTurnError: boolean;
+    /** ISO timestamp. */
+    dateCreated: string;
+    dateUpdated: string;
+}
+/** Full thread with transcript (single-thread GET). */
+interface AgentThreadDetail {
+    id: string;
+    title: string | null;
+    userId: string | null;
+    userName: string | null;
+    userEmail: string | null;
+    visitorId: string | null;
+    devSession: boolean;
+    messageCount: number;
+    /** ISO timestamp. */
+    dateCreated: string;
+    dateUpdated: string;
+    messages: AgentTranscriptMessage[];
+}
+/** GET /_internal/v2/apps/:appId/agent-threads */
+interface AgentThreadsListResult {
+    threads: AgentThreadListItem[];
+    nextCursor: string | null;
+}
+/** GET /_internal/v2/apps/:appId/agent-threads/:threadId */
+type AgentThreadsGetResult = AgentThreadDetail;
+
+interface ThreadsListParams {
+    /** Max threads per page (default 20, server clamps to 100). */
+    limit?: number;
+    /** Pagination cursor from a prior page's `nextCursor`. */
+    cursor?: string;
+}
+/**
+ * Every conversation the app's agent has had, newest activity first.
+ *
+ * Returns cursored pages; pass `nextCursor` from one page as `cursor` for the
+ * next. Transcripts are not included — fetch a thread with `threadsGet`.
+ *
+ * `toolErrorCount` and `hasTurnError` are how you find the conversations worth
+ * reading, and `devSession` separates your own test threads from real traffic.
+ *
+ * @example
+ * const { threads } = await admin.agent.threadsList({ limit: 20 });
+ * const broken = threads.filter((t) => t.toolErrorCount > 0 || t.hasTurnError);
+ */
+declare function threadsList(ctx: AdminContext, params?: ThreadsListParams): Promise<AgentThreadsListResult>;
+/**
+ * One thread with its full transcript: what the user said, what the agent
+ * replied, which tools it called with which arguments, and what came back.
+ *
+ * This is the primary tool for iterating on an agent's system prompt and tool
+ * descriptions — read what actually happened rather than guessing. Each method
+ * tool call carries a `requestId`; pass it to `requests.get()` for that call's
+ * input, output, stdout and error.
+ *
+ * @throws AdminApiError `thread_not_found` (404).
+ * @example
+ * const thread = await admin.agent.threadsGet('4f6c…');
+ * console.log(thread.messages);
+ */
+declare function threadsGet(ctx: AdminContext, threadId: string): Promise<AgentThreadDetail>;
+
+type agent_ThreadsListParams = ThreadsListParams;
+declare const agent_threadsGet: typeof threadsGet;
+declare const agent_threadsList: typeof threadsList;
+declare namespace agent {
+  export { type agent_ThreadsListParams as ThreadsListParams, agent_threadsGet as threadsGet, agent_threadsList as threadsList };
+}
+
 /**
  * Response types for the v2 analytics (insights) endpoints.
  *
@@ -875,6 +1014,7 @@ interface DataSourcesIngestUpdate {
     };
     contextual?: {
         enabled?: boolean;
+        modelId?: string;
     };
     images?: {
         describe?: boolean;
@@ -5069,6 +5209,7 @@ declare function buildClient(ctx: AdminContext): {
     context: Readonly<AdminContext>;
     /** A sibling client for another app, sharing credentials. */
     forApp(appId: string): /*elided*/ any;
+    agent: BoundOps<typeof agent>;
     analytics: BoundOps<typeof analytics>;
     crashes: BoundOps<typeof crashes>;
     cron: BoundOps<typeof cron>;
@@ -5149,4 +5290,4 @@ declare class AdminTimeoutError extends Error {
 
 declare const admin: AdminClient;
 
-export { AdminApiError, type AdminClient, type AdminClientOptions, type AdminContext, AdminTimeoutError, type AnalyticsAiHostRow, type AnalyticsAiSourcesResult, type AnalyticsAiVendorRow, type AnalyticsBatchResult, type AnalyticsCrawlersOverviewResult, type AnalyticsCrawlersRecentResult, type AnalyticsCrawlersRecentRow, type AnalyticsCrawlersResult, type AnalyticsCrawlersTimeseriesBucket, type AnalyticsCrawlersTimeseriesResult, type AnalyticsLiveResult, type AnalyticsMapPoint, type AnalyticsMapResult, type AnalyticsMetric, type AnalyticsQueryResult, type AnalyticsQueryResultRow, type AnalyticsSourceRow, type AnalyticsSourcesResult, type AppCronJobStatus, type AppCronJobStatusReason, type AppCronRunState, type AppEmailSuppression, type AppSecretRow, type CrashGroup, type CrashOccurrenceRow, type CrashesGetResult, type CrashesListResult, type CrashesOccurrencesResult, type CrashesStatsBucket, type CrashesStatsResult, type CronJobDecorated, type CronOverviewResult, type CronRunResult, type CronRunSummary, type DashboardLiveRelease, type DashboardReleaseMethod, type DashboardResult, type DataLiftFromDevResult, type DataLiftFromLiveResult, type DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesDeleteResult, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesPromoteResult, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, type DataSourcesSearchCitation, type DataSourcesSearchResult, type DataSourcesSearchResultItem, type DataSourcesUploadTokenResult, type DatasetFile, type DbQueryResult, type DiagnosticsAuditEnvironment, type DiagnosticsDashboardResult, type DiagnosticsFinding, type DiagnosticsLighthouseScores, type DiagnosticsPayload, type DiagnosticsReleaseResult, type DiagnosticsRuntimeFindings, type DomainsCheckResult, type DomainsCustomAddResult, type DomainsCustomCheckResult, type DomainsCustomHostnameUiStatus, type DomainsCustomHostnameView, type DomainsCustomListResult, type DomainsCustomRemoveResult, type DomainsCustomRetryResult, type DomainsDnsInstructions, type DomainsGetResult, type DomainsSetResult, type EmailBatchLifecycle, type EmailBatchResult, type EmailBatchSummary, type EmailBatchesResult, type EmailDomainBase, type EmailEffectiveSender, type EmailInboxResult, type EmailListResult, type EmailMessageKind, type EmailMessageResult, type EmailMessageStatus, type EmailSenderTier, type EmailSendingStatusResult, type EmailStatsResult, type EmailSummary, type EmailSuppressResult, type EmailSuppressionsResult, type EmailUnsuppressResult, type FilesDeleteResult, type FilesFileMeta, type FilesListEntry, type FilesListResult, type FilesLsResult, type FilesScanBadge, type FilesScanFlagged, type FilesScanStore, type FilesStatResult, type FilesStoreSummaryEntry, type FilesUploadUrlResult, type FilesUrlResult, type FrontendErrorType, type InboundDnsInstructions, type InboundEmailDomainAddResult, type InboundEmailDomainCheckResult, type InboundEmailDomainDeleteResult, type InboundEmailDomainUiStatus, type InboundEmailDomainVerifyResult, type InboundEmailDomainView, type InboundEmailDomainsListResult, type InboxEmailPreview, type IssueAuthorKind, type IssueCommentRow, type IssueEventType, type IssueKind, type IssueRow, type IssueStatus, type IssuesCommentResult, type IssuesCreateResult, type IssuesDeleteResult, type IssuesGetResult, type IssuesListResult, type IssuesUpdateResult, type JewelPairRow, type JewelPairSummaryRow, type JewelVerdict, type JewelsDatasetSummary, type JewelsDryrunResult, type JewelsExportResult, type JewelsGradeResult, type JewelsGrading, type JewelsOverviewResult, type JewelsPairResult, type JewelsPairsResult, type JewelsQueueResult, type JewelsResolveResult, type JewelsRunResult, type JewelsRunsResult, type JewelsTimeseriesBucket, type JewelsTimeseriesResult, type JewelsTrainResult, type LiftedDatabase, type MethodsInvokeResult, type OutboundDnsInstructions, type OutboundEmailDomainAddResult, type OutboundEmailDomainCheckResult, type OutboundEmailDomainDeleteResult, type OutboundEmailDomainUiStatus, type OutboundEmailDomainVerifyResult, type OutboundEmailDomainView, type OutboundEmailDomainsListResult, type PlatformSuppression, type PrerenderGetResult, type PrerenderInvalidateResult, type PrerenderPage, type PrerenderPagesResult, type PrerenderViewResult, type ReleaseFragment, type ReleasesByCommitResult, type ReleasesGetResult, type ReleasesListResult, type RequestsGetResult, type RequestsListResult, type RequestsListRow, type RequestsStatsMethodBucket, type RequestsStatsMethodResult, type RequestsStatsSummaryBucket, type RequestsStatsSummaryResult, type SecretsDeleteResult, type SecretsGetResult, type SecretsListResult, type SecretsSetResult, type SettingsResult, type SuppressionSource, type TrainingLogEntry, type TrainingRunRow, type TrainingRunStatus, type UserAuthProvider, type UserListItem, type UserRecord, type UsersCreateApiKeyResult, type UsersListResult, type UsersRevokeApiKeyResult, type UsersSetRoleResult, type V2AppSettings, type V2BuildLogEntry, type V2BuildStats, type V2CommitInfo, type V2EmailMessage, type V2ReleaseStatus, type VoiceAvailableNumber, type VoiceNumbersBuyResult, type VoiceNumbersListResult, type VoiceNumbersReleaseResult, type VoiceNumbersSearchResult, type VoiceNumbersSetNameResult, type VoicePhoneNumberStatus, type VoicePhoneNumberView, type VoiceResolvedPolicy, type VoiceSessionChannel, type VoiceSessionCost, type VoiceSessionCostLine, type VoiceSessionDetail, type VoiceSessionGetResult, type VoiceSessionListItem, type VoiceSessionSip, type VoiceSessionSpeechEntry, type VoiceSessionStatus, type VoiceSessionToolEntry, type VoiceSessionTranscriptEntry, type VoiceSessionsListResult, type VoiceSettingsCeilings, type VoiceSettingsGetResult, type VoiceSettingsOverrides, type VoiceSettingsSetResult, admin, createAdminClient, admin as default };
+export { AdminApiError, type AdminClient, type AdminClientOptions, type AdminContext, AdminTimeoutError, type AgentThreadDetail, type AgentThreadListItem, type AgentThreadsGetResult, type AgentThreadsListResult, type AgentToolCall, type AgentTranscriptMessage, type AgentTurnError, type AnalyticsAiHostRow, type AnalyticsAiSourcesResult, type AnalyticsAiVendorRow, type AnalyticsBatchResult, type AnalyticsCrawlersOverviewResult, type AnalyticsCrawlersRecentResult, type AnalyticsCrawlersRecentRow, type AnalyticsCrawlersResult, type AnalyticsCrawlersTimeseriesBucket, type AnalyticsCrawlersTimeseriesResult, type AnalyticsLiveResult, type AnalyticsMapPoint, type AnalyticsMapResult, type AnalyticsMetric, type AnalyticsQueryResult, type AnalyticsQueryResultRow, type AnalyticsSourceRow, type AnalyticsSourcesResult, type AppCronJobStatus, type AppCronJobStatusReason, type AppCronRunState, type AppEmailSuppression, type AppSecretRow, type CrashGroup, type CrashOccurrenceRow, type CrashesGetResult, type CrashesListResult, type CrashesOccurrencesResult, type CrashesStatsBucket, type CrashesStatsResult, type CronJobDecorated, type CronOverviewResult, type CronRunResult, type CronRunSummary, type DashboardLiveRelease, type DashboardReleaseMethod, type DashboardResult, type DataLiftFromDevResult, type DataLiftFromLiveResult, type DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesDeleteResult, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesPromoteResult, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, type DataSourcesSearchCitation, type DataSourcesSearchResult, type DataSourcesSearchResultItem, type DataSourcesUploadTokenResult, type DatasetFile, type DbQueryResult, type DiagnosticsAuditEnvironment, type DiagnosticsDashboardResult, type DiagnosticsFinding, type DiagnosticsLighthouseScores, type DiagnosticsPayload, type DiagnosticsReleaseResult, type DiagnosticsRuntimeFindings, type DomainsCheckResult, type DomainsCustomAddResult, type DomainsCustomCheckResult, type DomainsCustomHostnameUiStatus, type DomainsCustomHostnameView, type DomainsCustomListResult, type DomainsCustomRemoveResult, type DomainsCustomRetryResult, type DomainsDnsInstructions, type DomainsGetResult, type DomainsSetResult, type EmailBatchLifecycle, type EmailBatchResult, type EmailBatchSummary, type EmailBatchesResult, type EmailDomainBase, type EmailEffectiveSender, type EmailInboxResult, type EmailListResult, type EmailMessageKind, type EmailMessageResult, type EmailMessageStatus, type EmailSenderTier, type EmailSendingStatusResult, type EmailStatsResult, type EmailSummary, type EmailSuppressResult, type EmailSuppressionsResult, type EmailUnsuppressResult, type FilesDeleteResult, type FilesFileMeta, type FilesListEntry, type FilesListResult, type FilesLsResult, type FilesScanBadge, type FilesScanFlagged, type FilesScanStore, type FilesStatResult, type FilesStoreSummaryEntry, type FilesUploadUrlResult, type FilesUrlResult, type FrontendErrorType, type InboundDnsInstructions, type InboundEmailDomainAddResult, type InboundEmailDomainCheckResult, type InboundEmailDomainDeleteResult, type InboundEmailDomainUiStatus, type InboundEmailDomainVerifyResult, type InboundEmailDomainView, type InboundEmailDomainsListResult, type InboxEmailPreview, type IssueAuthorKind, type IssueCommentRow, type IssueEventType, type IssueKind, type IssueRow, type IssueStatus, type IssuesCommentResult, type IssuesCreateResult, type IssuesDeleteResult, type IssuesGetResult, type IssuesListResult, type IssuesUpdateResult, type JewelPairRow, type JewelPairSummaryRow, type JewelVerdict, type JewelsDatasetSummary, type JewelsDryrunResult, type JewelsExportResult, type JewelsGradeResult, type JewelsGrading, type JewelsOverviewResult, type JewelsPairResult, type JewelsPairsResult, type JewelsQueueResult, type JewelsResolveResult, type JewelsRunResult, type JewelsRunsResult, type JewelsTimeseriesBucket, type JewelsTimeseriesResult, type JewelsTrainResult, type LiftedDatabase, type MethodsInvokeResult, type OutboundDnsInstructions, type OutboundEmailDomainAddResult, type OutboundEmailDomainCheckResult, type OutboundEmailDomainDeleteResult, type OutboundEmailDomainUiStatus, type OutboundEmailDomainVerifyResult, type OutboundEmailDomainView, type OutboundEmailDomainsListResult, type PlatformSuppression, type PrerenderGetResult, type PrerenderInvalidateResult, type PrerenderPage, type PrerenderPagesResult, type PrerenderViewResult, type ReleaseFragment, type ReleasesByCommitResult, type ReleasesGetResult, type ReleasesListResult, type RequestsGetResult, type RequestsListResult, type RequestsListRow, type RequestsStatsMethodBucket, type RequestsStatsMethodResult, type RequestsStatsSummaryBucket, type RequestsStatsSummaryResult, type SecretsDeleteResult, type SecretsGetResult, type SecretsListResult, type SecretsSetResult, type SettingsResult, type SuppressionSource, type TrainingLogEntry, type TrainingRunRow, type TrainingRunStatus, type UserAuthProvider, type UserListItem, type UserRecord, type UsersCreateApiKeyResult, type UsersListResult, type UsersRevokeApiKeyResult, type UsersSetRoleResult, type V2AppSettings, type V2BuildLogEntry, type V2BuildStats, type V2CommitInfo, type V2EmailMessage, type V2ReleaseStatus, type VoiceAvailableNumber, type VoiceNumbersBuyResult, type VoiceNumbersListResult, type VoiceNumbersReleaseResult, type VoiceNumbersSearchResult, type VoiceNumbersSetNameResult, type VoicePhoneNumberStatus, type VoicePhoneNumberView, type VoiceResolvedPolicy, type VoiceSessionChannel, type VoiceSessionCost, type VoiceSessionCostLine, type VoiceSessionDetail, type VoiceSessionGetResult, type VoiceSessionListItem, type VoiceSessionSip, type VoiceSessionSpeechEntry, type VoiceSessionStatus, type VoiceSessionToolEntry, type VoiceSessionTranscriptEntry, type VoiceSessionsListResult, type VoiceSettingsCeilings, type VoiceSettingsGetResult, type VoiceSettingsOverrides, type VoiceSettingsSetResult, admin, createAdminClient, admin as default };

package/dist/index.js

@@ -58,16 +58,11 @@ function loadWorkspaceAppId(workspaceDir = WORKSPACE_DIR) {
   return result.value.appId;
 }
 
-// src/ops/analytics.ts
-var analytics_exports = {};
-__export(analytics_exports, {
-  aiSources: () => aiSources,
-  batch: () => batch,
-  crawlers: () => crawlers,
-  live: () => live,
-  map: () => map,
-  query: () => query,
-  sources: () => sources
+// src/ops/agent.ts
+var agent_exports = {};
+__export(agent_exports, {
+  threadsGet: () => threadsGet,
+  threadsList: () => threadsList
 });
 
 // src/errors.ts
@@ -168,7 +163,33 @@ async function tryCall(ctx, method, apiPath) {
   return { ok: res.ok, status: res.status, body: await readBody(res) };
 }
 
+// src/ops/agent.ts
+function threadsList(ctx, params = {}) {
+  return call(
+    ctx,
+    "GET",
+    `/_internal/v2/apps/${ctx.appId}/agent-threads${qs(params)}`
+  );
+}
+function threadsGet(ctx, threadId) {
+  return call(
+    ctx,
+    "GET",
+    `/_internal/v2/apps/${ctx.appId}/agent-threads/${seg(threadId)}`
+  );
+}
+
 // src/ops/analytics.ts
+var analytics_exports = {};
+__export(analytics_exports, {
+  aiSources: () => aiSources,
+  batch: () => batch,
+  crawlers: () => crawlers,
+  live: () => live,
+  map: () => map,
+  query: () => query,
+  sources: () => sources
+});
 function query(ctx, body) {
   return call(
     ctx,
@@ -1626,6 +1647,7 @@ function buildClient(ctx) {
     forApp(appId) {
       return buildClient({ ...ctx, appId });
     },
+    agent: bindOps(agent_exports, ctx),
     analytics: bindOps(analytics_exports, ctx),
     crashes: bindOps(crashes_exports, ctx),
     cron: bindOps(cron_exports, ctx),