@sage-protocol/sdk 0.2.6 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-protocol/sdk",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -58,7 +58,6 @@
   },
   "dependencies": {
     "@merit-systems/echo-typescript-sdk": "^1.0.17",
-    "@whetstone-research/doppler-sdk": "^0.0.1-alpha.40",
     "ai": "^5.0.52",
     "axios": "^1.11.0",
     "ethers": "^6.15.0",

package/types/index.d.ts

@@ -147,6 +147,11 @@ export type ProposalAccess = 'council-only' | 'community-threshold';
 export type ExecutionAccess = 'council-only' | 'anyone';
 export type GovernancePlaybook = 'council-closed' | 'council-drafts' | 'community' | 'legacy' | 'custom';
 
+// UX-facing labels (webapp/cli alignment)
+export type GovernanceMode = 'COMMUNITY_MANAGED' | 'TEAM_MANAGED' | 'INDIVIDUAL_MANAGED';
+export type ManagedScope = 'INDIVIDUAL' | 'TEAM' | 'UNKNOWN';
+export type QueueWiring = 'GOVERNOR_ONLY' | 'OPERATORS_ONLY' | 'BOTH' | 'NEITHER';
+
 export interface GovernanceProfile {
   /** Profile version: 1=legacy (detected via heuristics), 2=explicit 3-axis profile */
   version: 1 | 2;
@@ -558,6 +563,85 @@ export interface ManifestValidator {
   bestPracticeCheckFile(manifestPath: string): Array<Record<string, any>>;
 }
 
+// ============================================================================
+// Manifest + Skill Versioning Types (Phase 6)
+// ============================================================================
+
+export interface Provenance {
+  source: 'github' | 'local' | 'sage';
+  repo?: string;
+  path?: string;
+  ref?: string;
+  commit?: string;
+  importedAt?: string;
+}
+
+export interface PromptEntry {
+  key: string;
+  name?: string;
+  type?: 'prompt' | 'skill' | 'agent' | 'command' | 'template' | 'workflow';
+  cid?: string;
+  description?: string;
+  tags?: string[];
+  provenance?: Provenance;
+}
+
+export type UpstreamRef =
+  | { type: 'cid'; value: string }
+  | { type: 'github_commit'; value: { repo: string; commit: string } };
+
+export interface SkillIndex {
+  key: string;
+  activeVersion: string;
+  previousVersion?: string;
+  pendingVersion?: string;
+  installedAt: string;
+
+  origin?: Origin;
+
+  lastChecked?: string;
+  latestUpstream?: UpstreamRef;
+  updateStatus?: 'up_to_date' | 'available' | 'removed' | 'check_failed';
+
+  versions: Record<string, {
+    upstream: UpstreamRef;
+    downloadedAt: string;
+    pinned?: boolean;
+  }>;
+
+  provenance?: Provenance;
+}
+
+export type Origin = OriginSage | OriginGithub;
+
+export type OriginSage =
+  | {
+      type: 'sage';
+      tier: 'dao' | 'personal' | 'shared';
+      originKind: 'entry';
+      chainId: number;
+      owner: string;
+      libraryId: string;
+      manifestCid: string;
+      entryKey: string;
+    }
+  | {
+      type: 'sage';
+      tier: 'dao' | 'personal' | 'shared';
+      originKind: 'library';
+      chainId: number;
+      owner: string;
+      libraryId: string;
+      manifestCid: string;
+    };
+
+export interface OriginGithub {
+  type: 'github';
+  repo: string;
+  path: string;
+  ref?: string;
+}
+
 export interface LibrarySearchResult {
   type: 'library' | 'prompt';
   name: string;
@@ -740,33 +824,93 @@ export interface TreasuryModule {
   getLPContribution(args: { provider: ProviderLike; treasury: AddressLike; subdao: AddressLike; token: AddressLike }): Promise<bigint>;
 }
 
+export interface MerkleBoost {
+  manager: AddressLike;
+  proposalId: number;
+  totalPool: bigint;
+  totalClaimed: bigint;
+  merkleRoot: HashLike;
+  expiresAt: bigint;
+  active: boolean;
+  finalized: boolean;
+  creator: AddressLike;
+}
+
+export interface DirectBoost {
+  manager: AddressLike;
+  proposalId: number;
+  creator: AddressLike;
+  governor: AddressLike | null;
+  snapshot: bigint;
+  perVoter: bigint;
+  maxVoters: bigint;
+  votersPaid: bigint;
+  minVotes: bigint;
+  payoutMode: number;
+  support: number;
+  startAt: number;
+  expiresAt: number;
+  totalPool: bigint;
+  totalPaid: bigint;
+  kind: number;
+  policy: AddressLike | null;
+  active: boolean;
+  paused: boolean;
+}
+
 export interface BoostModule {
-  getMerkleConfig(args: { provider: ProviderLike; manager: AddressLike; proposalId: number | bigint }): Promise<{
+  // Merkle manager (GovernanceBoostManagerMerkle)
+  getMerkleBoost(args: { provider: ProviderLike; manager: AddressLike; proposalId: number | bigint }): Promise<MerkleBoost | null>;
+  buildMerkleCreateTx(args: {
     manager: AddressLike;
-    proposalId: number;
-    token: AddressLike | null;
-    totalAmount: bigint;
-    startTime: number;
-    endTime: number;
-    merkleRoot: bigint;
-  } | null>;
+    proposalId: number | bigint;
+    totalPool?: BigNumberish;
+    amount?: BigNumberish;
+  }): TransactionPayload;
+  buildMerkleSetMerkleRootTx(args: {
+    manager: AddressLike;
+    proposalId: number | bigint;
+    root?: HashLike;
+    merkleRoot?: HashLike;
+  }): TransactionPayload;
+  buildMerkleFinalizeTx(args: { manager: AddressLike; proposalId: number | bigint }): TransactionPayload;
+  buildMerkleClaimTx(args: {
+    manager: AddressLike;
+    proposalId: number | bigint;
+    account: AddressLike;
+    amount: BigNumberish;
+    proof: HashLike[];
+  }): TransactionPayload;
+
+  // Legacy names (back-compat)
+  getMerkleConfig(args: { provider: ProviderLike; manager: AddressLike; proposalId: number | bigint }): Promise<MerkleBoost | null>;
   buildMerkleFundTx(args: { manager: AddressLike; proposalId: number | bigint; amount: BigNumberish }): TransactionPayload;
-  buildMerkleSetRootTx(args: { manager: AddressLike; proposalId: number | bigint; merkleRoot: BigNumberish }): TransactionPayload;
-  getDirectConfig(args: { provider: ProviderLike; manager: AddressLike; proposalId: number | bigint }): Promise<{
+  buildMerkleSetRootTx(args: { manager: AddressLike; proposalId: number | bigint; merkleRoot: HashLike }): TransactionPayload;
+
+  // Direct manager (GovernanceBoostManager)
+  getDirectBoost(args: { provider: ProviderLike; manager: AddressLike; proposalId: number | bigint }): Promise<DirectBoost | null>;
+  buildDirectCreateTx(args: {
     manager: AddressLike;
-    proposalId: number;
-    token: AddressLike | null;
-    perVoter: bigint;
-    maxVoters: bigint;
-    startTime: number;
-    endTime: number;
-  } | null>;
-  buildDirectCreateTx(args: { manager: AddressLike; proposalId: number | bigint; token: AddressLike; perVoter: BigNumberish; maxVoters: BigNumberish }): TransactionPayload;
-  buildDirectFundTx(args: { manager: AddressLike; proposalId: number | bigint; amount: BigNumberish }): TransactionPayload;
+    governor: AddressLike;
+    proposalId: number | bigint;
+    perVoter: BigNumberish;
+    maxVoters: BigNumberish;
+    kind?: number;
+    policy?: AddressLike;
+    minVotes?: BigNumberish;
+    payoutMode?: number;
+    support?: number;
+    startAt?: BigNumberish;
+    expiresAt?: BigNumberish;
+  }): TransactionPayload;
+  buildDirectClaimTx(args: { manager: AddressLike; proposalId: number | bigint; data?: HashLike }): TransactionPayload;
+  buildDirectFinalizeTx(args: { manager: AddressLike; proposalId: number | bigint }): TransactionPayload;
+
+  // Legacy name (back-compat)
+  getDirectConfig(args: { provider: ProviderLike; manager: AddressLike; proposalId: number | bigint }): Promise<DirectBoost | null>;
 }
 
 export interface PersonalModule {
-  buildCreatePersonalRegistryTx(args: { factory: AddressLike; policy: number }): TransactionPayload;
   buildSetPriceTx(args: { marketplace: AddressLike; key: string; price: BigNumberish }): TransactionPayload;
   buildBuyTx(args: {
     marketplace: AddressLike;
@@ -864,7 +1008,7 @@ export interface AuctionConfig {
   weth: AddressLike;
   timeBuffer: bigint;
   reservePrice: bigint;
-  minBidIncrementPercentage: bigint;
+  minBidIncrementBps: bigint;
   duration: bigint;
   mintTierId: bigint;
   defaultTokenURI: string;
@@ -887,7 +1031,7 @@ export interface AuctionModule {
   buildUnpauseTx(args: { auctionHouse: AddressLike }): TransactionPayload;
   buildSetTimeBufferTx(args: { auctionHouse: AddressLike; timeBuffer: BigNumberish }): TransactionPayload;
   buildSetReservePriceTx(args: { auctionHouse: AddressLike; reservePrice: BigNumberish }): TransactionPayload;
-  buildSetMinBidIncrementTx(args: { auctionHouse: AddressLike; percentage: BigNumberish }): TransactionPayload;
+  buildSetMinBidIncrementTx(args: { auctionHouse: AddressLike; bps: BigNumberish }): TransactionPayload;
   buildSetDurationTx(args: { auctionHouse: AddressLike; duration: BigNumberish }): TransactionPayload;
   buildSetMintTierIdTx(args: { auctionHouse: AddressLike; tierId: BigNumberish }): TransactionPayload;
   buildSetDefaultTokenURITx(args: { auctionHouse: AddressLike; uri: string }): TransactionPayload;
@@ -895,7 +1039,7 @@ export interface AuctionModule {
 
 // ============ Bounty System Types ============
 
-export type BountyMode = 'OPEN' | 'DIRECT' | 'COMPETITIVE';
+export type BountyMode = 'DIRECT' | 'COMPETITIVE';
 export type BountyStatus = 'ACTIVE' | 'CLAIMED' | 'UNDER_REVIEW' | 'VOTING' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED';
 export type LibraryAction = 'PAYMENT_ONLY' | 'ADD_TO_LIBRARY' | 'PAYMENT_AND_ADD';
 
@@ -1083,19 +1227,13 @@ export interface BountyModule {
     assignee: AddressLike;
     libraryKey: string;
   }): TransactionPayload;
-  // Claiming & Submission
-  buildClaimBountyTx(args: { bountySystem: AddressLike; bountyId: BigNumberish }): TransactionPayload;
+  // Submission
   buildSubmitEntryTx(args: {
     bountySystem: AddressLike;
     bountyId: BigNumberish;
     promptIPFS: string;
     deliverableIPFS: string;
   }): TransactionPayload;
-  buildCompleteBountyTx(args: {
-    bountySystem: AddressLike;
-    bountyId: BigNumberish;
-    deliverableIPFS: string;
-  }): TransactionPayload;
   // Voting (COMPETITIVE mode)
   buildStartVotingTx(args: { bountySystem: AddressLike; bountyId: BigNumberish }): TransactionPayload;
   buildVoteTx(args: { bountySystem: AddressLike; bountyId: BigNumberish; submissionId: BigNumberish }): TransactionPayload;
@@ -1332,6 +1470,32 @@ export interface GitStorageClientConstructor {
 
 export declare const GitStorageClient: GitStorageClientConstructor;
 
+// ============ Library Visibility & Credit Types ============
+
+export type LibraryVisibility = 'public' | 'private' | 'shared';
+export type LibraryTier = 'personal' | 'shared' | 'dao';
+
+export interface LibraryLimitError {
+  error: string;
+  code: string;
+  costCredits: number;
+  currentCount: number;
+  freeLimit: number;
+  message: string;
+}
+
+export interface InsufficientCreditsError {
+  error: string;
+  needed: number;
+  balance: number;
+  message: string;
+}
+
+export interface CreditBalanceResponse {
+  balance: number;
+  wallet: string;
+}
+
 export interface SageSDK {
   version: string;
   getProvider: (rpcUrl: string) => any;