@graphlit/durable-agents 1.0.20260614002

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Unstruk Data, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# Graphlit Durable Agents CLI
+
+Command-line interface for Durable Agents.
+
+```bash
+npm install -g @graphlit/durable-agents
+durable --help
+```
+
+The CLI defaults to the production Durable Agents API and uses `--json` for stable machine-readable output.
+
+```bash
+durable login
+```
+
+Login opens Durable Agents Hub, shows a pairing code in both the terminal and browser, and stores a claimed Durable API key in the local credentials file.
+
+Agent mutations use the property-oriented grammar:
+
+```bash
+durable agents set <agent> prompt "Run the daily account sweep."
+durable agents set <agent> prompt --file ./prompt.md
+durable agents set <agent> schedule.cron "0 7 * * 1-5"
+durable agents set <agent> trigger.kinds text page
+durable agents clear <agent> focus
+durable agents clear <agent> trigger.kinds
+```
+
+Scalar values are positional by default. List-valued properties use repeated
+positional values. The global `--json` flag controls output only; it is not an
+input parser.
+
+The older `durable agents update ...` flags remain available for compatibility.

package/dist/api.d.ts

@@ -0,0 +1,173 @@
+import { type ActiveCredentials } from './credentials.js';
+import { createDurableClient } from './generated/openapi-client.js';
+import type { DurableAgent, DurableAgentList, DurableAccount, DurableAccountList, DurableAccountMutationResult, DurableDataSource, DurableDataSourceCreateResult, DurableDataSourceDiscoveryList, DurableDataSourceList, DurableApiKeyList, DurableApiKeyCreateResponse, DurableBillingFundingRequest, DurableBillingUsage, DurableChannelBinding, DurableChannelConnector, DurableChannelConnectorList, DurableChannelEndpointList, DurableConnector, DurableConnectorList, DurableConnectorMutationResult, DurableContent, DurableContentInspection, DurableContentList, DurableDeletedResponse, DurableEmailInbox, DurableEmailInboxList, DurableEmailMessage, DurableEmailMessageList, DurableEmailMessageSendResult, DurableHealth, DurableMessagingStatus, DurableModelList, DurablePersona, DurablePersonaList, DurableRegisteredPhone, DurableRegisteredPhoneList, DurableRun, DurableRunEventList, DurableRunList, DurableRunReplay, DurableSkill, DurableSkillList, DurableSlackSetupGuide, DurableVfsEntryList, DurableVfsItem, DurableVfsSearchResult } from './types.js';
+export interface AuthenticatedClient {
+    credentials: ActiveCredentials;
+    apiBaseUrl: string;
+    client: ReturnType<typeof createDurableClient>;
+}
+export declare function createAuthenticatedClient(): Promise<AuthenticatedClient>;
+export declare function getHealth(): Promise<DurableHealth>;
+export declare function getUsage(authClient: AuthenticatedClient): Promise<DurableBillingUsage>;
+export declare function createBillingFundingRequest(authClient: AuthenticatedClient, body: {
+    credits: number;
+    payment_method: 'link_mpp';
+}): Promise<DurableBillingFundingRequest>;
+export declare function getBillingFundingRequest(authClient: AuthenticatedClient, fundingRequestId: string): Promise<DurableBillingFundingRequest>;
+export declare function listKeys(authClient: AuthenticatedClient): Promise<DurableApiKeyList>;
+export declare function createApiKey(authClient: AuthenticatedClient, body: {
+    name: string;
+    scopes?: string[];
+    challenge?: string;
+}): Promise<DurableApiKeyCreateResponse>;
+export declare function listAgents(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    search?: string;
+}): Promise<DurableAgentList>;
+export declare function listAccounts(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    provider?: string;
+}): Promise<DurableAccountList>;
+export declare function createAccount(authClient: AuthenticatedClient, body: {
+    provider: string;
+}): Promise<DurableAccountMutationResult>;
+export declare function getAccount(authClient: AuthenticatedClient, accountRef: string): Promise<DurableAccount>;
+export declare function deleteAccount(authClient: AuthenticatedClient, accountRef: string): Promise<DurableDeletedResponse>;
+export declare function connectAccount(authClient: AuthenticatedClient, accountRef: string): Promise<DurableAccountMutationResult>;
+export declare function listDataSources(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    provider?: string;
+    type?: string;
+    account?: string;
+    status?: string;
+    search?: string;
+}): Promise<DurableDataSourceList>;
+export declare function createDataSource(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableDataSourceCreateResult>;
+export declare function getDataSource(authClient: AuthenticatedClient, sourceRef: string): Promise<DurableDataSource>;
+export declare function updateDataSource(authClient: AuthenticatedClient, sourceRef: string, body: Record<string, unknown>): Promise<DurableDataSource>;
+export declare function deleteDataSource(authClient: AuthenticatedClient, sourceRef: string): Promise<DurableDeletedResponse>;
+export declare function pauseDataSource(authClient: AuthenticatedClient, sourceRef: string): Promise<DurableDataSource>;
+export declare function resumeDataSource(authClient: AuthenticatedClient, sourceRef: string): Promise<DurableDataSource>;
+export declare function syncDataSource(authClient: AuthenticatedClient, sourceRef: string): Promise<DurableDataSource>;
+export declare function discoverDataSourceResources(authClient: AuthenticatedClient, type: string, body: Record<string, unknown>): Promise<DurableDataSourceDiscoveryList>;
+export declare function createAgent(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableAgent>;
+export declare function getAgent(authClient: AuthenticatedClient, agentId: string): Promise<DurableAgent>;
+export declare function updateAgent(authClient: AuthenticatedClient, agentId: string, body: Record<string, unknown>): Promise<DurableAgent>;
+export declare function updateAgentProperties(authClient: AuthenticatedClient, agentId: string, body: {
+    properties: Record<string, unknown>;
+}): Promise<DurableAgent>;
+export declare function deleteAgent(authClient: AuthenticatedClient, agentId: string): Promise<DurableDeletedResponse>;
+export declare function listConnectors(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    search?: string;
+}): Promise<DurableConnectorList>;
+export declare function createConnector(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableConnectorMutationResult>;
+export declare function getConnector(authClient: AuthenticatedClient, connectorRef: string): Promise<DurableConnector>;
+export declare function updateConnector(authClient: AuthenticatedClient, connectorRef: string, body: Record<string, unknown>): Promise<DurableConnector>;
+export declare function deleteConnector(authClient: AuthenticatedClient, connectorRef: string): Promise<DurableDeletedResponse>;
+export declare function connectConnector(authClient: AuthenticatedClient, connectorRef: string): Promise<DurableConnectorMutationResult>;
+export declare function disconnectConnector(authClient: AuthenticatedClient, connectorRef: string): Promise<DurableConnector>;
+export declare function listRuns(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    agent?: string;
+    status?: string;
+}): Promise<DurableRunList>;
+export declare function pauseRun(authClient: AuthenticatedClient, runId: string): Promise<DurableRun>;
+export declare function listContent(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    path?: string;
+    search?: string;
+    label?: string[];
+    type?: string[];
+    file_type?: string[];
+}): Promise<DurableContentList>;
+export declare function createContent(authClient: AuthenticatedClient, input: {
+    json: Record<string, unknown>;
+    formData?: never;
+} | {
+    json?: never;
+    formData: FormData;
+}): Promise<DurableContent>;
+export declare function getContent(authClient: AuthenticatedClient, contentId: string): Promise<DurableContent>;
+export declare function inspectContent(authClient: AuthenticatedClient, contentId: string): Promise<DurableContentInspection>;
+export declare function updateContent(authClient: AuthenticatedClient, contentId: string, body: Record<string, unknown>): Promise<DurableContent>;
+export declare function deleteContent(authClient: AuthenticatedClient, contentId: string): Promise<DurableDeletedResponse>;
+export declare function listVfsEntries(authClient: AuthenticatedClient, query: Record<string, string | number | boolean | undefined>): Promise<DurableVfsEntryList>;
+export declare function getVfsItem(authClient: AuthenticatedClient, query: Record<string, string | boolean | undefined>): Promise<DurableVfsItem>;
+export declare function searchVfs(authClient: AuthenticatedClient, query: Record<string, string | number | boolean | undefined>): Promise<DurableVfsSearchResult>;
+export declare function listPersonas(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    search?: string;
+}): Promise<DurablePersonaList>;
+export declare function createPersona(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurablePersona>;
+export declare function getPersona(authClient: AuthenticatedClient, personaId: string): Promise<DurablePersona>;
+export declare function updatePersona(authClient: AuthenticatedClient, personaId: string, body: Record<string, unknown>): Promise<DurablePersona>;
+export declare function deletePersona(authClient: AuthenticatedClient, personaId: string): Promise<DurableDeletedResponse>;
+export declare function listSkills(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    search?: string;
+}): Promise<DurableSkillList>;
+export declare function createSkill(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableSkill>;
+export declare function getSkill(authClient: AuthenticatedClient, skillId: string): Promise<DurableSkill>;
+export declare function updateSkill(authClient: AuthenticatedClient, skillId: string, body: Record<string, unknown>): Promise<DurableSkill>;
+export declare function deleteSkill(authClient: AuthenticatedClient, skillId: string): Promise<DurableDeletedResponse>;
+export declare function listModels(authClient: AuthenticatedClient): Promise<DurableModelList>;
+export declare function listChannelConnectors(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+}): Promise<DurableChannelConnectorList>;
+export declare function createChannelConnector(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableChannelConnector>;
+export declare function deleteChannelConnector(authClient: AuthenticatedClient, connectorId: string): Promise<DurableDeletedResponse>;
+export declare function getSlackSetupGuide(authClient: AuthenticatedClient, name?: string): Promise<DurableSlackSetupGuide>;
+export declare function listEmailInboxes(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+}): Promise<DurableEmailInboxList>;
+export declare function createEmailInbox(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableEmailInbox>;
+export declare function deleteEmailInbox(authClient: AuthenticatedClient, inboxId: string): Promise<DurableDeletedResponse>;
+export declare function listEmailInboxMessages(authClient: AuthenticatedClient, inboxRef: string, query?: {
+    cursor?: string;
+    limit?: number;
+}): Promise<DurableEmailMessageList>;
+export declare function getEmailInboxMessage(authClient: AuthenticatedClient, inboxRef: string, messageId: string): Promise<DurableEmailMessage>;
+export declare function sendEmailInboxMessage(authClient: AuthenticatedClient, inboxRef: string, body: Record<string, unknown>): Promise<DurableEmailMessageSendResult>;
+export declare function getMessagingStatus(authClient: AuthenticatedClient): Promise<DurableMessagingStatus>;
+export declare function listMessagingPhones(authClient: AuthenticatedClient): Promise<DurableRegisteredPhoneList>;
+export declare function verifyMessagingPhone(authClient: AuthenticatedClient, phoneNumber: string): Promise<{
+    sent: boolean;
+}>;
+export declare function confirmMessagingPhone(authClient: AuthenticatedClient, phoneNumber: string, code: string): Promise<DurableRegisteredPhone>;
+export declare function deleteMessagingPhone(authClient: AuthenticatedClient, phone: string): Promise<DurableDeletedResponse>;
+export declare function listChannelEndpoints(authClient: AuthenticatedClient, query?: {
+    cursor?: string;
+    limit?: number;
+    provider?: string;
+    query?: string;
+}): Promise<DurableChannelEndpointList>;
+export declare function putChannelBinding(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableChannelBinding>;
+export declare function deleteChannelBinding(authClient: AuthenticatedClient, body: Record<string, unknown>): Promise<DurableDeletedResponse>;
+export declare function startRun(authClient: AuthenticatedClient, agentId: string, input: Record<string, unknown>, options?: {
+    wait?: boolean;
+    timeoutSeconds?: number;
+}, signal?: AbortSignal): Promise<DurableRun>;
+export declare function promptRun(authClient: AuthenticatedClient, runId: string, input: Record<string, unknown>, options?: {
+    wait?: boolean;
+    timeoutSeconds?: number;
+}, signal?: AbortSignal): Promise<DurableRun>;
+export declare function getRun(authClient: AuthenticatedClient, runId: string, signal?: AbortSignal): Promise<DurableRun>;
+export declare function listRunEvents(authClient: AuthenticatedClient, runId: string, query: {
+    cursor?: string;
+    limit?: number;
+    types?: string[];
+}, signal?: AbortSignal): Promise<DurableRunEventList>;
+export declare function replayRun(authClient: AuthenticatedClient, runId: string, signal?: AbortSignal): Promise<DurableRunReplay>;
+export declare function cancelRun(authClient: AuthenticatedClient, runId: string, signal?: AbortSignal): Promise<DurableRun>;
+export declare function resumeRun(authClient: AuthenticatedClient, runId: string, reply: string | undefined, signal?: AbortSignal): Promise<DurableRun>;